Change or end a POS–RT link
Before the link is communicated anything can change. After, only label and ended_on: setting ended_on (last day of use) makes the end the next thing to communicate (operation C, DataFine). 409 link_already_filed otherwise. Live keys only (403 livemode_required). Free.
Before the link is communicated anything can change. After, only label and ended_on: setting ended_on (last day of use) makes the end the next thing to communicate (operation C, DataFine). 409 link_already_filed otherwise. Live keys only (403 livemode_required). Free.
apiKeyAuthorizationBearer <token>API key: gb_test_… or gb_live_…
id*stringGetbeel-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?string"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?booleanprovince?|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?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?|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 PATCH 'https://www.getbeel.com/api/v1/pos-rt-links/string' \ -H 'Content-Type: application/json' \ -d '{}'{ "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"}