Appearance
Guida: fatturazione clienti
Obiettivo — Gestire le fatture ai clienti e i relativi incassi tramite API, per costruire un sistema di fatturazione completo. Gli stessi dati alimentano automaticamente il cruscotto agente.
Come funziona (a parole)
- Crea una bozza di fattura per un cliente, con le sue righe (energia, trasporto, oneri, canone…). Totali e IVA sono calcolati in automatico.
- Emetti la fattura: riceve un numero ufficiale (
AAAA/NNNNNN, progressivo annuale) e una scadenza; da quel momento non è più modificabile. - Registra gli incassi: quando i pagamenti coprono il totale, la fattura risulta pagata.
- Consulti in ogni momento elenco fatture, pagamenti e scadenzario (incluse le scadute).
Stati: bozza → emessa → pagata (oppure scaduta). Le correzioni si fanno in bozza; una fattura emessa si storna con nota di credito (in arrivo).
Tracciabilità
Ogni fattura e pagamento registra chi li ha creati/aggiornati (creato_da/aggiornato_da), oltre al log di audit generale — utile per controlli e contestazioni.
Riferimento tecnico — API Reference → tag Fatturazione.
Componenti regolate ARERA, fattura elettronica SdI/FatturaPA, conservazione, solleciti/morosità e SEPA sono previsti in una fase successiva.