GetbeelDocs

Mark links communicated

After the AdE processed the upload ("Storico richieste massive"): the pending operation of each link becomes filed (associations, then ends). Live keys only (403 livemode_required). Free.

POST
/pos-rt-links/mark-filed

After the AdE processed the upload ("Storico richieste massive"): the pending operation of each link becomes filed (associations, then ends). Live keys only (403 livemode_required). Free.

Autorizzazione

apiKey
headerAuthorizationBearer <token>

API key: gb_test_… or gb_live_…

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
application/json
  1. body
links*array<>

The rows of the uploaded file (links of the export): only a link whose pending operation is still the one given is marked

Items1 <= items <= 1000

Corpo della risposta

OK

application/json
  1. response
object*string
updated*integer
Range-9007199254740991 <= value <= 9007199254740991
data*array<>
Esempio di richiesta
curl -X POST 'https://www.getbeel.com/api/v1/pos-rt-links/mark-filed' \  -H 'Content-Type: application/json' \  -d '{  "links": [    {      "id": "prl_0123456789abcdef0123456789abcdef",      "operation": "I"    }  ]}'
Esempio di risposta
{  "object": "pos_rt_filed",  "updated": -9007199254740991,  "data": [    {      "id": "string",      "object": "pos_rt_link",      "label": "string",      "rt_serial": "string",      "acquirer_country": "IT",      "acquirer_id": "string",      "acquirer_name": "string",      "pos_type": "00",      "terminal_id": "string",      "contract_number": "string",      "itinerant": true,      "province": "string",      "municipality": "string",      "street": "string",      "street_number": "string",      "postal_code": "string",      "active_from": "2026-10-29",      "ended_on": "2026-10-29",      "status": "to_file",      "pending": {        "operation": "I",        "from": "2026-10-29",        "due": "2026-10-29",        "not_late_until": "2026-10-29",        "reference_month": "string",        "initial_window": true      },      "linked_filed_at": "2019-08-24T14:15:22Z",      "end_filed_at": "2019-08-24T14:15:22Z",      "created_at": "2019-08-24T14:15:22Z",      "updated_at": "2019-08-24T14:15:22Z"    }  ]}