# Introduzione (https://docs.getbeel.com/it/api)

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 [#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](/it/api/sandbox), che simula lo SDI; le chiavi `gb_live_…` trasmettono davvero. Gli endpoint sono gli stessi.
- **Un'API, un server MCP.** Il [server MCP](/it/api/mcp) usa le stesse chiavi e gli stessi servizi dell'API.

## URL di base [#url-di-base]

```text
https://www.getbeel.com/api/v1
```

<Callout title="In arrivo">
  L'API sarà servita anche su `https://api.getbeel.com/v1`. L'URL attuale
  continuerà a funzionare.
</Callout>

## Cosa puoi fare oggi [#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](/it/api/reference). I webhook sono descritti in [Webhook](/it/api/webhooks).

<Callout title="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.
</Callout>

## Prossimi passi [#prossimi-passi]

<Cards>
  <Card
    title="Quickstart"
    href="/it/api/quickstart"
    description="Prima chiamata e prima fattura in sandbox in pochi minuti."
  />
  <Card
    title="Autenticazione"
    href="/it/api/authentication"
    description="Chiavi di test e live, scope, sicurezza."
  />
  <Card
    title="Sandbox"
    href="/it/api/sandbox"
    description="Come ottenere ogni esito dello SDI."
  />
  <Card
    title="MCP"
    href="/it/api/mcp"
    description="Collega Claude, ChatGPT o Cursor."
  />
</Cards>
