1.1获取订单明细

优质

小牛编辑

118浏览

2023-12-01

本接口用于获取指定的订单详情。

订单id由平台通过推送接口向下推送，API模式收到推送消息后，需要根据消息中的订单id调用此接口获取订单详情。

DLL接口中已经封装好，向DLL主程序推送时已经准备好完整的订单详情数据，不需要单独调用此接口。

请求参数说明

参数	描述	必填	示例值	类型	最大长度
action	接口参数组	是		object
└action	需要调用的接口名称	是	do_get_order	string
get	GET参数组，本组参数需要参与签名	是		object
└id	订单id.由推送消息中获得相应订单id	是	8600032893	number	18
└getpay	获取订单支付信息，用于订单有支付时，一次性获取订单信息和支付信息	否	1	number
└invoice	设置该参数备注（ memo字段）与发票信息（ invoice字段）分别单独显示，不设置invoice参数，默认将发票和备注信息合并到（ memo字段）显示	否	1	number

请求示例

{
	"action": {
		"action": "do_get_order"
	},
	"get": {
		"id": "8600032893",
		"getpay": "1",
		"invoice": "1"
	}
}

响应参数说明

参数	描述	必填	示例值	类型	最大长度
status	返回状态。接口成功时为1，出错为0	是	1	number
id	订单的唯一编号	是	8600032893	number	18
count		否	2	number
date	订单业务日期	是	20190702	number
cust	客人姓名	否	张三丰	string
cate	订单业务分类	是	10=堂食，11=打包，12=预点，20=外卖，21=外卖自提	number
addr	订单地址（外卖业务）	否		string
other_pay_item	外卖平台参数信息	否		object
route	路线	否		string
rider_name	骑手名称	否		string
phone	客人手机号	否	13988888888	number
payid	支付单id。先付模式下订单已支付，会有订单 id。为0说明未支付（后付）。已支付外卖订单为1	否	8600426131	number
rider_phone	骑手电话	否		string
src	订单来源	否	wx，el=饿了么,mt=美团	string
num	订单序号	否	1	number
paytype	支付类型	是	1=货到付款，2=在线支付	number
pay_amt	外卖平台客人实付金额（外卖官方接口支持）	否		string
chucfs	出菜方式	否		string
mbaccid	微会员id	否	2060615	number
package_num		否		string
srcnum	订单流水号描述	否	微信#1	string
rider_id	菜品外部代码	否		string
wishtime	预约时间	否		string
cfmuser	确认人	否	支付下单	string
cfmtime	下单时间	否	2019-07-02 13:31:15	string
cfmcode	确认人工号	否		string
mbcardno	会员卡号	否	20606157	number
table	订单桌台名称	是		string
invoice	是否单独推送发票信息（设置该参数备注（ memo字段）与发票信息（ invoice字段）分别单独显示，不设置invoice参数，默认将发票和备注信息合并到（ memo字段）显示）	否		string
pscount	人数	否	9	number
state	订单状态	是	1	number
srcid	外卖平台订单号	否		string
type	类选	否	0=堂食，1=外卖	number
time	订单时间	否	2019-07-02 13:31:09	string
msid	订单门店编号，使用搬单功能时，有可能会推送多个门店的订单	是	6786	number
memo	订单备注	是	预点,尽快	string
mbid	平台id	否	6061522	number
list	订单中的明细列表	否		list
└qty	数量	是	1	number
└amt	金额	是	20	number
└rebate	折扣	是	100	number
└id	明细 id	是	1	number
└unit	单位	是		string
└name	名称	是	芋头奶茶	string
└memo	备注	是		string
└dgid	平台菜品id	是	4927381	number
└refid	门店菜品id	是		string
└parentid	套餐明细标识	否	0	number
└price	价格	是	20	number
└cartid	外卖平台订单口袋id	否	33	number
└cartname	外卖平台订单口袋名称	否	333333	number
└spec	外卖平台支持：菜品规格（开放需申请）	否	大份	string
└attrs	外卖平台支持：菜品属性（开放需申请）	否	加辣	string
└remark	外卖平台支持：菜品备注（开放需申请）	否	不加香菜	string
└dcid	菜品类别ID	否	22	number
└dcname	菜品类别名称	否	凉菜	string

响应示例

{
    "status": "1",
    "id": "8600032893",
    "count": "2",
    "date": "20190702",
    "cust": "张三丰",
    "cate": "12",
    "addr": "",
    "other_pay_item": [],
    "route": "",
    "rider_name": "",
    "phone": "13988888888",
    "payid": "8600426131",
    "rider_phone": "",
    "src": "wx",
    "num": 1,
    "paytype": "0",
    "pay_amt": "",
    "server_timestamp": 1566061006,
    "chucfs": "",
    "mbaccid": "2060615",
    "package_num": "",
    "srcnum": "微信#1",
    "rider_id": "",
    "wishtime": "",
    "cfmuser": "支付下单",
    "cfmtime": "2019-07-02 13:31:15",
    "cfmcode": "",
    "mbcardno": "20606157",
    "table": "",
    "server_time": "2019-08-18 00:56:46",
    "server_name": "wx-task2.hz",
    "invoice": "",
    "pscount": "9",
    "state": "1",
    "srcid": "",
    "type": "0",
    "time": "2019-07-02 13:31:09",
    "msid": "6786",
    "memo": "预点,尽快",
    "mbid": "6061522",
    "list": [
        {
            "qty": 1,
            "amt": 20,
            "rebate": "100",
            "id": "1",
            "unit": "",
            "name": "芋头奶茶",
            "memo": "",
            "spec": "大份",
            "attrs": "加辣",
            "remark": "不加香菜",
            "dgid": "4927381",
            "refid": "",
            "parentid": "0",
            "price": 20,
            "cartid": "33",
            "cartname": "333333",
            "dcid": "22",
            "dcname": "凉菜"
        },
        {
            "qty": 1,
            "amt": 2,
            "rebate": "100",
            "id": "2",
            "unit": "",
            "name": "泰国香米饭",
            "memo": "",
            "dgid": "4927382",
            "refid": "",
            "parentid": "0",
            "price": 2
        },
        {
            "qty": 9,
            "amt": 180,
            "rebate": "100",
            "id": "3",
            "unit": "位",
            "name": "茶位费",
            "memo": "",
            "dgid": 21,
            "refid": "99921",
            "parentid": "0",
            "price": 20
        },
        {
            "qty": 1,
            "amt": 4,
            "rebate": "100",
            "id": "4",
            "unit": "项",
            "name": "服务费",
            "memo": "+4",
            "dgid": 22,
            "refid": "99922",
            "parentid": "0",
            "price": 4
        },
        {
            "qty": 1,
            "amt": 12.3594,
            "rebate": "100",
            "id": "5",
            "unit": "项",
            "name": "税金",
            "memo": "22x6%",
            "dgid": 23,
            "refid": "99923",
            "parentid": "0",
            "price": 12.3594
        }
    ]
}

说明

外卖订单中的配送费与打包费的编码如下：

编码	名称
99901	配送费
99902	打包费
99911	外卖平台佣金
99912	外卖平台活动优惠
99913	口碑其他费用
99914	替用户承担配送费（新）
99921	餐位/茶位费
99922	消费服务费
99923	消费税金