Клиенти и пребарување во службениот регистар

1. POST /v1/clients создава или ажурира клиент, дедупликиран по tax_id и, ако го нема, по нормализирано име.
2. GET /v1/clients ги листа клиентите со limit, offset и слободен текст q.
3. GET /v1/lookup/company/{tax_id} го валидира даночниот број во службениот регистар (во Романија: CUI кај ANAF) и ги враќа службените податоци.
4. Пополнете го buyer од резултатот на пребарувањето за e-Factura да не се отфрли поради застарено име или адреса.

bash
# Дедупликација по tax_id, а ако го нема, по нормализирано име:
# повторното испраќање на истиот клиент го АЖУРИРА, наместо да создаде дупликат.
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"

# Службени податоци од регистарот (во Романија: ANAF) — користете ги за да го пополните "buyer" за
# e-Factura да не се отфрли поради застаро име или адреса.

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

• Не ви треба зачуван клиент за издавање: објектот buyer може да се испрати директно во POST /invoices.
• За румунски купувачи county мора да биде вистинското окружие (județ); за Букурешт ставете го секторот во city.
• tax_id се прифаќа со или без префиксот на земјата (RO12345678 или 12345678).
• Повторното испраќање на истиот клиент го ажурира записот, па повторен увоз не создава дупликати.