新增索赔

1、功能名称：新增索赔

2、功能描述：新增索赔

3、请求地址：https://ssl.glitzcloud.com/agent/v1/orders/claim/add

      测试地址：http://gztest.glitzcloud.com/agent/v1/orders/claim/add

4、请求方式：POST

5、请求参数

名称 类型 必填 示例值 描述
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时必填

6、请求示例

        {
            "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"
        }

7、返回格式：JSON

8、返回示例：

正确时的返回JSON数据包如下：

        {
            "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"
                    }
                ]
            }
        }

错误时的返回JSON数据包如下：

        {
            "status": 2582,
            "reqMsg": "Invalid Outflow Sn",
            "result": []
        }

9、返回参数说明：

参数 类型 示例值 描述
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"}] 附件列表

全局返回码说明