FiscalLink
    Cloud DashboardDescarcă

    API Cloud: administrare

    Clienți

    Clienții organizației tale.

    Rute

    Resursa GetIntegratorClientResponse

    iduuiddoar citire
    Id-ul clientului.
    namestringdoar citire
    Numele clientului.
    cuistringpoate fi nulldoar citire
    Codul fiscal al clientului.
    contactNamestringpoate fi nulldoar citire
    Persoana de contact.
    emailstringpoate fi nulldoar citire
    Adresa de email.
    phonestringpoate fi nulldoar citire
    Numărul de telefon.
    addressstringpoate fi nulldoar citire
    Adresa.
    localitystringpoate fi nulldoar citire
    Localitatea.
    countystringpoate fi nulldoar citire
    Județul.
    zipCodestringpoate fi nulldoar citire
    Codul poștal.
    notesstringpoate fi nulldoar citire
    Notițele tale despre client.
    createdAtdatetimedoar citire
    Când a fost creat, în UTC.
    registerCountintegerpoate fi nulldoar citire
    Câte case are clientul. Doar în listă; în rest e null.

    Obiecte folosite aici

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

    Rute

    GET …/clients

    list-clients

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

    GETCerere
    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
    {
  "page": 1,
  "pageSize": 20,
  "total": 1,
  "items": []
}

    GET …/clients/{clientId}

    get-client

    Un client.

    GETCerere
    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
    {
  "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.

    POSTCerere
    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
    {
  "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.

    PUTCerere
    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
    {
  "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.

    DELETECerere
    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
    {
  "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
}