Deduplikované vloženie alebo aktualizácia podľa tax_id a kontrola v registri ANAF (Rumunsko), aby elektronická faktúra nebola odmietnutá.
Prvá faktúra v 6 krokoch
- POST /v1/clients vytvorí alebo aktualizuje klienta, pričom deduplikuje podľa tax_id a ak chýba, podľa normalizovaného názvu.
- GET /v1/clients vypíše klientov s limit, offset a fulltextovým q.
- GET /v1/lookup/company/{tax_id} overí rumunské CUI v registri ANAF a vráti oficiálne údaje.
- Predvyplňte buyer z výsledku vyhľadávania, aby e-Factura nebola zamietnutá pre neaktuálny názov alebo adresu.
Všetky endpointy
| Metóda | Endpoint | Scope | Idempotency-Key | Požiadaviek / minútu |
|---|---|---|---|---|
| GET | /clients Zoznam klientov | clients:read | — | 120 |
| POST | /clients Vytvoriť alebo aktualizovať klienta | clients:write | — | 30 |
| GET | /lookup/company/{tax_id} Overiť CUI v registri ANAF (Rumunsko) | clients:read | — | 120 |
Čo je 4invoices API
bash
# Deduplikované podľa tax_id, inak podľa normalizovaného názvu:
# opätovné odoslanie toho istého klienta ho AKTUALIZUJE namiesto vytvorenia duplikátu.
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"
# Oficiálne údaje z registra ANAF (Rumunsko) — použite ich na predvyplnenie "buyer", aby
# e-Factura nebola odmietnutá kvôli zastaranému názvu alebo adrese.https://api.4invoices.net/v1 · https://api.4invoices.net/v1/openapi.json
Časté chyby
- Na vystavenie nepotrebujete uloženého klienta: objekt buyer možno poslať priamo v POST /invoices.
- Pri rumunských odberateľoch musí byť county skutočná župa; pre Bukurešť uveďte sektor v city.
- tax_id sa prijíma s predponou krajiny aj bez nej (RO12345678 alebo 12345678).
- Opätovné odoslanie toho istého klienta aktualizuje záznam, takže opakovaný import nevytvára duplikáty.
Otázky a odpovede pre vývojárov
Aký rozsah vyžaduje vyhľadávanie v registri ANAF (Rumunsko)?
clients:read. Zápis klientov vyžaduje clients:write.
Môžem importovať tisíce klientov zo starého systému?
Áno, ale rešpektujte kvótu 30 zápisov za minútu. Importujte po dávkach s backoffom pri 429.
Čo ak CUI nie je v registri?
Vyhľadávanie vráti 404 not_found. Stále môžete vystaviť faktúru s vlastnými údajmi, ale riskujete zamietnutie pri odoslaní (v Rumunsku: CIUS-RO).