Без активної серії типу fiscale виставлення повертає 409 no_series_configured.
Перший рахунок за 6 кроків
- GET /v1/series повертає список серій нумерації, налаштованих для тенант.
- Для випуску потрібна щонайменше одна АКТИВНА серія типу fiscale.
- Без неї POST /v1/invoices повертає 409 no_series_configured.
- Серії створюються й активуються в панелі, а не через API.
Усі ендпоїнти
| Метод | Ендпоїнт | Scope | Idempotency-Key | Запитів / хвилину |
|---|---|---|---|---|
| GET | /series Список серій нумерації | invoices:read | — | 120 |
Що таке API 4invoices
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?
Це конфлікт стану акаунта, а не проблема з надісланими вами даними. Ваш пейлоад коректний; бракує конфігурації.