Klienti a vyhledávání v registru ANAF (Rumunsko)

Vložení nebo aktualizace (upsert) deduplikované podle tax_id a vyhledání v registru ANAF (Rumunsko), aby elektronická faktura nebyla odmítnuta.

← Zpět na dokumentaci API

První faktura v 6 krocích

POST /v1/clients vytvoří nebo aktualizuje klienta, deduplikovaného podle tax_id a v nouzi podle normalizovaného názvu.
GET /v1/clients vypíše klienty s parametry limit, offset a fulltextovým q.
GET /v1/lookup/company/{tax_id} ověří CUI proti registru ANAF (Rumunsko) a vrátí oficiální údaje.
Předvyplňte buyer z výsledku vyhledání, aby e-Factura nebyla odmítnuta kvůli zastaralému názvu nebo adrese.

Všechny endpointy

Metoda	Endpoint	Scope	Idempotency-Key	Požadavků / minutu
GET	/clients Výpis klientů	clients:read	—	120
POST	/clients Vytvořit nebo aktualizovat klienta	clients:write	—	30
GET	/lookup/company/{tax_id} Ověřit CUI proti registru ANAF (Rumunsko)	clients:read	—	120

Co je API 4invoices

bash
# Deduplikováno podle tax_id, jinak podle normalizovaného názvu:
# opětovné odeslání stejného klienta ho AKTUALIZUJE místo vytvoření duplicity.
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ální údaje z registru ANAF (Rumunsko) — použijte je k předvyplnění "buyer", aby
# e-Factura nebyla odmítnuta kvůli zastaralému názvu nebo adrese.

https://api.4invoices.net/v1 · https://api.4invoices.net/v1/openapi.json

Časté chyby

Pro vystavení nepotřebujete uloženého klienta: objekt buyer lze poslat přímo v POST /invoices.
U rumunských odběratelů musí být county skutečný župa; pro Bukurešť uveďte sektor do city.
tax_id se přijímá s předčíslím země i bez něj (RO12345678 nebo 12345678).
Opětovné odeslání stejného klienta záznam aktualizuje, takže opakovaný import nevytváří duplicity.

Otázky a odpovědi pro vývojáře

Jaký scope potřebuje vyhledání v registru ANAF (Rumunsko)?

clients:read. Zápis klientů vyžaduje clients:write.

Mohu importovat tisíce klientů ze starého systému?

Ano, ale respektujte kvótu zápisů 30 za minutu. Importujte po dávkách s backoff při 429.

Co když CUI v registru není?

Vyhledání vrátí 404 not_found. Můžete stále vystavit s vlastními údaji, ale riskujete odmítnutí při podání (v Rumunsku podle CIUS-RO).

Viz také