Documentation de l'API

Le schéma de facture (InvoiceRequest)

Un schéma JSON pour les deux sens : /v1/convert l'accepte en entrée, /v1/read le renvoie pour les factures entrantes (aller-retour). Il couvre les champs sémantiques EN 16931 ; les cas spéciaux passent par le XML CII direct.

Groupe de champs	Exemples
En-tête	`number`, `typeCode` (380/381/384), `issueDate`, `dueDate`, `currency`, `buyerReference`, `notes`
Références	`orderReference`, `contractReference`, `projectId`, `correctedInvoice`
Paiement	`paymentTerms`, `paymentMeansCode`, `cashDiscounts`, `prepaidAmount`, `taxCurrency`
Parties	`seller`/`buyer`/`payee`/`deliveryAddress` avec adresse, `vatId`, `iban`/`bic`, `contact`, `endpointId`
Lignes	`items[]` avec `name`, `quantity`, `unit`, `unitPrice`, `vatPercent`, `vatCategory`, `gtin`, remises/majorations
Niveau document	`allowances`/`charges`, `attachments`, `totals`

Le bloc totals optionnel est recalculé côté serveur — un écart produit un 422 détaillé, jamais une correction silencieuse. Liste complète des champs : openapi.json. Exemple minimal :

{
  "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 } ]
}