Receiving from SDI: status and readiness
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.
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.
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 GET '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" }}Approve or reject a proposal POST
Approves (in force at once) or rejects a pending rule value or proroga. Through the API only a proposal with an official source can be approved, and a rules-watch proposal only when its quote was found word for word in the source (400 quote_not_verified: a PDF; approve it in the admin page after reading it). 404 proposal_not_found when it was already decided. Tax rules apply to every company: only getbeel administrators change them, with a live key that has the admin-only tax_rules:admin scope (created in the admin page; 403 insufficient_scope otherwise, 403 live_key_required with a test key, 403 super_admin_required when its creator is no longer an administrator). Recorded in the audit log.
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.