> Source: https://fiscal.link/integrators/docs/reference/cloud-management/clients
> Clienții organizației tale.

API Cloud: administrare

# Clienți

Clienții organizației tale.

## Resursa GetIntegratorClientResponse

`id` uuid doar citire

Id-ul clientului.

`name` string doar citire

Numele clientului.

`cui` string poate fi null doar citire

Codul fiscal al clientului.

`contactName` string poate fi null doar citire

Persoana de contact.

`email` string poate fi null doar citire

Adresa de email.

`phone` string poate fi null doar citire

Numărul de telefon.

`address` string poate fi null doar citire

Adresa.

`locality` string poate fi null doar citire

Localitatea.

`county` string poate fi null doar citire

Județul.

`zipCode` string poate fi null doar citire

Codul poștal.

`notes` string poate fi null doar citire

Notițele tale despre client.

`createdAt` datetime doar citire

Când a fost creat, în UTC.

`registerCount` integer poate fi null doar citire

Câte case are clientul. Doar în listă; în rest e `null`.

### Obiecte folosite aici

-   [IntegratorClientListQuery](https://fiscal.link/integrators/docs/reference/objects/cloud-client-list-query)
-   [PaginatedResponse](https://fiscal.link/integrators/docs/reference/objects/cloud-page)
-   [CreateIntegratorClientRequest](https://fiscal.link/integrators/docs/reference/objects/cloud-client-request)

## Rute

GET `…/clients`

### `list-clients`

Clienții organizației, paginat, după nume. Filtre: `search`, `hasRegisters`, `createdFrom`, `createdTo`.

-   Răspuns [GetIntegratorClientResponse](https://fiscal.link/integrators/docs/reference/objects/cloud-client)
-   Cerere [IntegratorClientListQuery](https://fiscal.link/integrators/docs/reference/objects/cloud-client-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/clients' \
  -H 'X-Api-Key: fsk_YOUR_API_KEY'
```

200Răspuns

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

GET `…/clients/{clientId}`

### `get-client`

Un client.

-   Răspuns [GetIntegratorClientResponse](https://fiscal.link/integrators/docs/reference/objects/cloud-client)

GETCerere

```bash
curl -X GET 'https://cloud-api.fiscallink.ro/api/v2/tenants/YOUR_TENANT_ID/integrator/clients/0f8a1c2e-6b3d-4e7f-9a10-2c4d6e8f0a12' \
  -H 'X-Api-Key: fsk_YOUR_API_KEY'
```

200Răspuns

```json
{
  "id": "0f8a1c2e-6b3d-4e7f-9a10-2c4d6e8f0a12",
  "name": "Exemplu SRL",
  "cui": "<CIF>",
  "contactName": "<contact-name>",
  "email": "<email>",
  "phone": "<phone>",
  "locality": "<locality>",
  "county": "<county>",
  "createdAt": "2026-08-27T09:14:22.512Z",
  "registerCount": null
}
```

POST `…/clients`

### `create-client`

Creează un client și codul lui de activare. Răspunde `201` cu antetul `Location`. Numele e unic în organizație.

Câmpuri: `name` (obligatoriu, maximum 200 de caractere, unic fără a ține cont de majuscule), `cui`, `contactName`, `email`, `phone`, `address`, `locality`, `county`, `zipCode`, `notes`.

-   Cerere [CreateIntegratorClientRequest](https://fiscal.link/integrators/docs/reference/objects/cloud-client-request)
-   Răspuns [GetIntegratorClientResponse](https://fiscal.link/integrators/docs/reference/objects/cloud-client)

POSTCerere

```bash
curl -X POST 'https://cloud-api.fiscallink.ro/api/v2/tenants/YOUR_TENANT_ID/integrator/clients' \
  -H 'X-Api-Key: fsk_YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Exemplu SRL",
  "cui": "<CIF>",
  "contactName": "<contact-name>",
  "email": "<email>",
  "phone": "<phone>",
  "locality": "<locality>",
  "county": "<county>"
}'
```

201Răspuns

```json
{
  "id": "0f8a1c2e-6b3d-4e7f-9a10-2c4d6e8f0a12",
  "name": "Exemplu SRL",
  "cui": "<CIF>",
  "contactName": "<contact-name>",
  "email": "<email>",
  "phone": "<phone>",
  "locality": "<locality>",
  "county": "<county>",
  "createdAt": "2026-08-27T09:14:22.512Z",
  "registerCount": null
}
```

PUT `…/clients/{clientId}`

### `update-client`

Înlocuiește toate datele clientului: un câmp opțional lipsă sau `null` se șterge.

-   Cerere [CreateIntegratorClientRequest](https://fiscal.link/integrators/docs/reference/objects/cloud-client-request)
-   Răspuns [GetIntegratorClientResponse](https://fiscal.link/integrators/docs/reference/objects/cloud-client)

PUTCerere

```bash
curl -X PUT 'https://cloud-api.fiscallink.ro/api/v2/tenants/YOUR_TENANT_ID/integrator/clients/0f8a1c2e-6b3d-4e7f-9a10-2c4d6e8f0a12' \
  -H 'X-Api-Key: fsk_YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Exemplu SRL",
  "cui": "<CIF>",
  "contactName": "<contact-name>",
  "email": "<email>",
  "phone": "<phone>",
  "locality": "<locality>",
  "county": "<county>"
}'
```

200Răspuns

```json
{
  "id": "0f8a1c2e-6b3d-4e7f-9a10-2c4d6e8f0a12",
  "name": "Exemplu SRL",
  "cui": "<CIF>",
  "contactName": "<contact-name>",
  "email": "<email>",
  "phone": "<phone>",
  "locality": "<locality>",
  "county": "<county>",
  "createdAt": "2026-08-27T09:14:22.512Z",
  "registerCount": null
}
```

DELETE `…/clients/{clientId}`

### `delete-client`

Șterge clientul și codul lui. Refuzat cât timp clientul are case care nu sunt `Removed`.

-   Răspuns [GetIntegratorClientResponse](https://fiscal.link/integrators/docs/reference/objects/cloud-client)

DELETECerere

```bash
curl -X DELETE 'https://cloud-api.fiscallink.ro/api/v2/tenants/YOUR_TENANT_ID/integrator/clients/0f8a1c2e-6b3d-4e7f-9a10-2c4d6e8f0a12' \
  -H 'X-Api-Key: fsk_YOUR_API_KEY'
```

200Răspuns

```json
{
  "id": "0f8a1c2e-6b3d-4e7f-9a10-2c4d6e8f0a12",
  "name": "Exemplu SRL",
  "cui": "<CIF>",
  "contactName": "<contact-name>",
  "email": "<email>",
  "phone": "<phone>",
  "locality": "<locality>",
  "county": "<county>",
  "createdAt": "2026-08-27T09:14:22.512Z",
  "registerCount": null
}
```