Klijenti i pretraga u službenom registru

Umetanje ili ažuriranje bez duplikata po tax_id uz pretragu službenog registra (u Rumuniji: ANAF) da e-faktura ne bude odbijena.

Umetanje ili ažuriranje bez duplikata po tax_id uz pretragu službenog registra (u Rumuniji: ANAF) da e-faktura ne bude odbijena.

← Nazad na API dokumentaciju

Vaša prva faktura u 6 koraka

  1. POST /v1/clients kreira ili ažurira klijenta, bez duplikata po tax_id, a ako ga nema, po normalizovanom nazivu.
  2. GET /v1/clients prikazuje klijente sa limit, offset i slobodnim tekstom q.
  3. GET /v1/lookup/company/{tax_id} provjerava poreski broj u službenom registru (u Rumuniji: CUI kod ANAF-a) i vraća zvanične podatke.
  4. Popunite buyer rezultatom pretrage da e-Factura ne bude odbijena zbog zastarjelog naziva ili adrese.

Sve krajnje tačke

MetodKrajnja tačkaOpsegIdempotency-KeyZahtjeva / minut
GET/clients
Listanje klijenata
clients:read—120
POST/clients
Kreira ili ažurira klijenta
clients:write—30
GET/lookup/company/{tax_id}
Provjerava poreski broj u službenom registru (u Rumuniji: ANAF)
clients:read—120

Šta je API 4invoices

bash
# Bez duplikata po tax_id, a ako ga nema, po normalizovanom nazivu:
# ponovno slanje istog klijenta ga AŽURIRA umjesto da pravi duplikat.
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"

# Zvanični podaci iz službenog registra (u Rumuniji: ANAF) — koristite ih za popunjavanje "buyer" da
# e-Factura ne bude odbijena zbog zastarjelog naziva ili adrese.

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

Česte greške

  • Za izdavanje ne treba sačuvan klijent: objekat buyer se može poslati direktno u POST /invoices.
  • Za rumunske kupce county mora biti stvarni okrug (județ); za Bukurešt stavite sektor u city.
  • tax_id se prihvata sa prefiksom zemlje ili bez njega (RO12345678 ili 12345678).
  • Ponovno slanje istog klijenta ažurira zapis, pa ponovljeni uvoz ne pravi duplikate.

Pitanja i odgovori za programere

Koji opseg treba pretrazi registra?

clients:read. Za pisanje klijenata potreban je clients:write.

Mogu li uvesti hiljade klijenata iz starog sistema?

Da, ali poštujte grupu pisanja od 30 po minuti. Uvozite u serijama sa backoff-om na 429.

Šta ako poreski broj nije u registru?

Pretraga vraća 404 not_found. I dalje možete izdavati sa sopstvenim podacima, ali rizikujete odbijanje pri podnošenju.