Send an autofattura to SDI
Sends a generated autofattura to SDI, exactly like the Send to SDI button: the XML must be generated, and the send is paid from the prepaid balance at the SDI send price (402 insufficient_balance when it does not cover it). It is queued and returns the autofattura with sdi.status = queued; read it again for the SDI answer. Safe to repeat: a second call never sends or charges again (409 autofattura_already_queued or autofattura_already_sent). A corrected resend after an SDI rejection is not charged again. Live keys only.
Sends a generated autofattura to SDI, exactly like the Send to SDI button: the XML must be generated, and the send is paid from the prepaid balance at the SDI send price (402 insufficient_balance when it does not cover it). It is queued and returns the autofattura with sdi.status = queued; read it again for the SDI answer. Safe to repeat: a second call never sends or charges again (409 autofattura_already_queued or autofattura_already_sent). A corrected resend after an SDI rejection is not charged again. Live keys only.
apiKeyAuthorizationBearer <token>API key: gb_test_… or gb_live_…
id*stringGetbeel-Company?stringAct on one of the account's client companies (its id from GET /companies) instead of the key's own account. 404 company_not_found when the key cannot act on it.
uuidOK
application/json- response
id*stringobject*stringdate*stringDate of the purchase (bank debit or document)
supplier*string|nullsupplier_country*|IdPaese of the foreign supplier
supplier_invoice_number*string|nullamount*stringAmount of the purchase, as a decimal string
currency*stringtipo_documento*|TD17, TD18 or TD19 (reverse charge)
numero*|Number of the autofattura
status*stringnot_created, queued, processing, generated (XML ready), error, needs_country
xml_ready*booleansdi*curl -X POST 'https://www.getbeel.com/api/v1/autofatture/string/send'{ "id": "string", "object": "autofattura", "date": "string", "supplier": "string", "supplier_country": "string", "supplier_invoice_number": "string", "amount": "string", "currency": "string", "tipo_documento": "string", "numero": "string", "status": "string", "xml_ready": true, "sdi": { "status": "string", "id": "string", "error": "string", "updated_at": "string" }}An autofattura with its SDI status GET
The autofattura of a foreign purchase: TD type, number, whether the XML is ready, and the SDI status (null until sent, then queued, sent_to_sdi, consegnata, scartata…). Both key modes.
List a month or folder of the Drive GET
The folders and files of one month (month=2026-10: invoice files by invoice date, statements and uploads by upload date) or of one uploads folder (folder=contratti or 2026-10/contratti), newest first. Invoice files also need received_invoices:read and bank statements bank:read; without them they are left out. Both key modes.