Fattura di vendita (Sales invoice)

Rappresenta una fattura di vendita (sales invoice): emissione verso cliente con numerazione interna, date fattura e scadenza, cliente, riferimenti opzionali a ordine di vendita e documento di consegna (salesOrderId, deliveryNoteId e numeri leggibili), valuta, condizioni di pagamento, righe fatturate, totali. Adatta ai flussi AR (accounts receivable), SDI / e-fattura in uscita (se mappati a valle) e chiusura ciclo ordine–consegna–fattura.

Esempio JSON completo

{
  "id": "si_2Uv5Wx8Yz1Ab4",
  "channel": "demoipaas",
  "createdAt": "2026-01-24T10:15:00+00:00",
  "updatedAt": "2026-01-24T10:15:00+00:00",
  "number": "SI-2026-00402",
  "status": "posted",
  "invoiceDate": "2026-01-24",
  "dueDate": "2026-02-23",
  "customerId": "cust_4Fx7Gy0Hz3Ja6",
  "salesOrderId": "so_8Km2Np5Qr8St1",
  "salesOrderNumber": "SO-2026-0118",
  "deliveryNoteId": "dn_7Jk1Lm4No7Pq0",
  "deliveryNoteNumber": "DN-2026-0093",
  "currency": "EUR",
  "paymentTerms": "Net 30",
  "lineItems": [
    {
      "position": 10,
      "itemId": "itm_WIDGET_A",
      "description": "Widget mod. A — conf. 24 pz",
      "quantity": 48,
      "unitPrice": 12.5,
      "taxRate": 22,
      "lineTotal": 600
    }
  ],
  "subtotal": 600,
  "taxTotal": 132,
  "grandTotal": 732,
  "notes": null
}

Note

• Il campione fattura solo parte dell’ordine (riga widget), coerente con un DDT parziale; fatture successive possono coprire altre righe o servizi.
• Alcuni ERP richiedono split per causale o registrazioni separate per anticipi: estendere il modello in mappatura se necessario.
• Legare sempre customerId e le righe agli articoli (itemId) usati nel piano dei conti / anagrafica articoli di destinazione.