Klienti a kontrola v registri ANAF (Rumunsko)

Deduplikované vloženie alebo aktualizácia podľa tax_id a kontrola v registri ANAF (Rumunsko), aby elektronická faktúra nebola odmietnutá.

Deduplikované vloženie alebo aktualizácia podľa tax_id a kontrola v registri ANAF (Rumunsko), aby elektronická faktúra nebola odmietnutá.

← Späť na dokumentáciu API

Prvá faktúra v 6 krokoch

  1. POST /v1/clients vytvorí alebo aktualizuje klienta, pričom deduplikuje podľa tax_id a ak chýba, podľa normalizovaného názvu.
  2. GET /v1/clients vypíše klientov s limit, offset a fulltextovým q.
  3. GET /v1/lookup/company/{tax_id} overí rumunské CUI v registri ANAF a vráti oficiálne údaje.
  4. 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ódaEndpointScopeIdempotency-KeyPož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).