Factur-X
Franța · obligatoriu din 1 sept. 2026Factur-X e formatul hibrid francez de e-factură: un PDF obișnuit, lizibil de om, cu un fișier XML CII conform integrat ca atașament PDF/A-3. Un singur fișier funcționează atât pentru o persoană care îl deschide, cât și pentru un sistem care îl parsează.
Ce este
PDF-ul vizibil și factur-x.xml integrat (CII, profil EN 16931) descriu aceeași factură — asta e toată ideea formatului. E și sintaxa XML folosită de ZUGFeRD 2.x german, deci un document Factur-X bine format e interoperabil pe scară largă pe ambele piețe.
Unde e obligatoriu
Obligația de e-facturare B2B a Franței începe la 1 septembrie 2026: fiecare factură B2B franceză trebuie să treacă printr-o Plateforme Agréée înregistrată, cel mai adesea ca Factur-X. Vezi pagina noastră dedicată pre-flight pentru setul complet de reguli BR-FR (61 de coduri) și indicații specifice PA — această pagină acoperă formatul de document Factur-X în sine.
Ce nu facem. CrateAPI nu este o Plateforme Agréée și nu transmite facturi prin una. Producem și validăm documentul; depunerea lui printr-o PA înregistrată rămâne un pas separat.
Încearcă
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-uri relevante
| Endpoint | Note |
|---|---|
POST /v1/generate/facturx | Dintr-un model de factură JSON — layout-ul nostru vizual propriu, CII EN 16931 integrat. |
POST /v1/generate/facturx/embed | Produsul emblematic: păstrează PDF-ul TĂU cu brand, integrează XML-ul conform. Multipart, PDF până la 10 MB. |
POST /v1/pdfa/validate?flavour=3bgratuit | Verificare structurală veraPDF a containerului PDF/A-3 — reguli și clauze trecute/eșuate. |
POST /v1/pdfa/consistency | Compară XML-ul integrat cu textul vizibil al PDF-ului, prinde diferențele dintre cele două. |
Exemple și documentație
Descarcă un exemplu Factur-X validat din biblioteca noastră de exemple, citește ghidul nostru pre-flight pentru Franța, sau referința API completă.
Întrebări frecvente
Factur-X îmi înlocuiește designul actual de factură?
Nu neapărat — POST /v1/generate/facturx/embed preia PDF-ul tău existent, cu brand, și integrează XML-ul conform în el, păstrând layout-ul tău.
E același lucru cu ZUGFeRD?
Același nucleu CII și aceeași idee de PDF hibrid, dar ecosisteme naționale diferite — un fișier Factur-X e în general lizibil de tool-urile ZUGFeRD 2.x. Vezi pagina noastră XRechnung pentru opțiunea doar-XML a Germaniei.
CrateAPI trimite factura mea către o Plateforme Agréée?
Nu — transmiterea printr-o PA rămâne un pas separat. Vezi /plateforme-agreee/ pentru lista de verificare pre-flight.