8.1门店账单数据上传
优质
小牛编辑
128浏览
2023-12-01
此接口用于上传老板通营业订单数据
支持单条上传和批量上传
对于非点菜消费数据(如会员卡充值)的上传:
此类无消费的数据也可以通过此接口上传,此类数据中只需要有pay项目的内容,而item项目为空。
并且为了区分此单据类型,增加type属性来区分,目前有两种:do:点菜单据,mc:会员充值单据
针对非正常点菜信息的识别(如退单、赠送):
系统规则是当数量qty为负数则识别为退单,
当金额amt为零则识别为赠送。(注意赠送记录数量不能为零,价格最好传菜品的原价,以用于统计赠送菜品的金额)
识别后的退单、赠送菜品信息会统计到相应报表中
原则:
1.菜品单价*数量=金额
2.菜品金额合计=付款金额合计
请求参数说明
参数 | 描述 | 必填 | 示例值 | 类型 | 最大长度 |
action | 接口参数组 | 是 | object | ||
└action | 需要调用的接口名称 | 是 | du_put_bill | string | |
post | POST参数组 | 是 | object | ||
└bill | 账单数据 | 否 | object | ||
└└date | 账单业务日期 | 是 | 20151228 | number | |
└└time | 账单实际日期_时间 | 是 | 20151229_010108 | string | |
└└table | 桌台号 | 是 | 88 | number | |
└└type | 账单类型 | 是 | do | string | |
└└pscount | 人数 | 是 | 3 | number | |
└└bzid | 账单业务单号(必须保证唯一,相同bzid上传以最后数据为准) | 是 | 201512280008 | number | |
└└item | 菜品列表 | 否 | list | ||
└└└gdsid | 菜品编号 | 否 | 0001050 | number | |
└└└name | 菜品名称 | 否 | 红烧大排翅 | string | |
└└└qty | 数量 | 否 | 1 | number | |
└└└price | 单价 | 否 | 188 | number | |
└└└amt | 金额小计=qty*price | 否 | 188 | number | |
└└└ctid | 分类编号 | 否 | 01001 | number | |
└└└ctname | 分类名称 | 否 | 燕鲍翅 | string | |
└└└unit | 单位 | 否 | 例 | string | |
└└└isfree | 是否赠送1=赠送,-1=非赠送。默认为根据amt=0判断为赠送 | 否 | 1 | number | |
└└pay | 账单付款项目列表 | 否 | list | ||
└└└code | 付款科目代码 | 否 | xj | string | |
└└└name | 付款科目名称 | 否 | 现金 | string | |
└└└amt | 付款金额 | 否 | 180 | number | |
└└└discount | 用于标示非实收科目,0=实收科目,1=非实收科目 | 否 | 0 | number |
请求示例
{ "action": { "action": "du_put_bill" }, "post": { "bill": { "date": "20151228", "time": "20151229_010108", "table": "88", "type": "do", "pscount": "3", "bzid": "201512280008", "item": [{ "gdsid": "0001050", "name": "红烧大排翅", "qty": "1", "price": "188", "amt": "188", "ctid": "01001", "ctname": "燕鲍翅", "unit": "例", "isfree": "1" }], "pay": [{ "code": "xj", "name": "现金", "amt": "180", "discount": 0 }, { "code": "zk", "name": "折扣", "amt": "8", "discount": "1" } ] } } }
响应参数说明
参数 | 描述 | 必填 | 示例值 | 类型 | 最大长度 |
status | 返回状态。接口成功时为1,出错为0 | 是 | 1 | number | |
info | 错误时会返回相应的错误信息 | 是 | 保存成功; | string | |
success | 上传成功账单号列表 | 否 | 0001201601130006=45982,0001201601130008=49983 | string | |
error | 上传失败账单号列表 | 否 | 0001201601130007=出错 | string |
响应示例
{ "status": "1", "info": "保存成功;", "success": "0001201601130006=45982,0001201601130008=49983", "error": "0001201601130007=出错" }
批量上传:可以使用list参数将一批账单一起上传。每条订单内容与上面bill参数中一样。一次最多不超过100条。
list=[{
"date": "20151228",
"time": "20151229_010108",
"table": "88",
"bzid": "201512280008",
.....
},
{
"date": "20151228",
"time": "20151229_010136",
"table": "99",
"bzid": "201512280009",
.....
},
]