API Cloud: administrare

Case

Casele clienților tăi.

Rute

GET …/registerslist-registers
GET …/registers/{registerId}get-register
POST …/registersactivate-register
POST …/registers/{registerId}/serialbind-register-serial
PATCH …/registers/{registerId}move-register
DELETE …/registers/{registerId}remove-register

Resursa GetIntegratorRegisterResponse

iduuiddoar citire: Id-ul înregistrării casei.
clientIduuiddoar citire: Id-ul clientului.
clientNamestringdoar citire: Numele clientului.
serialNumberstringpoate fi nulldoar citire: Seria fiscală. null cât timp casa așteaptă seria.
brandstringpoate fi nulldoar citire: Marca, din cea mai recentă citire a cotelor TVA. null în răspunsurile la modificări.; Tremol Tremol.
Datecs Datecs.
Daisy Daisy.
statusstringdoar citire: Starea casei.; AwaitingSerial Așteaptă seria: casa a refuzat sau nu s-a legat încă.
Active Activă.
Suspended Suspendată: plata a expirat.
Removed Eliminată, definitiv.
isOnlinebooleandoar citire: true când casa e activă, conectată și nu așteaptă acordul clientului.
activatedAtUtcdatetimepoate fi nulldoar citire: Când a fost activată, în UTC.
serialBoundAtUtcdatetimepoate fi nulldoar citire: Când a fost legată seria, în UTC.
awaitingClientConsentbooleandoar citire: true când casa trebuie să accepte legarea.
clientDeclinedAtUtcdatetimepoate fi nulldoar citire: Când a refuzat clientul legarea, în UTC.
clientDeclinedSerialNumberstringpoate fi nulldoar citire: Seria refuzată de client.

Obiecte folosite aici

GetIntegratorRegisterResponse

{
  "id": "7d2e9b4f-1a3c-4d5e-8f60-b1c2d3e4f5a6",
  "clientId": "0f8a1c2e-6b3d-4e7f-9a10-2c4d6e8f0a12",
  "clientName": "Exemplu SRL",
  "serialNumber": "DT000001",
  "brand": "Tremol",
  "status": "AwaitingSerial",
  "isOnline": true,
  "activatedAtUtc": "2026-08-27T09:14:22.512Z",
  "serialBoundAtUtc": "2026-08-27T09:14:22.512Z",
  "awaitingClientConsent": false,
  "clientDeclinedAtUtc": "string",
  "clientDeclinedSerialNumber": "string"
}

Rute

GET …/registers

`list-registers`

Toate înregistrările, inclusiv Removed, paginat, cele mai noi primele. Filtre: search, clientId, activated.

GETCerere

curl -X GET 'https://cloud-api.fiscallink.ro/api/v2/tenants/YOUR_TENANT_ID/integrator/registers' \
  -H 'X-Api-Key: fsk_YOUR_API_KEY'

200Răspuns

{
  "page": 1,
  "pageSize": 20,
  "total": 1,
  "items": []
}

GET …/registers/{registerId}

`get-register`

O casă, cu starea și conexiunea ei.

Câmp	Descriere
`brand`	Marca, din ultima citire reușită a cotelor TVA; `null` fără serie sau fără o asemenea citire.
`isOnline`	`true` doar când starea e `Active`, clientul a acceptat și casa a fost văzută ultima dată online.
`awaitingClientConsent`	`true` după ce ai activat sau legat tu o serie, până acceptă casa.
`clientDeclinedAtUtc` / `clientDeclinedSerialNumber`	Când a refuzat casa și ce serie a refuzat (refuzul golește `serialNumber`).

Răspuns GetIntegratorRegisterResponse

GETCerere

curl -X GET 'https://cloud-api.fiscallink.ro/api/v2/tenants/YOUR_TENANT_ID/integrator/registers/7d2e9b4f-1a3c-4d5e-8f60-b1c2d3e4f5a6' \
  -H 'X-Api-Key: fsk_YOUR_API_KEY'

200Răspuns — get-register, 200

{
  "id": "7d2e9b4f-1a3c-4d5e-8f60-b1c2d3e4f5a6",
  "clientId": "0f8a1c2e-6b3d-4e7f-9a10-2c4d6e8f0a12",
  "clientName": "Exemplu SRL",
  "serialNumber": "DT000001",
  "brand": "Datecs",
  "status": "Active",
  "isOnline": true,
  "awaitingClientConsent": false,
  "activatedAtUtc": "2026-08-27T09:14:22.512Z",
  "serialBoundAtUtc": "2026-08-27T09:14:22.512Z",
  "clientDeclinedAtUtc": null,
  "clientDeclinedSerialNumber": null
}

POST …/registers

`activate-register`

Activează o casă pentru un client, după serie. Înregistrarea e Active cu awaitingClientConsent true; răspunde 201 cu Location. Activarea e gratuită și cere un abonament de integrator activ.

Răspuns GetIntegratorRegisterResponse
Cerere AutomationAddIntegratorRegisterRequest

