Клиенти и проверка в регистъра на фирмите

Вмъкване или актуализиране с дедупликация по tax_id и справка в регистъра на ANAF (Румъния), за да не бъде отхвърлена е-фактурата.

← Обратно към API документацията

Първата фактура в 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 записа на минута. Импортирайте на партиди с експоненциално забавяне при 429.

Ами ако CUI не е в регистъра?

Справката връща 404 not_found. Пак можете да издадете с ваши данни, но рискувате отхвърляне от националната система за е-фактуриране при подаването.

Вижте също