# 无忧退货(运费险)简介
小程序无忧退货(运费险)是微信官方推出的售后退换货保障服务。商家向微信充值保费后,可以为用户订单购买运费险,若订单发生退换货,无忧退货支持用户预约上门取件,寄退货免付基础运费,最高抵扣¥19.35(基本全国免费寄退货)。商家使用无忧退货无需支付额外费用。
# 一、接入案例
# 二、运作流程
- 预充值:商家通过微信向保司充值保费,账期60天,到期未用余额自动原路退回。
- 投保:商家需要对订单投保时,通过投保接口向微信主动发起投保。
- 理赔:
- 上门取件:京东上门取件,用户寄件时直接抵扣基础运费,最高抵扣 ¥19.35。
- 自行寄回:支持全部物流公司,用户自行线下寄回后填写退货物流单号,理赔款 ¥10 打款到用户微信零钱包。
- 退款:商家主动向微信/系统自动发起退款,资金原路返回。
注:微信支付单号、保单号、理赔单号一一对应,一笔交易订单仅能投保和理赔一次。
# 三、用户体验 (消息无需订阅,页面无需开发)
# 四、开通路径 (无需支付额外费用)
# 开通位置
小程序后台-功能-物流服务-无忧退货(运费险)
# 签署服务协议
# 后台接口对接
# 保费预充值(支持扫码/网银转账)
# 查看投保和资金记录
# 五、开票流程
目前支持开具电子普票、纸质普票和纸质增值税专用发票,商家可以在指定日期,按照要求邮件申请(附件大小不超过15M),开具的纸质发票将通过快递的方式寄送给商家,发票邮寄费用由商家自行承担。电子发票由所填邮箱接收。
邮件标题:运费险发票申请-xx小程序x月
邮件正文及附件内容:
小程序主体名、小程序appid、开票金额(元)、纳税人名称(与小程序主体一致)、纳税人识别号、地址、电话、开户行及账号、电子邮箱、联系人及电话
营业执照扫描件/复印件,加盖公章
需要开票的保单信息(可在小程序后台-物流服务-无忧退货-保单信息中筛选下载excel)
发送时间:请在每月初1-5日,发送邮件申请。
开票邮箱: xuziyi900@pingan.com.cn
# 六、开发说明
# 接入流程泳道图
| 接口名称 | 请求路径 | 描述 |
|---|---|---|
| 解绑退货ID | /cgi-bin/express/delivery/no_worry_return/unbind | 当商家同意退货申请之后,与用户达成协商「无需退货」时,可以通过本接口可以接触商家退货单与退货 ID的绑定 |
| 查询退货ID状态 | /cgi-bin/express/delivery/no_worry_return/get | 本接口用于商家查询用户退货状态(是否填写退货信息)及追踪用户退货物流,方便仓库收货 |
| 创建退货ID | /cgi-bin/express/delivery/no_worry_return/add | 商家在同意用户退货之后,通过本接口创建退货ID,shoporderid和退货 ID 一一对应 |
# 常见返回码
| 返回码 | 说明 |
|---|---|
| 2 | 缺少必要参数 |
| 1010 | 投保时间错误 |
| 1011 | 物流单号重复 |
| 2001 | 重复开通 |
| 2003 | 充值金额限制,单次最高1万元 |
| 2004 | 未开通无忧退货 |
| 2007 | 重复理赔 |
| 2008 | 系统安全原因,暂停理赔 |
| 2009 | 未找到对应投保单 |
| 2011 | 订单错误 - 订单号/openid错误 |
| 2012 | 订单错误 - 非该小程序内下单 |
| 2013 | 订单错误 - 支付时间错误 |
| 2014 | 订单错误 - 支付金额错误 |
| 2015 | 订单错误 - 其他 |
| 2028 | 物流单号查不到轨迹 |
| 4001 | 余额不足 |
# 服务端 API 接口
无忧退货相关接口
| 接口名称 | 请求路径 | 描述 |
|---|---|---|
| 开通无忧退货 | /wxa/business/insurance_freight/open | 本接口用于开通无忧退货 |
| 查询开通状态 | /wxa/business/insurance_freight/query_open | 本接口用于查询开通状态 |
| 发货时投保 | /wxa/business/insurance_freight/createorder | 本接口用于发货时投保 |
| 无忧退理赔 | /wxa/business/insurance_freight/claim | 本接口用于无忧退理赔,收到用户退货后再触发 |
| 申请充值订单号 | /wxa/business/insurance_freight/createchargeid | 本接口用于申请充值订单号 (支持自定义金额) |
| 申请支付 | /wxa/business/insurance_freight/applypay | 本接口用于无忧退货申请支付 |
| 拉取充值订单信息 | /wxa/business/insurance_freight/getpayorderlist | 本接口用于拉取充值订单信息 |
| 充值保费退款 | /wxa/business/insurance_freight/refund | 本接口用于充值保费退款 |
| 拉取理赔摘要 | /wxa/business/insurance_freight/getsummary | 本接口可用于查询当前保费、投保单量、理赔单量、账号余额等信息 |
| 拉取保单信息 | /wxa/business/insurance_freight/getorderlist | 本接口用于拉取保单信息 |
| 设置保费告警余额 | /wxa/business/insurance_freight/update_notify_funds | 开发者可通过接口自定义余额为xx时通知小程序管理员(余额xx无改动情况下24h内通知一次) |
退货组件相关接口
| 接口名称 | 请求路径 | 描述 |
|---|---|---|
| 创建退货ID | /cgi-bin/express/delivery/no_worry_return/add | 商家在同意用户退货之后,通过本接口创建退货ID,shoporderid和退货 ID 一一对应 |
| 解绑退货ID | /cgi-bin/express/delivery/no_worry_return/unbind | 当商家同意退货申请之后,与用户达成协商「无需退货」时,可以通过本接口可以接触商家退货单与退货 ID的绑定 |
| 查询退货ID状态 | /cgi-bin/express/delivery/no_worry_return/get | 本接口用于商家查询用户退货状态(是否填写退货信息)及追踪用户退货物流,方便仓库收货 |
# 七、组件调用
商家可选择调用组件(the latest version)至小程序页面,实现用户在小程序页面内点击按钮拉起退货寄件。
- 订单有运费险:拉起无忧退货页面,上门取件抵扣基础运费。
- 订单无运费险:拉起半屏弹窗,上门取件自付运费。
# 代码示例
# 基本用法
test.wxml:
// 需要使用两个插槽节点(slot="refund" 和 slot="refund_detail" 分别对应退货前跟退货后状态的插槽节点,如果没有要求退货状态,可以使用同意的元素节点)
// 对状态有要求,不同状态展示不同文案节点
<view>
<sales-return returnId="{{returnId}}">
<button slot="refund">立即退货</button> //还未退过货的插槽节点
<button slot="refund_detail">退货详情</button> //还退完货后的插槽节点
</sales-return>
</view>
// 对状态无要求,不同状态展示相同同文案节点
<view>
<sales-return returnId="{{returnId}}">
<button slot="refund">立即退货</button> //还未退过货的插槽节点
<button slot="refund_detail">立即退货</button> //退完货后的插槽节点
</sales-return>
</view>
test.js:
data: {
returnId: "xxx";
}
test.json:
{
"usingComponents": {
"sales-return": "plugin://logisticsPlugin/sales-return"
}
}
app.json 引入插件:
{
"pages": [
"pages/index/index",
],
"window": {
},
"plugins": {
"logisticsPlugin": {
"version": "2.3.0",
"provider": "wx9ad912bf20548d92"
}
},
}
# goods_info内容
| 参数名称 | 类型 | 必选 | 备注 |
|---|---|---|---|
| returnld | string | 是 | 退货 ID |
# 插槽 Slots
| 插槽名 | 类型 | 必选 | 备注 |
|---|---|---|---|
| refund | string | 是 | 还未退货的插槽节点,用来触发弹窗、跳转页面的节点(必填) |
| refund_detail | string | 是 | 退完货的插槽节点,用来触发弹窗、跳转页面的节点(必填,如果退货行为完成前后是相同文案可使用refund所使用的的文案) |
# 八、咨询建议
如有疑问或建议,可前往微信开放社区-微信物流服务 发帖提问讨论,官方工作人员会及时回复。