16.1账单数据同步

  请求参数说明

参数描述必填示例值类型最大长度
action接口参数组是object
└action需要调用的接口名称是do_sync_billstring
postPOST参数组是object
└bill账单否object
└└cate账单明细类型[10=店内就餐,11=打包带走,12=预定,20=配送,21=自提,22=配送点配送]是10number
└└table桌台名称是100number
└└state状态[9=已完成,30=已开台,32=用餐中,50=支付中(封账),-1=已取消]是30string
└└time创建时间是2023-01-01 00:00:00string
└└realTime真实日期否2023-01-01 00:00:00string
└└pepole用餐人数是1string
└└remark备注否string
└└src来源[wx=微信,ali=支付宝,mt=美团,el=饿了么,dy=抖音,jd=京东]是wxstring
└└srcId来源ID, 对应平台的订单ID否string
└└payTime支付时间否2023-01-01 00:00:00string
└└completeTime完成时间否2023-01-01 00:00:00string
└└parentBizId父线下账单ID(有连台时传)否string
└└orders订单信息否list
└└└orderId订单ID(和orderBizId二选一)是186260010000000002string
└└└orderBizId线下订单ID(和orderId二选一)是string
└└└time下单时间是2023-01-01 00:00:00string
└└└items明细信息否list
itemId明细ID是186260017000000002string
itemBizId线下明细ID是string
goodsId菜品ID(和goodsBizId二选一)是10000001string
goodsBizId线下菜品ID(和goodsId二选一)是string
name菜品名称是柠檬水string
price售价是4number
oprice原价否5number
priceType特价类型[0=普通,1=会员价,2=时特价,3=活动价]否1string
qty数量是1number
unit单位是件string
state状态[1=已下单,5=制作中,8=制作完成,10=已上菜]是1string
chucfs出餐方式[0=即,1=叫,2=急,3=加]否0string
parentItemBizId父级线下明细ID[0=单菜品,-1=套餐头,>0=套餐子菜品]是0string
attr商品属性否list
name属性类型否加料string
value属性名称否珍珠string
add属性加价否1string
└└realDate否2023-01-01string
└└billId否186260016000000002number
└└billBizId否10202601010001number
└└mealId否1001number
└└menuId否2001number
└└accId否1001number
└└waiterId否1001number
└└operatorId否1001number
└└bkId否1001number
remarkQty否1number
└└pay否object
└└└payId否186260018000000002number
└└└payBizId否20202601010001number
└└└payTime否2023-01-01 00:00:00string
└└└payItems否list
payItemId否186260019000000002number
payItemBizId否21202601010001number
payCode否wxstring
payAmt否4number

 请求示例

{
    "action": {
        "action": "do_sync_bill"
    },
    "post": {
        "bill": {
            "billId": "",
            "billBizId": "10202601010001",
            "cate": "10",
            "table": "100",
            "state": "30",
            "time": "2023-01-01 00:00:00",
            "realDate": "2023-01-01",
            "pepole": "1",
            "remark": "",
            "src": "wx",
            "srcId": "",
            "completeTime": "2023-01-01 00:00:00",
            "parentBizId": "",
            "mealId": "1001",
            "menuId": "2001",
            "accId": "1001",
            "waiterId": "1001",
            "operatorId": "1001",
            "bkId": "1001",
            "orders": [
                {
                    "orderId": "186260010000000002",
                    "orderBizId": "11202601010001",
                    "time": "2023-01-01 00:00:00",
                    "terminalNo": "1001",
                    "waiterId": "1001",
                    "remark": "",
                    "isPrint": "0",
                    "items": [
                        {
                            "itemId": "",
                            "itemBizId": "12202601010001",
                            "goodsId": "",
                            "goodsBizId": "10000001",
                            "name": "柠檬水",
                            "price": "4",
                            "oprice": "5",
                            "priceType": "1",
                            "qty": "1",
                            "unit": "杯",
                            "state": "1",
                            "chucfs": "0",
                            "parentItemBizId": "",
                            "remarkQty": "1",
                            "sourceBizId": "",
                            "remark": "",
                            "attr": [
                                {
                                    "name": "加料",
                                    "value": "珍珠",
                                    "add": "1"
                                }
                            ]
                        }
                    ]
                }
            ],
            "pay": {
                "payId": "186260018000000002",
                "payBizId": "20202601010001",
                "payTime": "2023-01-01 00:00:00",
                "payItems": [
                    {
                        "payItemId": "186260019000000002",
                        "payItemBizId": "21202601010001",
                        "payCode": "wx",
                        "payAmt": "4"
                    }
                ]
            }
        }
    }
}

  响应参数说明

参数描述必填示例值类型最大长度
status返回状态。接口成功时为1，出错为0是1number
info错误时会返回相应的错误信息是提交成功string
id账单ID否186260016000000002number
msid门店ID否10021number
bill否object
└billId否10202601010001number
└billBizId否10202601010001number
└orders否list
└└orderId否186260010000000002number
└└orderBizId否11202601010001number
└└items否list
└└└itemId否186260017000000002number
└└└itemBizId否12202601010001number
└pay否object
└└payId否186260018000000002number
└└payBizId否20202601010001number
└└payItems否list
└└└payItemId否186260019000000002number
└└└payItemBizId否21202601010001number

 响应示例

{
    "status": "1",
    "info": "提交成功",
    "server_timestamp": 1567480027,
    "server_time": "2019-09-03 11:07:07",
    "server_name": "api-105.hz",
    "msid": "10021",
    "bill": {
        "billId": "10202601010001",
        "billBizId": "10202601010001",
        "orders": [
            {
                "orderId": "186260010000000002",
                "orderBizId": "11202601010001",
                "items": [
                    {
                        "itemId": "186260017000000002",
                        "itemBizId": "12202601010001"
                    }
                ]
            }
        ],
        "pay": {
            "payId": "186260018000000002",
            "payBizId": "20202601010001",
            "payItems": [
                {
                    "payItemId": "186260019000000002",
                    "payItemBizId": "21202601010001"
                }
            ]
        }
    }
}