Poland

Description
Actions
Workflows
Documents


Developer	Invopop
Category	Government
Scope	B2B
Country	Poland

KSeF (Krajowy System e-Faktur) 2.0 is Poland’s mandatory national e-invoicing system operated by the Ministry of Finance. The system uses the FA(3) XML schema format for structured invoice data and provides real-time clearance for all B2B invoices.Electronic invoicing in Poland operates on a clearance model whereby every invoice must be validated against the FA(3) schema and business rules in real-time. Validated invoices receive a unique KSeF ID and official timestamp. The platform provides secure archiving for issued and received e-invoices.Invoices are encoded in FA(3), a strict XML format published and maintained by Polish tax authorities. The schema enforces standardized fields for both domestic and cross-border transactions, including buyer/seller data, VAT details, and item lines.Key Features

Party Registration: Register suppliers in the KSeF system with their Polish Tax ID (NIP).
Workflow Automation: Automated workflows for registering parties and issuing invoices through the KSeF 2.0 system.
Real-Time Validation: Every invoice is validated in real-time against the FA(3) schema and business rules, ensuring compliance with Polish e-invoicing regulations.
Legally Compliant PDF Invoices: Invoices are generated with all mandatory fields and FA(3) QR codes linked to the KSeF portal.
FA(3) XML Generation: Compliant XML generation is supported for the KSeF FA(3) schema.
QR Code: Generates the FA(3) QR code according to KSeF specifications.
KSeF 2.0 Integration: Direct integration with KSeF 2.0, Poland’s official national platform for electronic invoicing.

Sandbox Only - Production Environment Not Yet AvailableKSeF 2.0 is currently only available in the sandbox environment. The production environment is expected to launch in February 2026 for large taxpayers.

Make sure to check out our Poland Guide for instructions on how to register suppliers, issue invoices, and set up your workflows.

The following workflows are available to make your integration easier. Use them as templates to build upon.

Poland party registration workflow

This workflow registers a supplier in the KSeF system.

Example Register supplier for KSeF workflow with states

{
    "name": "Register for KSeF",
    "description": "Register a party in KSeF",
    "schema": "org/party",
    "steps": [
        {
            "id": "f6ca2240-fb6b-11f0-b2f4-37a8eb8f9eb9",
            "name": "Set State",
            "provider": "silo.state",
            "summary": "Set state to `processing`{.state .processing}",
            "config": {
                "state": "processing"
            }
        },
        {
            "id": "e2cd6770-fb6b-11f0-b2f4-37a8eb8f9eb9",
            "name": "Register for KSeF",
            "provider": "gov-pl.register"
        },
        {
            "id": "f0b45d30-fb6b-11f0-b2f4-37a8eb8f9eb9",
            "name": "Set State",
            "provider": "silo.state",
            "summary": "Set state to `registered`{.state .registered}",
            "config": {
                "state": "registered"
            }
        }
    ],
    "rescue": [
        {
            "id": "ebf99440-fb6b-11f0-b2f4-37a8eb8f9eb9",
            "name": "Set State",
            "provider": "silo.state",
            "summary": "Set state to `error`{.state .error}",
            "config": {
                "state": "error"
            }
        }
    ]
}

Add to my workspace →

Poland invoice sending workflow

This workflow automates FA(3) Polish invoice processing and tax compliance.

Example Send KSeF invoice workflow with states

{
    "name": "Send KSeF invoice",
    "description": "Generate FAVAT (3) XML and send it to KSeF",
    "schema": "bill/invoice",
    "steps": [
        {
            "id": "20bbac70-fb6e-11f0-8a4e-79beeb9e3cf2",
            "name": "Set State",
            "provider": "silo.state",
            "summary": "Set state to `processing`{.state .processing}",
            "config": {
                "state": "processing"
            }
        },
        {
            "id": "9b5f5330-fb70-11f0-bcdd-bdb71eaf1fb4",
            "name": "Add Sequential Code",
            "provider": "sequence.enumerate",
            "summary": "Dynamic · KSeF · 000001",
            "config": {
                "name": "KSeF",
                "padding": 6,
                "start": 1
            }
        },
        {
            "id": "2f41c860-fb6e-11f0-8a4e-79beeb9e3cf2",
            "name": "Sign Envelope",
            "provider": "silo.close"
        },
        {
            "id": "2b064190-fb6e-11f0-8a4e-79beeb9e3cf2",
            "name": "Generate FA_VAT v3 XML",
            "provider": "gov-pl.generate"
        },
        {
            "id": "36ec8550-fb6e-11f0-8a4e-79beeb9e3cf2",
            "name": "Send FA_VAT v3 XML to KSeF",
            "provider": "gov-pl.send"
        },
        {
            "id": "3a3e2150-fb6e-11f0-8a4e-79beeb9e3cf2",
            "name": "Set State",
            "provider": "silo.state",
            "summary": "Set state to `sent`{.state .sent}",
            "config": {
                "state": "sent"
            }
        }
    ],
    "rescue": [
        {
            "id": "3eca1210-fb6e-11f0-8a4e-79beeb9e3cf2",
            "name": "Set State",
            "provider": "silo.state",
            "summary": "Set state to `error`{.state .error}",
            "config": {
                "state": "error"
            }
        }
    ]
}

Add to my workspace →

🇵🇱 Invopop resources for Poland


Compliance	Invoicing compliance in Poland Compliance timeline
Apps	Poland
Guides	Poland Guide
FAQ	Poland FAQ
GOBL	Poland Tax Regime Polish KSeF FA(3) Addon

Participate in our community

Ask and answer questions about Poland App →

Network

Government

Notify

Format

Document

Storage

Integrations

Poland

Poland

Register Party in KSeF (Poland)

Generate FA(3) XML

Send FA(3) XML to KSeF

Participate in our community