GetbeelDocs
API referenceReceived invoices

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.

POST
/sdi-receiving

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.

Authorization

apiKey
headerAuthorizationBearer <token>

API key: gb_test_… or gb_live_…

Header Parameters

Idempotency-Key?string

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

Lengthlength <= 255
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 POST '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"  }}