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.

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

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

Svi endpointi

MetodaEndpointScopeIdempotency-KeyZahtjeva / 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).