fiscale növündə aktiv seriya olmadan yaradılma 409 no_series_configured qaytarır.
6 addımda ilk fakturanız
- GET /v1/series müştəri üçün konfiqurasiya olunmuş nömrələmə seriyalarını siyahılayır.
- Yaradılma üçün ən azı bir AKTİV fiscale növ seriya lazımdır.
- Onsuz POST /v1/invoices 409 no_series_configured qaytarır.
- Seriyalar API ilə yox, paneldə yaradılır və aktivləşdirilir.
Bütün son nöqtələr
| Metod | Son nöqtə | Əhatə | Idempotency-Key | Sorğu / dəqiqə |
|---|---|---|---|---|
| GET | /series Nömrələmə seriyalarını siyahılayır | invoices:read | — | 120 |
4invoices API nədir
bash
curl -sS https://api.4invoices.net/v1/series \
-H "Authorization: Bearer $ACCESS_TOKEN"
# "fiscale" növündə ən azı bir AKTİV seriya olmalıdır, əks halda
# POST /invoices 409 no_series_configured qaytarır.https://api.4invoices.net/v1 · https://api.4invoices.net/v1/openapi.json
Xətalar
| Status | Növ | Kod |
|---|---|---|
| 409 | conflict_error | no_series_configured |
Ümumi səhvlər
- POST /v1/invoices cavabı series və number daşıyır — uzlaşma üçün hər ikisini qeyd edin.
- Storno seriyadan yeni nömrə istifadə edir; orijinal fakturanın nömrəsi heç vaxt təkrar istifadə olunmur.
- Proformalar fiskal seriyadan ayrı nömrələmə istifadə edir, buna görə fiskal nömrə xərcləmirlər.
- Nömrə formatını fərz etməyin: number-i tam ədəd yox, qeyri-şəffaf sətir kimi qəbul edin.
İnkişafçılar üçün suallar və cavablar
API vasitəsilə seriya yarada bilərəmmi?
Yox. API seriyaları yalnız oxuyur. Yaratmaq və aktivləşdirmək paneldə olur, çünki fiskal nömrələmə uyğunluq qərarıdır.
Bir neçə aktiv seriyam varsa nə olur?
Paneldə konfiqurasiya olunmuş defolt seriya istifadə olunur. Yaradılma qeyri-müəyyən seriyalar arasında özü seçim etmir.
Niyə no_series_configured 422 yox, 409-dur?
Bu hesab vəziyyətində ziddiyyətdir, göndərdiyiniz məlumatlarla bağlı problem yox. Yükünüz etibarlıdır; konfiqurasiya çatışmır.