Terms of service: Polish Vat Scanner

Effective from: December 31, 2019.

The Polish VAT Scanner module includes two services:

  • NRB verification,
  • Polish VAT Scanner.

NRB verification

  1. The NRB Check service allows you to check the contractor’s NIP number and bank account number in a flat file (VAT white list) provided by the Ministry of Finance – National Tax Administration (KAS). The flat file allows verification of settlement accounts, personal accounts in SKOK and virtual accounts.
  2. The NRB Check service is available in the “VAT White List (KYC)” category and settled under the NIP Scanner module. It allows you to check whether the NIP number and bank account number provided by the customer appear in a flat file made available by KAS on a given day. In response you receive information containing the customer’s status (the status for the data pair: tax identification number and bank account number). The flat file does not allow the tax ID number to be checked or a bank account number to be searched for. To do this, use the NIP Scanner service – VAT register.
  3. The NRB Check service is available in two variants: collective verification and single verification. Each inquiry, regardless of whether it verifies one bank account or a set of bank accounts, is treated as a single query to the database and settled within the available balance.
  4. The NRB Check service is closely related to the Polish VAT Scanner module and is settled from the balance of this module for each request.
  5. Sending an NRB inquiry returns the following messages: “Incorrect NIP” (incorrect check digit – the NIP number is validated for correct construction); “Incorrect data” – the bank account number is not constructed correctly. If the tax identification number (NIP) and bank account number are correct, the response tells you whether the given pair appears in the flat file provided by KAS on that day.
  6. Sending the NRB query returns the messages: “Active”, “VAT-free”, “Not registered for VAT”.
  7. If you have a positive balance of available queries, each time you send an NRB query the number of available requests decreases by one.

Polish VAT Scanner

  1. Polish VAT Scanner allows the contractor’s VAT number to be checked in three publicly available registers:
  • in the Polish business registry kept by the Central Statistical Office,
  • in the VAT register – the so-called VAT white list – kept by the National Tax Administration,
  • in the VIES register made available by the European Commission.
  1. Polish business registry: checks whether the customer’s VAT number is correct and whether a company with the given number exists. If the VAT number is correct and such an entity exists, you receive information containing basic data about the customer: date of commencement of operation, its suspension and/or liquidation, and the current status of activity. The data source is the Central Statistical Office.
  2. VAT registry: checks whether the company with the provided VAT number is registered as a VAT taxpayer on the White VAT List. The data source is the register provided by the National Tax Administration.
  3. VIES registry: checks the activity of the EU VAT number. The response contains information for cross-border transactions within the EU.
  4. The service is available as a web application on the HyperFlow platform and via the API (REST JSON web service).
  5. The service is available as query packages and is charged for each query sent to the database, regardless of the number of selected registers, within the available credit balance, or as unlimited access for a specified period*.
  6. When the service has the status Active, filling in a non-empty value in the query form and pressing the “Check VAT status” button or Enter, or sending a correctly formulated request via the API (in accordance with the API documentation), is referred to as sending a request. The answer is presented as text information (in the web application) or as a JSON message (for requests sent via the API).
  7. Sending a Polish business registry query returns the following messages: “Bad VAT number” (incorrect check digit – the VAT number is validated for correct construction); “Record not found” – the VAT number is structured correctly, but no entity with this VAT number exists. If the tax identification number is correct and an entity with this number exists, the response contains information about the entity, including the current status of activity.
  8. Sending the “National VAT registry” query returns the following messages: “Active”, “VAT-free”, “Not registered for VAT”. It also contains the query date and query ID.
  9. The VIES report returns the messages “Active” or “Not registered for VAT”. It also includes the date of the inquiry and the company’s address for confirmation.
  10. If the credit balance is greater than zero, each time a request is sent, the number of available requests is reduced by one.
  11. The service becomes inactive when the number of requests (credit balance) on a given Customer Account reaches 0 (zero).
  12. The Service Provider does not provide the entire database (copies for download) as part of this service.
  13. The maximum frequency of sending queries is 5 queries per second.
  14. If queries are executed more frequently, the service may respond with the error code “Server busy”.
  15. If you send a request that ends with a “Server busy” or “Server timeout” error, the balance of available queries is not reduced.
  16. The Polish VAT Scanner service includes the NRB Verification module, which allows a pair of data (VAT number and bank account number) to be checked in a flat file provided by the Ministry of Finance – National Tax Administration in Poland. NRB verification is closely related to the Polish VAT Scanner service and is charged per request from the balance of this service.
  17. The NRB Verification module enables mass verification by entering or pasting VAT numbers and bank accounts (separated by a space), or by loading a file with this data.
  18. The VAT Scanner History feature allows you to obtain a monthly query report and to track changes in contractor data, e.g. change of status, name or address.
  19. The VAT Scanner History feature is closely related to the service and is available when the service has the status Active.
  20. The VAT Scanner History feature provides a history of queries covering: query date, NIP number, full entity name, entity status, legal form name and the name of the querying user.
  21. Full historical data of Polish business registry requests is available as monthly reports to download in CSV format.
  22. The Service Provider is not responsible for the lack of access to the Central Statistical Office, VAT or VIES registers, especially in cases where:
  • the servers providing the service operated by the NTA do not respond,
  • the National Tax Administration does not provide a flat file on a given day,
  • the VIES servers do not respond,
  • the servers providing the service run by the CSO do not respond.
  • In accordance with the recommendations of the National Tax Administration, when the service is unavailable, keep a record of the unavailability of the service and inform the competent Heads of Tax Offices about the transfers you have made.

* – fixed-term access with no query limit: above 20,000 queries per month the service remains active, but to ensure service continuity the response waiting time may be extended to 30 seconds.

Leave a Reply