KSeF Poland

Description
Actions
Workflows
Documents

Issue invoices and credit notes through KSeF.


Developer	Invopop
Category	Government
Country	Poland
Docs	Implementation guide

KSeF (Krajowy System e-Faktur) is Poland’s official national platform for electronic invoicing, established and operated by the Ministry of Finance. KSeF with the FA_VAT format aims to increase transparency, streamline VAT compliance, and reduce tax fraud in business-to-business (B2B) invoicing.Electronic invoicing in Poland operates on a real-time validation model whereby every invoice must be validated against the FA_VAT schema and business rules. Validated invoices receive a unique KSeF ID and official ‘receipt’ timestamp. The platform provides secure archiving for issued and received e-invoices.Invoices are encoded in FA_VAT, 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

Workflow Automation: This app provides automated workflows for issuing invoices and credit notes through the KSeF system.
Real-Time Validation: Every invoice is validated in real-time against the FA_VAT schema and business rules, ensuring compliance with Polish e-invoicing regulations.
Legally Compliant PDF Invoices: Invoices are generated with all mandatory fields and FA_VAT QR codes linked to the KSeF portal.
FA_VAT XML Generation: Compliant XML generation is supported for the KSeF FA_VAT schema.
QR Code: Generates the FA_VAT QR code according to KSeF specifications.
KSeF Integration: Direct integration with KSeF, Poland’s official national platform for electronic invoicing.

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

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

KSeF Poland invoice workflow

This workflow automates FA_VAT Polish invoice processing and tax compliance.

Example KSeF send invoice workflow with states

{
    "name": "PL – Send invoice to KSeF",
    "description": "Send FA_VAT invoice to KSeF in Poland",
    "schema": "bill/invoice",
    "steps": [
        {
            "id": "7be51070-46e5-11f0-8992-b3700a7ae767",
            "name": "Set State",
            "provider": "silo.state",
            "summary": "Set state to `processing`{.state .processing}",
            "config": {
                "state": "processing"
            }
        },
        {
            "id": "f63048e0-46e5-11f0-8992-b3700a7ae767",
            "name": "Add Sequential Code",
            "provider": "sequence.enumerate",
            "summary": "Dynamic · KSef Sequence · 000001",
            "config": {
                "name": "KSef Sequence",
                "padding": 6,
                "sign": false,
                "start": 1
            }
        },
        {
            "id": "fe680390-46e5-11f0-8992-b3700a7ae767",
            "name": "Sign Envelope",
            "provider": "silo.close"
        },
        {
            "id": "774dd510-46e5-11f0-8992-b3700a7ae767",
            "name": "Send to KSeF (Poland)",
            "provider": "ksef-pl.send",
            "summary": "Test",
            "config": {
                "environment": "test",
                "issuer_nip": "",
                "issuer_token": ""
            }
        },
        {
            "id": "79757000-46e5-11f0-8992-b3700a7ae767",
            "name": "Generate PDF",
            "provider": "pdf",
            "summary": "Polish - A4",
            "config": {
                "date_format": "%Y-%m-%d",
                "layout": "A4",
                "locale": "pl",
                "logo_height": 40
            }
        },
        {
            "id": "821a1d50-46e5-11f0-8992-b3700a7ae767",
            "name": "Set State",
            "provider": "silo.state",
            "summary": "Set state to `sent`{.state .sent}",
            "config": {
                "state": "sent"
            }
        }
    ],
    "rescue": [
        {
            "id": "86a794b0-46e5-11f0-8992-b3700a7ae767",
            "name": "Set State",
            "provider": "silo.state",
            "summary": "Set state to `error`{.state .error}",
            "config": {
                "state": "error"
            }
        }
    ]
}

Add to my workspace →

KSeF Poland Self-Billed Invoice

KSeF self-billed invoice

{
    "$schema": "https://gobl.org/draft-0/bill/invoice",
    "$regime": "PL",
    "$tags": [
        "self-billed"
    ],
    "uuid": "3aea7b56-59d8-4beb-90bd-f8f280d852a0",
    "type": "standard",
    "code": "SAMPLE-001",
    "issue_date": "2025-08-01",
    "currency": "PLN",
    "supplier": {
        "name": "Provide One S.L.",
        "tax_id": {
            "country": "PL",
            "code": "9876543210"
        },
        "addresses": [
            {
                "num": "42",
                "street": "ul. Przykładowa",
                "locality": "Warszawa",
                "region": "mazowieckie",
                "code": "00-015",
                "country": "PL"
            }
        ],
        "emails": [
            {
                "addr": "[email protected]"
            }
        ]
    },
    "customer": {
        "name": "Your Company S.A.",
        "tax_id": {
            "country": "PL",
            "code": "1234567788"
        },
        "addresses": [
            {
                "num": "43",
                "street": "ul. Przykładowa",
                "locality": "Warszawa",
                "region": "mazowieckie",
                "code": "00-015",
                "country": "PL"
            }
        ]
    },
    "lines": [
        {
            "i": 1,
            "quantity": "20",
            "item": {
                "name": "Development services",
                "price": "90.00",
                "unit": "h"
            },
            "sum": "1800.00",
            "taxes": [
                {
                    "cat": "VAT",
                    "rate": "standard",
                    "percent": "23.0%"
                }
            ],
            "total": "1800.00"
        },
        {
            "i": 2,
            "quantity": "1",
            "item": {
                "name": "Financial service",
                "price": "10.00",
                "unit": "service"
            },
            "sum": "10.00",
            "taxes": [
                {
                    "cat": "VAT",
                    "rate": "reduced",
                    "percent": "8.0%"
                }
            ],
            "total": "10.00"
        }
    ]
}

🇵🇱 Invopop resources for Poland


Compliance	Invoicing compliance in Poland Compliance timeline
Apps	KSeF Poland
Guides	Poland Guide
FAQ	Poland FAQ
GOBL	Poland Tax Regime Polish KSeF FA_VAT Addon

Participate in our community

Ask and answer questions about KSeF Poland App →

Government

Notify

Format

Document

Storage

Integrations

KSeF Poland

KSeF Poland

Send to KSeF (Poland)

Participate in our community