Без активна серија од видот fiscale, издавањето враќа 409 no_series_configured.
← Назад кон API документацијата
Првата фактура во 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 ги содржи series и number — запишете ги двете за усогласување.
- Storno зема нов број од серијата; оригиналниот број на фактурата никогаш не се повторно користи.
- Проформите користат нумерација одделена од фискалната серија, па не трошат фискални броеви.
- Не претпоставувајте формат на бројот: третирајте го number како непроѕирна низа, не како цел број.
Прашања и одговори за програмери
Можам ли да создадам серија преку API?
Не. API-то само ги чита серии. Создавањето и активирањето се прави во панелот, бидејќи фискалната нумерација е одлука за усогласеност.
Што ако имам повеќе активни серии?
Се користи стандардната серија конфигурирана во панелот. Издавањето само по себе не избира помеѓу двосмислени серии.
Зошто no_series_configured е 409, а не 422?
Тоа е конфликт во состојбата на сметката, а не проблем со податоците што ги испративте. Вашето барање е валидно; недостасува конфигурацијата.