GetbeelDocs
API referenceReceived invoices

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).

DELETE
/sdi-receiving

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).

Authorization

apiKey
headerAuthorizationBearer <token>

API key: gb_test_… or gb_live_…

Header Parameters

Getbeel-Company?string

Act 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.

Formatuuid

Response Body

OK

application/json
  1. response
object*string
status*string

not_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)

Value in"not_enabled""awaiting_approval""pending""active""error"
provider*string
fiscal_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*|null
last_error*string|null
approval*|

Set while status is awaiting_approval (security: proof that the company owns the P.IVA)

last_received_at*|null
received_count*integer
Range-9007199254740991 <= value <= 9007199254740991
indirizzo_telematico*
conservazione*
readiness*
links*
Example Request
curl -X DELETE 'https://www.getbeel.com/api/v1/sdi-receiving'
Example Response
{  "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"  }}