交班

收银员结束当前班次，生成交班记录。

请求接口

POST /open/cashier/shift_handover/handover

通用参数

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

请求参数

参数	必填	类型	说明
remark	否	String	交班备注

响应参数

交班成功后返回交班记录信息：

参数	类型	说明
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	笔数

请求示例

{
  "remark": "正常交班"
}

响应示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "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": "正常交班"
  }
}