Bez aktywnej serii typu fiscale wystawienie zwraca 409 no_series_configured.
Pierwsza faktura w 6 krokach
- GET /v1/series listuje serie numeracji skonfigurowane dla tenanta.
- Wystawienie wymaga co najmniej jednej AKTYWNEJ serii typu fiscale.
- Bez niej POST /v1/invoices zwraca 409 no_series_configured.
- Serie tworzy się i aktywuje w panelu, nie przez API.
Wszystkie endpointy
| Metoda | Endpoint | Scope | Idempotency-Key | Żądania / minutę |
|---|---|---|---|---|
| GET | /series Wyświetl serie numeracji | invoices:read | — | 120 |
Czym jest API 4invoices
bash
curl -sS https://api.4invoices.net/v1/series \
-H "Authorization: Bearer $ACCESS_TOKEN"
# Musi istnieć co najmniej jedna AKTYWNA seria typu "fiscale", inaczej
# POST /invoices zwraca 409 no_series_configured.https://api.4invoices.net/v1 · https://api.4invoices.net/v1/openapi.json
Błędy
| Status | Typ | Kod |
|---|---|---|
| 409 | conflict_error | no_series_configured |
Częste błędy
- Odpowiedź na POST /v1/invoices zawiera series i number — loguj oba na potrzeby uzgadniania.
- Storno zużywa nowy numer z serii; numer pierwotnej faktury nigdy nie jest używany ponownie.
- Proformy mają numerację oddzielną od serii fiskalnych, więc nie zużywają numerów fiskalnych.
- Nie zakładaj formatu numeru: traktuj number jako nieprzezroczysty ciąg znaków, a nie liczbę całkowitą.
Pytania i odpowiedzi dla programistów
Czy mogę utworzyć serię przez API?
Nie. API tylko odczytuje serie. Tworzenie i aktywacja odbywają się w panelu, ponieważ numeracja fiskalna jest decyzją z zakresu zgodności z przepisami.
Co, jeśli mam kilka aktywnych serii?
Używana jest seria domyślna skonfigurowana w panelu. Wystawienie nie wybiera samodzielnie spośród niejednoznacznych serii.
Dlaczego no_series_configured to 409, a nie 422?
To konflikt stanu konta, a nie problem z przesłanymi danymi. Twój payload jest poprawny; brakuje konfiguracji.