fiscale türünde etkin bir seri yoksa fatura kesimi 409 no_series_configured döndürür.
6 adımda ilk fatura
- GET /v1/series, tenant için yapılandırılmış numaralandırma serilerini listeler.
- Düzenleme, fiscale türünde en az bir ETKİN seri gerektirir.
- Böyle bir seri yoksa POST /v1/invoices 409 no_series_configured döndürür.
- Seriler API üzerinden değil, panelde oluşturulur ve etkinleştirilir.
Tüm uç noktalar
| Metot | Uç nokta | Scope | Idempotency-Key | İstek / dakika |
|---|---|---|---|---|
| GET | /series Numaralandırma serilerini listele | invoices:read | — | 120 |
4invoices API'si nedir
bash
curl -sS https://api.4invoices.net/v1/series \
-H "Authorization: Bearer $ACCESS_TOKEN"
# "fiscale" türünde en az BİR ETKİN seri bulunmalıdır, aksi hâlde
# POST /invoices 409 no_series_configured döndürür.https://api.4invoices.net/v1 · https://api.4invoices.net/v1/openapi.json
Hatalar
| Durum | Tip | Kod |
|---|---|---|
| 409 | conflict_error | no_series_configured |
Sık yapılan hatalar
- POST /v1/invoices yanıtı series ve number taşır — mutabakat için ikisini de kaydedin.
- Bir iptal (storno) seriden yeni bir numara tüketir; orijinal faturanın numarası asla yeniden kullanılmaz.
- Proformalar mali serilerden ayrı bir numaralandırma kullanır, bu yüzden mali numara tüketmez.
- Bir numara biçimi varsaymayın: number’ı tamsayı olarak değil, opak bir dize olarak ele alın.
Geliştiriciler için soru ve cevaplar
API üzerinden seri oluşturabilir miyim?
Hayır. API serileri yalnızca okur. Oluşturma ve etkinleştirme panelde yapılır, çünkü mali numaralandırma bir uyumluluk kararıdır.
Birden fazla etkin serim varsa ne olur?
Panelde yapılandırılmış varsayılan seri kullanılır. Düzenleme, belirsiz seriler arasında kendi başına seçim yapmaz.
no_series_configured neden 422 değil de 409?
Bu, gönderdiğiniz verilerle ilgili bir sorun değil, bir hesap durumu çakışmasıdır. Payload’ınız geçerlidir; eksik olan yapılandırmadır.