Submit batch invoices to Poland KSeF 2.0 using FA(3) schema

domain: ksef.mf.gov.pl · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Obtain a KSeF authentication token by calling the session initiation endpoint with your NIP and a signed challenge; the KSeF 2.0 API uses OpenAPI 3.0.4 and all session calls require a valid token in the SessionToken header.
  2. Build each invoice as a valid FA_VAT(3) XML document; FA(3) is the only accepted schema from 1 February 2026 — FA(2) documents will be rejected.
  3. Wrap multiple FA(3) invoices in a batch envelope according to the KSeF 2.0 integration guide and POST the batch payload to the batch invoice submission endpoint documented in the interactive KSeF 2.0 API portal.
  4. Poll the batch status endpoint with the returned reference number until the status changes to PROCESSED or REJECTED.
  5. For each accepted invoice, retrieve the UPO (Urzedowe Poswiadczenie Odbioru) from the UPO endpoint using the invoice's KSeF number — the UPO is the legally binding receipt of acceptance.
  6. Store the KSeF number and UPO for each invoice; these are required for audit and buyer reference.

Known gotchas

Related routes

Integrate with Poland's KSeF 2.0 API to submit mandatory structured B2B e-invoices
podatki.gov.pl · 5 steps · unrated
Issue invoices in KSeF offline24 mode and reconcile them with KSeF
ksef.mf.gov.pl · 6 steps · unrated
Submit a B2B e-invoice to Romania RO e-Factura via ANAF SPV API
mfinante.gov.ro · 5 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans