数码订单申请

## 数码订单申请接口 `公开`

### 支持场景

> 已支持第三方系统提交生码下单申请。

### API描述

> 平台以当前用户的主组织作为申请组织和使用组织，下单成功表示申请已受理，后续进度通过状态接口查询。

### 请求流程

> 1. 在超8平台线下申请第三方应用的 Access Key 和密钥。
> 2. 使用 Access Key 和密钥申请 **Access Token**。操作步骤见 [获取 AccessToken](https://developers.yesno.com.cn/doc/57/)。
> 3. 携带 Access Token 调用开放接口。调用流程见 [接入指南](https://developers.yesno.com.cn/doc/56/)。

### 请求信息

| 协议 | HTTPS |
|---|---|
| 请求方法 | POST |
| 请求路径 | /base/app/v2/open/order/add |

### header头

请按平台要求传递 Access Token。请求头字段见 [通用请求头](https://developers.yesno.com.cn/doc/56/)。请求体采用 UTF-8 JSON，设置 `Content-Type: application/json`。

### 传入参数

| 参数名称 | 是否必填 | 参数类型 | 参数说明 |
|---|---|---|---|
| labelId | 是 | String | 获取标签接口返回的标签业务 ID，非空白 |
| applyCount | 是 | Integer | 申请数量，正整数。需满足企业上限、包装比例和可用额度 |
| orderNo | 否 | String | 调用方订单编号。传入时为 4～30 位，不包含中文或文件名非法字符（反斜线、斜线、冒号、星号、问号、双引号、尖括号、竖线）。在订单落库企业内唯一。不传或空串时由平台生成 |
| productId | 否 | String | 关联商品的业务 ID，  [商品列表](https://developers.yesno.com.cn/doc/670/)|
| packageName | 否 | String | 自定义码包名称，最长 128 字符，不得包含上述文件名非法字符 |
| fileCount | 否 | Integer | 申请码包的分包文件数。需要平均拆分时传正整数，且 `applyCount % fileCount = 0`。不指定拆分时省略或传 `0` |
| remark | 否 | String | 申请备注 |

### 返回消息体

<table>
  <tr><td>名称</td><td>类型</td><td>是否必须</td><td>默认值</td><td>备注</td><td>其他信息</td></tr>
  <tr><td>message</td><td>string</td><td>非必须</td><td></td><td>响应说明</td><td></td></tr>
  <tr><td>timestamp</td><td>integer</td><td>非必须</td><td></td><td>Unix 时间戳，单位为毫秒</td><td>format: int64</td></tr>
  <tr><td>traceId</td><td>string</td><td>非必须</td><td></td><td>请求追踪 ID，按实际返回</td><td></td></tr>
  <tr><td>code</td><td>integer</td><td>非必须</td><td></td><td>业务状态码，200 表示成功</td><td>format: int32</td></tr>
  <tr><td>data</td><td>object</td><td>非必须</td><td></td><td>订单受理结果</td><td></td></tr>
  <tr><td colspan="6">
    <table>
      <tr><td>orderId</td><td>string</td><td>非必须</td><td></td><td>平台订单业务 ID</td><td></td></tr>
      <tr><td>orderNo</td><td>string</td><td>非必须</td><td></td><td>实际使用的订单编号。未传时以响应生成值为准</td><td></td></tr>
      <tr><td>enterpriseNo</td><td>string</td><td>非必须</td><td></td><td>订单落库企业号，建议与订单编号一同保存</td><td></td></tr>
      <tr><td>orderStatus</td><td>string</td><td>非必须</td><td></td><td>当前订单状态编码，见状态表</td><td></td></tr>
      <tr><td>orderStatusName</td><td>string</td><td>非必须</td><td></td><td>状态显示名称。处理业务应以 orderStatus 为准</td><td></td></tr>
      <tr><td>orderSource</td><td>string</td><td>非必须</td><td></td><td>订单来源。V2 下单固定为 "3"。状态查询返回原订单来源，如 "2" 自主下单、"3" 接口对接</td><td></td></tr>
    </table>
  </td></tr>
</table>

### 请求示例

```http
POST {URL}/base/app/v2/open/order/add
Content-Type: application/json

{
  "labelId": "LBL10001",
  "applyCount": 1000,
  "orderNo": "EXT_20261104_00001",
  "productId": "PRD10001",
  "packageName": "示例码包",
  "fileCount": 2,
  "remark": "第三方系统数码申请"
}
```

### 出参示例

```json
{
  "code": 200,
  "message": "success",
  "data": {
    "orderId": "ORDER10001",
    "orderNo": "EXT_20261104_00001",
    "enterpriseNo": "100001",
    "orderStatus": "1",
    "orderStatusName": "待审核",
    "orderSource": "3"
  },
  "timestamp": 1793769601000,
  "traceId": "example-trace-add"
}
```

### Code 错误码说明

| 返回码 | 描述 | 处理建议 |
|---|---|---|
| 200 | 申请已受理 | 保存 data 中的订单号和订单所属企业号 |
| 406 | 请求体不可读取或字段类型不匹配 | 检查 JSON 和字段类型 |
| 500 | 系统异常或下游请求失败 | 记录请求时间及 traceId（若返回），联系平台排查 |

#### 订单服务业务码（联调排查）

| 返回码 | 描述 | 处理建议 |
|---|---|---|
| 401 | 缺少企业或用户身份 | 检查接入凭证 |
| 21810001 | 企业身份或参数不符合要求 | 核对接入身份及请求参数 |
| 21823141 | 没有主组织或查询所属组织失败 | 核对账号主组织配置 |
| 21825112 | 标签 ID 为空白 | 填写标签列表返回的 labelId |
| 21825113 | 未提供申请数量 | 填写 applyCount |
| 21823001 | 申请数量必须大于 0 | 填写正整数 |
| 21823014 | 申请数量超过企业上限 | 减少申请数量 |
| 21823017 | 申请数量与包装比例不符 | 按标签和印厂包装比例调整数量 |
| 21825107 | 申请数量无法按指定文件数平均拆分 | 调整数量或文件数 |
| 21825117 | 码包名称超过 128 字符 | 缩短 packageName |
| 21825118 | 码包名称包含非法字符 | 检查 packageName |
| 21825119 | 使用组织不存在或不可见 | 核对账号主组织归属 |
| 21825121 | 订单编号格式不正确 | 检查长度及字符 |
| 21825122 | 订单编号已存在 | 按原编号及订单所属企业查询 |
| 21823005 | 标签不存在 | 重新查询可用标签 |
| 21823006 | 标签没有对应的物码规则 | 联系平台配置物码规则 |
| 21823117 | 标签未授权给当前组织 | 核对标签授权 |
| 21823130 | 标签不在当前组织可用范围内 | 重新查询可用标签 |
| 21823131 | 自建标签缺少生码文件配置 | 联系平台配置标签 |
| 21823132 | 没有覆盖当前时刻的有效授权，授权已过期 | 联系平台核对授权有效期 |
| 21823133 | 目标企业不在可操作范围内 | 核对接入企业及组织归属 |
| 21823134 | 标签已作废 | 更换可用标签 |
| 21823137 | 标签授权尚未生效 | 核对授权生效时间 |
| 21823115 | 组织标签可用额度为 0 | 联系平台配置额度 |
| 21823116 | 组织标签剩余额度不足 | 减少申请数量或调整额度 |
| 21825103 | 企业授信额度为 0 | 联系平台核对授信配置 |
| 21825104 | 企业授信额度不足 | 核对企业额度和并发占用情况 |
| 21825106 | 企业年包额度尚未生效或已过期 | 核对年包额度有效期 |
| 21825115 | 企业已被禁用 | 联系平台核对企业状态 |
| 21825116 | 查询企业信息失败 | 联系平台排查 |
| 21823051 | 企业尚未配置计费模式 | 联系平台配置计费模式 |
| 21825108 | 企业未开启自主下单 | 联系平台开启自主下单 |
| 21823622 | 未找到启用的标签价目表 | 联系平台核对价目表 |
| 21823801 | 查询企业平台环境失败 | 联系平台排查 |
| 21823802 | 企业账单超期且尚未完成对账 | 联系平台处理对账 |
| 21823013 | 并发操作冲突 | 先查原单，必要时按原号退避重试 |