Factur-X
Francia · obbligo dal 1° sett. 2026Factur-X è il formato ibrido francese di fattura elettronica: un normale PDF leggibile da una persona, con un file XML CII conforme incorporato come allegato PDF/A-3. Un solo file funziona sia per chi lo apre sia per un sistema che lo analizza.
Cos'è
Il PDF visibile e il factur-x.xml incorporato (CII, profilo EN 16931) descrivono la stessa fattura — questa è l'idea alla base del formato. È anche la sintassi XML usata dal tedesco ZUGFeRD 2.x, quindi un documento Factur-X ben formato è generalmente interoperabile su entrambi i mercati.
Dove è obbligatorio
L'obbligo di fatturazione elettronica B2B in Francia inizia il 1° settembre 2026: ogni fattura B2B francese deve passare attraverso una Plateforme Agréée registrata, il più delle volte come Factur-X. Vedi la nostra pagina pre-flight dedicata per l'intero set di regole BR-FR (61 codici) e indicazioni specifiche per le PA — questa pagina copre il formato del documento Factur-X in sé.
Cosa non facciamo. CrateAPI non è una Plateforme Agréée e non trasmette fatture attraverso una di esse. Generiamo e validiamo il documento; l'invio tramite una PA registrata resta un passaggio separato.
Provalo
curl -X POST "$BASE/v1/generate/facturx/embed" \ -H "X-API-Key: $KEY" \ -F "invoice=<invoice.json" -F "pdf=@branded.pdf" -o facturx.pdf
Endpoint rilevanti
| Endpoint | Note |
|---|---|
POST /v1/generate/facturx | Da un modello di fattura JSON — il nostro layout visivo proprio, CII EN 16931 incorporato. |
POST /v1/generate/facturx/embed | Il prodotto di punta: mantiene IL VOSTRO PDF con marchio, incorpora l'XML conforme. Multipart, PDF fino a 10 MB. |
POST /v1/pdfa/validate?flavour=3bgratuito | Controllo strutturale veraPDF del contenitore PDF/A-3 — regole e clausole superate/fallite. |
POST /v1/pdfa/consistency | Confronta l'XML incorporato con il testo visibile del PDF, rileva le discrepanze tra i due. |
Esempi e documentazione
Scarica un esempio Factur-X validato dalla nostra libreria di esempi, leggi la nostra guida pre-flight per la Francia, oppure il riferimento API completo.
Domande frequenti
Factur-X sostituisce il design attuale delle mie fatture?
Non necessariamente — POST /v1/generate/facturx/embed prende il tuo PDF con marchio esistente e vi incorpora l'XML conforme, mantenendo il tuo layout.
È la stessa cosa di ZUGFeRD?
Stesso nucleo CII e stessa idea di PDF ibrido, ma ecosistemi nazionali diversi — un file Factur-X è generalmente leggibile dagli strumenti ZUGFeRD 2.x. Vedi la nostra pagina XRechnung per l'opzione solo XML della Germania.
CrateAPI invia la mia fattura a una Plateforme Agréée?
No — l'invio tramite una PA resta un passaggio separato. Vedi /plateforme-agreee/ per la checklist pre-flight.