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. La sandbox è gratuita e non consuma la quota SDI; vale solo il limite di richieste.
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 è
200constatus: "sent"e il webhookinvoice.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 conGET /invoices/{id}. - Lo scarto simulato usa il codice
00305(IdCodice del cessionario non valido), con il messaggio00305 1.4.1.1.2 <IdCodice> non valido (sandbox: partita IVA 00000000000 is always rejected), e la fattura va arejectedcome uno scarto reale. Il00404non è simulato: su una fattura già inviata significa che è già emessa, vedi ciclo di vita SDI. - 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_invalide la fattura resta in bozza. - Una fattura di test scartata si riapre come una live:
POST /invoices/{id}/reopen, correggila conPATCH /invoices/{id}(per esempio una partita IVA vera al posto di00000000000) e inviala di nuovo.
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 |
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
00404non arriva mai da lì.
Per questo MC e 00404 sono collaudati riproducendo nel webhook di getbeel ricevute registrate.
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.