Attivare KSeF via POP

Obiettivo

Collegare il tuo account POP al sistema KSeF (Polonia) per inviare fatture elettroniche FA(3).

Prerequisiti

• Su WordPress: nessun piano minimo, l’attivazione e l’invio sono disponibili su ogni piano (incluso Free), a consumo di crediti. Su Shopify serve invece il piano Basic o superiore.
• NIP (partita IVA polacca) impostato nei dati dell’account.
• Ambiente live: accesso a podpis.gov.pl con Profil Zaufany, oppure un certificato PKI KSeF (PKCS#12 o PEM).
• Ambiente sandbox: nessun prerequisito, la firma viene simulata automaticamente.

Live e sandbox sono registrazioni separate: attivare il sandbox non attiva automaticamente il live, e viceversa.

Passi (pannello account)

1. Registra la legal entity: indirizzo, città, CAP, email di notifica. NIP e ragione sociale vengono letti automaticamente dalle impostazioni account, non vanno reinseriti.
2. Autorizza l’accesso:
   • Sandbox: clicca “Avvia autorizzazione” (finestra di 10 minuti), poi “Attiva”.
   • Live con Profil Zaufany: scarica il file di firma, firmalo su podpis.gov.pl, carica l’XML firmato, poi “Attiva”.
   • Live con certificato PKI: carica nome certificato, passphrase e file del certificato.
3. Connessione attiva: da questo momento puoi inviare fatture KSeF tramite l’API POP.

Se accedi per la prima volta con un account polacco (PL), l’attivazione può avvenire anche dal wizard di configurazione guidata, con gli stessi due passi (registrazione + autorizzazione).

Costo in crediti

Ogni documento KSeF consuma 1 credito, solo per la consegna: la generazione locale dell’XML non consuma mai un credito.

Disconnessione

• Disconnetti: sospende l’invio mantenendo la registrazione (puoi riattivare in seguito).
• Elimina connessione: rimuove anche i dati locali della registrazione.

Errori comuni

• “KSeF Legal Entity is missing”: la legal entity non è stata registrata (Passo 1) prima di generare/inviare un documento, completa la registrazione nel pannello account.
• Onboarding KSeF non completato: mancano NIP o dati account, verifica le impostazioni prima di procedere con l’autorizzazione.
• Sandbox attivo ma nessun invio reale avviene: atteso, la sandbox non consegna realmente a KSeF, serve passare all’ambiente live per l’invio effettivo.

Configurazione correlata

Per i dettagli del contratto API (payload, mapping campi FA(3)), vedi api/ksef.