Basic info
Component ID in PWFL:vendor.checker.entities-info.action
Category: Plus Vendor Checker
Available from version: 1.0.X
Description
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
Configuration parameters
| Parameter Name | From version | Description | Parameter type | Default value | Field type | Comments and restricitons |
|---|---|---|---|---|---|---|
| Tax IDs / Account numbers* | 1.0.7 | The value with which we are looking for a business entity. | Text Array | Editable field | ||
| Date | 1.0.7 | Downloading information for a selected day. | Date Array | Editable field | ||
| Type* | 1.0.7 | The type of the parameter we search for information on. | Text | Value list | Value list | |
| Table id* | Appears when a component is placed on a form | |||||
| The mapping key | 1.0.7 | Selected downloaded parameters for mapping. | Text Array | Value list | Value list | All available keys in the table below |
| Variable | 1.0.7 | Variable used to write the value. | Vairables Array | Editable field | ||
| Processing status | 1.0.7 | Value 'OK' when data has been successfully downloaded. Otherwise, the content of the error. | Variable | Editable field | ||
| Comment | 1.0.7 | Logical | YES | Editable field | Only error messages |
| MAPPING TABLE OF ECONOMY INFORMATION PARAMETERS | |||
| Key | Name | Description | Type required |
|---|---|---|---|
| NAME | Name | Company (name) or first and last name. | string[] |
| NIP | Tax ID | Tax identification number. | string[] |
| STATUS_VAT | VAT taxpayer status | Czynny,Zwolniony,Niezarejestrowany. | string[] |
| REGON | REGON | REGON identification number. | string[] |
| PESEL | Pesel | Universal Electronic System for Registration of the Population. | string[] |
| KRS | KRS | KRS number, if assigned. | string[] |
| RESIDENCE_ADDRESS | Business address | Address of the registered office of a natural person running a business. | string[] |
| WORKING_ADRESS | HQ adress | The address of the NATURAL PERSON or the registered office of the ORGANIZATION. | string[] |
| REGISTRATION_LEGAL_DATE | Date of registration | Date of registration as a VAT payer. | date[] |
| REGISTRATION_DENIAL_DATE | Date of refusal | Date of refusal to register as a VAT payer. | date[] |
| REGISTRATION_DENIAL_BASIS | Legal basis for refusal | Legal basis for refusing registration. | string[] |
| RESTORATION_DATE | Date of reinstatement | Date of reinstatement as a VAT payer. | date[] |
| RESTORATION_BASIS | Legal basis for restoration | Legal basis for reinstatement as a VAT payer. | string[] |
| REMOVAL_DATE | Date of removal | Date of removal of refusal to register as a VAT taxpayer. | date[] |
| REMOVAL_BASIS | Legal basis for removal | Legal basis for removal of refusal to register as a VAT taxpayer. | string[] |
| HAS_VIRTUAL_ACCOUNTS | Has virtual accounts | Information whether the economic entity has virtual accounts. | string[] |
| REQUEST_ID | Request ID | The id of the query from the MF server. | string[] |
| REQUEST_DATETIME | Request DateTime | Date of the MF server polling. | string[] |
| ERROR_MESSEGE | Error message | Detailed information about the entity returned from the Ministry of Finance. | string[] |
Sample configuration
Example
- Data searched for using the NIP column
- Used api /api/search/nips/{nip}
- Rewriting the retrieved values to form variables
Change log
1.0.7
Add Comment