Vevők és ANAF nyilvántartás-ellenőrzés (Románia)

tax_id alapján deduplikált beszúrás vagy frissítés (upsert) és ANAF nyilvántartás-lekérdezés (Románia), hogy az e-számlát ne utasítsák el.

tax_id alapján deduplikált beszúrás vagy frissítés (upsert) és ANAF nyilvántartás-lekérdezés (Románia), hogy az e-számlát ne utasítsák el.

← Vissza az API dokumentációhoz

Az első számla 6 lépésben

  1. A POST /v1/clients létrehoz vagy frissít egy ügyfelet, a tax_id alapján deduplikálva, ennek hiányában pedig a normalizált név alapján.
  2. A GET /v1/clients listázza az ügyfeleket limit, offset és szabad szöveges q paraméterrel.
  3. A GET /v1/lookup/company/{tax_id} ellenőrzi a román CUI-t az ANAF nyilvántartásában, és visszaadja a hivatalos adatokat.
  4. Töltse ki előre a buyer adatait a keresés eredményéből, hogy az e-Factura ne kerüljön elutasításra elavult név vagy cím miatt.

Minden végpont

MetódusVégpontScopeIdempotency-KeyKérés / perc
GET/clients
Vevők listázása
clients:read—120
POST/clients
Vevő létrehozása vagy frissítése
clients:write—30
GET/lookup/company/{tax_id}
CUI érvényesítése az ANAF nyilvántartásában (Románia)
clients:read—120

Mi a 4invoices API

bash
# A tax_id alapján deduplikál, hiány esetén a normalizált név alapján:
# ugyanazon vevő újraküldése FRISSÍTI, ahelyett hogy duplikátumot hozna létre.
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"

# Hivatalos adatok az ANAF nyilvántartásából (Románia) — ezekkel töltse ki előre a "buyer" mezőt, hogy
# az e-Factura ne utasítsa el elavult név vagy cím miatt.

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

Gyakori hibák

  • A kiállításhoz nincs szükség tárolt ügyfélre: a buyer objektum közvetlenül is elküldhető a POST /invoices kérésben.
  • Román vevők esetén a county a valós megye legyen; Bukarest esetén a kerületet a city mezőbe írja.
  • A tax_id országelőtaggal és anélkül is elfogadott (RO12345678 vagy 12345678).
  • Ugyanannak az ügyfélnek az ismételt elküldése frissíti a rekordot, így egy megismételt import nem hoz létre duplikátumokat.

Kérdések és válaszok fejlesztőknek

Milyen jogosultság kell az ANAF-kereséshez (Románia)?

clients:read. Az ügyfelek írásához clients:write szükséges.

Importálhatok több ezer ügyfelet egy régi rendszerből?

Igen, de tartsa be a percenkénti 30 írásos keretet. Kötegekben importáljon, 429 esetén backoffal.

Mi a teendő, ha a CUI nincs benne a nyilvántartásban?

A keresés 404 not_found választ ad. Saját adatokkal továbbra is kiállíthatja a számlát, de beküldéskor elutasítást kockáztat (Romániában: CIUS-RO).