生产数据回传接口

## 生产数据回传接口

## API描述
>API描述：对接生产数据

## 请求流程
>请参阅 [API开放平台接入指南](https://developers.yesno.com.cn/doc/56/ "API开放平台接入指南")

## 请求信息

>域名：请参阅 [环境信息](https://developers.yesno.com.cn/doc/56/ "环境信息")

<table>
<thead>
<tr>
<th>请求协议</th>
<th>HTTPS</th>
</tr>
</thead>
<tbody><tr>
<td>请求方法</td>
<td>POST</td>
</tr>
<tr>
<td>接口路径</td>
<td>/hivezs/guanfang/touyun/v1/production/upload</td>
</tr>
</tbody></table>

## 请求参数
**路径参数:**
>无

**Headers:**
>请参阅 [通用请求头](https://developers.yesno.com.cn/doc/56/ "通用请求头")

**Body:**<table>
<thead>
<tr>
<th>参数名称</th>
<th>是否必填</th>
<th>参数类型</th>
<th>参数说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>serialNo</td>
<td>是</td>
<td>String</td>
<td>流水号（唯一）</td>
</tr>

<tr>
<td>code1Qty</td>
<td>是</td>
<td>Integer</td>
<td>回传数量（1层码的数量）</td>
</tr>
<tr>
<td>batchNo</td>
<td>是</td>
<td>String</td>
<td>生产批次</td>
</tr>
<tr>
<td>productNo</td>
<td>是</td>
<td>String</td>
<td>产品编号</td>
</tr>
<tr>
<td>factoryNo</td>
<td>是</td>
<td>String</td>
<td>工厂编号</td>
</tr>
<tr>
<td>workshopNo</td>
<td>是</td>
<td>String</td>
<td>车间编号</td>
</tr>
<tr>
<td>lineNo</td>
<td>是</td>
<td>String</td>
<td>产线编号</td>
</tr>

<tr>
<td>productionDate</td>
<td>是</td>
<td>String</td>
<td>生产日期,格式:yyyy-MM-dd</td>
</tr>
<tr>
<td>expirationDate</td>
<td>是</td>
<td>String</td>
<td>保质日期,格式:yyyy-MM-dd</td>
</tr>

<tr>
<td>codes</td>
<td>是</td>
<td>List&lt;T&gt;</td>
<td>数码列表</td>
</tr>
<tr>
<td>-code1</td>
<td>是</td>
<td>String</td>
<td>一层数码</td>
</tr>
<tr>
<td>-code2</td>
<td>是</td>
<td>String</td>
<td>二层数码</td>
</tr>
<tr>
<td>-code3</td>
<td>否</td>
<td>String</td>
<td>三层数码</td>
</tr>
<tr>
<td>--scanTime</td>
<td>否</td>
<td>String</td>
<td>扫码时间，格式为yyyy-MM-dd HH:mm:ss</td>
</tr>

<tr>
<td>--isTail</td>
<td>是</td>
<td>Boolean</td>
<td>是否尾数</td>
</tr>
</tbody>
</table>

## 返回数据

<table>
<thead>
<tr>
<th>参数名称</th>
<th>参数类型</th>
<th>参数说明</th>
</tr>
</thead>
<tbody><tr>
<td>code</td>
<td>String</td>
<td>状态：成功=200，非200见message</td>
</tr>
<tr>
<td>message</td>
<td>String</td>
<td>信息</td>
</tr>
<tr>
<td>timestamp</td>
<td>Long</td>
<td>时间戳</td>
</tr>
<tr>
<td>traceId</td>
<td>String</td>
<td>追踪Id</td>
</tr>
<tr>
<td>data</td>
<td>Object</td>
<td>返回数据</td>
</tr>
</tbody></table>

**data对象说明**

## 请求示例

<div class="code-toolbar"><pre class="line-numbers language-json" data-prismjs-copy="复制" data-prismjs-copy-error="按Ctrl+C复制" data-prismjs-copy-success="代码已复制！" tabindex="0"><code class="language-json">POST {host}/hivezs/guanfang/touyun/v1/production/upload
{
  "serialNo": "SN20261027143000123",
  "productionOrderNo": "PO-SUP8-20261027-001",
  "code1Qty": 3,
  "batchNo": "B20261027001",
  "productNo": "P-SUP8-APPLE-001",
  "factoryNo": "F01",
  "workshopNo": "W02",
  "lineNo": "L05",
  "completedTime": "2026-10-27 14:30:12",
  "shelfLifeTime": "2027-10-27 00:00:00",
  "codes": [
    {
      "code1": "PL000000000001",
      "code2": "BX000000000001",
      "code3": "SN0000000000001",
      "scanTime": "2026-10-27 14:28:05",
      "isTail": false
    },
    {
      "code1": "PL000000000001",
      "code2": "BX000000000001",
      "code3": "SN0000000000002",
      "scanTime": "2026-10-27 14:28:41",
      "isTail": false
    },
    {
      "code1": "PL000000000002",
      "code2": "BX000000000002",
      "code3": "SN0000000000003",
      "scanTime": "2026-10-27 14:29:58",
      "isTail": true
    }
  ]
}
</code>
</pre>
</div>

## 出参示例-参数不正确
<div class="code-toolbar"><pre class="line-numbers language-json" data-prismjs-copy="复制" data-prismjs-copy-error="按Ctrl+C复制" data-prismjs-copy-success="代码已复制！" tabindex="0"><code class="language-json">{
    "code": 23560021,
    "message": "生产单位不正确",
    "data": null,
    "timestamp": 1792549759690,
    "traceId": "87cd3c1a-34f0-4602-82ce-e465e977eb29",
    "exception": "生产单位不正确",
    "meta": null,
    "ext": null
} </code></pre></div>

## 出参示例-成功
<div class="code-toolbar"><pre class="line-numbers language-json" data-prismjs-copy="复制" data-prismjs-copy-error="按Ctrl+C复制" data-prismjs-copy-success="代码已复制！" tabindex="0"><code class="language-json">{
  "code": 200,
  "message": "success",
  "data": null,
  "timestamp": 1792504583663,
  "traceId": "",
  "exception": null,
  "meta": null,
  "ext": null
} </code></pre></div>

## 常见错误

**错误码说明**

<tbody>

<tr>
<td>23560021</td>
<td>参数不正确</td>
<td>参数校验不过</td>
</tr>

</tbody>
</table>