Turn off receiving from SDI
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).
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).
apiKeyAuthorizationBearer <token>API key: gb_test_… or gb_live_…
Getbeel-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
object*stringstatus*stringnot_enabled; awaiting_approval (the P.IVA could not be verified in VIES: a getbeel operator checks it, then receiving turns on by itself; see approval); pending (asked the SDI provider); active (supplier invoices arrive in GET /received-invoices with source sdi); error (last_error says why)
"not_enabled""awaiting_approval""pending""active""error"provider*stringfiscal_id*|P.IVA (or codice fiscale) invoices are received for
codice_destinatario*|Give it to suppliers and register it as indirizzo telematico in the AdE area (Fatture e Corrispettivi). Null until receiving is enabled.
enabled_at*|nulllast_error*string|nullapproval*|Set while status is awaiting_approval (security: proof that the company owns the P.IVA)
last_received_at*|nullreceived_count*integer-9007199254740991 <= value <= 9007199254740991indirizzo_telematico*conservazione*readiness*links*curl -X DELETE 'https://www.getbeel.com/api/v1/sdi-receiving'{ "object": "sdi_receiving", "status": "not_enabled", "provider": "openapi", "fiscal_id": "string", "codice_destinatario": "PIC7CPS", "enabled_at": "2019-08-24T14:15:22Z", "last_error": "string", "approval": { "reason": "name_mismatch", "requested_at": "2019-08-24T14:15:22Z" }, "last_received_at": "2019-08-24T14:15:22Z", "received_count": -9007199254740991, "indirizzo_telematico": { "confirmed": true, "confirmed_at": "2019-08-24T14:15:22Z" }, "conservazione": { "status": "not_activated", "activated_on": "2026-10-29", "expires_on": "2026-10-29" }, "readiness": { "ready": true, "steps": [ { "id": "company_data", "done": true, "required": true, "missing": [ "name" ] } ] }, "links": { "ade_portal": "string", "ade_info": "string" }}Turn on receiving from SDI POST
Configures the company on the SDI provider so its supplier invoices reach getbeel, and returns the status with the codice destinatario. Then register the code as indirizzo telematico in the AdE area (Fatture e Corrispettivi) and confirm it in the app. Safe to call again. Live keys only (403 livemode_required); test keys use POST /sandbox/inbound-invoices.
Receive an invoice in the sandbox POST
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.