饿了么开放平台【接口变更】订单接口变更
尊敬的开发者:
您好,因饿了么即将向商家和开发者开放套餐服务,4月底将对部分订单接口做改造优化增加套餐商品信息,改造信息如下:
(一)、订单结构体OOrder中的OGoodsGroup中的OGoodsItem中新增套餐ID字段「uniqueId」和套餐子商品结构字段「foodGroup」,结构如下:
{
"name":"xxx",
"items":[
{
"uniqueId":"adfasf",
"foodGroup":[
[
{
"groupId":12345,
"id":123,
"quantity":1,
"skuId":"12",
"name":"xxx",
"newSpecs":[
],
"attrs":[
]
},
{
"groupId":12345,
"id":456,
"quantity":1,
"skuId":"34",
"name":"xxx",
"newSpecs":[
],
"attrs":[
]
}
]
]
}
]
}
改动涉及以下消息类型和接口:
type = 10 新订单消息
eleme.order.getOrder 获取订单
eleme.order.mgetOrders 批量获取订单
eleme.order.getAllOrders 查询全部订单
字段使用说明:
(1)uniqueId代表主商品的套餐ID,调用部分退款接口时传入;
(2)foodGroup字段,是个双层List结构,代表选择的套餐子商品结构,举个例子:一个套餐,主食可选:米饭、馒头,饮料可选可乐、雪碧,小菜可多选:榨菜、萝卜,则foodGroup结构为:
[
[
{
"name":"米饭",
"quantity":1
}
],
[
{
"name":"可乐",
"quantity":1
}
],
[
{
"name":"榨菜",
"quantity":1
},
{
"name":"萝卜",
"quantity":1
}
]
]
其中skuId是套餐子商品的skuId,name为套餐子商品的名称,建议展示套餐名称时,用foodGroup中的name字段拼接,如套餐[米饭+可乐+榨菜+萝卜]。
(二)、因饿了么向商家开放套餐服务,对套餐商品进行结构化处理,导致同一个主商品,不同子商品的2个套餐的主sku是一样的,若退款时只传skuId会存在不知道具体退哪个套餐的情况,为了明确商家退款的商品是哪个套餐,平台将于4月底在「eleme.order.refundPart 商家部分退款」接口内新增uniqueId入参字段,用于传递商品的uniqueId(套餐ID),请知晓。
接口详情可在接口上线后查看对应的接口文档,请各位开发者知悉并根据自己的业务需求做好对接。