GetbeelDocs

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 chiavi gb_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/v1

In arrivo

L'API sarà servita anche su https://api.getbeel.com/v1. L'URL attuale continuerà a funzionare.

Cosa puoi fare oggi

EndpointCosa fa
GET /meL'account, l'azienda e la chiave che fa la richiesta
GET /invoicesElenco delle fatture emesse
GET /invoices/{id}Una fattura emessa, con le righe
POST /invoicesCrea una bozza di fattura
POST /invoices/{id}/sendInvia la bozza allo SDI (o alla sandbox con una chiave di test)
POST /invoices/validateControlla un XML FatturaPA senza inviarlo
GET /received-invoicesElenco 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.

Prossimi passi

In questa pagina