按电商订单查询理赔

注意

本页适用于 OpenAPI 自主接入，或平台能力声明明确要求补充此能力的场景。使用平台集成方案时，请先确认该方案的 OpenAPI 依赖和职责边界。

按订单查询理赔

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

按订单号（电商平台订单号或前端订单号）查询该订单下的邮包险理赔记录。

当前接口仅支持邮包险。延保险暂不支持按订单查询理赔，请勿传 claimInsuranceType=4。

• orderId 与 frontOrderId 至少填一个（不是 longOrderNo / shortOrderNo）
• claimInsuranceType：3 表示邮包险；传 0 或省略时也默认邮包险。当前不支持值 4（延保险）
• 建议在服务单查询返回的 claimState 不为 0 时调用

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

注意：

• 本接口 claimMoney 是币种主单位字符串（例如 USD 下 "99.99" 表示 99.99 USD），不要写成 float64；与 ClaimQuery 理赔单顶层的“最小货币单位字符串”不同。
• 赔付方式用理赔单顶层的 compensationMethod（1–7），不要用已废弃的商品行 claimpayoutType。
• claimType = 3（延误赔偿）或 source = auto_delay 时，理赔单额外携带 Delay 自动赔付扩展字段（source / trackingNumber / carrierCode / carrierName / promisedDeliveryTime / actualDeliveryTime / delayDays / delayTier / points / giftCardUsd / autoCompensationTaskId），预设计，最终字段以研发确认为准。

接口入参示例：

按电商平台订单号查询

{
    "orderId": "order-202506010001",
    "claimInsuranceType": 3
}

按电商平台前端订单号查询

{
    "frontOrderId": "XM202506010001",
    "claimInsuranceType": 3
}

接口出参示例：

{
  "errCode": 0,
  "errMsg": "success",
  "data": {
    "orderId": "order-202506010001",
    "frontOrderId": "XM202506010001",
    "claims": [
      {
        "claimType": 1,
        "claimTypeDesc": "破损",
        "claimState": 3,
        "claimStateDesc": "已赔付",
        "compensationMethod": 2,
        "compensationMethodDesc": "商品全价赔偿",
        "claimApplyTime": "2025-06-02T14:00:00+08:00",
        "claimFinishTime": "2025-06-05T10:00:00+08:00",
        "claimMoney": "99.99",
        "claimMoneyCurrency": "USD",
        "comments": "包裹外包装破损，内部商品损坏",
        "compensationExtension": {
          "placeConsumerOrders": {
            "reissueOrderNo": "reissueOrderNo-100086"
          }
        }
      }
    ]
  }
}