OMSOrder Promotion
Order Promotion Object Schema
Đối tượng đại diện cho thông tin khuyến mãi áp dụng trên đơn hàng
JSON Schema
| Trường (Field) | Kiểu (Type) | Mô tả (Description) |
|---|---|---|
id | int | ID bản ghi order promotion |
company_id | int | ID công ty (tenant) |
creator_id | int | ID người tạo |
sale_order_id | int | ID đơn hàng |
sale_order_detail_id | int | ID chi tiết đơn hàng (dòng sản phẩm) |
product_id | int | ID sản phẩm được áp dụng khuyến mãi |
product_variant_id | int | ID biến thể sản phẩm |
customer_id | int | ID khách hàng |
ymd | int | Ngày áp dụng (định dạng YYYYMMDD) |
promotion_id | int | ID chương trình khuyến mãi |
promotion_type | int | Loại khuyến mãi |
promotion_scope | int | Phạm vi khuyến mãi |
discount_amount | int | Số tiền giảm giá (VNĐ) |
coupon_code | string | Mã coupon đã sử dụng |
gift_uom_id | int | ID đơn vị tính quà tặng |
gift_uom_quantity | int | Số lượng quà tặng (theo UOM) |
gift_uom_unit_price | int | Đơn giá quà tặng (VNĐ) |
bonus_json | object | Dữ liệu chi tiết bonus (chứa thông tin promotion) |
snapshot_json | object | Snapshot dữ liệu promotion tại thời điểm áp dụng |
status | int | Trạng thái (xem bảng mã bên dưới) |
ip_address | string | Địa chỉ IP |
date_created | int | Thời gian tạo (UNIX timestamp) |
date_modified | int | Thời gian cập nhật (UNIX timestamp) |
Enriched fields
Khi gọi API List hoặc Detail, mỗi item sẽ được bổ sung thêm các trường sau:
| Trường (Field) | Kiểu (Type) | Mô tả (Description) |
|---|---|---|
promotion | object | null | Thông tin chương trình khuyến mãi (trích xuất từ bonus_json hoặc snapshot_json) |
customer | object | null | Thông tin khách hàng (id, full_name, phone) |
customer_name | string | Tên khách hàng |
customer_phone | string | Số điện thoại khách hàng |
Bảng mã trạng thái (Status)
| Giá trị | Key | Mô tả |
|---|---|---|
| 1 | STATUS_ENABLE | Hoạt động |
| 3 | STATUS_DISABLED | Vô hiệu hóa |
Ví dụ JSON object
{
"id": 5001,
"company_id": 10311,
"creator_id": 1,
"sale_order_id": 10002414,
"sale_order_detail_id": 30001,
"product_id": 123,
"product_variant_id": 456,
"customer_id": 101,
"ymd": 20260309,
"promotion_id": 200,
"promotion_type": 101,
"promotion_scope": 3,
"discount_amount": 98180,
"coupon_code": "",
"gift_uom_id": 0,
"gift_uom_quantity": 0,
"gift_uom_unit_price": 0,
"bonus_json": {
"promotion": {
"id": 200,
"name": "Giảm 5% đơn hàng",
"type": 101
}
},
"snapshot_json": {},
"status": 1,
"ip_address": "14.169.11.81",
"date_created": 1741500000,
"date_modified": 1741500000,
"promotion": {
"id": 200,
"name": "Giảm 5% đơn hàng",
"type": 101
},
"customer": {
"id": 101,
"full_name": "Hoàng Văn Hải",
"phone": "0909876543"
},
"customer_name": "Hoàng Văn Hải",
"customer_phone": "0909876543"
}