API REST
Fiecare operație de facturare pe care o face CrateAPI, grupată după ce vrei să faci — Generate, Validate, Convert & Render, Extract & Embed — nu după formatul în care se întâmplă să fie factura.
Două lucruri merită știute din start: validarea e gratuită — fără card, fără cont — și extracția e deterministă — citește XML-ul chiar încorporat într-un PDF, nu reconstruiește și nu ghicește unul.
Încearcă live
Alege o operație, lipește sau încarcă un exemplu și apelează API-ul real — chiar aici, fără cont.
Factură JSON la intrare, XML conform — sau un PDF Factur-X — la ieșire. Fiecare rezultat e pre-validat înainte să ajungă la tine.
Aceasta e calea de dezvoltator — pentru un formular ghidat, folosește generatorul fără cod de pe pagina principală.
Generate
Factură JSON la intrare, XML conform — sau un PDF Factur-X — la ieșire. Fiecare rezultat e pre-validat înainte să ajungă la tine.
POST /v1/generate/ublXML de factură UBL 2.1 pre-validat — alegi Peppol BIS, XRechnung sau RO_CIUS cu ?profile=. Dacă nu trece regulile oficiale, primești o eroare în loc de o factură greșită.
POST /v1/generate/ciiAceeași garanție, în CII D16B — sintaxa din interiorul Factur-X și ZUGFeRD.
POST /v1/generate/facturxUn PDF Factur-X complet: layout-ul nostru vizual curat, cu XML-ul CII conform EN 16931 încorporat înăuntru.
POST /v1/generate/fatturapaPOST /v1/generate/facturaePOST /v1/generate/ksefFatturaPA din Italia, Facturae din Spania și FA_VAT/KSeF din Polonia — trei vocabulare XML naționale proprietare, un singur model de factură JSON la intrare.
Validate
Exact aceleași seturi de reguli din spatele fiecărui apel de generare, expuse ca produs de sine stătător. Și singurul lucru gratuit de pe această pagină.
Gratuit, fără cheie, chiar acum:
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/ciiValidare completă XSD + Schematron față de EN 16931, Peppol BIS, XRechnung, RO_CIUS și BR-FR. Constatări structurate cu ID-uri de regulă — gratuit, fără cont, fără cheie.
POST /v1/validate/ubl/reportAceeași verificare, randată ca raport PDF printabil: banner VALID/INVALID și tabel de constatări. Plătit, spre deosebire de endpoint-ul JSON de mai sus.
POST /v1/pdfa/validateVerifică orice PDF față de PDF/A-3 cu veraPDF, validatorul de referință construit pentru PDF Association — gratuit, la fel ca validarea facturii.
Convert & Render
Mută o factură între sintaxe sau transform-o în ceva ce un om poate chiar citi.
POST /v1/convert/{source}-to-{target}Opt direcții între UBL, CII, XRechnung și Factur-X. Fără pierderi sau respinsă: tot ce nu se poate converti curat se întoarce cu 422 și motivul exact, niciodată o factură degradată pe tăcute.
POST /v1/render/pdfPOST /v1/render/htmlXML de factură la intrare, o pagină PDF sau HTML citibilă la ieșire — foile de stil oficiale de vizualizare KoSIT, aceeași vedere de care au nevoie portalurile când un client primește un XML pe care nu-l poate deschide.
Extract & Embed
Scoate datele citibile de mașină dintr-un PDF — sau bagă-le înăuntru.
POST /v1/extract/xmlCitește XML-ul chiar atașat în interiorul unui PDF Factur-X/ZUGFeRD și îl întoarce — determinist, niciodată reconstruit sau ghicit.
POST /v1/extract/attachmentsListează fiecare fișier încorporat dintr-un PDF, nu doar XML-ul facturii — documentele suport incluse (BG-24).
POST /v1/generate/facturx/embedPDF-ul tău de factură cu branding propriu plus JSON-ul facturii, combinate într-un Factur-X/PDF/A-3 cu XML-ul conform încorporat înăuntru. Îți păstrezi design-ul, câștigi conformitatea.
Gata să-l apelezi singur?
Fiecare operație de mai sus e la un apel HTTP distanță — ia o cheie sau citește întâi referința completă.