Turn on receiving from SDI
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.
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.
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.
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 POST '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" }}Receiving from SDI: status and readiness GET
Whether the company receives its supplier invoices through getbeel's SDI channel (openapi.com), the codice destinatario to give suppliers and register as indirizzo telematico in the AdE area, a readiness checklist (company data, SDI add-on, receiving on, indirizzo telematico confirmed, conservazione) and the AdE conservazione status. Received invoices appear in GET /received-invoices with source sdi. Both key modes.
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).