FlowRunner
PricingContact
Theme
Start Free

Look up verified Polish company data and tax compliance status from official government registries with NIP24, searching by NIP, REGON, or KRS number. Agents confirm a counterparty is real and in good standing before invoicing.

11 actions Custom auth available
Platform Documentation ↗ Capability data verified 2026-07-31
A purchase invoice is booked against a Polish contractor's NIP
Get Invoice Data returns the registered name and address for that NIP as it stands today
Check Company Activity confirms the business is registered and neither suspended nor terminated
Check VAT Status reads the Ministry of Finance portal and returns a confirmation id
The confirmation id and its timestamp are archived against the invoice as evidence
Controller sees the booked invoice with the registry evidence already attached
An invoice from a contractor who is not an active VAT payer holds for a controller ruling

What This Integration Enables

The useful thing NIP24 returns is not the answer, it is the receipt. Check VAT Status comes back with the status code, the official wording, and a confirmation id issued by the Ministry of Finance Tax Portal. Check Bank Account returns a confirmation id too. Those ids are the difference between a finance team that says it performs due diligence and a finance team that can show, per transaction, what it checked and on which date. An agent that runs the check and drops the id is doing half the job.

The connector reaches the registries that Polish finance work actually runs on. Get Invoice Data returns the minimum set needed to issue a VAT invoice, looked up live by NIP, REGON, or KRS. Get Company Details pulls the fuller Central Statistical Office profile: legal form, ownership form, REGON, TERYT address codes, registry entry data, activity start, suspension and termination dates, business partners, and PKD activity codes. Check Company Activity answers the plain question of whether the business is trading. Check VAT Status distinguishes not registered, active VAT payer, and VAT-exempt payer, which are three different situations rather than a pass and a fail. Search VAT Registry returns the full published entry from the list of VAT taxpayers, including every bank account the entity has reported. Check Bank Account and Check Bank Account In Flat File verify an account against that list, the flat file variant avoiding the Ministry's per-day request limits and additionally reporting whether the account is a virtual masked account. Check EU VAT Number reaches VIES for cross-border counterparties. Get KRS Extract and Get KRS Section pull National Court Register data, including the sections covering arrears, enforcement, a court-appointed curator, and bankruptcy or restructuring proceedings. Get Account Status is free and reports remaining quota, which makes it the right guard before a batch.

Without FlowRunner

Contractor details typed from the invoice Whatever the supplier printed becomes the master record, including yesterday's address
VAT status checked when someone remembers Status is confirmed at onboarding and assumed to hold for every invoice afterwards
Due diligence performed but not evidenced The check happened, and there is no artifact that shows it happened or when

With FlowRunner

Contractor details pulled from the registry Get Invoice Data returns current registered values keyed on NIP, REGON, or KRS
VAT status checked per invoice Check VAT Status runs on the document that depends on it, not once at the start of the relationship
Due diligence evidenced by a confirmation id The Ministry of Finance confirmation id is archived against the transaction it supports

Use Case Scenarios

Purchase Invoice Booking

A supplier invoice arrives and needs to be booked in SAP Business One or Xero. The agent extracts the NIP and runs Get Invoice Data, which returns the registered name, street, building and flat number, city, and post code as the registry holds them right now. It compares that against what is printed on the invoice and against the supplier master, and flags the differences rather than silently accepting any of the three. It then runs Check Company Activity and Check VAT Status, stores the confirmation id and timestamp on the transaction, and posts the invoice. The evidence that the contractor was an active VAT payer on the day the invoice was booked is attached to the invoice, not to a spreadsheet somebody keeps separately.

Payment Run Against the Biala Lista

A batch of supplier payments is scheduled for release. For each payee the agent runs Check Bank Account In Flat File against the daily published file, which sidesteps the Ministry of Finance per-day request ceilings that a large batch would otherwise hit, and additionally tells the flow whether the account is a virtual masked account. Accounts that come back valid keep their confirmation ids on the payment record. Accounts that do not come back valid trigger a second pass: the agent runs Search VAT Registry on the entity and returns every bank account it has actually published, so the reviewer is not asked "this failed, now what" but "the invoice says account A, the taxpayer list publishes accounts B and C, which do you want to pay". Where a single account needs a same-day re-check after the flat file was published, Check Bank Account queries the online API instead.

Counterparty Health Monitoring

An agent watches the contractors with open purchase orders on a schedule. For each one it runs Check Company Activity and pulls the relevant Get KRS Section extracts, which cover arrears and enforcement, a court-appointed curator, and bankruptcy or restructuring proceedings. Where a supplier's status has moved, the agent does not cancel anything. It assembles the change, the open PO value, and the delivery commitments already made, and puts them in front of the buyer in Slack with a plain question: continue, hold new orders, or escalate to legal. On individual plans Get KRS Extract pulls all six sections in one response instead; on standard plans the sectioned call is the one that works, and the flow picks accordingly.

