ID komponentu w vendor.checker.entities-info.action

Kategoria: Plus Vendor Checker

Dostępne od wersji: 1.0.X

Pobiera szczegółowe informacje o podmiocie gospodarczym bezpośrednio ze strony Ministerstwa Finansów za pomocą wartości nip lub numeru konta. Komponent używa dostarczonych metod ( /api/search/nips/{nip} oraz /api/search/bank-accounts/{bank-accounts} ) z API MF. Pobiera tylko dane nagłówkowe (nie przepisuję wartości tabelarycznych w wyszukanym podmiocie gospodarczym).

Możliwość przeciągnięcia na

  • Przycisk tabeli
  • Formularz
Nazwa parametruOd wersjiOpisTyp parametruWartość domyślnaRodzaj pola

Uwagi i ograniczenia

NIPy/Numery kont*1.0.XWartość, za pomocą której szukamy podmiotu gospodarczego.Tablica tekstów Edytowalny 
Data 1.0.XPobranie informacji na wybrany dzień.Tablica Dat Edytowalny 
Typ*1.0.XTyp parametru po jakim wyszukujemy informacji.Tekstowy Lista wartości 

Id tabeli dynamicznej*

1.0.X Tekstowy EdytowalnyPojawia się, gdy komponent zostanie umieszczony na formularzu
Klucz mapowania1.0.XWybrane pobrane parametry do mapowania.Tablica tekstów Lista wartościWszystkie dostępne klucze w tabeli poniżej
Zmienna 1.0.XZmienna wykorzystywana do zapisania wartości.Tablica zmiennych Edytowalny 
Status przetwarzania1.0.XWartość 'OK' gdy poprawnie pobrano dane. W innym przypadku treść błędu.Zmienna Edytowalny 
Komentarz*1.0.X LogicznyTakEdytowalnyTylko komunikaty błędów

Parametr*- pole wymagane

 

TABELA MAPOWAŃ PARAMETRÓW INFORMACJI O PODMIOCIE GOSPODARCZYM
KluczNazwaOpisWymagany typ
NAMENazwaFirma (nazwa) lub imię i nazwisko.string[]
NIPNipNumer identyfikacji podatkowej.string[]
STATUS_VATStatus podatnika VATCzynny, Zwolniony, Niezarejestrowany.string[]
REGONREGONNumer identyfikacyjny REGON.string[]
PESELPeselPowszechny Elektroniczny System Ewidencji Ludności.string[]
KRSKRSNumer KRS jeżeli został nadany.string[]
RESIDENCE_ADDRESSAdres siedziby działalności gospodarczej Adres siedziby OSOBY FIZYCZNEJ prowadzącej działalność gospodarczą.string[]
WORKING_ADRESSAdres siedzibyAdres zamieszkania OSOBY FIZYCZNEJ lub adres siedziby ORGANIZACJI.string[]
REGISTRATION_LEGAL_DATEData rejestracjiData rejestracji jako podatnika VAT.date[]
REGISTRATION_DENIAL_DATEData odmowyData odmowy rejestracji jako podatnika VAT.date[]
REGISTRATION_DENIAL_BASISPodstawa prawna odmowyPodstawa prawna odmowy rejestracji.string[]
RESTORATION_DATEData przywróceniaData przywrócenia jako podatnika VAT.date[]
RESTORATION_BASISPodstawa prawna przywróceniaPodstawa prawna przywrócenia jako podatnika VAT.string[]
REMOVAL_DATEData wykreśleniaData wykreślenia odmowy rejestracji jako podatnika VAT.date[]
REMOVAL_BASISPodstawa prawna wykreśleniaPodstawa prawna wykreślenia odmowy rejestracji jako podatnika VAT.string[]
HAS_VIRTUAL_ACCOUNTSPosiada konta wirtualneInformacja czy podmiot gospodarczy posiada konta wirtualne.string[]
REQUEST_IDRequest IDIdentyfikator zapytania z serwera MF.string[]
REQUEST_DATETIMERequest DateTimeData odpytania serwera MF.string[]
ERROR_MESSEGEKomunikat o błędzieSzczegółowe informacje o błędzie zwrócone z MF dla podanego podmiotu.string[]

  1. Dane wyszukiwane za pomocą kolumny NIP 
  2. Wykorzystane api /api/search/nips/{nip}
  3. Przepisanie pobranych wartości do zmiennych formularza

 

 

 1.0.X

  • Dodanie komponentu

Component ID in PWFL:vendor.checker.entities-info.action

Category: Plus Vendor Checker

Available from version: 1.0.X

Retrieves detailed information about an economic entity directly from the website of the Ministry of Finance using the taxs identification number or accounts number The component uses the provided methods (/api/search/nips/{nip} and /api/search/bank-accounts/{bank-accounts}) from the MF API. Retrieves only the header data (Not rewriting tabular values in the searched business entity).

Action destination:

  • Table button
  • Form
Parameter NameFrom versionDescriptionParameter typeDefault valueField typeComments and restricitons
Tax IDs / Account numbers*1.0.XThe value with which we are looking for a business entity.Text Array Editable field 
Date1.0.XDownloading information for a selected day.Date Array Editable field 
Type*1.0.XThe type of the parameter we search for information on.TextValue listValue list 
Table id*      Appears when a component is placed on a form
The mapping key1.0.XSelected downloaded parameters for mapping.Text ArrayValue listValue listAll available keys in the table below
Variable1.0.XVariable used to write the value.Vairables Array Editable field 
Processing status1.0.XValue 'OK' when data has been successfully downloaded. Otherwise, the content of the error.Variable Editable field 
Comment1.0.X LogicalYESEditable fieldOnly error messages
MAPPING TABLE OF ECONOMY INFORMATION PARAMETERS
KeyNameDescription
Type required
NAMENameCompany (name) or first and last name.string[]
NIPTax IDTax identification number.string[]
STATUS_VATVAT taxpayer statusCzynny,Zwolniony,Niezarejestrowany.string[]
REGONREGONREGON identification number.string[]
PESELPeselUniversal Electronic System for Registration of the Population.string[]
KRSKRSKRS number, if assigned.string[]
RESIDENCE_ADDRESSBusiness addressAddress of the registered office of a natural person running a business.string[]
WORKING_ADRESSHQ adressThe address of the NATURAL PERSON or the registered office of the ORGANIZATION.string[]
REGISTRATION_LEGAL_DATEDate of registration Date of registration as a VAT payer.date[]
REGISTRATION_DENIAL_DATEDate of refusal Date of refusal to register as a VAT payer.date[]
REGISTRATION_DENIAL_BASISLegal basis for refusalLegal basis for refusing registration.string[]
RESTORATION_DATEDate of reinstatementDate of reinstatement as a VAT payer.date[]
RESTORATION_BASISLegal basis for restoration Legal basis for reinstatement as a VAT payer.string[]
REMOVAL_DATEDate of removalDate of removal of refusal to register as a VAT taxpayer.date[]
REMOVAL_BASISLegal basis for removalLegal basis for removal of refusal to register as a VAT taxpayer.string[]
HAS_VIRTUAL_ACCOUNTSHas virtual accountsInformation whether the economic entity has virtual accounts.string[]
REQUEST_IDRequest IDThe id of the query from the MF server.string[]
REQUEST_DATETIMERequest DateTimeDate of the MF server polling.string[]
ERROR_MESSEGEError messageDetailed information about the entity returned from the Ministry of Finance.string[]

 

 

  1. Data searched for using the NIP column
  2. Used api /api/search/nips/{nip}
  3. Rewriting the retrieved values to form variables

 

 

1.0.X

  • Adding component