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

Le chiavi di test inviano a uno SDI simulato da getbeel. Ecco come ottenere ogni esito.

Con una chiave di test (`gb_test_…`), `POST /invoices/{id}/send` non contatta lo SDI né il canale di trasmissione: getbeel genera e valida l'XML come per un invio vero, gli assegna un identificativo SDI simulato di 12 cifre e un nome file, e qualche secondo dopo applica un esito con i relativi [webhook](/it/api/webhooks). La sandbox è gratuita e non consuma la quota SDI; vale solo il [limite di richieste](/it/api/rate-limits).

## Come ottenere ogni esito [#come-ottenere-ogni-esito]

L'esito dipende dai dati del cliente, controllati in quest'ordine:

| Esito          | Come ottenerlo                                                                   | Stato           | `sdi`                                                                          | Webhook                 |
| -------------- | -------------------------------------------------------------------------------- | --------------- | ------------------------------------------------------------------------------ | ----------------------- |
| Scartata       | Partita IVA del cliente `00000000000` (con o senza `IT` davanti, spazi ignorati) | `rejected`      | `error_codes: ["00305"]`, `errors: [{ "code": "00305", "description": null }]` | `invoice.rejected`      |
| Non consegnata | Codice destinatario `MC00000` (maiuscole o minuscole) e un'altra partita IVA     | `not_delivered` | `available_since: null`                                                        | `invoice.not_delivered` |
| Consegnata     | Qualsiasi altra fattura valida                                                   | `delivered`     | —                                                                              | `invoice.delivered`     |

- La risposta all'invio è `200` con `status: "sent"` e il webhook `invoice.sent`. L'esito arriva circa 3 secondi dopo; se per qualche motivo non arriva, un processo periodico lo applica entro qualche minuto. Rileggi la fattura con `GET /invoices/{id}`.
- **Lo scarto simulato usa il codice `00305`** (IdCodice del cessionario non valido), con il messaggio `00305 1.4.1.1.2 <IdCodice> non valido (sandbox: partita IVA 00000000000 is always rejected)`, e la fattura va a `rejected` come uno scarto reale. Il `00404` non è simulato: su una fattura già inviata significa che è **già emessa**, vedi [ciclo di vita SDI](/it/api/sdi-lifecycle#duplicato-di-una-fattura-emessa-00404-su-una-fattura-inviata).
- **La non consegna simulata non ha data**: `sdi.available_since` è `null`. Nella realtà una MC porta la data di messa a disposizione nel cassetto fiscale; il tuo codice deve gestire entrambi i casi.
- Una fattura che non passa la validazione locale non viene inviata: la richiesta risponde `422 invoice_invalid` e la fattura resta in bozza.
- Una fattura di test scartata si riapre come una live: `POST /invoices/{id}/reopen`, correggila con `PATCH /invoices/{id}` (per esempio una partita IVA vera al posto di `00000000000`) e inviala di nuovo.

## Test e live a confronto [#test-e-live-a-confronto]

|                | Test (`gb_test_`)           | Live (`gb_live_`)                                          |
| -------------- | --------------------------- | ---------------------------------------------------------- |
| Endpoint       | Gli stessi                  | Gli stessi                                                 |
| Invio          | SDI simulato da getbeel     | SDI reale, tramite un provider di trasmissione accreditato |
| Risposta       | `200`, `sent`               | `202`, `sending`                                           |
| Esito          | Deciso dai dati del cliente | Deciso dallo SDI, da pochi minuti a 5 giorni               |
| Valore fiscale | Nessuno                     | La fattura è emessa (se consegnata o non consegnata)       |
| Costo          | Gratis, nessuna quota       | Secondo il [listino](/it/api/pricing)                      |

## La sandbox del canale di trasmissione [#la-sandbox-del-canale-di-trasmissione]

È una cosa diversa: è l'ambiente di prova del provider di trasmissione (openapi.com) che getbeel usa al suo interno per collaudare il canale. **Una chiave di test di getbeel non lo raggiunge mai.** Lo descriviamo perché spiega quali esiti getbeel ha potuto provare contro un canale vero (prova del 9 novembre 2026):

- le fatture e le autofatture in uscita passano a SENT e poi a DONE/DELIVERED a distanza di qualche minuto, anche con codice destinatario `0000000`;
- non produce mai una MC: openapi.com documenta una simulazione solo per le fatture in arrivo (`POST /IT-invoices_supplier_simulate`, Invoice API 1.8.7);
- non controlla i duplicati: lo stesso file inviato due volte viene consegnato due volte, quindi il `00404` non arriva mai da lì.

Per questo MC e `00404` sono collaudati riproducendo nel webhook di getbeel ricevute registrate.

## Fatture ricevute di prova [#fatture-ricevute-di-prova]

`POST /sandbox/inbound-invoices` riceve una fattura come se arrivasse dallo SDI (il tuo XML o una fattura di esempio intestata alla tua azienda): compare in `GET /received-invoices` con la chiave di test (`source: "sdi"`) e invia `received_invoice.created` agli endpoint di test. Vedi [Ricezione da SDI](/it/api/sdi-receiving#sandbox).