POSTCerere

curl -X POST 'https://cloud-api.fiscallink.ro/api/v2/tenants/YOUR_TENANT_ID/integrator/registers' \
  -H 'X-Api-Key: fsk_YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "clientId": "0f8a1c2e-6b3d-4e7f-9a10-2c4d6e8f0a12",
  "serialNumber": "DT000001"
}'

201Răspuns

{
  "id": "7d2e9b4f-1a3c-4d5e-8f60-b1c2d3e4f5a6",
  "clientId": "0f8a1c2e-6b3d-4e7f-9a10-2c4d6e8f0a12",
  "clientName": "Exemplu SRL",
  "serialNumber": "DT000001",
  "brand": "Datecs",
  "status": "Active",
  "isOnline": true,
  "awaitingClientConsent": false,
  "activatedAtUtc": "2026-08-27T09:14:22.512Z",
  "serialBoundAtUtc": "2026-08-27T09:14:22.512Z",
  "clientDeclinedAtUtc": null,
  "clientDeclinedSerialNumber": null
}

POST …/registers/{registerId}/serial

`bind-register-serial`

Doar pentru o înregistrare AwaitingSerial: leagă o serie nouă și cere din nou acordul. O serie legată e permanentă.

Răspuns GetIntegratorRegisterResponse
Cerere BindIntegratorRegisterSerialRequest

POSTCerere

curl -X POST 'https://cloud-api.fiscallink.ro/api/v2/tenants/YOUR_TENANT_ID/integrator/registers/7d2e9b4f-1a3c-4d5e-8f60-b1c2d3e4f5a6/serial' \
  -H 'X-Api-Key: fsk_YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "serialNumber": "DT000002"
}'

200Răspuns

{
  "id": "7d2e9b4f-1a3c-4d5e-8f60-b1c2d3e4f5a6",
  "clientId": "0f8a1c2e-6b3d-4e7f-9a10-2c4d6e8f0a12",
  "clientName": "Exemplu SRL",
  "serialNumber": "DT000001",
  "brand": "Datecs",
  "status": "Active",
  "isOnline": true,
  "awaitingClientConsent": false,
  "activatedAtUtc": "2026-08-27T09:14:22.512Z",
  "serialBoundAtUtc": "2026-08-27T09:14:22.512Z",
  "clientDeclinedAtUtc": null,
  "clientDeclinedSerialNumber": null
}

PATCH …/registers/{registerId}

`move-register`

Mută casa la alt client de-al tău. Doar evidență: facturarea și conexiunea nu se schimbă.

Răspuns GetIntegratorRegisterResponse
Cerere MoveIntegratorRegisterRequest

PATCHCerere

curl -X PATCH 'https://cloud-api.fiscallink.ro/api/v2/tenants/YOUR_TENANT_ID/integrator/registers/7d2e9b4f-1a3c-4d5e-8f60-b1c2d3e4f5a6' \
  -H 'X-Api-Key: fsk_YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "clientId": "5a6b7c8d-9e0f-4a1b-8c2d-3e4f5a6b7c8d"
}'

200Răspuns

{
  "id": "7d2e9b4f-1a3c-4d5e-8f60-b1c2d3e4f5a6",
  "clientId": "0f8a1c2e-6b3d-4e7f-9a10-2c4d6e8f0a12",
  "clientName": "Exemplu SRL",
  "serialNumber": "DT000001",
  "brand": "Datecs",
  "status": "Active",
  "isOnline": true,
  "awaitingClientConsent": false,
  "activatedAtUtc": "2026-08-27T09:14:22.512Z",
  "serialBoundAtUtc": "2026-08-27T09:14:22.512Z",
  "clientDeclinedAtUtc": null,
  "clientDeclinedSerialNumber": null
}

DELETE …/registers/{registerId}

`remove-register`

Trece casa în Removed imediat; nu mai primește comenzile tale. Răspunde 202, deși scoaterea e deja în vigoare.

Răspuns GetIntegratorRegisterResponse

DELETECerere

curl -X DELETE 'https://cloud-api.fiscallink.ro/api/v2/tenants/YOUR_TENANT_ID/integrator/registers/7d2e9b4f-1a3c-4d5e-8f60-b1c2d3e4f5a6' \
  -H 'X-Api-Key: fsk_YOUR_API_KEY'

202Răspuns

{
  "id": "7d2e9b4f-1a3c-4d5e-8f60-b1c2d3e4f5a6",
  "clientId": "0f8a1c2e-6b3d-4e7f-9a10-2c4d6e8f0a12",
  "clientName": "Exemplu SRL",
  "serialNumber": "DT000001",
  "brand": "Datecs",
  "status": "Active",
  "isOnline": true,
  "awaitingClientConsent": false,
  "activatedAtUtc": "2026-08-27T09:14:22.512Z",
  "serialBoundAtUtc": "2026-08-27T09:14:22.512Z",
  "clientDeclinedAtUtc": null,
  "clientDeclinedSerialNumber": null
}