交班历史

分页查询交班历史记录。

请求接口

POST /open/cashier/shift_handover/history

通用参数

• 请求签名：Authorization Header，详见签名方法
• 客户端信息：Ikudot-Cashier-Client Header，详见客户端信息；收银员登录后 session 字段必填，详见收银员登录

请求参数

参数	必填	类型	说明
shift_no	否	String	班次编号
begin_time	否	String	开始时间，格式 yyyy-MM-dd HH:mm:ss
end_time	否	String	结束时间，格式 yyyy-MM-dd HH:mm:ss
page_num	否	Integer	页码，默认 1
page_size	否	Integer	每页条数，默认 20，最大 100

响应参数

分页对象，包含以下字段：

参数	类型	说明
page_num	Integer	当前页码
page_size	Integer	每页条数
total	Long	总条数
list	Array	记录列表

list 中每项结构

参数	类型	说明
shift_no	String	班次编号
shift_name	String	班次名称
cashier	Object	交班收银员
start_time	String	班次开始时间
end_time	String	班次结束时间
pay_summary	Array	收款汇总
refund_summary	Array	退款汇总
coupon_summary	Array	核销汇总
remark	String	交班备注

收银员结构（cashier）

参数	类型	说明
name	String	名称
employee_no	String	工号

汇总项结构（AmountSummaryItem）

备注

汇总数组的第一项为总汇总项(code: "ALL")，后续项为按支付方式的分类汇总。

参数	类型	说明
code	String	汇总项编码，如 ALL、WXPAY
name	String	汇总项名称
amount	Long	金额（分）
count	Long	笔数

请求示例

{
  "begin_time": "2026-05-01 00:00:00",
  "end_time": "2026-05-07 23:59:59",
  "page_num": 1,
  "page_size": 20
}

响应示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "page_num": 1,
    "page_size": 20,
    "total": 1,
    "list": [
      {
        "shift_no": "SHIFT20260507001",
        "shift_name": "早班",
        "cashier": {
          "name": "张三",
          "employee_no": "EMP001"
        },
        "start_time": "2026-05-07 08:00:00",
        "end_time": "2026-05-07 16:00:00",
        "pay_summary": [
          { "code": "ALL", "name": "汇总", "amount": 50000, "count": 25 },
          { "code": "WXPAY", "name": "微信支付", "amount": 30000, "count": 15 },
          { "code": "ALIPAY", "name": "支付宝", "amount": 20000, "count": 10 }
        ],
        "refund_summary": [
          { "code": "ALL", "name": "汇总", "amount": 500, "count": 1 },
          { "code": "WXPAY", "name": "微信支付", "amount": 500, "count": 1 }
        ],
        "coupon_summary": [
          { "code": "ALL", "name": "汇总", "amount": 2000, "count": 5 }
        ],
        "remark": "正常交班"
      }
    ]
  }
}