文档首页/ 数字资产链 DAC/ API参考/ API/ 可信溯源/ 溯源码管理/ 溯源信息上链
更新时间：2025-08-04 GMT+08:00
查看PDF
分享

溯源信息上链

功能介绍

溯源信息上链

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）
表4 logistics

参数

是否必选

参数类型

描述

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
父主题： 溯源码管理

相关文档