8.1门店账单数据上传

优质

小牛编辑

125浏览

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",
.....

]