Loyalty Point Redeem Object Schema

JSON Schema

Trường (Field)	Kiểu (Type)	Mô tả (Description)
`id`	int	ID giao dịch trừ điểm
`company_id`	int	ID công ty
`creator_id`	int	ID người tạo
`customer_id`	int	ID khách hàng bị trừ điểm
`type`	int	Phân loại giao dịch (xem constants)
`mode`	int	Cách tạo giao dịch (xem constants)
`external_id`	string	Mã tham chiếu ngoài hệ thống
`total_points_before`	int	Tổng điểm khả dụng của khách hàng trước khi trừ
`points_redeemed`	int	Số điểm thực tế bị trừ
`points_value`	int	Giá trị quy đổi ra tiền (VND)
`source_id`	int	ID nguồn phát sinh (ví dụ: ID đơn hàng)
`count_earn`	int	Số lô tích điểm (`LoyaltyPointEarn`) bị ảnh hưởng khi trừ theo FIFO
`note`	string	Ghi chú
`data`	string	Dữ liệu mở rộng
`ip_address`	string	Địa chỉ IP khi tạo giao dịch
`date_created`	int	Thời gian tạo (UNIX timestamp)
`date_modified`	int	Thời gian cập nhật (UNIX timestamp)
`date_redeemed`	int	Thời gian đổi điểm (UNIX timestamp)
`enrich_customer_full_name`	string	Tên khách hàng (chỉ có ở response list/detail, dùng để hiển thị)

Ví dụ JSON object

{
  "id": 902,
  "company_id": 10311,
  "creator_id": 1,
  "customer_id": 8801,
  "type": 3,
  "mode": 1,
  "external_id": "",
  "total_points_before": 450,
  "points_redeemed": 100,
  "points_value": 100000,
  "source_id": 556677,
  "count_earn": 2,
  "note": "",
  "data": "",
  "ip_address": "103.21.45.10",
  "date_created": 1772870400,
  "date_modified": 1772870400,
  "date_redeemed": 1772870400,
  "enrich_customer_full_name": "Nguyễn Văn A"
}

Response khi tạo mới (POST)

Khi gọi POST /v1/loyaltypointredeems hoặc POST /v1/loyaltypointredeems/fromorder, response trả về object kết quả xử lý FIFO (khác schema object ở trên):

Trường	Kiểu	Mô tả
`customer_available_points`	int	Tổng điểm khả dụng trước khi trừ
`redeem_points`	int	Số điểm yêu cầu trừ
`redeem_id`	int	ID giao dịch trừ điểm vừa tạo
`redeem_details`	array	Chi tiết phân bổ điểm theo từng lô tích (`earn_id`, `used`)
`updated_batches`	array	Danh sách lô tích điểm sau khi cập nhật `points_remaining`
`ledger`	array	Sổ cái FIFO mô tả luồng trừ điểm

Loyalty Point Redeem Object Schema

JSON Schema

Ví dụ JSON object

Response khi tạo mới (POST)

On this page