Autofatture
Leggi un'autofattura in reverse charge (TD17, TD18, TD19) e inviala allo SdI, esattamente come il pulsante Invia allo SdI.
Un'autofattura è il documento che invii allo SdI per un acquisto da un fornitore estero (reverse charge): TD17 per servizi dall'estero, TD18 per beni da un altro paese UE, TD19 per beni già in Italia. getbeel le propone e le genera dai tuoi addebiti bancari, dall'import Autofatture e dalle fatture estere che ricevi. L'id è quello della pagina Autofatture (la transazione bancaria a cui appartiene).
La lettura richiede invoices:read (entrambe le modalità di chiave). L'invio richiede invoices:write e una chiave live: è un atto fiscale reale.
Leggere un'autofattura
curl "https://www.getbeel.com/api/v1/autofatture/$AUTOFATTURA_ID" \
-H "Authorization: Bearer $GETBEEL_API_KEY"{
"id": "9ea93ca3-fb8b-4ac3-b991-bdec63081696",
"object": "autofattura",
"date": "2026-11-02",
"supplier": "Vercel Inc.",
"supplier_country": "US",
"supplier_invoice_number": "INV-1102",
"amount": "-20.00",
"currency": "USD",
"tipo_documento": "TD17",
"numero": "AF-2026-7",
"status": "generated",
"xml_ready": true,
"sdi": { "status": null, "id": null, "error": null, "updated_at": null }
}status è l'XML: generated vuol dire pronta da inviare. sdi.status è null finché non la invii, poi queued, sending, sent_to_sdi e la risposta dello SdI: consegnata, non_consegnata, scartata (con sdi.error).
Inviarla allo SdI
curl -X POST "https://www.getbeel.com/api/v1/autofatture/$AUTOFATTURA_ID/send" \
-H "Authorization: Bearer $GETBEEL_API_KEY"Fa gli stessi passaggi del pulsante Invia allo SdI della pagina Autofatture:
- l'XML deve essere generato (altrimenti
409 autofattura_xml_missingoautofattura_not_generated); - l'invio si paga dal credito prepagato al prezzo dell'invio SdI (vedi Prezzi). Se il credito non basta la risposta è
402 insufficient_balance(Errori) e non viene inviato nulla; - viene messa in coda: la risposta è l'autofattura con
sdi.status: "queued". Rileggila più tardi per la risposta dello SdI.
Si può ripetere senza rischi. Una seconda chiamata non invia e non addebita di nuovo: 409 autofattura_already_queued mentre è in viaggio, 409 autofattura_already_sent quando lo SdI l'ha presa. Un reinvio corretto dopo uno scarto non viene addebitato di nuovo. Altri rifiuti: 409 sdi_monthly_cap_reached (il limite mensile degli invii live), 409 sdi_not_available (un account ancora su un piano precedente senza il servizio SDI), 404 resource_missing, 403 livemode_required con una chiave di test.
I tool MCP get_autofattura e send_autofattura_to_sdi fanno lo stesso (vedi MCP).