Introduzione
L'API REST e il server MCP di Getbeel per la fatturazione elettronica italiana.
Getbeel ti permette di creare, validare e inviare fatture elettroniche (FatturaPA) allo SDI, di leggere le fatture emesse e ricevute e di seguire ogni ricevuta SDI con i webhook. Le stesse operazioni sono disponibili come strumenti MCP per gli agenti AI.
Come è fatta
- REST e JSON. Campi in
snake_case, date ISO 8601, importi come stringhe decimali ("122.00") per evitare errori di arrotondamento. - I termini fiscali restano in italiano:
codice_destinatario,tipo_documento,natura,regime_fiscale. Tutto il resto è in inglese. - Chiavi di test e live. Le chiavi
gb_test_…usano la sandbox, che simula lo SDI; le chiavigb_live_…trasmettono davvero. Gli endpoint sono gli stessi. - Un'API, un server MCP. Il server MCP usa le stesse chiavi e gli stessi servizi dell'API.
URL di base
https://www.getbeel.com/api/v1In arrivo
L'API sarà servita anche su https://api.getbeel.com/v1. L'URL attuale
continuerà a funzionare.
Cosa puoi fare oggi
| Endpoint | Cosa fa |
|---|---|
GET /me | L'account, l'azienda e la chiave che fa la richiesta |
GET /invoices | Elenco delle fatture emesse |
GET /invoices/{id} | Una fattura emessa, con le righe |
POST /invoices | Crea una bozza di fattura |
POST /invoices/{id}/send | Invia la bozza allo SDI (o alla sandbox con una chiave di test) |
POST /invoices/validate | Controlla un XML FatturaPA senza inviarlo |
GET /received-invoices | Elenco delle fatture ricevute dai fornitori |
Tutti i dettagli, con il playground, sono nel riferimento API. I webhook sono descritti in Webhook.
In arrivo
Aziende multiple (companies), fatture ricevute via SDI sul codice
destinatario di Getbeel, PDF e XML delle fatture, contatti, riconciliazione
bancaria, SDK e CLI. Le pagine di questa documentazione si aggiornano quando
escono.