Klientët dhe kërkimi në regjistrin zyrtar

1. POST /v1/clients krijon ose përditëson një klient, i deduplikuar sipas tax_id dhe, nëse mungon, sipas emrit të normalizuar.
2. GET /v1/clients liston klientët me limit, offset dhe kërkim të lirë q.
3. GET /v1/lookup/company/{tax_id} validon një numër tatimor në regjistrin zyrtar (në Rumani: CUI te ANAF) dhe kthen të dhënat zyrtare.
4. Plotëso buyer me rezultatin e kërkimit, që e-Factura të mos refuzohet për një emër ose adresë të vjetruar.

bash
# E deduplikuar sipas tax_id, përndryshe sipas emrit të normalizuar:
# ridërgimi i të njëjtit klient e PËRDITËSON atë në vend që të krijojë një dublikatë.
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"

# Të dhënat zyrtare nga regjistri (në Rumani: ANAF) — përdori për të plotësuar «buyer» që
# e-Factura të mos refuzohet për një emër ose adresë të vjetruar.

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

• Nuk të duhet një klient i ruajtur për të lëshuar: objekti buyer mund të dërgohet brenda POST /invoices.
• Për blerësit rumunë, county duhet të jetë judeti i saktë (județ në rumanisht); për Bukureshtin, vendos sektorin te city.
• tax_id pranohet me ose pa prefiksin e shtetit (RO12345678 ose 12345678).
• Ridërgimi i të njëjtit klient përditëson regjistrimin, kështu që një import i përsëritur s'krijon dublikata.