Non un mockup di marketing — questa è la vera forma della richiesta, la vera forma della risposta, e un vero record di prova firmata (generato a scopo illustrativo). I nomi dei campi qui sotto sono copiati direttamente dal codice in esecuzione, non parafrasati.
curl -X POST https://invoxapi.de/v1/validate \ -H "X-API-Key: in_la_tua_chiave_qui" \ -F "file=@fattura.xml" \ -F "format=XRECHNUNG_3_UBL"Risposta — una fattura con due difetti reali
{
"verdict": "invalid",
"errors": [
{
"rule_id": "BR-01",
"severity": "error",
"human_message": "L'identificativo di specifica (BT-24) è mancante.",
"bt_number": "BT-24",
"auto_fix_possible": true
},
{
"rule_id": "BR-04",
"severity": "error",
"human_message": "Il codice tipo fattura (BT-3) è mancante.",
"bt_number": "BT-3",
"auto_fix_possible": true
}
],
"warnings": []
}
Non solo "Invalid invoice" senza altro. Ogni anomalia indica il termine commerciale esatto (BT-x, dallo standard EN 16931 stesso), se è possibile una correzione automatica, e una spiegazione in linguaggio semplice — esattamente l'informazione di cui un revisore umano avrebbe bisogno per correggere la fattura.
{
"request_id": "8f2c1a9e-...-uuid",
"doc_hash": "0d19ba76...e9a10179",
"format": "XRECHNUNG_3_UBL",
"violation_count": 0,
"chain_entry_hash": "79cb4fc0...4336961f"
}
Due cose da notare:
| doc_hash | Un hash SHA-256 della fattura — mai il contenuto della fattura stesso. Nulla di ciò che invii viene memorizzato. |
| chain_entry_hash | Questo risultato viene aggiunto a una catena hash append-only, a prova di manomissione, e firmato (Ed25519) — verificabile offline, senza dover fidarsi dei server di INVOX, da chiunque possieda la chiave pubblica pubblicata. |
Ogni risultato reale che generi ottiene il proprio request_id e la propria voce di catena — questa è un'illustrazione dello schema, non un record consultabile. Per verificare una vera prova firmata, usa il verificatore pubblico con un request_id del tuo account.