Sign in
Clienti

Listare clienti

Returneaza toti clientii din nomenclatorul tau SmartBill.

Filtrare

name potriveste oriunde in nume, nu doar la inceput: ?name=lpha gaseste Client Alpha SRL.

vatCode nu normalizeaza prefixul: un client salvat cu RO55555555 nu e gasit de ?vatCode=55555555. Trimite valoarea exact cum e salvata.

Filtrele se combina cu AND: ?name=Alpha&code=INEXISTENT intoarce 0 rezultate. Un filtru trimis gol (?name=) e ignorat, deci primesti lista nefiltrata.

get/v3/companies/{cif}/clients

Path parameters

cifstring required

CIF-ul firmei tale, fara spatii.

Query parameters

namestring

Filtreaza dupa nume (potrivire partiala, case-insensitive)

codestring

Filtreaza dupa cod intern (potrivire exacta, case-sensitive)

vatCodestring

Filtreaza dupa CIF (potrivire exacta, case-insensitive)

limitinteger

Numar maxim de rezultate returnate (intre 1 si 100)

afterstring

Cursor pentru pagina urmatoare, id-ul clientului dupa care se continua. Nu se foloseste impreuna cu 'before'.

beforestring

Cursor pentru pagina anterioara, id-ul clientului inainte de care se continua. Nu se foloseste impreuna cu 'after'.

Response

Lista clienti paginata (paginare cursor)

Example response

{
  "items": [
    {
      "id": "cus_019f17cde09d73a69826a35d9c640d13",
      "name": "Client Exemplu SRL",
      "vatCode": "RO77777777",
      "regCom": "J40/3333/2020",
      "code": "CLI003",
      "address": "Str. Exemplu 1",
      "city": "Bucuresti",
      "county": "Bucuresti",
      "country": "Romania",
      "bank": "Banca Exemplu",
      "iban": "RO49AAAA1B31007593840000",
      "email": "client@example.com",
      "contact": "Elena Radu",
      "phone": "0722000005",
      "deliveryAddresses": [
        {
          "description": "Auto-generated address 1",
          "address": "Str. Livezilor 3",
          "city": "Bucuresti",
          "county": "Bucuresti",
          "country": "Romania",
          "defaultAddress": true
        }
      ]
    }
  ]
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.