饿了么开放平台消息推送消息体结构定义
订单消息1.请参阅OOrder结构体定义,获取订单接口 eleme.order.getOrder2.OOrder.groups.items中name = 商品名称-规格[属性+属性+..] = name-newSpecs.name[attributes.name+attributes.name+...],示例: 厚芋泥波波奶茶-大杯(蔗糖换0卡糖)[少冰+五分糖]
订单状态变更消息订单状态变更结构体说明:
字段名 | 字段类型 | 字段说明 |
---|---|---|
orderId | String | 订单号 |
state | String | 订单状态,参见OOrder结构体的OOrderStatus枚举定义 |
shopId | Number | 店铺id |
updateTime | Number | 状态变更的时间戳,单位秒 |
role | Number | 驱动状态发生变更的操作者角色 |
role角色定义如下:
角色 | 常量值 |
---|---|
下单用户 | 1 |
饿了么系统 | 2 |
饿了么商户 | 3 |
饿了么客服 | 4 |
饿了么开放平台系统 | 5 |
饿了么短信系统 | 6 |
饿了么无线打印机系统 | 7 |
饿了么风控系统 | 8 |
饿了么订单完结 | 9 |
完整的推送消息示例:{ "appId":62933118, "requestId": "10135", "type": 12, "message": "{\"orderId\":\"100027500485933656\",\"state\":\"settled\",\"shopId\":968861,\"updateTime\":1482161481,\"role\":3}", "shopId": 968861, "timestamp": 1482161482053, "signature": "A6A1E1FD9D880E184EEC8BFF19DE45D6", "userId": 62864532 }
取消单退单消息取消单退单消息结构体说明:
字段名 | 字段类型 | 字段说明 |
---|---|---|
orderId | String | 订单号 |
refundStatus | String | 退单状态,参见OOrder结构体中的OOrderRefundStatus退单状态枚举定义 |
reason | String | 退单操作原因描述 |
shopId | Number | 店铺id |
goodsList | List | 退单商品列表,参考ORefundOrder结构体中的goodsList定义 |
refundType | String | 退单类型,参见ORefundType退单类型状态枚举定义 |
totalPrice | Double | 退款金额 |
updateTime | Number | 消息发送时间戳,单位秒 |
完整的推送消息示例:
{ "appId":62933118, "requestId": "7637", "type": "30", "message": "{\"orderId\":\"1201961795738011871\",\"refundStatus\":\"applied\",\"reason\":\"用户申请退单\",\"shopId\":150008082,\"updateTime\":1508419376,\"refundType\":\"normal\",\"totalPrice\":16.03,\"goodsList\":[{\"name\":\"黑椒牛柳意大利面[重辣]\",\"quantity\":1,\"price\":5.0},{\"name\":\"冰糖雪梨\",\"quantity\":1,\"price\":0.03},{\"name\":\"狮子头\",\"quantity\":1,\"price\":5.0},{\"name\":\"奶茶[去冰+半塘]\",\"quantity\":2,\"price\":3.0}]}", "shopId": 150008082, "timestamp": 1481694496373, "signature": "A1178A435FB4D4DFE239747E03CC81A4", "userId": 62864532 }
商户售中部分取消(type=39)
使用场景:商家缺货可以选择售中部分取消,饿了么测试/沙箱店铺不支持售中部分退。正式环境线上店铺可以找饿了么业务经理帮忙配置的,配置后即支持部分退。
{ "signature": "3226101BE96F215D80834C86EC330B10", "requestId": "2306272810468325256", "appId": 69259646, "shopId": 510198800, "type": 39, "message": "{\"goodsList\":[{\"name\":\"香辣嗦螺-约500g\",\"price\":12.32,\"quantity\":1,\"skuId\":\"300000********3340\",\"uniqueId\":\"1c1176fd5-****-****-8226-233********6\",\"vfoodId\":20000********833}],\"orderId\":\"80525********549051\",\"reason\":\"商家部分售中退 \",\"refundImages\":[],\"refundStatus\":\"successful\",\"refundType\":\"part\",\"shopId\":510****00,\"totalPrice\":12.94,\"updateTime\":1687881570}", "userId": "699142********09500", "timestamp": 1687881570499 }