Seritë e numërimit në API

Pa një seri aktive të tipit fiscale, lëshimi kthen 409 no_series_configured.

Fatura jote e parë në 6 hapa

GET /v1/series liston seritë e numërimit të konfiguruara për klientin.
Lëshimi kërkon të paktën një seri AKTIVE të tipit fiscale.
Pa të, POST /v1/invoices kthen 409 no_series_configured.
Seritë krijohen dhe aktivizohen në panel, jo përmes API.

Çdo pikë fundore

Metoda	Pika fundore	Fushëveprimi	Idempotency-Key	Kërkesa / minutë
GET	/series Liston seritë e numërimit	invoices:read	—	120

Çfarë është API e 4invoices

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

# Duhet të ekzistojë të paktën një seri AKTIVE e tipit «fiscale», përndryshe
# POST /invoices kthen 409 no_series_configured.

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

Gabimet

Statusi	Lloji	Kodi
409	conflict_error	no_series_configured

Gabimet e zakonshme

Përgjigja e POST /v1/invoices mban series dhe number — regjistri të dyja për pajtim.
Një storno konsumon një numër të ri nga seria; numri i faturës origjinale s'ripërdoret kurrë.
Proformat përdorin numërim të ndarë nga seria fiskale, kështu që s'konsumojnë numra fiskalë.
Mos supozo format të numrit: trajto number si varg të paanalizueshëm, jo si numër të plotë.

Pyetje dhe përgjigje për zhvilluesit

A mund të krijoj një seri përmes API?

Jo. API vetëm i lexon seritë. Krijimi dhe aktivizimi bëhen në panel, sepse numërimi fiskal është vendim përputhshmërie.

Çfarë ndodh nëse kam disa seri aktive?

Përdoret seria e paracaktuar e konfiguruar në panel. Lëshimi nuk zgjedh vetë mes serive të paqarta.

Përse no_series_configured është 409 e jo 422?

Është konflikt i gjendjes së llogarisë, jo problem me të dhënat që dërgove. Ngarkesa jote është e vlefshme; mungon konfigurimi.

Shih edhe