Per chi programma

API di CEO Trust

I tuoi sistemi leggono da CEO Trust i dati della tua azienda: fatture elettroniche, movimenti bancari, ordini dei negozi online e saldi. Un gestionale, un foglio di calcolo collegato o il tuo programmatore li ricevono in formato JSON, sempre aggiornati.

In breve

Solo lettura. Con le API nessuno può modificare o cancellare i dati.
Una chiave per ogni sistema. Il titolare o l'amministrazione la crea nell'app, nella pagina Collaboratori, e la revoca con un clic. Fino a 5 chiavi attive.
Ogni chiave vede solo la sua azienda. Nel nostro database resta solo l'impronta cifrata della chiave, non la chiave.
Incluse nei piani Pro e Business. Massimo 120 richieste al minuto per chiave.

Come si usa

Indirizzo di base:

https://xmbgjjucxlmcgkxcjxwi.supabase.co/functions/v1/api

La chiave va nell'intestazione Authorization:

curl https://xmbgjjucxlmcgkxcjxwi.supabase.co/functions/v1/api/v1/invoices?direction=emesse&from=2026-10-01 \
  -H "Authorization: Bearer ct_live_la-tua-chiave"

Percorsi

Percorso	Cosa restituisce	Filtri
GET /v1/company	Nome, partita IVA, settore e piano dell'azienda	—
GET /v1/invoices	Fatture emesse e ricevute: numero, date, controparte, imponibile, IVA, totale, pagata	`direction` (emesse, ricevute), `from`, `to`, `limit`, `offset`
GET /v1/bank-transactions	Movimenti dei conti collegati: data, importo, descrizione, controparte	`from`, `to`, `limit`, `offset`
GET /v1/shop-orders	Ordini dei negozi online: data, totale, rimborsi, stato	`from`, `to`, `limit`, `offset`
GET /v1/cash	Saldo di ogni conto collegato e cassa indicata dall'azienda	—

Le date sono nel formato AAAA-MM-GG. limit va da 1 a 500 (predefinito 100). Gli importi sono in euro con due decimali.

Esempio di risposta

{
  "data": [
    {
      "id": 48211,
      "direction": "emessa",
      "document_type": "TD01",
      "number": "214",
      "issue_date": "2026-10-03",
      "due_date": "2026-11-02",
      "counterpart": { "name": "Cliente di esempio srl", "vat_number": "IT00000000000" },
      "taxable": 2000.00,
      "vat": 440.00,
      "total": 2440.00,
      "currency": "EUR",
      "paid": true
    }
  ],
  "count": 1,
  "offset": 0,
  "has_more": false,
  "next": null
}

Se ci sono altri risultati, has_more è true e next contiene l'indirizzo della pagina successiva.

Errori

Codice	Quando succede
401	Chiave mancante, sbagliata o revocata
403	Il piano dell'azienda non è Pro o Business attivo
400	Un filtro non è valido, per esempio una data scritta male
404	Il percorso non esiste
405	Richiesta diversa da GET: le API sono in sola lettura
429	Oltre 120 richieste al minuto: riprova dopo 60 secondi

Ogni errore ha la forma {"error": {"code": "…", "message": "…"}}, con il messaggio in italiano.

Sicurezza

Tratta la chiave come una password: non metterla in pagine web pubbliche o in app che altri possono scaricare. Se pensi che qualcuno l'abbia vista, revocala nell'app e creane una nuova: quella vecchia smette di funzionare subito. Per installare CEO Trust dentro la tua azienda leggi la pagina Middleware per aziende.

Domande tecniche: info@ceotrust.it.