Đánh số Hóa đơn
Tổng quan
Việc đánh số hóa đơn là phía nhà cung cấp. Số hóa đơn tuần tự (số hóa đơn) được VNPAY (viiAPI) cấp phát và trả về cho BANA trong phản hồi phát hành. @nx/invoice không bao giờ sinh hay giữ chỗ số ở nội bộ - không có bộ đếm nội bộ (không có chuỗi Redis, không theo dõi khoảng trống/đối soát).
Đầu vào đánh số duy nhất BANA cung cấp là invoiceSymbol (số serial / ký hiệu), đọc từ cấu hình nhà cung cấp của merchant. VNPAY gán số kế tiếp trong ký hiệu đó và trả về; BANA lưu lại.
@nx/invoice làm gì
| Vấn đề | Chủ thể | Chi tiết |
|---|---|---|
Số tuần tự (số hóa đơn) | VNPAY (nhà cung cấp) | Cấp phát phía nhà cung cấp, trả về trong phản hồi phát hành |
invoiceSymbol (ký hiệu) | @nx/invoice (gửi) | Đọc từ TInvoiceProviderConfig.invoiceSymbol, đặt vào request JSON bởi _buildInvoiceRequest |
| Số trả về | @nx/invoice (lưu) | response.data.invoiceNumber lưu trên bản ghi Invoice |
| Toàn vẹn dãy / khoảng trống | VNPAY + GDT | Đảm bảo phía nhà cung cấp; không theo dõi trong BANA |
Luồng cấp phát
Ký hiệu hóa đơn (ký hiệu)
Ký hiệu do GDT quy định và lưu trong cấu hình nhà cung cấp của merchant; BANA chuyển tiếp nguyên trạng. Đây là trường đánh số duy nhất BANA gửi.
[Vị trí 1][Năm 2 chữ số][Loại mẫu][Chữ serial]
Ví dụ: C25TAA
C = Do doanh nghiệp phát hành (T = do cơ quan thuế sinh)
25 = Năm 2025
T = Loại hóa đơn điện tử (G = hóa đơn GTGT)
AA = Serial (merchant đặt, đăng ký với GDT)