美团外卖回调接口说明文档.docx

美团回调API使用式样书第0.4版2015年9月18日作 成 者2015/09/09Zhangqw修正履歴版数修正年月日修正箇所修正概要修正者0.12015/9/9全般初版Zhangqw0.22015/9/163.确认订单已经下载修改参数名称Zhangqw0.32015/9/17增加4.用户或者客服取消订单APIZhangqw0.42015/9/23增加5.美团用户或客服进行退款流程操作api6.商家获取申请退款信息apiZhangqw案例A:美团外卖1，推送订单API,2，美团用户或客服取消API,3，美团用户或客服退款流程操作API.B:门店1,获取门店订单详情API,2,确认订单已经下载API,3,获取申请退款信息API.接口说明1．推送订单APIREST地址/Api/orderPushCallback请求方法POST说明确认订单后供美团回调(参照：推送订单API（必接）.)请求参数名称说明order_id订单IDwm_order_id_view订单展示IDapp_poi_codeAPP方商家IDwm_poi_name美团商家名wm_poi_address美团商家地址wm_poi_phone美团商家电话recipient_address收件人地址recipient_phone收件人电话 recipient_name收件人姓名shipping_fee门店配送费total总价original_price)原价caution忌口或备注shipper_phone送餐员电话status订单状态city_id城市ID（目前暂时用不到此信息）has_invoiced是否开发票invoice_title发票抬头ctime创建时间utime更新时间delivery_time用户预计送达时间，“立即送达”时为0is_third_shipping是否为美团商家、APP方配送（0：否；1：是）pay_type支付类型（1：货到付款；2：在线支付）latitude实际送餐地址纬度longitude实际送餐地址经度detail此字段为Json串，具体格式如下：detail: [{app_food_code: 1,food_name: 狗不理,sku_id: 1,quantity: 6,price: 100,box_num:2,box_price:1,unit: 份,food_discount: 0.8 (菜品折扣，只是美团商家、APP方配送的门店才会设置，默认为1。折扣值不参与总价计算。开放平台1.0.3 新增)},{...}]extras此字段为Json串，具体格式如下：extras: [{act_detail_id:10,(活动id) reduce_fee: 2.5, (活动优惠金额，是美团承担活动费用和商户承担活动费用的总和)remark: 满10元减2.5元,（优惠说明）“type:1,（活动类型）“avg_send_time”:5.5(餐厅平均送餐时间，单位为分钟)},{reduce_fee: 5, (优惠金额，是美团承担活动费用和商户承担活动费用的总和)remark: 新用户立减5元,（优惠说明）“type:1,（活动类型）“avg_send_time”:1.0(餐厅平均送餐时间，单位为分钟)},{…}]返回值调用成功返回值：{data : ok}，其余情况请参考快速开始-返回参数格式说明※①post的Content-Type字段为text，所有参数均为普通post参数，不是json ②美团推送的参数未排序，请将参数排序后再计算sig2.获取门店订单详情REST地址/Api/doGetOrder请求方法GET说明获取门店未确认的订单请求参数名称是否为空说明app_id否appidapp_poi_code否门店idtimestamp否sig否返回值名称说明order_id订单IDwm_order_id_view订单展示IDapp_poi_codeAPP方商家IDwm_poi_name美团商家名wm_poi_address美团商家地址wm_poi_phone美团商家电话recipient_address收件人地址recipient_phone收件人电话 recipient_name收件人姓名shipping_fee门店配送费total总价original_price)原价caution忌口或备注shipper_phone送餐员电话status订单状态city_id城市ID（目前暂时用不到此信息）has_invoiced是否开发票invoice_title发票抬头ctime创建时间utime更新时间delivery_time用户预计送达时间，“立即送达”时为0is_third_shipping是否为美团商家、APP方配送（0：否；1：是）pa