GetbeelDocs
API referenceReceived invoices

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.

GET
/sdi-receiving

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.

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 GET '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"  }}