邮包险接入流程

接入指引 - 邮包险 (Shipping Protection)

获取报价
- 说明：提供两种获取保单费率及报价的方式。
  - 方式一（强烈推荐）：接收邮包费率回调。商户端根据回调下发的费率，结合订单实际金额自行计算邮包险保费。此方式无需实时调用外部接口，页面加载与用户体验最佳。
  - 方式二：主动调用获取购物车/结算页的试算报价接口实时拉取预估报价。
订单同步
- 说明：用户下单购买邮包险后，商户需通过同步平台订单接口将包含邮包险的订单明细推送至 Xcotton，平台将返回对应的保单号（服务单号）。注意：此时保单暂未正式生效。
发货同步及生效
- 说明：商户实际发货后，需调用**同步发货** 将物流信息同步至 Xcotton。处理成功后，邮包险保单正式生效并开放理赔通道。平台支持配置服务生效回调以异步通知商户保单状态。生效时可能同时收到生效回调与服务单状态回调（serviceState=3），请按服务单号做幂等。
退保支持
- 说明：邮包险仅支持在发货同步之前退保。调用 CancelServiceOrder，serviceOrderId 含 SP 即为邮包险。发货后接口不支持退保；如有特殊需求，请联系产品和业务人员评估处理方案。