Human-in-Loop Highlight

The gate sits on the purchase invoice, at the moment Check VAT Status returns status 1 or status 3 for a contractor whose invoice is charging VAT. Whether input VAT on that document can be treated as deductible is a tax position, and a tax position is taken by the people who sign the return, not by an agent that read a portal. So the agent posts the invoice nowhere. It routes to the controller with everything the ruling needs: "Invoice FV/2026/318 from [contractor], NIP [number], gross [amount], VAT charged [amount]. Ministry of Finance status today: not registered as a VAT payer. Confirmation id [id], checked [timestamp]. Registered activity per REGON: active. Book as charged, book without the VAT line, or return the invoice to the supplier?" The controller rules, the ruling is recorded next to the confirmation id, and the audit file explains itself later without anyone reconstructing it. Invoices from contractors who come back as active VAT payers post without a person in the path, which is the overwhelming majority. That split, routine volume automated and tax positions escalated, is the whole design intent behind human-in-the-loop on a finance flow.

Agent processes routinely
Detects exception requiring judgment
Clear match Continues automatically
Ambiguous Routes to human via preferred channel
Human decides
Agent resumes with decision

Agent Capabilities

11 actions

Company Data

3
  • Get Invoice Data Retrieves the minimum company data required to issue a Polish VAT invoice: registered name, owner first and last name, street, building and flat number, city, and post code. Looked up live by NIP, REGON, or KRS, so the result reflects current registry data rather than a cached copy.
  • Get Company Details Retrieves the full profile from the Central Statistical Office registry: legal form, ownership form, REGON, registry entry data, TERYT address codes, activity start, suspension and termination dates, business partners, and the list of PKD activity codes. Use it when invoice-level data is not enough to make the decision.
  • Check Company Activity Checks whether a company is currently conducting business according to the REGON registry. Returns active only when activity is registered and has been neither suspended nor terminated, which makes it a fast pre-check before onboarding a contractor.

VAT Verification

3
  • Check VAT Status Checks VAT registration status against the Ministry of Finance Tax Portal. Returns status 1 for not registered, 2 for an active VAT payer, and 3 for a VAT-exempt payer, together with the official wording and a confirmation id that can be stored as proof of the check.
  • Check EU VAT Number Confirms an EU VAT number in the European Commission VIES system for any member state, returning the validity flag, the trader name, company type, and address as published by the member state, plus a VIES consultation id.
  • Search VAT Registry Searches the Ministry of Finance list of VAT taxpayers and returns the full published entry: name, NIP, REGON, KRS, residence and working addresses, VAT status, representatives, authorized clerks, partners, every reported bank account, and the registration, denial, restoration, and removal dates.

Bank Account Verification

2
  • Check Bank Account Verifies through the Ministry of Finance API whether a bank account is assigned to a given entity in the list of VAT taxpayers on the checked date, returning a validity flag and the confirmation id used to document split-payment due diligence.
  • Check Bank Account In Flat File Verifies an account against the daily published flat file rather than the online API, which avoids the Ministry's per-day request limits on large batches. Additionally reports whether the account is a virtual masked account and the entity's VAT status from the same file.

KRS Registry

2
  • Get KRS Extract Downloads the complete current National Court Register extract for a company or association, covering all six sections in a single response. Available on individual plans only; standard plans use Get KRS Section instead.
  • Get KRS Section Downloads a single section of the current KRS extract, which keeps responses small and works on standard plans. Sections cover entity details and capital, representation and proxies, business activity and financial statements, arrears and enforcement, the court-appointed curator, and bankruptcy or restructuring proceedings.

Account

1
  • Get Account Status Returns the current state of the account: subscription type, validity date, the active plan with its request limit and per-function pricing and availability, and requests already used this billing period per function. The call is free, which makes it the correct guard before a batch job that is not.

Frequently Asked Questions

What can FlowRunner do with NIP24?

FlowRunner agents can run Get Invoice Data, Get Company Details, and Check Company Activity in NIP24, plus 8 more actions.

Does connecting NIP24 to FlowRunner require OAuth?

NIP24 uses a custom authentication method to connect to FlowRunner.

Can NIP24 trigger a FlowRunner workflow automatically?

NIP24 doesn't currently expose triggers in FlowRunner. It connects as an action step inside workflows started by another trigger.

Start building with NIP24

$100 in credits. No card required. Connect in minutes.