ID komponentu w PWFL:vendor.checker.entity-info.action

Kategoria: Plus Vendor Checker

Dostępne od wersji: 1.0.7

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/nip/{nip} oraz /api/search/bank-account/) z API MF.

Możliwość przeciągnięcia na

  • Formularz
  • Zmienną (pole NIP/Numer konta jest niewidoczne w konfiguracji, wartość jest pobierana bezpośrednio ze zmiennej)
  • Zwykły przycisk
Nazwa parametruOd wersjiOpisTyp parametruWartość domyślnaRodzaj pola

Uwagi i ograniczenia

NIP/Numer konta*1.0.7Wartość, za pomocą której szukamy podmiotu gospodarczego.Tekstowy EdytowalnyPo przeciągnięciu na zmienną, pole niewidoczne, wartość pobierana z zmiennej.
Data 1.0.7Pobranie informacji na wybrany dzień.Data Edytowalny 
Typ*1.0.7Typ parametru, po jakim wyszukujemy informacji.Tekstowy Lista wartości 
Klucz mapowania1.0.7Wybrane pobrane parametry do mapowania.Tablica tekstów Lista wartościWszystkie dostępne klucze w tabeli poniżej.
Zmienna 1.0.7Zmienna wykorzystywana do zapisania wartości.Tablica zmiennych Edytowalny 
Status przetwarzania1.0.7Wartość 'OK' gdy poprawnie pobrano dane. W innym przypadku treść błędu.Zmienna Edytowalny 
Komentarz*1.0.7 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 gospodarczejAdres siedziby OSOBY FIZYCZNEJ prowadzącej działalność gospodarczą.string
WORKING_ADRESSAdres siedzibyAdres zamieszkania OSOBY FIZYCZNEJ lub adres siedziby ORGANIZACJI.string
REPRESENTATIVES_COMPANY_NAMETabela reprezentantów - NazwaDane osób wchodzących w skład organu uprawnionego do reprezentowania podmiotu.string[]
REPRESENTATIVES_FIRST_NAMETabela reprezentantów - ImięDane osób wchodzących w skład organu uprawnionego do reprezentowania podmiotu.string[]
REPRESENTATIVES_LAST_NAMETabela reprezentantów - NazwiskoDane osób wchodzących w skład organu uprawnionego do reprezentowania podmiotu.string[]
REPRESENTATIVES_PESELTabela reprezentantów - PeselDane osób wchodzących w skład organu uprawnionego do reprezentowania podmiotu.string[]
REPRESENTATIVES_NIPTabela reprezentantów - NipDane osób wchodzących w skład organu uprawnionego do reprezentowania podmiotu.string[]
AUTHORIZED_CLERKS_COMPANY_NAMETabela prokurentów - NazwaDane prokurentów.string[]
AUTHORIZED_CLERKS_FIRST_NAMETabela prokurentów - ImięDane prokurentów.string[]
AUTHORIZED_CLERKS_LAST_NAMETabela prokurentów - NazwiskoDane prokurentów.string[]
AUTHORIZED_CLERKS_PESELTabela prokurentów - PeselDane prokurentów. string[]
AUTHORIZED_CLERKS_NIPTabela prokurentów - NipDane prokurentów.string[]
PARTNERS_COMPANY_NAMETabela wspólników - NazwaDane wspólników.string[]
PARTNERS_FIRST_NAMETabela wspólników - ImięDane wspólników.string[]
PARTNERS_LAST_NAMETabela wspólników - NazwiskoDane wspólników.string[]
PARTNERS_PESELTabela wspólników - PeselDane wspólników.string[]
PARTNERS_NIPTabela wspólników - NipDane wspólników.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
ACCOUNT_NUMBERSNumery kont bankowychTabela numerów kont bankowych.string[]
HAS_VIRTUAL_ACCOUNTSPosiada konta wirtualneInformacja czy podmiot gospodarczy posiada konta wirtualne.boolean
REQUEST_IDRequest IDIdentyfikator zapytania z serwera MF.string
REQUEST_DATETIMERequest DateTimeData odpytania serwera MF.datetime

  1. Dane wyszukiwane za pomocą NIP: 8561846394
  2. Użycie wybranego api: https://wl-api.mf.gov.pl/api/search/nip/8561846394?date=2021-01-11
  3. Pobrany dane w formie JSON

  4. Przepisanie pobranych wartości do zmiennych formularza

 

 

 1.0.7

  • Dodanie komponentu

