代索赔管理
新增代索赔
创建代索赔单。
生产环境
https://ssl.glitzcloud.com/agent/v1/orders/claim/add测试环境
http://gztest.glitzcloud.com/agent/v1/orders/claim/add说明
1、功能名称：新增索赔
2、功能描述：新增索赔
请参阅鉴权签名说明。
请求参数
| 名称 | 类型 | 必填 | 示例值 | 描述 |
|---|---|---|---|---|
| store_name | String | 是 | The Warehouse USA | 仓库名称 |
| reference_sn | String | 是 | GCO12172100005 | 关联单号 |
| tracking_number | String | 是 | 1Z112312312312 | 快递单号 |
| expect_value | String | 是 | 100.00 | 期望索赔金额 |
| bill_type | String | 是 | 1 | 尾程支付方式 1美仓 2第三方 3客户自供面单 |
| status | String | 是 | 1 | 1 已创建 2 待处理 |
| consignee_phone | String | 是 | 13800000000 | 电话 |
| consignee_email | String | 是 | 123@qq.com | 邮箱 |
| goods_weight | String | 是 | 100.00 | 重量 |
| goods_value | String | 是 | 100.00 | 货物价值 |
| sale_number | String | 是 | 1234567890 | P.O |
| goods_description | String | 是 | The Warehouse USA | 货物描述 |
| is_shipped_displace_package | String | 否 | 1 | 是否有已发运替换包 1 是 2 否 |
| displace_tracking_number | String | 否 | 1Z123123123123 | 替换追踪号,is_shipped_displace_package为1时必填 |
返回字段
| 参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| status | String | 1 | 状态，1 已创建 2待处理 3处理中 4 已完成 5 已取消 6已驳回 |
| work_node_status | String | 2 | 节点状态，1 提交 2 待上传(已填写的索赔单) 3 已上传(已填写的索赔单) 4 索赔成功 5 索赔失败 |
| work_node_remark | String | 节点备注 | |
| work_node_remark | String | [{"id":"4","claim_id":"2","file_url":"http://oss.twusa.cn/shippingClaim/db8e1af0cb3aca1ae2d0018624204529/2209071133576318112505c84.png","file_type":"1","update_time":"1662522095"}] | 附件列表 |
示例
请求示例
{
"apikey": "85082f5f62a811e684f500163e06045f",
"secretkey": "85082f6862a811e684f500163e06045f",
"store_name": "TWUSA01",
"sign": "0c5fb3befa389d4afe382a86b428f7a6",
"reference_sn": "GCO12172100005",
"tracking_number": "2",
"client_id": "276",
"expect_value": "3.00",
"actual_value": "0.00",
"bill_type": "1",
"status": "1",
"is_shipped_displace_package": "2",
"displace_tracking_number": "",
"consignee_phone": "4",
"consignee_email": "5",
"sale_number": "8",
"goods_weight": "6.00",
"goods_value": "7.00",
"goods_desc": "9"
}返回示例
{
"status": 200,
"reqMsg": "success",
"result": {
"id": "62",
"claim_sn": "GCS05122600012",
"reference_sn": "GCO12172100005",
"tracking_number": "2",
"client_id": "276",
"expect_value": "3.00",
"actual_value": "0.00",
"bill_type": "1",
"status": "1",
"work_node_status": "0",
"work_node_remark": null,
"is_shipped_displace_package": "2",
"displace_tracking_number": "",
"consignee_phone": "4",
"consignee_email": "5",
"sale_number": "8",
"goods_weight": "6.00",
"goods_value": "7.00",
"goods_desc": "9",
"creator": "276",
"create_time": "2026-05-12 18:03:25",
"submit_time": null,
"start_process_time": null,
"completed_time": null,
"reject_time": null,
"attachments": [
{
"id": "34",
"file_url": "http://oss.twusa.cn/shippingClaim/db8e1af0cb3aca1ae2d0018624204529/2605121803256a02faed0e8cc.zpl",
"file_type": "1",
"update_time": "1778580205"
}
]
}
}示例 3
{
"status": 2582,
"reqMsg": "Invalid Outflow Sn",
"result": []
}