Factur-X
Francia · obligatorio desde el 1 sept. 2026Factur-X es el formato híbrido francés de factura electrónica: un PDF normal, legible por una persona, con un archivo XML CII conforme incrustado como anexo PDF/A-3. Un solo archivo sirve tanto para una persona que lo abre como para un sistema que lo analiza.
Qué es
El PDF visible y el factur-x.xml incrustado (CII, perfil EN 16931) describen la misma factura — esa es toda la idea del formato. También es la sintaxis XML que usa el alemán ZUGFeRD 2.x, por lo que un documento Factur-X bien formado es ampliamente interoperable en ambos mercados.
Dónde es obligatorio
El mandato de facturación electrónica B2B en Francia empieza el 1 de septiembre de 2026: toda factura B2B francesa debe pasar por una Plateforme Agréée registrada, casi siempre como Factur-X. Consulta nuestra página pre-flight dedicada para el conjunto completo de reglas BR-FR (61 códigos) y orientación específica de las PA — esta página cubre el formato de documento Factur-X en sí.
Qué no hacemos. CrateAPI no es una Plateforme Agréée y no transmite facturas a través de una. Generamos y validamos el documento; enviarlo a través de una PA registrada sigue siendo un paso aparte.
Pruébalo
curl -X POST "$BASE/v1/generate/facturx/embed" \ -H "X-API-Key: $KEY" \ -F "invoice=<invoice.json" -F "pdf=@branded.pdf" -o facturx.pdf
Endpoints relevantes
| Endpoint | Notas |
|---|---|
POST /v1/generate/facturx | A partir de un modelo de factura JSON — nuestra propia maquetación visual, CII EN 16931 incrustado. |
POST /v1/generate/facturx/embed | El buque insignia: conserva TU PDF de marca, incrusta el XML conforme. Multipart, PDF hasta 10 MB. |
POST /v1/pdfa/validate?flavour=3bgratis | Comprobación estructural veraPDF del contenedor PDF/A-3 — reglas y cláusulas aprobadas/fallidas. |
POST /v1/pdfa/consistency | Compara el XML incrustado con el texto visible del PDF, detecta discrepancias entre ambos. |
Ejemplos y documentación
Descarga un ejemplo de Factur-X validado desde nuestra biblioteca de ejemplos, lee nuestra guía pre-flight de Francia, o la referencia completa de la API.
Preguntas frecuentes
¿Factur-X sustituye el diseño actual de mis facturas?
No necesariamente — POST /v1/generate/facturx/embed toma tu PDF de marca existente e incrusta el XML conforme en él, conservando tu maquetación.
¿Es lo mismo que ZUGFeRD?
Mismo núcleo CII y misma idea de PDF híbrido, pero ecosistemas nacionales distintos — un archivo Factur-X suele ser legible por herramientas ZUGFeRD 2.x. Consulta nuestra página de XRechnung para la opción solo-XML de Alemania.
¿CrateAPI envía mi factura a una Plateforme Agréée?
No — el envío a través de una PA sigue siendo un paso aparte. Consulta /plateforme-agreee/ para la checklist pre-flight.