Receive an invoice in the sandbox
Test keys only (403 test_mode_required with a live key). Receives a FatturaPA (your XML or base64 .p7m, or a sample addressed to your company when the body is empty) as if a supplier sent it through SDI: it is parsed like a real one, listed by GET /received-invoices with the test key (source sdi, status pending_review) and fires received_invoice.created to test webhook endpoints. Nothing reaches the app.
Test keys only (403 test_mode_required with a live key). Receives a FatturaPA (your XML or base64 .p7m, or a sample addressed to your company when the body is empty) as if a supplier sent it through SDI: it is parsed like a real one, listed by GET /received-invoices with the test key (source sdi, status pending_review) and fires received_invoice.created to test webhook endpoints. Nothing reaches the app.
apiKeyAuthorizationBearer <token>API key: gb_test_… or gb_live_…
Idempotency-Key?stringRecommended. Retrying with the same key and body within 24 hours replays the first response (header Idempotent-Replayed: true) instead of acting twice. The same key with a different body returns 422 idempotency_key_reused.
length <= 255Getbeel-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.
uuidapplication/json- body
xml?stringA FatturaPA XML (or base64 .p7m) to receive. Omit it to receive a sample invoice addressed to your company.
1 <= length <= 5242880OK
application/json- response
object*stringid*stringsource*stringHow the invoice reached getbeel: sdi (received through SDI on the company codice destinatario), email, forwarded, bank_transaction, manual, …
invoice_number*string|nullinvoice_type*stringinvoice_date*string^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$datedue_date*|nullstatus*stringpayment_status*stringcategory*stringcurrency*stringamount_subtotal*stringDecimal amount as a string
^-?\d+\.\d{2}$amount_tax*stringDecimal amount as a string
^-?\d+\.\d{2}$amount_total*stringDecimal amount as a string
^-?\d+\.\d{2}$vendor*reverse_charge*|The reverse-charge autofattura getbeel proposed for this invoice of a foreign supplier (null when none applies). The XML draft is on the Autofatture page; sending it to SdI is always a user action.
created_at*string^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$date-timeupdated_at*string^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$date-timecurl -X POST 'https://www.getbeel.com/api/v1/sandbox/inbound-invoices' \ -H 'Content-Type: application/json' \ -d '{}'{ "object": "received_invoice", "id": "string", "source": "email", "invoice_number": "string", "invoice_type": "invoice", "invoice_date": "2026-10-29", "due_date": "2026-10-29", "status": "verified", "payment_status": "string", "category": "string", "currency": "string", "amount_subtotal": "122.00", "amount_tax": "122.00", "amount_total": "122.00", "vendor": { "name": "string", "vat_number": "string", "email": "string", "country": "string", "city": "string", "address": "string" }, "reverse_charge": { "tipo_documento": "TD17", "status": "proposed", "reason": "non_eu_services", "deadline_basis": "receipt", "deadline": "2026-10-29" }, "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z"}Turn off receiving from SDI DELETE
Stops the SDI provider receiving the company's supplier invoices (sending to SDI is untouched; invoices already received stay) and returns the status. Change or remove the indirizzo telematico in the AdE area afterwards, or new invoices only reach the cassetto fiscale. Safe to call again. Receiving also turns off by itself when the SDI add-on or rate card ends. Live keys only (403 livemode_required).
Upload a supplier invoice or receipt POST
Uploads a document (PDF, JPEG, PNG or WEBP, up to 50 MB; the type is read from the file, not its name) by file_url (public https, no redirects) or file_base64 with file_name. The AI reads it as an upload in the app does: the invoice then appears in GET /received-invoices with status pending_review. Check progress with GET /received-invoices/uploads/{id}. Uses one invoice credit per file. Live keys only (403 livemode_required).