Без активне серије типа fiscale издавање враћа 409 no_series_configured.
Прва фактура у 6 корака
- GET /v1/series приказује серије нумерисања конфигурисане за тенант.
- За издавање је потребна бар једна АКТИВНА серија типа 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?
То је сукоб са стањем налога, а не проблем са подацима које сте послали. Ваш пејлоад је исправан; недостаје конфигурација.