Get Points Usage Records

Description

取得點數使用紀錄。

Resource

GET /v1/points_usage_records

Authorization

採用 OAuth 2.0 Bearer Token，詳細使用流程請參考 Auth Login。

Query Parameters

Name	Type	Description
start_date	string	開始日期 (例：2020-08-14 12:00:00)
end_date	string	結束日期 (例：2020-08-14 23:59:59)
store_id	string	門市代碼 (optional)
time_sort	string (enum)	時間排序 ALLOWED VALUES: DEFAULT ASCEND DESCEND (optional)

Request Example

GET /v1/points_usage_records?start_date=2020-06-04 12:12:12&end_date=2020-09-04 23:12:12

Response

{
    "logs": [
    {
        "bonuspt_point": 50,
        "date_time": "2020-09-01T10:17:59",
        "gift_give": false,
        "member_name": "ming",
        "order_amount": "200",
        "order_id": "MCSF0220090400024",
        "point_type": "exchange_goods",
        "shop_name": "左營文天",
        "point_memo": "測試",
        "use_point_instructions": "使用點數說明"
    },
    {
        "bonuspt_point": 50,
        "date_time": "2020-09-01T10:16:00",
        "gift_give": false,
        "member_name": "ming",
        "order_amount": "200",
        "order_id": "MCSF0220090400024",
        "point_type": "exchange_goods_sell_back",
        "store_name": "左營文天",
        "point_memo": "測試",
        "use_point_instructions": "使用點數說明"
    }
  ],
  "points_expire": [
        {
            "dead_line": "2022-05-02T23:59:59",
            "expired_point": 201
        }
    ]
}

Response Body

Name	Type	Description
logs	Log	異動紀錄
points_expire	PointsExpire	即將到期點數

Response Body Parameters - PointsExpire

Name	Type	Description
dead_line	string	到期日期
expired_point	int	即將到期點數

Response Body Parameters - Log

Name	Type	Description
bonuspt_point	int	紅利點數
date_time	string	發生時間
gift_give	bool	是否贈送
member_name	string	會員姓名
order_amount	string	訂單金額
order_id	string	訂單編號
point_type	PointType	點數狀態
store_name	string	門市名稱
point_memo	string	點數備註
use_point_instructions	string	點數使用說明

Response Body Parameters - PointType

Name	Description
new_consumption	消費新增
sales_return_reduction	銷退返還
exchange	點數兌換
exchange_sell_back	點數兌換銷退
transfer_out	點數轉出
transfer_in	點數轉入
activity_deduction_points	活動扣點
activity_accumulated_points	活動累點
zero	點數歸零