Quy tắc hàng hóa

Quy tắc hàng hóa dùng để đổi mã hoặc tên sản phẩm từ website/phần mềm thành tên, mã hàng, đơn vị và thuế suất chuẩn trên hóa đơn.

Ví dụ, website gửi WOO_SKU_VPS-PRO, Pay2S có thể xuất thành:

Tên: Cước dịch vụ máy chủ ảo
Mã hàng: VPS
Đơn vị: Tháng
Thuế suất: 10%

Mã nguồn thường gặp

• Chọn Mã sản phẩm để cấu hình chính xác một sản phẩm.
• Chọn Mã nhóm sản phẩm để nhiều sản phẩm dùng chung một cách xuất.
• Chọn Tên sản phẩm khi hệ thống nguồn không có mã ổn định. Tên phải khớp toàn bộ; Pay2S bỏ khoảng trắng thừa và không phân biệt chữ hoa/thường, nhưng vẫn phân biệt dấu tiếng Việt.
• Trong cùng phạm vi và nguồn, thứ tự ưu tiên là Mã sản phẩm → Mã nhóm sản phẩm → Tên sản phẩm.

Cách ghép tên

• Chỉ dùng tên cấu hình: thay hoàn toàn tên nguồn gửi lên.
• Tên cấu hình + tên sản phẩm: ví dụ Cước máy chủ ảo PL1.
• Tên sản phẩm + tên cấu hình: đặt tên nguồn ở phía trước.

Nguồn tích hợp mặc định là any. Chỉ chọn một nguồn cụ thể khi cùng mã nhưng cần xử lý khác nhau giữa WHMCS, WooCommerce hoặc hệ thống khác.

Dữ liệu nên gửi lên

Mỗi dòng hàng nên có:

{
  "itemCode": "WOO_SKU_VPS-PRO",
  "itemGroupCode": "WOO_CATEGORY_12",
  "sourceProductName": "VPS PL1",
  "itemName": "VPS PL1",
  "unit": "Tháng",
  "quantity": 1,
  "unitPrice": 100000,
  "taxRate": 10
}

Tên khóa có thể khác theo module, nhưng mã sản phẩm, mã nhóm, tên gốc, số lượng, đơn giá và thuế suất cần được gửi nhất quán. Nếu không có itemCode, quy tắc theo tên sẽ dùng sourceProductName; khi trường này trống, Pay2S dùng itemName để đối chiếu.

Với hóa đơn bán hàng áp dụng giảm thuế theo Nghị quyết 204/2025/QH15, mỗi dòng đủ điều kiện có thể gửi thêm:

{
  "vatReductionEligible": true,
  "directVatRate": 5
}

directVatRate chỉ nhận 1, 2, 3 hoặc 5 và là tỷ lệ tính thuế GTGT trực tiếp trên doanh thu. Nếu không gửi hai trường này, quy tắc hàng hóa trên Pay2S vẫn có thể bổ sung tự động theo mã sản phẩm hoặc mã nhóm đã cấu hình.

Khi quy tắc thay đổi thuế

Số tiền đã thanh toán được xem là tổng cuối cùng. Khi quy tắc đổi thuế suất, Pay2S tự tính lại đơn giá trước thuế để tổng hóa đơn vẫn khớp số tiền khách đã trả.