2.2提交桌台账单
优质
小牛编辑
126浏览
2023-12-01
秒付业务,下行接口收到cash-request后(下行接口详见0.5),从业务系统中获取桌台账单,上传到服务端。
新版桌台码秒付时,生成的请求id为18位,请注意兼容性。
请求参数说明
参数 | 描述 | 必填 | 示例值 | 类型 | 最大长度 |
action | 接口参数组 | 是 | object | ||
└action | 需要调用的接口名称 | 是 | cash_post_bill | string | |
get | GET参数组,本组参数需要参与签名 | 是 | object | ||
└id | 支付流水id(cash-request推送) | 是 | 721386328601451823 | string | |
└state | 1:有账单,-1:未开台无账单 | 是 | 1 | number | |
└info | 当有结账错误时,返回错误信息。state非1时有效 | 是 | 无账单 | string | |
post | POST参数组 | 是 | object | ||
└data | 否 | object | |||
└└result | 否 | 1 | number | ||
└└id | 线下账单号 | 否 | 201411270006 | number | |
└└viewmode | 设置为1则表示账单还不能结算(不传或0为可以结算) | 否 | 0 | number | |
└└bill | 账单明细列表 | 否 | list | ||
└└└qty | 数量 | 否 | 11 | number | |
└└└amt | 金额 (amt=qty*price) | 否 | 33 | number | |
└└└name | 菜品名称 | 否 | 农夫山泉 | string | |
└└└desc | 单位描述 | 否 | 瓶/001 | string | |
└└└price | 单价 | 否 | 3 | number | |
└└└value | 原价 | 否 | 3 | number | |
└└└rebate | 设置为100表示这个菜品不打折(0或者不传为可以折扣) | 否 | 100 | number | |
└└└no_allow_pt | 不参与积分抵扣(1=不参与积分抵扣,其他/默认=参与积分抵扣) | 否 | 1 | number | |
└└└no_allow_co | 不参与优惠券抵扣(1=不参与优惠券抵扣,其他/默认=参与优惠券抵扣) | 否 | 1 | number |
请求示例
{ "action": { "action": "cash_post_bill" }, "get": { "id": "721386328601451823", "state": "1", "info": "无账单" }, "post": { "data": { "result": 1, "id": "201411270006", "viewmode": 0, "bill": [ { "qty": "11", "amt": "33", "name": "农夫山泉", "desc": "瓶/001", "price": "3", "value": "3", "no_allow_pt": "1", "no_allow_co": "1", "rebate": 100 }, { "qty": "11", "amt": "55", "name": "雪碧", "desc": "罐/001", "price": "5", "value": "5" } ] } } }
响应参数说明
参数 | 描述 | 必填 | 示例值 | 类型 | 最大长度 |
status | 返回状态。接口成功时为1,出错为0 | 是 | 1 | number | |
info | 错误时会返回相应的错误信息 | 是 | 提交成功 | string |
响应示例
{ "status": 1, "info": "提交成功" }
参数 | 参数名称 | 必填 | 描述 | 范例 |
---|---|---|---|---|
id | 账单号 | 否 | 会与支付单关联,方便查询 | 201411270006 |
bill | 账单明细列表 | 是 | 订单列表数组 | 数组 |
gdsid | 菜品编码 | 否 | 收银系统菜品编码 | 0051001 |
qty | 数量 | 是 | 数量 | 2 |
amt | 金额 | 是 | amt=qty*price | 22 |
desc | 单位描述 | 否 | 单位等信息 | 例 |
name | 名称 | 是 | 菜品名称、做法等 | 多宝鱼红绕 |
price | 单价 | 是 | 单价 | 28 |
value | 原价 | 否 | 如果price为特价、会员价等情况时,可以传原价 | 38 |