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
- 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.
- A GET /v1/clients listázza az ügyfeleket limit, offset és szabad szöveges q paraméterrel.
- 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.
- 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ódus | Végpont | Scope | Idempotency-Key | Ké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).