> Source: https://fiscal.link/integrators/docs/reference/cloud-management/registers
> Casele clienților tăi.

API Cloud: administrare

# Case

Casele clienților tăi.

## Resursa GetIntegratorRegisterResponse

`id` uuid doar citire

Id-ul înregistrării casei.

`clientId` uuid doar citire

Id-ul clientului.

`clientName` string doar citire

Numele clientului.

`serialNumber` string poate fi null doar citire

Seria fiscală. `null` cât timp casa așteaptă seria.

`brand` string poate fi null doar citire

Marca, din cea mai recentă citire a cotelor TVA. `null` în răspunsurile la modificări.

-   `Tremol` Tremol.
-   `Datecs` Datecs.
-   `Daisy` Daisy.

`status` string doar 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.

`isOnline` boolean doar citire

`true` când casa e activă, conectată și nu așteaptă acordul clientului.

`activatedAtUtc` datetime poate fi null doar citire

Când a fost activată, în UTC.

`serialBoundAtUtc` datetime poate fi null doar citire

Când a fost legată seria, în UTC.

`awaitingClientConsent` boolean doar citire

`true` când casa trebuie să accepte legarea.

`clientDeclinedAtUtc` datetime poate fi null doar citire

Când a refuzat clientul legarea, în UTC.

`clientDeclinedSerialNumber` string poate fi null doar citire

Seria refuzată de client.

### Obiecte folosite aici

-   [IntegratorRegisterListQuery](https://fiscal.link/integrators/docs/reference/objects/cloud-register-list-query)
-   [PaginatedResponse](https://fiscal.link/integrators/docs/reference/objects/cloud-page)
-   [AutomationAddIntegratorRegisterRequest](https://fiscal.link/integrators/docs/reference/objects/cloud-register-add-request)
-   [BindIntegratorRegisterSerialRequest](https://fiscal.link/integrators/docs/reference/objects/cloud-register-serial-request)
-   [MoveIntegratorRegisterRequest](https://fiscal.link/integrators/docs/reference/objects/cloud-register-move-request)

## Rute

GET `…/registers`

### `list-registers`

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

-   Răspuns [GetIntegratorRegisterResponse](https://fiscal.link/integrators/docs/reference/objects/cloud-register)
-   Cerere [IntegratorRegisterListQuery](https://fiscal.link/integrators/docs/reference/objects/cloud-register-list-query)
-   Răspuns [PaginatedResponse](https://fiscal.link/integrators/docs/reference/objects/cloud-page)

GETCerere

```bash
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

```json
{
  "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](https://fiscal.link/integrators/docs/reference/objects/cloud-register)

GETCerere

```bash
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

```json
{
  "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](https://fiscal.link/integrators/docs/reference/objects/cloud-register)
-   Cerere [AutomationAddIntegratorRegisterRequest](https://fiscal.link/integrators/docs/reference/objects/cloud-register-add-request)

POSTCerere

```bash
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

```json
{
  "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](https://fiscal.link/integrators/docs/reference/objects/cloud-register)
-   Cerere [BindIntegratorRegisterSerialRequest](https://fiscal.link/integrators/docs/reference/objects/cloud-register-serial-request)

POSTCerere

```bash
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

```json
{
  "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](https://fiscal.link/integrators/docs/reference/objects/cloud-register)
-   Cerere [MoveIntegratorRegisterRequest](https://fiscal.link/integrators/docs/reference/objects/cloud-register-move-request)

PATCHCerere

```bash
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

```json
{
  "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](https://fiscal.link/integrators/docs/reference/objects/cloud-register)

DELETECerere

```bash
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

```json
{
  "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
}
```