Müştərilər və rəsmi reyestrdə axtarış

1. POST /v1/clients müştərini yaradır və ya yeniləyir; tax_id üzrə dublikatsız, tapılmadıqda normallaşdırılmış ad üzrə.
2. GET /v1/clients müştəriləri limit, offset və sərbəst mətn q ilə siyahılayır.
3. GET /v1/lookup/company/{tax_id} vergi nömrəsini rəsmi reyestrdə (Rumıniyada: ANAF-da CUI) yoxlayır və rəsmi məlumatı qaytarır.
4. Köhnəlmiş ad və ya ünvana görə e-Factura rədd edilməsin deyə buyer-i axtarış nəticəsi ilə doldurun.

bash
# tax_id üzrə dublikatsız, tapılmadıqda normallaşdırılmış ad üzrə:
# eyni müştərini yenidən göndərmək onu YENİLƏYİR, dublikat yaratmır.
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"

# Rəsmi reyestr məlumatı (Rumıniyada: ANAF) — "buyer"i doldurmaq üçün istifadə edin ki,
# köhnəlmiş ad və ya ünvana görə e-Factura rədd edilməsin.

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

• Yaratmaq üçün saxlanılmış müştəri lazım deyil: buyer obyekti POST /invoices daxilində göndərilə bilər.
• Rumıniyalı alıcılar üçün county real rayon (județ) olmalıdır; Bukreş üçün sektoru city-yə yazın.
• tax_id ölkə prefiksi ilə və ya onsuz qəbul olunur (RO12345678 və ya 12345678).
• Eyni müştərini yenidən göndərmək qeydi yeniləyir, buna görə təkrar idxal dublikat yaratmır.