Серии за номериране в API

Без активна серия от тип fiscale издаването връща 409 no_series_configured.

Първата фактура в 6 стъпки

GET /v1/series изброява сериите за номериране, конфигурирани за tenant-а.
Издаването изисква поне една АКТИВНА серия от вид fiscale.
Без такава POST /v1/invoices връща 409 no_series_configured.
Сериите се създават и активират в панела, а не през API.

Всички endpoint-и

Метод	Endpoint	Scope	Idempotency-Key	Заявки / минута
GET	/series Списък с серии за номериране	invoices:read	—	120

Какво е 4invoices API

bash
curl -sS https://api.4invoices.net/v1/series \
  -H "Authorization: Bearer $ACCESS_TOKEN"

# Трябва да съществува поне една АКТИВНА серия от тип "fiscale", иначе
# POST /invoices връща 409 no_series_configured.

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

Грешки

Статус	Тип	Код
409	conflict_error	no_series_configured

Често срещани грешки

Отговорът на POST /v1/invoices съдържа серия и номер — записвайте и двете за равнението.
Сторнирането изразходва нов номер от серията; номерът на оригиналната фактура никога не се преизползва.
Проформите използват номериране, отделно от фискалните серии, така че не изразходват фискални номера.
Не приемайте определен формат на номера: третирайте номер като непрозрачен низ, а не като цяло число.

Въпроси и отговори за разработчици

Мога ли да създам серия през API?

Не. API-то само чете сериите. Създаването и активирането им става в панела, защото фискалното номериране е решение за съответствие.

Ами ако имам няколко активни серии?

Използва се серията по подразбиране, конфигурирана в панела. Издаването не избира само между нееднозначни серии.

Защо no_series_configured е 409, а не 422?

Това е конфликт в състоянието на акаунта, а не проблем с изпратените от вас данни. Payload-ът ви е валиден; липсва конфигурацията.

Вижте също