Tanpa seri aktif berjenis fiscale, penerbitan mengembalikan 409 no_series_configured.
Faktur pertama Anda dalam 6 langkah
- GET /v1/series mendaftar seri penomoran yang dikonfigurasi untuk tenant.
- Penerbitan memerlukan minimal satu seri AKTIF berjenis fiscale.
- Tanpa itu, POST /v1/invoices mengembalikan 409 no_series_configured.
- Seri dibuat dan diaktifkan di panel, bukan melalui API.
Semua endpoint
| Metode | Endpoint | Scope | Idempotency-Key | Permintaan / menit |
|---|---|---|---|---|
| GET | /series Daftar seri penomoran | invoices:read | — | 120 |
Apa itu API 4invoices
bash
curl -sS https://api.4invoices.net/v1/series \
-H "Authorization: Bearer $ACCESS_TOKEN"
# Minimal satu seri AKTIF berjenis "fiscale" harus ada, jika tidak
# POST /invoices mengembalikan 409 no_series_configured.https://api.4invoices.net/v1 · https://api.4invoices.net/v1/openapi.json
Error
| Status | Tipe | Kode |
|---|---|---|
| 409 | conflict_error | no_series_configured |
Kesalahan umum
- Respons POST /v1/invoices membawa series dan number — catat keduanya untuk rekonsiliasi.
- Storno mengambil nomor baru dari seri; nomor faktur asli tidak pernah dipakai ulang.
- Proforma menggunakan penomoran yang terpisah dari seri fiskal, sehingga tidak menghabiskan nomor fiskal.
- Jangan berasumsi tentang format nomor: perlakukan number sebagai string buram, bukan bilangan bulat.
Tanya jawab untuk pengembang
Bisakah saya membuat seri melalui API?
Tidak. API hanya membaca seri. Pembuatan dan aktivasinya dilakukan di panel, karena penomoran fiskal adalah keputusan kepatuhan.
Bagaimana jika saya punya beberapa seri aktif?
Seri default yang dikonfigurasi di panel yang digunakan. Penerbitan tidak memilih sendiri di antara seri yang ambigu.
Mengapa no_series_configured 409 dan bukan 422?
Itu konflik status akun, bukan masalah pada data yang Anda kirim. Muatan Anda valid; konfigurasinya yang belum ada.