Fatturazione elettronica

Fatture elettroniche emesse e ricevute, in sola lettura.

4 endpoint Versione v1 · revisione 2026-07-20

Gli endpoint sono relativi a https://api.officina.it e richiedono l'header Authorization: Bearer con la chiave API e X-API-Version: 2026-07-20. L'header della revisione è obbligatorio: differenza fra v1 e revisione.

GET /v1/electronic-invoices
Permesso richiesto invoices.read

Elenca le fatture elettroniche emesse

Le fatture elettroniche trasmesse allo SdI, con il loro stato (sent, delivered, rejected). L'intero gruppo è in sola lettura: la trasmissione allo SdI non è esposta su questa API. Rientra nel permesso invoices, non ne ha uno proprio.
Risposte
200
Le fatture elettroniche emesse.
401
Chiave API mancante, non valida, revocata o scaduta.
402
Il piano non include l'accesso API, oppure non è attivo un abbonamento.
403
La chiave non ha il permesso richiesto per questa operazione.
422
Un campo della richiesta manca o non è valido: «param» indica quale.
500
Errore imprevisto del server. Il dettaglio finisce nei log, non nella risposta.
Richiesta
curl https://api.officina.it/v1/electronic-invoices \
  -H "Authorization: Bearer ofk_live_LA_TUA_CHIAVE" \
  -H "X-API-Version: 2026-07-20"
Risposta
{
  "object": "list",
  "data": [
    {
      "object": "electronic_invoice",
      "id": "6b2f9d54-8c17-4a03-be91-2d7c5a4f8e30",
      "status": "delivered",
      "document_type": "TD01",
      "invoice_id": "4412e7b9-0c35-4a18-92d7-5b6ea1f38c04",
      "credit_note_id": null,
      "receipt_number": null,
      "seq_number": 214,
      "customer_name": "Mario Rossi",
      "vehicle_name": "Fiat Panda",
      "total_after_discount": 285.36,
      "date": "2026-07-16",
      "sent_at": "2026-07-16T10:35:00Z",
      "delivered_at": "2026-07-16T11:02:00Z",
      "rejected_at": null,
      "created_at": "2026-07-16T10:35:00Z"
    }
  ],
  "has_more": false,
  "url": "/v1/electronic-invoices",
  "date_filter": {
    "object": "date_filter",
    "preset": "year",
    "from": "2026-01-01",
    "to": "2026-12-31"
  }
}
GET /v1/electronic-invoices-incoming
Permesso richiesto invoices.read

Elenca le fatture elettroniche ricevute

Le fatture elettroniche ricevute dai fornitori. expense_id è valorizzato quando la fattura è già stata registrata come spesa.
Risposte
200
Le fatture elettroniche ricevute.
401
Chiave API mancante, non valida, revocata o scaduta.
402
Il piano non include l'accesso API, oppure non è attivo un abbonamento.
403
La chiave non ha il permesso richiesto per questa operazione.
422
Un campo della richiesta manca o non è valido: «param» indica quale.
500
Errore imprevisto del server. Il dettaglio finisce nei log, non nella risposta.
Richiesta
curl https://api.officina.it/v1/electronic-invoices-incoming \
  -H "Authorization: Bearer ofk_live_LA_TUA_CHIAVE" \
  -H "X-API-Version: 2026-07-20"
Risposta
{
  "object": "list",
  "data": [
    {
      "object": "electronic_invoice_incoming",
      "id": "4c7e1b90-6d23-4a85-9f31-7b2c8e5d4a06",
      "supplier_id": "6f2b8c14-9d70-4a35-b8e2-1c5f7a3d9e60",
      "business_name": "Ricambi Lombardia S.r.l.",
      "invoice_number": "2026/1184",
      "invoice_date": "2026-07-28",
      "total_amount": 512.4,
      "status": "delivered",
      "document_type": "TD01",
      "expense_id": "ba38f519-4c72-4e06-9d81-5a2c7f4b3e90",
      "created_at": "2026-07-29T06:00:00Z"
    }
  ],
  "has_more": false,
  "url": "/v1/electronic-invoices-incoming",
  "date_filter": {
    "object": "date_filter",
    "preset": "year",
    "from": "2026-01-01",
    "to": "2026-12-31"
  }
}
GET /v1/electronic-invoices-incoming/status-counts
Permesso richiesto invoices.read

Conta le fatture ricevute per stato

Il numero di fatture ricevute in ciascuno stato, con gli stessi filtri dell'elenco.
Risposte
200
Il numero di fatture ricevute per stato.
401
Chiave API mancante, non valida, revocata o scaduta.
402
Il piano non include l'accesso API, oppure non è attivo un abbonamento.
403
La chiave non ha il permesso richiesto per questa operazione.
500
Errore imprevisto del server. Il dettaglio finisce nei log, non nella risposta.
Richiesta
curl https://api.officina.it/v1/electronic-invoices-incoming/status-counts \
  -H "Authorization: Bearer ofk_live_LA_TUA_CHIAVE" \
  -H "X-API-Version: 2026-07-20"
Risposta
{
  "object": "electronic_invoice_incoming_status_counts",
  "received": 214,
  "quarantena": 0,
  "date_filter": {
    "object": "date_filter",
    "preset": "year",
    "from": "2026-01-01",
    "to": "2026-12-31"
  }
}
GET /v1/electronic-invoices/status-counts
Permesso richiesto invoices.read

Conta le fatture elettroniche per stato

Il numero di fatture elettroniche in ciascuno stato, con gli stessi filtri dell'elenco.
Risposte
200
Il numero di fatture elettroniche per stato.
401
Chiave API mancante, non valida, revocata o scaduta.
402
Il piano non include l'accesso API, oppure non è attivo un abbonamento.
403
La chiave non ha il permesso richiesto per questa operazione.
500
Errore imprevisto del server. Il dettaglio finisce nei log, non nella risposta.
Richiesta
curl https://api.officina.it/v1/electronic-invoices/status-counts \
  -H "Authorization: Bearer ofk_live_LA_TUA_CHIAVE" \
  -H "X-API-Version: 2026-07-20"
Risposta
{
  "object": "electronic_invoice_status_counts",
  "sent": 3,
  "delivered": 128,
  "rejected": 1,
  "date_filter": {
    "object": "date_filter",
    "preset": "year",
    "from": "2026-01-01",
    "to": "2026-12-31"
  }
}