关于我们

饿了么开放平台【接口变更】订单接口变更

发布时间:2022-02-13

 

个人零费用代理店+,日收入3000+,可兼职做

尊敬的开发者:

您好,因饿了么即将向商家和开发者开放套餐服务,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),请知晓。

 

 

接口详情可在接口上线后查看对应的接口文档,请各位开发者知悉并根据自己的业务需求做好对接。

 

/template/Home/AllNew/PC/Static