Record a POS linked to an RT
The fields of the AdE bulk CSV: RT matricola, acquirer (codice fiscale, name, IT or ES), POS type (00 physical with its TerminalId, 01 virtual), contract number, address of the unità locale or itinerant, and the first day of use. Live keys only (403 livemode_required). Free.
The fields of the AdE bulk CSV: RT matricola, acquirer (codice fiscale, name, IT or ES), POS type (00 physical with its TerminalId, 01 virtual), contract number, address of the unità locale or itinerant, and the first day of use. 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
label?|Your own name for the till, e.g. "Cassa 1"
rt_serial*stringMatricola of the RT or Server RT (CSV Matricola)
^[A-Za-z0-9]{1,30}$acquirer_country*stringTipoAcquirer: IT italiano, ES estero
"IT""IT""ES"acquirer_id*stringIdentificativoAcquirer: the acquirer’s Italian codice fiscale (11 digits, leading zeros kept)
^[A-Za-z0-9]{1,30}$acquirer_name*stringDenominazioneAcquirer
^(?![=+\-@])[^;"\r\n\t]*$1 <= length <= 200pos_type*stringTipoPos: 00 physical (incl. SoftPOS), 01 virtual
"00""01"terminal_id?|TerminalId of the POS terminal: required when pos_type is 00 (physical), ignored when it is 01 (virtual)
contract_number*stringConvenzione: number of the contract with the acquirer
^[A-Za-z0-9._/-]{1,50}$itinerant*booleanAmbulante: the RT is always used itinerant (no address)
falseprovince?|Two-letter province code (sigla) of the place where the RT is used (CSV UbicazioneProv). Required unless itinerant
municipality?|Municipality (comune) where the RT is used (CSV UbicazioneComune). Required unless itinerant
street?|Street of the unità locale where the RT is used (CSV UbicazioneIndirizzo). Required unless itinerant
street_number?|Street number (CSV UbicazioneCivico). Required unless itinerant
postal_code?|Five-digit CAP (CSV UbicazioneCap). Required unless itinerant
active_from*stringFirst day the POS was used with this RT (sets the deadline)
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$dateended_on?|Last day of use: the link is ended (CSV operation C, DataFine)
OK
application/json- response
id*stringobject*stringlabel*string|nullrt_serial*stringacquirer_country*string"IT""ES"acquirer_id*stringacquirer_name*stringpos_type*string"00""01"terminal_id*string|nullcontract_number*stringitinerant*booleanprovince*string|nullmunicipality*string|nullstreet*string|nullstreet_number*string|nullpostal_code*string|nullactive_from*string^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$dateended_on*|nullstatus*string"to_file""filed""end_to_file""ended"pending*|What is still to communicate to the AdE, and by when
linked_filed_at*|nullend_filed_at*|nullcreated_at*string^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$date-timeupdated_at*string^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$date-timecurl -X POST 'https://www.getbeel.com/api/v1/pos-rt-links' \ -H 'Content-Type: application/json' \ -d '{ "rt_serial": "99IEY928374", "acquirer_country": "IT", "acquirer_id": "04107060966", "acquirer_name": "NEXI PAYMENTS S.P.A.", "pos_type": "00", "contract_number": "string", "itinerant": false, "active_from": "2026-10-29"}'{ "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"}List POS–RT links GET
Each payment terminal linked to a registratore telematico, with its status (to_file, filed, end_to_file, ended) and, when something is still to communicate, the window of provv. AdE 424470/2025 (from the 6th to the last working day of the second month after the change).
A POS–RT link GET
Pagina successiva