ZUGFeRD / Factur-X

both2026-07-01

POST /wp-json/api/v2/create-zugferd genera un bundle ZUGFeRD/Factur-X dal payload condiviso POP.

Output

Sempre JSON, con tre allegati in base64:

attachments.pdf — PDF visuale
attachments.xml — XML EN16931 CII
attachments.hybrid_pdf — PDF ibrido con XML incorporato

Da sapere

non esiste consegna in uscita (webhook/integrazioni) su questa route
supporta generazione solo-payload via RapidAPI (X-RapidAPI-Key senza X-API-Key POP); in questa modalità il payload deve contenere tutti i campi richiesti esplicitamente
in sandbox, invoice_number viene prefissato con SANDBOX-
varianti fiscali supportate: IVA standard, reverse charge, intra-UE 0%, export 0%, esente, fuori campo generale; non supportate: OSS, regime del margine, split payment

Verifica lato consumer

Usa validation.hybrid_pdf.has_embedded_xml e validation.hybrid_pdf.embedded_xml_matches nella risposta come check immediato che l’XML sia incorporato correttamente nel PDF ibrido.