Electronic Invoice API
Validați și creați facturi electronice printr-o interfață
Aceleași reguli ca validatorul din browser, pentru software-ul dumneavoastră: trimiteți o factură, primiți rezultatul în format JSON, creați facturi electronice pornind de la datele dumneavoastră. Planul Free nu costă nimic și include 50 de apeluri pe lună.
Ce acoperă API-ul: creează și validează XRechnung, ZUGFeRD și Factur-X (EN 16931). Validarea prin API și MCP acoperă și alte formate europene, vedeți formatele acceptate. Nu trimite facturi. Se adresează exclusiv întreprinderilor.
Ghiduri cu exemple: XRechnung, ZUGFeRD, validare, export DATEV, integrare cu Claude, ChatGPT, Copilot și propriii dumneavoastră agenți, documentația serverului MCP.
Ce poate face API-ul
| Funcție | Descriere |
|---|---|
| Validare | UBL, CII și PDF ZUGFeRD/Factur-X conform EN 16931 și XRechnung 3.0, plus alte formate europene (vedeți formatele acceptate): verdict, constatări cu ID-ul regulii, locul și o scurtă explicație. PDF-urile sunt verificate ca containere PDF/A-3, iar XML-ul încorporat ca orice altă factură. |
| Creare | XRechnung (UBL, CII), ZUGFeRD și Factur-X ca PDF/A-3 pornind de la o factură JSON. Fiecare fișier este validat prin aceeași cale de verificare înainte de a fi returnat; dacă există erori, primiți constatările în locul fișierului. |
| Vizualizare | XRechnung sau ZUGFeRD XML ca PDF sau HTML lizibil, astfel încât destinatarii să poată citi și arhiva facturile. |
| Conversie | Convertiți între UBL și CII, XRechnung în PDF ZUGFeRD. |
| Extragere | Datele facturii ca JSON, CSV și ca lot de înregistrare DATEV pentru facturile primite. |
| Lot | Validați mai multe fișiere într-un singur ZIP (până la 200 de fișiere, 5 MiB per fișier, 50 MiB în total). Rezultat per fișier, numerele de factură duplicate din cadrul lotului sunt detectate, iar raportul sumar este furnizat în format JSON, CSV sau PDF. Din planul Starter. Fiecare fișier verificat contează ca un apel, iar un lot rulează o dată la un moment dat per cont. |
| Plauzibilitate | Mai mult decât formatul: mențiunile obligatorii conform § 14 alin. (4) din Legea germană privind TVA (UStG), erorile de calcul, sconturile pentru plata anticipată (Skonto) și scadența, numerele de factură duplicate din cadrul unui lot, forma codului de TVA (fără interogare la Oficiul Federal Central pentru Taxe din Germania (BZSt) sau VIES). |
Formate acceptate
Se aplică validării prin API și serverul MCP. Validatorul din browser verifică în continuare doar XRechnung și ZUGFeRD, iar acolo fișierul nu părăsește niciodată dispozitivul dumneavoastră.
| Țară | Format | Ce este verificat |
|---|---|---|
| Germania | XRechnung 3.0 (UBL, CII) | Regulile EN 16931 și CIUS-ul XRechnung |
| UE | EN 16931 (UBL, CII) | Regulile EN 16931 |
| Germania, Franța | ZUGFeRD / Factur-X 1.09.2 (MINIMUM, BASIC WL, BASIC, EN 16931, EXTENDED) | Reguli per profil, plus o verificare PDF/A-3 a containerului |
| Europa | Peppol BIS Billing 3.0.21 (UBL Invoice and CreditNote) | Regulile formatului de fișier. Fără trimitere sau primire prin rețeaua Peppol. |
| Țările de Jos | NLCIUS (SI-UBL 2.0.3.13, NLCIUS-CII 1.0.3.13) | Reguli naționale |
| România | CIUS-RO 1.0.1 | Reguli naționale |
| Franța | Regulile CIUS franceze (FNFE France_RFE 1.4.0.04), cu country=FR, inclusiv EXTENDED-CTC-FR | Reguli naționale |
| Alte țări din UE | Alte CIUS EN 16931, de exemplu Croația, Portugalia | Doar regulile de bază EN 16931. Rezultatul este cel mult „avertismente”, cu o mențiune că regulile naționale nu au fost verificate. |
| Italia | FatturaPA (XSD 1.2.3) | Doar schema oficială. Verificările suplimentare sunt efectuate de autoritate (SdI). |
| Polonia | KSeF FA(3) | Doar schema oficială, fără limite superioare de repetare. Verificările suplimentare sunt efectuate de autoritate (KSeF). |
Generarea și conversia rămân limitate la XRechnung, ZUGFeRD și EN 16931. API-ul verifică formatul de fișier Peppol BIS; nu trimite facturi.
Testele noastre (31 octombrie 2026): 223 din 223 de cazuri de test (cazurile de test oficiale KoSIT și cazurile noastre de eroare) au fost conform așteptărilor; 35 din 35 de facturi generate (toate categoriile de taxe, cinci formate) trec verificarea încrucișată independentă cu validatorul KoSIT, Mustang și veraPDF. Acesta este un test pe eșantioane, nu o certificare.
Confidențialitate: cum este construit API-ul
- Doar în memorie: Facturile sunt procesate și nu sunt stocate. Containerul rulează cu un sistem de fișiere doar pentru citire, iar fișierele temporare rezidă în memorie.
- Fără conținut în jurnale: Fiecare cerere generează o linie de jurnal cu ID-ul cererii, ora, durata, dimensiunea și rezultatul. Niciun conținut de factură, nicio adresă IP în jurnalele aplicației.
- Servere de procesare în Germania: Procesarea efectivă rulează pe serverele Hetzner Online GmbH din Germania (centrul de date din Nürnberg). Când este utilizat serverul MCP, cererea este procesată mai întâi în memorie într-un Cloudflare Worker la mcp.electronic-invoice.app; Cloudflare poate folosi în acest scop centre de date din afara UE.
- Gateway-ul din amonte: Verificările cheilor și cotele sunt gestionate de un Cloudflare Worker. Acesta vede cererile în memorie deoarece le redirecționează și nu stochează niciun conținut. În consolă, cheia API este stocată doar ca hash; pentru conexiunile OAuth la serverul MCP este stocată suplimentar criptat cu AES-256-GCM. Datele conexiunii OAuth sunt păstrate în Durable Objects cu cerință de localizare în UE. Contoarele de apeluri sunt stocate. Cloudflare poate de asemenea să dirijeze cererile prin centre de date din afara UE; detaliile se află în acordul privind prelucrarea datelor.
- Prelucrarea datelor: Se aplică acordul privind prelucrarea datelor (DPA).
- Fără utilizare în scopuri proprii: Nu utilizăm datele facturilor în scopuri proprii, în special nu pentru publicitate, îmbunătățirea produselor, analiză sau antrenarea modelelor AI.
- Facturare: Abonamente lunare fixe prin Stripe. Stripe nu află nici conținutul facturilor, nici numărul apelurilor dumneavoastră.
Planuri
| Plan | Preț pe lună | Apeluri incluse | Apeluri pe minut | Concurrente | Peste limită |
|---|---|---|---|---|---|
| Free | 0 EUR | 50 | aproximativ 10 | 2 | Limită strictă: apelurile suplimentare sunt respinse |
| Starter | 19 EUR | 2.000 | aproximativ 60 | 4 | Apelurile suplimentare sunt respinse (429) până la sfârșitul perioadei de facturare sau până când vă actualizați planul |
| Business | 49 EUR | 10.000 | aproximativ 300 | 6 | Apelurile suplimentare sunt respinse (429) până la sfârșitul perioadei de facturare sau până când vă actualizați planul |
| Pro | 149 EUR | 50.000 | aproximativ 1.000 | 8 | Apelurile suplimentare sunt respinse (429) până la sfârșitul perioadei de facturare sau până când vă actualizați planul |
Prețuri lunare fixe, fără facturare în funcție de utilizare. Nu se percepe TVA conform § 19 din Legea germană privind TVA (UStG) (întreprindere mică). API-ul se adresează exclusiv întreprinderilor; se aplică condițiile. Accesați consola
Limite și volume mari
Ce contează: Răspunsurile cu 200, 400, 422 și 504 contează ca un apel; la loturi, contează fiecare fișier verificat. 401, 403, 404, 405, 411, 413, 429, 500, 502, 503 și /v1/health nu contează.
Limita pe minut: Valorile sunt aproximative și se aplică per locație Cloudflare. Peste această limită, API-ul răspunde cu 429 rate_limited. Concurrente înseamnă apelurile în curs de execuție și în așteptare ale unui cont. Peste această limită, răspunde imediat cu 429 too_many_concurrent.
Multe facturi: Multe fișiere XML se trimit în /v1/validate/batch (din planul Starter). Trimiteți doar câteva cereri simultan. Generarea PDF durează câteva secunde; la 503, reîncercați după Retry-After. 429 rate_limited, too_many_concurrent și batch_in_progress indică și acolo timpul de așteptare în secunde.
Dimensiune și format: O cerere poate avea până la 10 MiB (10.485.760 de octeți), un lot până la 50 MiB. Content-Type este tratat cu indulgență: doar multipart/form-data este citit separat, în rest API-ul detectează formatul din conținut.
Exemple de cod
Se încarcă exemplele ...
Referință
Se încarcă referința ...
Textele juridice sunt disponibile în germană și engleză: politica de confidențialitate, condițiile API și impresum. Numai versiunea germană este obligatorie din punct de vedere juridic.