取消配送单

调用本接口可以取消配送单,详情可见即时配送接口-商家侧概述,使用过程中如遇到问题,可在开放平台服务商专区发帖交流。

使用场景

调用本接口可向配送公司请求取消配送单,各家取消规则如下:

配送公司 取消规则
顺丰同城急送 配送完成前任意节点可取消配送单
闪送 配送完成前任意节点可取消配送单
美团配送 配送完成前任意节点可取消配送单
达达 骑手取货之前可取消配送单

请求地址

POST https://api.weixin.qq.com/cgi-bin/express/local/business/order/cancel?access_token=ACCESS_TOKEN

请求参数

属性 类型 默认值 必填 说明
access_token String 第三方平台接口调用令牌authorizer_access_token
shopid string 商家id, 由配送公司分配的appkey
shop_order_id string 唯一标识订单的 ID,由商户生成
shop_no string 商家门店编号,如果只有一个门店,闪送shop_no必填,值为店铺id
delivery_sign string 用配送公司提供的appSecret加密的校验串说明
delivery_id string 快递公司ID
waybill_id string 配送单id
cancel_reason_id number 取消原因Id
cancel_reason string 取消原因

说明,配送公司信息请查看https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/immediate-delivery/delivery_info.html

cancel_reason_id 的合法值

说明
1 暂时不需要邮寄
2 价格不合适
3 订单信息有误,重新下单
4 骑手取货不及时
5 骑手配送不及时
6 其他原因( 如果选择6,需要填写取消原因,否则不需要填写 )

请求示例

{
   "shopid": "123456",
   "shop_order_id": "123456",
   "waybill_id": "123456",
   "delivery_id": "123456",
   "cancel_reason_id": 1,
   "cancel_reason": "",
   "delivery_sign": "123456",
   "shop_no": "shop_no_111"
}

返回值

属性 类型 说明
errcode number 错误码, 当errcode==0或者不存在还需要看resultcode
errmsg string 错误描述
resultcode number 运力返回的错误码
resultmsg string 运力返回的错误描述
deduct_fee number 扣除的违约金(单位:元),精确到分
desc string 说明

返回数据示例

{
  "resultcode": 0,
  "resultmsg": "ok",
  "deduct_fee": 5,
  "desc": "blabla"
}

错误码说明

说明
0 成功
其他错误码 请查看全局错误码