Fatture, credito e contrassegni

Endpoint di sola lettura per riconciliare dal tuo gestionale ciò che vedi nel pannello: fatture, credito, rimesse dei contrassegni e distinte resi. Tutti gli elenchi sono paginati e accettano il periodo from / to (AAAA-MM-GG).

Fatture

Endpoint	Descrizione
`GET /invoices`	Fatture e proforma
`GET /invoices/{id}`	Dettaglio con le righe in `items[]`
`GET /invoices/{id}/pdf`	La fattura con il PDF in base64 nel campo `pdf`

Filtri dell’elenco:

Filtro	Valori
`from`, `to`	Periodo
`proforma`	`true` o `false`: filtra le proforma
`archived`	`true` o `false`: fatture archiviate (predefinito `false`)


{
  "id": 2041,
  "number": "2026/315",
  "proforma": false,
  "invoiceDate": "2026-09-30",
  "dueDate": "2026-10-30",
  "subtotal": 250.00,
  "total": 305.00,
  "paid": 0,
  "currency": "EUR",
  "items": [
    { "description": "Distinta N. 183 del 30.09.2026", "quantity": 1, "unitPrice": 16.84, "total": 16.84 }
  ]
}

Se la generazione del PDF non è momentaneamente disponibile la risposta è 503: riprova più tardi.

Credito

Endpoint	Descrizione
`GET /credit`	Saldo attuale
`GET /credit/movements`	Movimenti, dal più recente


{ "balance": 182.40, "currency": "EUR", "prepaid": true, "updatedAt": "2026-10-01T09:12:44+02:00" }

prepaid indica un account a credito prepagato.

I movimenti accettano from, to e type (credit per le ricariche, debit per gli addebiti). In ogni movimento amount è negativo per gli addebiti e balance è il saldo dopo il movimento.

Distinte contrassegni

Endpoint	Descrizione
`GET /cod-lists`	Distinte contrassegni (rimesse)
`GET /cod-lists/{id}`	Dettaglio con le spedizioni in `shipments[]`

Filtri: from, to e status (processing in lavorazione, paid pagata).

Ogni distinta riporta il numero di spedizioni, il totale dei contrassegni (total), il totale pagato (totalPaid) e la data di pagamento (paymentDate). Nel dettaglio, per ogni spedizione trovi l’importo del contrassegno (codAmount) e l’importo pagato (codPaid).

Sulla singola spedizione, lo stato del contrassegno è in cod.status:

Valore	Significato
0	In attesa
1	In lavorazione
2	Liquidato

Distinte resi

Endpoint	Descrizione
`GET /returns`	Distinte resi del periodo
`GET /returns/{id}`	Dettaglio con le spedizioni rese

Ogni distinta riporta il numero di spedizioni, il costo totale e, quando è stata fatturata, l’invoiceId della fattura.