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.
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.
apiKeyAuthorizationBearer <token>API key: gb_test_… or gb_live_…
Idempotency-Key?stringRecommended. 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.
length <= 255Getbeel-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.
uuidapplication/json- 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
1 <= items <= 1000OK
application/json- response
object*stringupdated*integer-9007199254740991 <= value <= 9007199254740991data*array<>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" } ]}'{ "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" } ]}The bulk CSV for the AdE portal GET
Everything still to communicate (I to associate, C to end) in the 15 columns of the AdE "Manuale operativo" (April 2026), at most 1,000 rows per file (part). The separator, encoding and header names are not in any official document: the template downloadable in the portal is the reference, and tsv has the same rows to paste into it. next_steps has the path in Fatture e Corrispettivi. getbeel never uploads it for you. format=csv returns the file.
An autofattura with its SDI status GET
The autofattura of a foreign purchase: TD type, number, whether the XML is ready, and the SDI status (null until sent, then queued, sent_to_sdi, consegnata, scartata…). Both key modes.