GetbeelDocs

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"
Risposta
{
  "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_missing o autofattura_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).

In questa pagina