秒付业务,下行接口收到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 | |
| └└└no_allow_mc_bonus | 不能使用卡赠送金额(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",
"no_allow_mc_bonus": "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 |