Component ID in PWFL: vendor.checker.entity-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 tax identification number or account number. The component uses the provided methods (/ api / search / nip / {nip} and / api / search / bank-account /) with API MF
Action destination:
  • Form
  • Variable (the NIP / Account number field is not visible in the configuration, the value is taken directly from the variable)
  • Button
Parameter NameFrom versionDescriptionParameter typeDefault valueField typeComments and restricitons
Tax ID / Account number*1.0.7The value with which we are looking for a business entity.Text Editable field 
Date1.0.7Downloading information for a selected day.Date Editable field 
Type*1.0.7The type of the parameter we search for information on.TextValue listEditable field 
The mapping key1.0.7Selected downloaded parameters for mapping.Text ArrayValue list All available keys in the table below
Variable1.0.7Variable used to write the value.Vairables Array   
Processing status1.0.7Value 'OK' when data has been successfully downloaded. Otherwise, the content of the error.Variable   
Comment1.0.7 LogicalYES Only error messages
MAPPING TABLE OF ECONOMY INFORMATION PARAMETERS
KluczNazwaOpisTyp
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
REPRESENTATIVES_COMPANY_NAMERepresentatives Table - NameData of persons belonging to the body authorized to represent the entity.string[]
REPRESENTATIVES_FIRST_NAMERepresentatives Table - First nameData of persons belonging to the body authorized to represent the entity.string[]
REPRESENTATIVES_LAST_NAMERepresentatives Table - Last nameData of persons belonging to the body authorized to represent the entity.string[]
REPRESENTATIVES_PESELRepresentatives Table - PeselData of persons belonging to the body authorized to represent the entity.string[]
REPRESENTATIVES_NIPRepresentatives Table - Tax IDData of persons belonging to the body authorized to represent the entity.string[]
AUTHORIZED_CLERKS_COMPANY_NAMEAuthorized clerk Table - Name Data of authorized clerks.string[]
AUTHORIZED_CLERKS_FIRST_NAMEAuthorized clerk Table - First nameData of authorized clerks.string[]
AUTHORIZED_CLERKS_LAST_NAMEAuthorized clerk Table - Last nameData of authorized clerks.string[]
AUTHORIZED_CLERKS_PESELAuthorized clerk Table - PeselData of authorized clerks.string[]
AUTHORIZED_CLERKS_NIPAuthorized clerk Table -  Tax IDData of authorized clerks.string[]
PARTNERS_COMPANY_NAMEPartners Table - Name Data of the partners.string[]
PARTNERS_FIRST_NAMEPartners Table - First nameData of the partners.string[]
PARTNERS_LAST_NAMEPartners Table - Last nameData of the partners.string[]
PARTNERS_PESELPartners Table - PeselData of the partners.string[]
PARTNERS_NIPPartners Table - NipData of the partners.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 payerdate
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[]
ACCOUNT_NUMBERSBank account numbersBank account numbers Table.string[]
HAS_VIRTUAL_ACCOUNTSHas virtual accountsInformation whether the economic entity has virtual accounts.boolean
REQUEST_IDRequest IDThe id of the query from the MF server.string
REQUEST_DATETIMERequest DateTimeDate of the MF server polling.datetime

 

 

  1. Data searched using NIP:: 8561846394
  2. Use the selected api: https://wl-api.mf.gov.pl/api/search/nip/8561846394?date=2021-01-11
  3. Data downloaded in the form of JSON

  4. Rewriting the retrieved values to form variables

1.0.7

  • Adding component