Číslovací řady v API

Bez aktivní řady typu fiscale vrací vystavení 409 no_series_configured.

První faktura v 6 krocích

GET /v1/series vypíše číslovací řady nakonfigurované pro tenant.
Vystavení potřebuje alespoň jednu AKTIVNÍ řadu typu fiscale.
Bez ní POST /v1/invoices vrací 409 no_series_configured.
Řady se vytvářejí a aktivují v panelu, ne přes API.

Všechny endpointy

Metoda	Endpoint	Scope	Idempotency-Key	Požadavků / minutu
GET	/series Výpis číslovacích řad	invoices:read	—	120

Co je API 4invoices

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

# Musí existovat alespoň jedna AKTIVNÍ řada typu "fiscale", jinak
# POST /invoices vrací 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

Odpověď POST /v1/invoices nese series a number — zapisujte si obojí pro párování.
Storno spotřebuje novou hodnotu z řady; číslo původní faktury se nikdy znovu nepoužije.
Proformy používají číslování oddělené od fiskální řady, takže nespotřebují fiskální čísla.
Nepředpokládejte formát čísla: se number zacházejte jako s neprůhledným řetězcem, ne jako s celým číslem.

Otázky a odpovědi pro vývojáře

Mohu vytvořit řadu přes API?

Ne. API řady pouze čte. Vytváření a aktivace probíhají v panelu, protože fiskální číslování je záležitost souladu s předpisy.

Co když mám několik aktivních řad?

Použije se výchozí řada nakonfigurovaná v panelu. Vystavení si z nejednoznačných řad nevybírá samo.

Proč je no_series_configured 409, a ne 422?

Je to konflikt stavu účtu, ne problém s odeslanými daty. Vaše data jsou platná; chybí konfigurace.

Viz také