Be aktyvios fiskalinės serijos (fiscale) išrašymas grąžina 409 no_series_configured.
Pirmoji sąskaita per 6 žingsnius
- GET /v1/series išvardija jūsų tenant sukonfigūruotas numeravimo serijas.
- Išrašymui reikia bent vienos AKTYVIOS serijos tipo fiscale.
- Be jos POST /v1/invoices grąžina 409 no_series_configured.
- Serijos kuriamos ir aktyvuojamos skydelyje, o ne per API.
Visi galiniai taškai
| Metodas | Galinis taškas | Scope | Idempotency-Key | Užklausų / min. |
|---|---|---|---|---|
| GET | /series Išvardyti numeravimo serijas | invoices:read | — | 120 |
Kas yra 4invoices API
bash
curl -sS https://api.4invoices.net/v1/series \
-H "Authorization: Bearer $ACCESS_TOKEN"
# Turi būti bent viena AKTYVI serija tipo „fiscale”, kitaip
# POST /invoices grąžina 409 no_series_configured.https://api.4invoices.net/v1 · https://api.4invoices.net/v1/openapi.json
Klaidos
| Būsena | Tipas | Kodas |
|---|---|---|
| 409 | conflict_error | no_series_configured |
Dažniausios klaidos
- POST /v1/invoices atsakyme yra series ir number — užregistruokite abu suderinimui.
- Storno sunaudoja naują numerį iš serijos; pradinės sąskaitos numeris niekada nenaudojamas pakartotinai.
- Proforma sąskaitos naudoja numeravimą, atskirtą nuo fiskalinės serijos, todėl jos nesunaudoja fiskalinių numerių.
- Nedarykite prielaidų apie numerio formatą: laikykite number nepermatoma eilute, o ne sveikuoju skaičiumi.
Kūrėjų klausimai ir atsakymai
Ar galiu sukurti seriją per API?
Ne. API tik skaito serijas. Jų kūrimas ir aktyvavimas vyksta skydelyje, nes fiskalinis numeravimas yra atitikties sprendimas.
Ką daryti, jei turiu kelias aktyvias serijas?
Naudojama skydelyje nustatyta numatytoji serija. Išrašymas pats nepasirenka tarp dviprasmiškų serijų.
Kodėl no_series_configured yra 409, o ne 422?
Tai paskyros būsenos konfliktas, o ne jūsų siųstų duomenų problema. Jūsų užklausa teisinga; trūksta konfigūracijos.