# 服务保障

# 开发前准备

• 功能了解：开发前建议先阅读以下运营文档了解完整业务流程
  • 微信小店「服务保障单」使用指南
  • 微信小店「假一赔三」管理规则
  • 微信小店「坏损包退」管理规则
  • 微信小店「坏损包退」使用指南
  • 保障单与售后单、纠纷单的关系详见 售后管理开发指南
• 权限与凭证：商家自研可直接调用，使用小店 access_token；第三方服务商需获得商家对权限集 ID：131的授权，使用 authorizer_access_token
• 消息推送配置：需配置消息推送回调 URL，本模块涉及的事件：[事件] 保障单更新通知 / channels_ec_guarantee_update。详见 消息通知（回调）说明

# 保障单核心概念

# 保障单类型

# 保障单状态枚举

保障单完整状态枚举详见 [API] 获取保障单详情 / getguaranteeorder 中的 status 字段说明。

# 接入流程

# 假一赔三流程

用户申诉商品存在假冒注册商标或假冒材质成分问题，平台介入鉴定后按商品费用的 3 倍赔付。

商家收到 [事件] 保障单更新通知 / channels_ec_guarantee_update（status=WAIT_MERCHANT_HANDLE，等待商家处理）后，应调用 [API] 获取保障单详情 / getguaranteeorder 查询保障单详情，确认 type=1（假一赔三）后执行对应操作：

• 同意赔付：调用 [API] 商家同意保障单申请 / merchantacceptguarantee，直接进入赔付流程
• 拒绝并举证：调用 [API] 商家拒绝保障单申请 / merchantrefuseguarantee，需提供 reason（拒绝原因）和 pic_list（凭证图片），转平台裁决
• 举证阶段：平台判定需要更多证据时，会再次推送事件通知（status=WAIT_MERCHANT_PROOF 或 WAIT_BOTH_PROOF），商家需调用 [API] 获取保障单详情 / getguaranteeorder 查看举证要求，再通过 [API] 商家举证保障单 / merchantproofguarantee 提交文字和图片证据

假一赔三赔付金额说明：

• 申请原因（apply_reason_type）：1 假冒注册商标，2 假冒材质成分
• 赔付金额 = 鉴定费用（identify_fee）+ 商品费用（product_fee）× 3
• 可能出现金额异常待确认状态（STATUS_PAY_BLOCK），需平台人工确认后继续赔付
• 鉴定凭证和费用凭证通过 fake_one_pay_four_info 中的 identify_proof_pic_list、fee_proof_pic_list 字段获取（media_id 列表）

# 坏损包退流程

用户申诉商品存在坏损问题，平台根据损坏程度按比例赔付。

坏损包退的入口与假一赔三相同（[事件] 保障单更新通知 / channels_ec_guarantee_update → [API] 获取保障单详情 / getguaranteeorder 确认 type=2），商家处理操作：

• 同意赔付：调用 [API] 商家同意保障单申请 / merchantacceptguarantee
• 拒绝并举证：调用 [API] 商家拒绝保障单申请 / merchantrefuseguarantee，需提供 reason 和 pic_list
• 协商坏损比例：调用 [API] 商家协商保障单 / merchantmodifyguarantee，bad_level 可填 10 / 30 / 50 / 80 / 100（代表损坏程度百分比），用户同意则直接赔付，用户拒绝则转平台裁决
• 举证阶段：与假一赔三相同，收到 status=WAIT_MERCHANT_PROOF 或 WAIT_BOTH_PROOF 后通过 [API] 商家举证保障单 / merchantproofguarantee 提交

坏损包退赔付金额说明：

• 赔付金额 = bad_level（损坏程度百分比）× 商品金额，含运费
• 平台裁决时可能调整 platform_modify_level
• 坏损凭证通过 bad_pay_info 中的 content（文字）和 pic_list（图片 media_id）获取
• refund_type 标识退款类型：1 仅退款，2 退货退款，3 换货

# 接口全览

# API 接口

# 事件通知

# 常见问题 FAQ

Q：商家处理保障单有时间限制吗？ A：有，通过 [API] 获取保障单详情 / getguaranteeorder 返回的 expire_time 字段为商家处理截止时间，超时未处理可能由平台代为裁决。

Q：假一赔三出现金额异常怎么办？ A：当赔付金额出现异常时，保障单进入 STATUS_PAY_BLOCK 状态，需等待平台人工确认后继续赔付流程。