Číselné rady v API

Bez aktívneho radu typu fiscale vystavenie vráti 409 no_series_configured.

Prvá faktúra v 6 krokoch

GET /v1/series vypíše číselné rady nakonfigurované pre tenanta.
Vystavenie vyžaduje aspoň jeden AKTÍVNY rad typu fiscale.
Bez neho POST /v1/invoices vráti 409 no_series_configured.
Rady sa vytvárajú a aktivujú v paneli, nie cez API.

Všetky endpointy

Metóda	Endpoint	Scope	Idempotency-Key	Požiadaviek / minútu
GET	/series Zoznam číselných radov	invoices:read	—	120

Čo je 4invoices API

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

# Musí existovať aspoň jeden AKTÍVNY číselný rad typu "fiscale", inak
# POST /invoices vráti 409 no_series_configured.

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

Chyby

Stav	Typ	Kód
409	conflict_error	no_series_configured

Časté chyby

Odpoveď na POST /v1/invoices obsahuje series aj number — logujte obe kvôli párovaniu.
Storno spotrebuje nové číslo z radu; číslo pôvodnej faktúry sa nikdy znovu nepoužije.
Zálohové faktúry majú číslovanie oddelené od fiškálnych radov, takže nespotrebúvajú fiškálne čísla.
Nepredpokladajte formát čísla: s number zaobchádzajte ako s nepriehľadným reťazcom, nie ako s celým číslom.

Otázky a odpovede pre vývojárov

Môžem vytvoriť rad cez API?

Nie. API rady iba číta. Ich vytváranie a aktivácia prebieha v paneli, pretože fiškálne číslovanie je rozhodnutie z oblasti súladu s predpismi.

Čo ak mám niekoľko aktívnych radov?

Použije sa predvolený rad nastavený v paneli. Vystavenie samo nevyberá medzi nejednoznačnými radmi.

Prečo je no_series_configured 409 a nie 422?

Ide o konflikt stavu účtu, nie o problém s údajmi, ktoré ste poslali. Váš payload je platný; chýba konfigurácia.

Pozrite tiež