Klijenti i provjera u ANAF registru (Rumunjska)

Umetanje ili ažuriranje (upsert) deduplicirano po tax_id i provjera u ANAF registru (Rumunjska) kako e-račun ne bi bio odbijen.

← Natrag na API dokumentaciju

Prva faktura u 6 koraka

POST /v1/clients stvara ili ažurira klijenta, uz deduplikaciju po tax_id, a ako ga nema, po normaliziranom nazivu.
GET /v1/clients ispisuje klijente uz limit, offset i slobodno pretraživanje q.
GET /v1/lookup/company/{tax_id} provjerava rumunjski CUI u ANAF registru i vraća službene podatke.
Popunite buyer iz rezultata provjere kako e-Factura ne bi bila odbijena zbog zastarjelog naziva ili adrese.

Svi endpointi

Metoda	Endpoint	Scope	Idempotency-Key	Zahtjeva / minutu
GET	/clients Popis klijenata	clients:read	—	120
POST	/clients Stvaranje ili ažuriranje klijenta	clients:write	—	30
GET	/lookup/company/{tax_id} Provjera CUI-ja u registru ANAF-a (Rumunjska)	clients:read	—	120

Što je 4invoices API

bash
# Deduplicirano po tax_id, a u nedostatku prema normaliziranom nazivu:
# ponovno slanje istog kupca GA AŽURIRA umjesto da stvori 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"

# Službeni podaci iz ANAF-ova registra (Rumunjska) — upotrijebite ih za unaprijed 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 pogreške

Za izdavanje ne trebate pohranjenog klijenta: objekt buyer može se poslati izravno u POST /invoices.
Za rumunjske kupce county mora biti stvarna županija; za Bukurešt upišite sektor u city.
tax_id prihvaća se s prefiksom države ili bez njega (RO12345678 ili 12345678).
Ponovno slanje istog klijenta ažurira zapis, pa ponovljeni uvoz ne stvara duplikate.

Pitanja i odgovori za razvijatelje

Koji scope treba za provjeru u ANAF registru (Rumunjska)?

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

Mogu li uvesti tisuće klijenata iz starog sustava?

Da, ali poštujte bucket od 30 upisa u minuti. Uvozite u serijama, s backoffom na 429.

Što ako CUI nije u registru?

Provjera vraća 404 not_found. I dalje možete izdati fakturu s vlastitim podacima, ali riskirate odbijanje pri predaji (u Rumunjskoj: CIUS-RO).

Vidi također