# 溯源信息上链 - UploadLabels
#### 功能介绍
溯源信息上链
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-dac/dac_api_006.html)。
#### URI
POST /v1/{project_id}/trace/trace-sweepcode/label/upload-chain-info
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                            |
|:---|:---|:---|:---|
| project_id | 是    | String | 租户从IAM申请到的projectid，一般为32位字符串 |
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述      |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户Token |
   
表3请求Body参数 
| 参数                 | 是否必选 | 参数类型                                                 | 描述                                                      |
|:---|:---|:---|:---|
| operationWarehouse | 否    | String                                               | 目的仓                                                     |
| merchant           | 是    | String                                               | 商户ID（取值为项目ID）                                           |
| linkCode           | 是    | String                                               | 环节码                                                     |
| batchCode          | 是    | String                                               | 批次码                                                     |
| level3Code         | 否    | String                                               | 三级溯源码(level3Code, level2Code itemCode这三个必须有其一，目前只支持一级码) |
| level2Code         | 否    | String                                               | 二级溯源码(level3Code, level2Code itemCode这三个必须有其一，目前只支持一级码) |
| logistics          | 否    | [logistics] object | 物流信息                                                    |
| itemCode           | 否    | String                                               | 一级溯源码(level3Code, level2Code itemCode这三个必须有其一，目只支持一级码)  |
| logisticsEvent     | 是    | String                                               | 物流事件，例如：出仓,入仓,到港,清关,门店售出                                |
| occurTime          | 否    | String                                               | ISO8601标准格式（2024-03-06T15:30:12+08:00）                  |
   
 表4logistics 
| 参数               | 是否必选 | 参数类型   | 描述   |
|:---|:---|:---|:---|
| logisticsOrderNo | 是    | String | 物流单号 |
| logisticsCompany | 是    | String | 物流企业 |
   
#### 响应参数
**状态码：200**
表5响应Body参数 
| 参数      | 参数类型   | 描述   |
|:---|:---|:---|
| code    | String | 返回码  |
| message | String | 返回描述 |
   
**状态码：500**
表6响应Body参数 
| 参数         | 参数类型   | 描述   |
|:---|:---|:---|
| error_code | String | 错误码  |
| error_msg  | String | 错误描述 |
   
#### 请求示例
```
{
  "itemCode" : "fgYRvak0Z6",
  "linkCode" : "2024021920092096301701",
  "batchCode" : "366a8e60133c4046b86b582b5640ddba",
  "merchant" : "1759540612045058049",
  "logisticsEvent" : "采摘3",
  "operationWarehouse" : "西安中心仓库",
  "occurTime" : "2024-03-06T15:30:12+08:00"
}
```
#### 响应示例
**状态码：200**
Success
```
{
  "code" : "200",
  "message" : "操作成功!"
}
```
**状态码：500**
Error response
```
{
  "code" : "500",
  "message" : "系统异常"
}
```
#### 状态码
| 状态码 | 描述             |
|:---|:---|
| 200 | Success        |
| 500 | Error response |