延保险接入流程

注意

本页适用于 OpenAPI 自主接入，或平台能力声明明确要求补充此能力的场景。使用平台集成方案时，请先确认该方案的 OpenAPI 依赖和职责边界。

接入指引 - 延保险 (Product Protection)

延保险业务的核心特征在于对商品属性的高度依赖：不同的商品类别对应的费率存在差异。因此，在标准的保险接入流程前，必须增加**“商品同步”**环节，以便准确匹配延保方案。

---

1. 业务阶段定义

• 商品同步（前置依赖）

  • 说明：延保报价强依赖商品类目与属性。商户需先通过商品同步接口将其商品信息同步至 Xcotton，系统进而完成延保方案的匹配。

• 获取报价

  • 说明：提供两种获取方案费率及报价的方式。

    • 方式一（推荐）：接收延保报价回调。商户端在本地数据库缓存商品对应的方案费率，并在前端（如商品详情页/购物车）根据 商品金额 * 费率自行计算并展示报价。此方式可最大化提升页面加载与下单性能。
    • 方式二：主动调用获取延保报价接口实时查询。

• 订单同步

  • 说明：用户下单购买延保后，商户需调用同步平台订单接口将订单信息同步至 Xcotton。

• 发货同步及生效

  • 说明：商户实际发货后，需调用**同步发货** 将物流信息同步至 Xcotton。处理成功后，延保险保单正式 生效并开放理赔通道。平台支持配置服务生效回调以异步通知商户保单状态。生效时可能同时收到生效回调与 服务单状态回调（serviceState=3），请按服务单号做幂等。

• 退保支持

  • 说明：延保险仅支持在发货同步之前退保。调用 CancelServiceOrder，serviceOrderId 含 PP 即为延保。发货前支持整单退保；部分退保传入 cancelItems。发货后接口不支持退保；如有特殊需求，请联系产品和业务人员评估处理方案。

---

2. 流程与时序交互

2.1 延保险业务流程图

2.2 延保险系统交互时序图