API REST
Ogni operazione di fatturazione che CrateAPI svolge, raggruppata per ciò che vuoi fare — Generate, Validate, Convert & Render, Extract & Embed — non per il formato in cui si trova la fattura.
Due cose utili da sapere subito: la validazione è gratuita — senza carta di credito, senza account — e l'estrazione è deterministica — legge l'XML realmente incorporato in un PDF, non ne ricostruisce né ne indovina uno.
Provalo dal vivo
Scegli un’operazione, incolla o carica un esempio, e chiama l’API reale — proprio qui, senza registrazione.
Fattura JSON in ingresso, XML conforme — o un PDF Factur-X — in uscita. Ogni output è pre-validato prima ancora di arrivare a te.
Questo è il percorso sviluppatore — per un modulo guidato, usa il generatore senza codice nella home page.
Generate
Fattura JSON in ingresso, XML conforme — o un PDF Factur-X — in uscita. Ogni output è pre-validato prima ancora di arrivare a te.
POST /v1/generate/ublXML di fattura UBL 2.1 pre-validato — scegli Peppol BIS, XRechnung o RO_CIUS con ?profile=. Se non supera le regole ufficiali, ricevi un errore invece di una fattura scorretta.
POST /v1/generate/ciiLa stessa garanzia, in CII D16B — la sintassi all'interno di Factur-X e ZUGFeRD.
POST /v1/generate/facturxUn PDF Factur-X completo: il nostro layout visivo pulito, con l'XML CII conforme EN 16931 incorporato all'interno.
POST /v1/generate/fatturapaPOST /v1/generate/facturaePOST /v1/generate/ksefFatturaPA italiana, Facturae spagnola e FA_VAT/KSeF polacca — tre vocabolari XML nazionali proprietari, un solo modello di fattura JSON in ingresso.
Validate
Esattamente gli stessi set di regole dietro ogni chiamata di generazione, esposti come prodotto a sé stante. Ed è anche l'unica cosa gratuita in questa pagina.
Gratis, senza chiave, subito:
curl -X POST https://api.crateapi.com/v1/validate/ubl \ -H "Content-Type: application/xml" \ --data-binary @invoice.xml {"profile":"peppol","valid":true,"counts":{"fatal":0,"warning":0},"findings":[],"duration_ms":12}
POST /v1/validate/ublPOST /v1/validate/ciiValidazione completa XSD + Schematron rispetto a EN 16931, Peppol BIS, XRechnung, RO_CIUS e BR-FR. Riscontri strutturati con ID di regola — gratis, senza registrazione, senza chiave.
POST /v1/validate/ubl/reportLo stesso controllo, reso come report PDF stampabile: un banner VALID/INVALID e una tabella dei riscontri. A pagamento, a differenza dell'endpoint JSON qui sopra.
POST /v1/pdfa/validateVerifica qualsiasi PDF rispetto a PDF/A-3 con veraPDF, il validatore di riferimento sviluppato per la PDF Association — gratis, come la validazione fattura.
Convert & Render
Sposta una fattura tra sintassi diverse, oppure trasformala in qualcosa che una persona può davvero leggere.
POST /v1/convert/{source}-to-{target}Otto direzioni tra UBL, CII, XRechnung e Factur-X. Senza perdite o rifiutata: tutto ciò che non può essere convertito in modo pulito torna come 422 con il motivo esatto, mai una fattura degradata silenziosamente.
POST /v1/render/pdfPOST /v1/render/htmlXML di fattura in ingresso, una pagina PDF o HTML leggibile in uscita — i fogli di stile ufficiali di visualizzazione KoSIT, la stessa vista di cui i portali hanno bisogno quando un cliente riceve un XML che non può aprire.
Extract & Embed
Recupera i dati leggibili da una macchina da un PDF — o inseriscili.
POST /v1/extract/xmlLegge l'allegato XML realmente presente all'interno di un PDF Factur-X/ZUGFeRD e lo restituisce — deterministico, mai ricostruito o indovinato.
POST /v1/extract/attachmentsElenca ogni file incorporato in un PDF, non solo l'XML della fattura — documenti di supporto inclusi (BG-24).
POST /v1/generate/facturx/embedIl tuo PDF di fattura personalizzato più il JSON della fattura, combinati in un Factur-X/PDF/A-3 con l'XML conforme incorporato all'interno. Mantieni il tuo design, guadagni la conformità.
Pronto a chiamarla tu stesso?
Ogni operazione qui sopra è a una sola chiamata HTTP di distanza — prendi una chiave, o leggi prima il riferimento completo.