Numbriseeriad API-s

Ilma aktiivse fiskaalse seeriata (fiscale) annab väljastamine 409 no_series_configured.

Esimene arve 6 sammuga

GET /v1/series loetleb tenant'ile seadistatud numbriseeriad.
Väljastamiseks on vaja vähemalt ühte AKTIIVSET seeriat tüübiga fiscale.
Ilma selleta tagastab POST /v1/invoices 409 no_series_configured.
Seeriad luuakse ja aktiveeritakse paneelis, mitte API kaudu.

Kõik lõpp-punktid

Meetod	Lõpp-punkt	Scope	Idempotency-Key	Päringuid / minut
GET	/series Loetle numbriseeriad	invoices:read	—	120

Mis on 4invoices API

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

# Peab olema vähemalt üks AKTIIVNE seeria tüübiga „fiscale”, muidu
# POST /invoices tagastab 409 no_series_configured.

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

Vead

Staatus	Tüüp	Kood
409	conflict_error	no_series_configured

Levinud vead

POST /v1/invoices vastus sisaldab series ja number — logi mõlemad vastavuse kontrollimiseks.
Storno võtab seeriast uue numbri; algse arve numbrit ei kasutata kunagi uuesti.
Proformaarvetel on fiskaalseeriast eraldi numeratsioon, seega need ei kuluta fiskaalnumbreid.
Ära eelda numbrivormingut: käsitle number läbipaistmatu stringina, mitte täisarvuna.

Arendajate küsimused ja vastused

Kas ma saan seeria luua API kaudu?

Ei. API ainult loeb seeriaid. Nende loomine ja aktiveerimine toimub paneelis, sest fiskaalne numeratsioon on vastavusotsus.

Mis siis, kui mul on mitu aktiivset seeriat?

Kasutatakse paneelis seadistatud vaikeseeriat. Väljastamine ei vali ise mitmetähenduslike seeriate vahel.

Miks on no_series_configured 409 ja mitte 422?

See on konto olekukonflikt, mitte saadetud andmete probleem. Sinu päring on korrektne; seadistus puudub.

Vaata ka