Numerācijas sērijas API

Bez aktīvas fiskālās sērijas (fiscale) izrakstīšana atgriež 409 no_series_configured.

Pirmais rēķins 6 soļos

GET /v1/series uzskaita jūsu tenant konfigurētās numerācijas sērijas.
Izrakstīšanai nepieciešama vismaz viena AKTĪVA sērija ar tipu fiscale.
Bez tās POST /v1/invoices atgriež 409 no_series_configured.
Sērijas tiek izveidotas un aktivizētas panelī, nevis caur API.

Visi galapunkti

Metode	Galapunkts	Scope	Idempotency-Key	Pieprasījumi / minūtē
GET	/series Uzskaitīt numerācijas sērijas	invoices:read	—	120

Kas ir 4invoices API

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

# Jābūt vismaz vienai AKTĪVAI sērijai ar tipu „fiscale”, citādi
# POST /invoices atgriež 409 no_series_configured.

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

Kļūdas

Statuss	Tips	Kods
409	conflict_error	no_series_configured

Biežākās kļūdas

POST /v1/invoices atbildē ir series un number — reģistrējiet abus saskaņošanai.
Storno patērē jaunu numuru no sērijas; sākotnējā rēķina numurs nekad netiek izmantots atkārtoti.
Proforma rēķiniem ir numerācija, kas atšķiras no fiskālās sērijas, tāpēc tie neizlieto fiskālos numurus.
Neuzskatiet numura formātu par zināmu: traktējiet number kā necaurspīdīgu virkni, nevis kā veselu skaitli.

Izstrādātāju jautājumi un atbildes

Vai es varu izveidot sēriju caur API?

Nē. API tikai lasa sērijas. To izveide un aktivizēšana notiek panelī, jo fiskālā numerācija ir atbilstības lēmums.

Ko darīt, ja man ir vairākas aktīvas sērijas?

Tiek izmantota panelī konfigurētā noklusējuma sērija. Izrakstīšana pati neizvēlas starp neskaidrām sērijām.

Kāpēc no_series_configured ir 409, nevis 422?

Tas ir konta stāvokļa konflikts, nevis jūsu nosūtīto datu problēma. Jūsu pieprasījums ir derīgs; trūkst konfigurācijas.

Skatīt arī