Clienți și verificarea CUI la ANAF

1. POST /v1/clients creează sau actualizează un client, deduplicat pe tax_id și, în lipsa lui, pe numele normalizat.
2. GET /v1/clients listează clienții cu limit, offset și căutare liberă prin q.
3. GET /v1/lookup/company/{tax_id} validează un CUI în registrul ANAF și întoarce datele oficiale.
4. Prepopulează buyer din rezultatul lookup-ului, ca e-Factura să nu fie respinsă pentru un nume sau o adresă învechită.

bash
# Deduplicat după tax_id, iar în lipsa lui după un nume normalizat:
# retrimiterea aceluiași client O ACTUALIZEAZĂ, în loc să creeze un duplicat.
curl -sS -X POST https://api.4invoices.net/v1/clients \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Exemplu Comert SRL",
    "tax_id": "RO12345678",
    "email": "[email protected]",
    "country": "RO",
    "county": "Cluj",
    "city": "Cluj-Napoca",
    "address": "Str. Fabricii 12",
    "iban": "RO49AAAA1B31007593840000"
  }'

bash
curl -sS https://api.4invoices.net/v1/lookup/company/RO12345678 \
  -H "Authorization: Bearer $ACCESS_TOKEN"

# Date oficiale din registrul ANAF — folosește-le ca să completezi "buyer", ca
# e-Factura să nu fie respinsă din cauza unui nume sau al unei adrese vechi.

https://api.4invoices.net/v1 · https://api.4invoices.net/v1/openapi.json

• Nu ai nevoie de un client salvat ca să emiți: obiectul buyer poate fi trimis inline pe POST /invoices.
• Pentru cumpărători din România, county trebuie să fie județul real; pentru București pui sectorul în city.
• tax_id se acceptă cu sau fără prefixul de țară (RO12345678 sau 12345678).
• Retrimiterea aceluiași client actualizează înregistrarea, deci un import repetat nu produce duplicate.