Documentazione API

Lo schema fattura (InvoiceRequest)

Uno schema JSON per entrambe le direzioni: /v1/convert lo accetta in ingresso, /v1/read lo restituisce per le fatture in arrivo (round-trip). Copre i campi semantici EN 16931; i casi speciali passano dal passthrough XML CII.

Gruppo di campi	Esempi
Intestazione	number, typeCode (380/381/384), issueDate, dueDate, currency, buyerReference, notes
Riferimenti	orderReference, contractReference, projectId, correctedInvoice
Pagamento	paymentTerms, paymentMeansCode, cashDiscounts, prepaidAmount, taxCurrency
Parti	seller/buyer/payee/deliveryAddress con indirizzo, vatId, iban/bic, contact, endpointId
Righe	items[] con name, quantity, unit, unitPrice, vatPercent, vatCategory, gtin, sconti/maggiorazioni
Livello documento	allowances/charges, attachments, totals

Il blocco opzionale totals viene ricalcolato lato server — uno scostamento produce un 422 dettagliato, mai una correzione silenziosa. Elenco completo dei campi: openapi.json. Esempio minimo:

{
  "number": "RE-2026-0042",
  "issueDate": "2026-07-08",
  "dueDate": "2026-08-07",
  "currency": "EUR",
  "seller": { "name": "Muster GmbH", "street": "Musterstraße 1", "zip": "4020",
              "city": "Linz", "country": "AT", "vatId": "ATU12345678",
              "iban": "AT611904300234573201" },
  "buyer":  { "name": "Beispiel GmbH", "street": "Beispielweg 2", "zip": "80331",
              "city": "München", "country": "DE", "vatId": "DE123456789" },
  "items": [ { "name": "Softwareentwicklung", "quantity": 16, "unit": "HUR",
               "unitPrice": 120.0, "vatPercent": 20 } ]
}