发起理赔
接口名:/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。
接口入参示例:
Section titled “接口入参示例:”{ "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" } ]}接口出参示例:
Section titled “接口出参示例:”{ "errCode": 0, "errMsg": "成功", "data": { "claimId": "xmh_claim001" }}