Клијенти и провера у ANAF регистру (Румунија)

Уметање или ажурирање са дедупликацијом по tax_id и провера у ANAF регистру (Румунија) да е-фактура не буде одбијена.

Прва фактура у 6 корака

POST /v1/clients прави или ажурира клијента, уз дедупликацију по tax_id, а ако њега нема, по нормализованом називу.
GET /v1/clients приказује клијенте уз лимит, offset и слободну претрагу q.
GET /v1/lookup/company/{tax_id} проверава румунски CUI у ANAF регистру и враћа званичне податке.
Попуните купац из резултата провере, да e-Factura не би била одбијена због застарелог назива или адресе.

Сви endpoint-и

Метода	Endpoint	Scope	Idempotency-Key	Захтева / минут
GET	/clients Листа клијената	clients:read	—	120
POST	/clients Креирај или ажурирај клијента	clients:write	—	30
GET	/lookup/company/{tax_id} Провери CUI у ANAF регистру (Румунија)	clients:read	—	120

Шта је 4invoices API

bash
# Дедупликација по tax_id, а ако га нема, по нормализованом називу:
# поновно слање истог клијента га АЖУРИРА уместо да прави дупликат.
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"

# Званични подаци из ANAF регистра (Румунија) — користите их да унапред попуните "buyer", како
# e-Factura не би била одбијена због застарелог назива или адресе.

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

Честе грешке

За издавање вам није потребан сачуван клијент: објекат купац може се послати директно у POST /invoices.
За румунске купце county мора бити стварни округ; за Букурешт упишите сектор у град.
tax_id се прихвата са префиксом државе или без њега (RO12345678 или 12345678).
Поновно слање истог клијента ажурира запис, па поновљени увоз не прави дупликате.

Питања и одговори за програмере

Који опсег је потребан за проверу у ANAF регистру (Румунија)?

clients:read. За упис клијената потребан је clients:write.

Могу ли да увезем хиљаде клијената из старог система?

Да, али поштујте корпа од 30 уписа у минуту. Увозите у групама, са backoff-ом на 429.

Шта ако CUI није у регистру?

Провера враћа 404 not_found. И даље можете да издате фактуру са сопственим подацима, али ризикујете одбијање при предаји (у Румунији: CIUS-RO).

Види такође