跳转到内容
Xcotton Xcotton Developer Docs
Ctrl K

查询理赔

接口名：/go/packageOpenApiWeb/OpenApiV2/ClaimQuery

Section titled “接口名：/go/packageOpenApiWeb/OpenApiV2/ClaimQuery”

查询服务单的理赔情况。serviceOrderId 必填；claimId 选填，传入时在该服务单范围内查询指定理赔单。

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

注意：

  • 出参数组 JSON 名是 claim（不是 claims）。
  • 收款方式键是 claimPaymentMethod（报案入参才是 paymentMethod）。
  • 理赔单顶层金额 claimApplyMoney / claimMoney / claimServiceFee 是最小货币单位的字符串（例如 USD 下 "500000" 表示 5000.00 USD），不要写成数字；回调同名字段才是币种主单位字符串。
  • 商品行出参用 pic / itemNum / priceCurrency，其中 itemNum 是整数；claimpayoutType 已废弃，若返回该字段请忽略。
  • claimType = 3（延误赔偿）或 source = auto_delay 时，理赔单额外携带 Delay 自动赔付扩展字段（source / trackingNumber / carrierCode / carrierName / promisedDeliveryTime / actualDeliveryTime / delayDays / delayTier / points / giftCardUsd / autoCompensationTaskId），预设计，最终字段以研发确认为准。

接口入参示例：

Section titled “接口入参示例：”
{
    "serviceOrderId": "20260601XSP0001"
}

接口出参示例：

Section titled “接口出参示例：”
{
    "errCode": 0,
    "errMsg": "成功",
    "data": {
        "claim": [
            {
                "orderId": "1234567890",
                "claimId": "CL2024010100001",
                "claimType": 1,
                "fileLinks": [
                    "http://example.com/file1.jpg",
                    "http://example.com/file2.jpg"
                ],
                "comments": "商品损坏，需理赔。",
                "claimPaymentObj": 1,
                "claimPaymentMethod": 1,
                "claimItems": [
                    {
                        "itemId": "001",
                        "productId": "p001",
                        "skuId": "ABC123",
                        "variantId": "V001",
                        "itemName": "商品名称1",
                        "pic": "http://example.com/pic1.jpg",
                        "priceCurrency": "",
                        "itemNum": 2,
                        "claimApplyMoney": "",
                        "claimReviewMoney": "",
                        "claimType": 1,
                        "claimState": 2
                    }
                ],
                "claimInsuranceType": 3,
                "claimApplyMoney": "500000",
                "claimMoney": "450000",
                "claimMoneyCurrency": "USD",
                "claimServiceFee": "5000",
                "claimServiceFeeCurrency": "USD",
                "claimPaymentState": 2,
                "claimPaymentTime": "2026-06-05T10:05:00+08:00",
                "claimCompensationType": 7,
                "claimReviewState": 1,
                "claimState": 2,
                "rejectReasonDetail": "",
                "claimGenTime": "2026-06-02T14:00:00+08:00",
                "claimTime": "2026-06-05T10:00:00+08:00",
                "compensationExtension": {
                    "placeConsumerOrders": {
                        "reissueOrderNo": "reissue-order-100086"
                    }
                }
            }
        ]
    }
}