Quy tắc hàng hóa

Quy tắc hàng hóa dùng để đổi mã sản phẩm từ website hoặc 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

Nguồn	Mã sản phẩm	Mã nhóm
WHMCS	WHMCS_PRODUCT_12	WHMCS_GROUP_3
WooCommerce	WOO_SKU_VPS-PRO, WOO_PRODUCT_80	WOO_CATEGORY_12
HostBill	HOSTBILL_PRODUCT_35	HOSTBILL_CATEGORY_4
API riêng	API_PRODUCT_CLOUD_SERVER	API_GROUP_INFRASTRUCTURE

• 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.
• Nếu cả hai cùng khớp, quy tắc sản phẩm được ưu tiên.

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.

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ả.

Kiểm tra trước khi dùng tự động

Hãy thử ít nhất một sản phẩm thường, một sản phẩm giảm giá và một sản phẩm có chu kỳ nhiều tháng trên Sandbox.