KSeF FA(3) XML

Route principale: POST /wp-json/api/v2/create-ksef-xml — genera XML FA(3) localmente. Con integration.use = ksef nel payload, genera e invia in un solo passo tramite KSeF via POP.

Route di supporto (account connessi): POST /wp-json/api/v2/ksef/document-get (stato documento), POST /wp-json/api/v2/ksef/upo-get (ricevuta UPO).

Cosa serve

• fornitore con paese PL e NIP polacco valido
• customer_type deve essere company o freelance (non private)
• invio tramite KSeF via POP richiede ente legale registrato e onboarding completato; su Shopify serve inoltre il piano Basic o superiore (su WordPress, API diretta, n8n e MCP l’invio non richiede più un piano a pagamento, usa i crediti disponibili)

Output

• generazione locale: XML grezzo
• invio KSeF via POP (integration.use = ksef): JSON
• ksef/upo-get: XML grezzo; ksef/document-get: JSON
• errori: sempre JSON

Da sapere

• codici pagamento supportati: MP01, MP02, MP03, MP05, MP08
• varianti fiscali supportate: IVA standard, esente, reverse charge, intra-UE 0% (ZERO_WDT), export 0% (ZERO_EXPORT)
• per note di credito, imposta type = credit_note nel payload condiviso
• integration.use accetta anche l’alias ksef-via-pop
• ksef/document-get restituisce lo stato provider (in_queue, processing, valid, invalid, rejected, blocked, approved, draft) tradotto in un messaggio leggibile
• errori pubblici principali: insufficient_level (solo Shopify, piano sotto Basic), pop_api_ksef_legal_entity_missing (legal entity non registrata), pop_api_ksef_onboarding_required (onboarding incompleto), pop_api_ksef_generation_failed (XML FA(3) non generabile)
• connector_exclusive_channel_active (403) — l’invio KSeF è bloccato mentre Zoho è il canale di fatturazione attivo e connesso sull’account; la generazione locale dell’XML non è comunque interessata