Clients i consulta al registre d'empreses

1. POST /v1/clients crea o actualitza un client, deduplicat pel tax_id i, si no n'hi ha, pel nom normalitzat.
2. GET /v1/clients llista els clients amb limit, offset i text lliure q.
3. GET /v1/lookup/company/{tax_id} valida un CUI contra el registre ANAF (Romania) i retorna les dades oficials.
4. Omple buyer amb el resultat de la consulta perquè la e-Factura no sigui rebutjada per un nom o una adreça desactualitzats.

bash
# Deduplicat pel tax_id; si no n'hi ha, pel nom normalitzat:
# tornar a enviar el mateix client l'ACTUALITZA en lloc de crear-ne 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"

# Dades oficials del registre ANAF (Romania) — fes-les servir per omplir «buyer» perquè la
# e-Factura no sigui rebutjada per un nom o una adreça desactualitzats.

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

• No cal un client guardat per emetre: l'objecte buyer es pot enviar en línia a POST /invoices.
• Per als compradors romanesos, county ha de ser el comtat real; per a București, posa el sector a city.
• tax_id s'accepta amb o sense el prefix del país (RO12345678 o 12345678).
• Tornar a enviar el mateix client n'actualitza el registre, de manera que una importació repetida no crea duplicats.