跳转到内容

取消投保

接口名:/go/packageOpenApiWeb/OpenApiV2/CancelServiceOrder

Section titled “接口名:/go/packageOpenApiWeb/OpenApiV2/CancelServiceOrder”

使用订单同步生成的服务单号退保。邮包险 serviceOrderId 含 SP,延保险含 PP。邮包险和延保险都仅支持在发货同步之前退保;发货后接口不支持退保。延保险在发货前支持整单退保和部分退保。

电商平台须维护服务单与订单商品的关系。

发货后如有特殊退保需求,请联系产品和业务人员评估处理方案,不要直接调用本接口。

完整字段说明见 API 接口文档 · CancelServiceOrder。

注意:

  • 延保险部分退保时,cancelFee 与 cancelItems 必须同时传入。如果只传其中一个,当前接口会按整单退保处理;不确定时请先联系产品和业务人员确认,不要直接调用。
  • 部分失败列表 JSON 名是 CancelError(PascalCase,结构体无 json tag)。
{
"cancelServiceOrderItems": [
{
"cancelId": "cancel-20250314-001",
"serviceOrderId": "20250314XSP83011364A832",
"cancelTime": "2025-03-14T10:00:00+08:00"
}
]
}
{
"errCode": 0,
"errMsg": "success",
"data": {
"serviceOrderIds": ["20250314XSP83011364A832"],
"CancelError": []
}
}