8.1门店账单数据上传

此接口用于上传老板通营业订单数据

支持单条上传和批量上传

对于非点菜消费数据(如会员卡充值)的上传:

此类无消费的数据也可以通过此接口上传,此类数据中只需要有pay项目的内容,而item项目为空。

并且为了区分此单据类型,增加type属性来区分,目前有两种:do:点菜单据,mc:会员充值单据

针对非正常点菜信息的识别(如退单、赠送):

系统规则是当数量qty为负数则识别为退单,

当金额amt为零则识别为赠送。(注意赠送记录数量不能为零,价格最好传菜品的原价,以用于统计赠送菜品的金额)

识别后的退单、赠送菜品信息会统计到相应报表中


 原则:
1.菜品单价*数量=金额

2.菜品金额合计=付款金额合计

  请求参数说明

参数描述必填示例值类型最大长度
action接口参数组object
└action需要调用的接口名称du_put_billstring
postPOST参数组object
└bill账单数据object
└└date账单业务日期20151228number
└└time账单实际日期_时间20151229_010108string
└└table桌台号88number
└└type账单类型dostring
└└pscount人数3number
└└bzid账单业务单号(必须保证唯一,相同bzid上传以最后数据为准)201512280008number
└└item菜品列表list
└└└gdsid菜品编号0001050number
└└└name菜品名称红烧大排翅string
└└└qty数量1number
└└└price单价188number
└└└amt金额小计=qty*price188number
└└└ctid分类编号01001number
└└└ctname分类名称燕鲍翅string
└└└unit单位string
└└└isfree是否赠送1=赠送,-1=非赠送。默认为根据amt=0判断为赠送1number
└└pay账单付款项目列表list
└└└code付款科目代码xjstring
└└└name付款科目名称现金string
└└└amt付款金额180number
└└└discount用于标示非实收科目,0=实收科目,1=非实收科目0number

 请求示例

{
	"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,出错为01number
info错误时会返回相应的错误信息保存成功;string
success上传成功账单号列表0001201601130006=45982,0001201601130008=49983string
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",
   .....

    },

]


批量上传示例
{
  "action": {
    "action": "du_put_bill"
  },
  "post": {
    "list": [
      {
        "pay": [
          {
            "amt": 116,
            "name": "现金",
            "code": "CA"
          }
        ],
        "table": "A08",
        "pscount": 5,
        "type": "do",
        "time": "121221",
        "item": [
          {
            "qty": 1,
            "amt": 48,
            "ctname": "1中餐类",
            "isfree": "-1",
            "gdsid": "000100776",
            "unit": "份",
            "name": "西芹百合炒腰果(大)",
            "ctid": "00010002",
            "price": 48
          },
          {
            "qty": 1,
            "amt": 68,
            "ctname": "1中餐类",
            "isfree": "-1",
            "gdsid": "000100779",
            "unit": "份",
            "name": "溜肚片",
            "ctid": "00010002",
            "price": 68
          }
        ],
        "date": "20210630",
        "bzid": "0004202106300003"
      },
      {
        "pay": [
          {
            "amt": 164,
            "name": "现金",
            "code": "CA"
          }
        ],
        "table": "A08",
        "pscount": 4,
        "type": "do",
        "time": "121416",
        "item": [
          {
            "qty": 1,
            "amt": 28,
            "ctname": "1中餐类",
            "isfree": "-1",
            "gdsid": "000100286",
            "unit": "份",
            "name": "鱼头豆腐汤",
            "ctid": "00010002",
            "price": 28
          },
          {
            "qty": 1,
            "amt": 25,
            "ctname": "1中餐类",
            "isfree": "-1",
            "gdsid": "000100406",
            "unit": "份",
            "name": "清炒莴笋",
            "ctid": "00010002",
            "price": 25
          },
          {
            "qty": 1,
            "amt": 28,
            "ctname": "1中餐类",
            "isfree": "-1",
            "gdsid": "000100277",
            "unit": "份",
            "name": "苦瓜炒牛肉",
            "ctid": "00010002",
            "price": 28
          },
          {
            "qty": 1,
            "amt": 38,
            "ctname": "1中餐类",
            "isfree": "-1",
            "gdsid": "000100276",
            "unit": "份",
            "name": "泡椒牛肉",
            "ctid": "00010002",
            "price": 38
          },
          {
            "qty": 1,
            "amt": 45,
            "ctname": "1中餐类",
            "isfree": "-1",
            "gdsid": "000100275",
            "unit": "份",
            "name": "辣子鸡",
            "ctid": "00010002",
            "price": 45
          }
        ],
        "date": "20210630",
        "bzid": "0004202106300004"
      }
    ]
  }
}