跳转到内容

发起理赔

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

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

通过服务单号提交理赔申请。

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

注意:

  • 必填:serviceOrderId + claimItems + claimPaymentObj;describe 非必填。
  • claimType 见 理赔类型:1 破损 / 2 丢失 / 3 Delay / 4 退货赔偿 / 5 意外损坏 / 6 电气或机械故障 / 7 设计缺陷。
  • claimPaymentObj=1(买家)时 accountInfo 必传;accountInfo.address 是单个地址字符串,不是字符串数组。
  • 商品行用 pic / itemNum / priceCurrency;报案入参收款方式键是 paymentMethod(查询/回调才是 claimPaymentMethod)。
  • compensationReason 是赔付原因,选填,0 或不传表示未指定。邮包险可传 1–8,延保险可传 101–104;传入不属于当前险种的值会报错。
  • 商品行 claimpayout 是电商平台核定的本商品申请金额,使用 priceCurrency 对应币种的主单位并以字符串传入;接口会汇总各商品的 claimpayout 作为申请金额。它不是赔付方式。
  • 商品行 claimpayoutType 已废弃、无需传。报案入参的收款方式使用顶层 paymentMethod。
  • 顶层 refundId 与 orderGoodsId 仅用于已约定的“退款单触发报案”场景,并共同组成幂等键;必须同时传入才会启用幂等,普通接入可同时省略。商品行内同名的 orderGoodsId 用于匹配被保障商品,语义不同。
  • API Reference 的 Try-it 可用「填入当前请求」写入联调设置里上次同步的服务单号和商品身份;示例申请金额固定为 10.00。
{
"serviceOrderId": "20250818XPP0001ABCD",
"claimInsuranceType": 4,
"claimType": 5,
"compensationReason": 101,
"fileLinks": [
"https://example.com/file1.jpg",
"https://example.com/file2.jpg"
],
"comments": "商品损坏,需理赔。",
"claimPaymentObj": 1,
"paymentMethod": 2,
"accountInfo": {
"accountName": "John Doe",
"accountNumber": "9876543210",
"routingNumber": "021000021",
"address": "123 Main St, Apt 4B, New York, NY 10001, United States"
},
"claimItems": [
{
"itemId": "item-001",
"skuId": "SKU001",
"orderGoodsId": "orderGoodsId001",
"itemName": "Sample protected product",
"pic": "https://example.com/product-001.jpg",
"priceCurrency": "USD",
"itemNum": 1,
"itemUnitPrice": "120.00",
"itemSumPrice": "120.00",
"claimpayout": "10.00"
}
]
}
{
"errCode": 0,
"errMsg": "成功",
"data": {
"claimId": "xmh_claim001"
}
}