Umetanje ili ažuriranje bez duplikata po tax_id uz pretragu službenog registra (u Rumuniji: ANAF) da e-faktura ne bude odbijena.
Vaša prva faktura u 6 koraka
- POST /v1/clients kreira ili ažurira klijenta, bez duplikata po tax_id, a ako ga nema, po normalizovanom nazivu.
- GET /v1/clients prikazuje klijente sa limit, offset i slobodnim tekstom q.
- 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.
- Popunite buyer rezultatom pretrage da e-Factura ne bude odbijena zbog zastarjelog naziva ili adrese.
Sve krajnje tačke
| Metod | Krajnja tačka | Opseg | Idempotency-Key | Zahtjeva / 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.