GetbeelDocs

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:

EsitoCome ottenerloStatosdiWebhook
ScartataPartita IVA del cliente 00000000000 (con o senza IT davanti, spazi ignorati)rejectederror_codes: ["00305"], errors: [{ "code": "00305", "description": null }]invoice.rejected
Non consegnataCodice destinatario MC00000 (maiuscole o minuscole) e un'altra partita IVAnot_deliveredavailable_since: nullinvoice.not_delivered
ConsegnataQualsiasi altra fattura validadelivered—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.
  • 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 (gb_test_)Live (gb_live_)
EndpointGli stessiGli stessi
InvioSDI simulato da getbeelSDI reale, tramite un provider di trasmissione accreditato
Risposta200, sent202, sending
EsitoDeciso dai dati del clienteDeciso dallo SDI, da pochi minuti a 5 giorni
Valore fiscaleNessunoLa fattura è emessa (se consegnata o non consegnata)
CostoGratis, nessuna quotaSecondo 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 00404 non 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.

In questa pagina