Flowie
Compliance · 🇵🇱 Polonia Rollout graduale

Polonia — Clearance B2B obbligatoria KSeF

Clearance obbligatoria KSeF · grandi contribuenti feb 2026 · tutti apr 2026 — autorità di regolamentazione: Ministerstwo Finansów (Ministero delle Finanze). Dati aggiornati l'ultima volta: 2026-05-05.

Modello di copertura
Flowie gestisce un Access Point Peppol registrato in questa giurisdizione direttamente dove disponiamo di un accreditamento nazionale, oppure tramite un partner locale qualificato registrato presso l'autorità di regolamentazione del paese laddove sia richiesta una presenza sul territorio (KSeF, intermediario SDI, fornitore di servizi ZATCA, ecc.). In entrambi i casi, chiami lo stesso POST /v1/documents/send.

In sintesi

Scadenze

DataChiCosa
2022-01-01KSeF volontarioDisponibile per gli early adopter.
2026-02-01Grandi contribuenti (vendite > PLN 200M)KSeF obbligatorio.
2026-04-01Tutti gli altri contribuenti IVAKSeF obbligatorio.
2027-01-01Integrazione dei registratori di cassaI sistemi POS devono connettersi a KSeF per i documenti B2C.

Contesto

La Polonia gestisce il regime CTC più rigoroso dell'UE: clearance, non semplice reporting. Una fattura non esiste legalmente finché KSeF non la accetta e restituisce un numero KSeF. Il venditore può quindi consegnare la fattura all'acquirente (in qualsiasi formato), con il numero KSeF come prova di validità.

Il flusso nazionale polacco di Flowie: POST /v1/documents/send → Flowie converte il JSON in FA(2) → invia a KSeF → riceve il numero KSeF e l'URL di visualizzazione → li restituisce al chiamante, quindi consegna facoltativamente all'acquirente (PDF o Peppol).

Profilo del formato

Campi obbligatori

Settore pubblico (B2G)

HubSchema di identificazione PeppolRicerca
KSeF (copre pubblico + privato)PL-NIP-<nip>https://www.podatki.gov.pl/ksef

KSeF è l'hub polacco universale — anche i destinatari del settore pubblico lo utilizzano. Non esiste una piattaforma B2G separata.

Reporting / clearance B2B

KSeF — Clearance: la fattura viene validata e dotata di un numero KSeF prima della consegna legale.

Stato del ciclo di vitaRiportato come
issuedInviata; numero KSeF restituito.
rejectedErrore di schema o di regola di business; FA(2) originale restituito.
cancelledMessaggio di annullamento; numero KSeF originale referenziato.

Opt-out: settings.autoCompliance.PL = false (only for cross-border-only sellers)

Codici di errore

CodiceSignificatoSoluzione
KSEF-21100Errore di validazione dello schema su FA(2).Esamina error.details per individuare l'elemento problematico.
KSEF-21102NIP non registrato presso KSeF.Una delle parti non è ancora stata onboardata; verifica con l'acquirente.
KSEF-22001Token di autenticazione scaduto.Flowie effettua il refresh automatico; le integrazioni manuali devono riemettere il JWT.

Test in sandbox

Cosa vuoi testareCome
Percorso felice KSeFNIP del venditore 1111111111, NIP dell'acquirente 2222222222; la sandbox restituisce un numero KSeF sintetico.
Forzare il rifiuto di KSeFsimulateCompliance: "reject_KSEF_21100".

FAQ

Posso inviare un PDF all'acquirente se KSeF ha accettato il FA(2)?

Sì — una volta che KSeF restituisce un numero, la fattura esiste. Puoi anche consegnare un PDF leggibile (con il numero KSeF riportato) alla casella di posta dell'acquirente, oppure inviarlo via Peppol se preferisce.

I venditori esteri sono obbligati?

Solo se registrati ai fini IVA in Polonia. Un venditore estero dell'UE che fattura verso la Polonia applica le normali regole UE; KSeF non è richiesto.

Riferimenti

Fonti primarie (governo / autorità di regolamentazione / ente di normazione):

Analisi di settore (tracker di fornitori — utili per i confronti incrociati):