Dãy số hóa đơn trong API

Nếu không có dãy số đang hoạt động thuộc loại fiscale, việc phát hành trả về 409 no_series_configured.

Hóa đơn đầu tiên trong 6 bước

GET /v1/series liệt kê các dãy số được cấu hình cho tenant.
Việc phát hành cần ít nhất một dãy số ĐANG HOẠT ĐỘNG thuộc loại fiscale.
Nếu không có, POST /v1/invoices trả về 409 no_series_configured.
Dãy số được tạo và kích hoạt trong bảng điều khiển, không qua API.

Mọi endpoint

Phương thức	Endpoint	Scope	Idempotency-Key	Yêu cầu / phút
GET	/series Liệt kê dãy số	invoices:read	—	120

API 4invoices là gì

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

# Phải có ít nhất MỘT dãy số ĐANG HOẠT ĐỘNG thuộc loại "fiscale", nếu không
# POST /invoices sẽ trả về 409 no_series_configured.

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

Lỗi

Trạng thái	Loại	Mã
409	conflict_error	no_series_configured

Lỗi thường gặp

Phản hồi của POST /v1/invoices chứa series và number — hãy ghi lại cả hai để đối soát.
Storno lấy một số mới từ dãy số; số của hóa đơn gốc không bao giờ được dùng lại.
Hóa đơn proforma dùng cách đánh số tách biệt với dãy số tài chính, nên không tiêu tốn số tài chính nào.
Đừng giả định về định dạng số: hãy coi number là một chuỗi không rõ cấu trúc, không phải số nguyên.

Câu hỏi và trả lời cho nhà phát triển

Tôi có thể tạo dãy số qua API không?

Không. API chỉ đọc dãy số. Việc tạo và kích hoạt diễn ra trong bảng điều khiển, vì việc đánh số hóa đơn tài chính là một quyết định tuân thủ pháp luật.

Nếu tôi có nhiều dãy số đang hoạt động thì sao?

Dãy số mặc định được cấu hình trong bảng điều khiển sẽ được dùng. Việc phát hành không tự chọn giữa các dãy số mơ hồ.

Vì sao no_series_configured là 409 chứ không phải 422?

Đó là xung đột trạng thái tài khoản, không phải vấn đề với dữ liệu bạn gửi. Yêu cầu của bạn hợp lệ; thiếu là phần cấu hình.

Xem thêm