Documentazione API
Che cos'è eunormia?
eunormia crea, legge e convalida fatture elettroniche nei formati ZUGFeRD/Factur-X (PDF/A-3 con XML CII incorporato, EN 16931) e XRechnung. Viene consegnato solo ciò che supera la convalida — ogni fattura generata passa veraPDF (PDF/A-3) e lo Schematron EN 16931. Dati e PDF vengono elaborati solo in memoria e mai salvati.
Autenticazione
Tutti gli endpoint funzionano in forma anonima (i risultati
portano una filigrana campione, limite giornaliero per IP). Con un account crei
un token Bearer in Token API
(Authorization: Bearer eun_live_…) per risultati produttivi senza
filigrana nel tuo contingente.
In hosting o offline
| API online | SDK offline (Eunormia.Sdk) | |
|---|---|---|
| Uso | chiamate HTTP a eunormia.com | libreria .NET nella tua applicazione |
| Infrastruttura | nessuna (la gestiamo noi) | nessuna (tutto nel pacchetto NuGet) |
| Flusso dati | la fattura passa dai nostri server (solo RAM) | non lascia mai la tua azienda |
| Funzionalità | identiche: creare, leggere, convalidare — stessi gate | |
Endpoint
POST /v1/convert— creare una fattura (JSON/XML CII + PDF → ZUGFeRD convalidato)POST /v1/read— leggere una fattura in arrivo come JSON strutturatoPOST /v1/validate— convalidare una fattura in arrivo (con controlli ufficiali opzionali)
Specifica machine-readable: openapi.json. Prova senza codice: convertitore e convalida nel browser.