Számlatömbök az API-ban

Aktív fiscale típusú számlatömb nélkül a kiállítás 409 no_series_configured hibát ad.

Az első számla 6 lépésben

A GET /v1/series listázza a tenanthoz beállított sorszámozási sorozatokat.
A kiállításhoz legalább egy AKTÍV, fiscale típusú sorozat szükséges.
Enélkül a POST /v1/invoices 409 no_series_configured választ ad.
A sorozatokat a panelen kell létrehozni és aktiválni, nem az API-n keresztül.

Minden végpont

Metódus	Végpont	Scope	Idempotency-Key	Kérés / perc
GET	/series Számlatömbök listázása	invoices:read	—	120

Mi a 4invoices API

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

# Legalább egy AKTÍV, "fiscale" típusú számlatömbnek léteznie kell, különben
# a POST /invoices 409 no_series_configured választ ad.

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

Hibák

Státusz	Típus	Kód
409	conflict_error	no_series_configured

Gyakori hibák

A POST /v1/invoices válasza tartalmazza a series és a number értéket — az egyeztetéshez naplózza mindkettőt.
A sztornó új sorszámot használ fel a sorozatból; az eredeti számla sorszámát soha nem használjuk újra.
A díjbekérők a fiskális sorozatoktól elkülönített számozást használnak, így nem fogyasztanak fiskális sorszámot.
Ne feltételezzen sorszámformátumot: a number értéket átlátszatlan karakterláncként kezelje, ne egész számként.

Kérdések és válaszok fejlesztőknek

Létrehozhatok sorozatot az API-n keresztül?

Nem. Az API csak olvassa a sorozatokat. Létrehozásuk és aktiválásuk a panelen történik, mert a fiskális sorszámozás megfelelőségi döntés.

Mi a helyzet, ha több aktív sorozatom van?

A panelen beállított alapértelmezett sorozatot használjuk. A kiállítás nem választ magától a nem egyértelmű sorozatok között.

Miért 409 a no_series_configured, és miért nem 422?

Ez fiókállapot-ütközés, nem az elküldött adatokkal van probléma. A payload érvényes; a konfiguráció hiányzik.

Lásd még