根据订单编号获取订单状态

## 根据订单编号获取订单状态 `公开`

### 支持场景

> 已支持第三方系统查询生码订单当前状态。

### API描述

> 按订单所属企业与订单编号精确查询。建议使用下单响应的  orderNo。

### 请求流程

> 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 |
|---|---|
| 请求方法 | GET |
| 请求路径 | /base/app/v2/open/order/status |

### header头

请按平台要求传递 Access Token。请求头字段见 [通用请求头](https://developers.yesno.com.cn/doc/56/)。

### 传入参数

| 参数名称 | 是否必填 | 参数类型 | 参数说明 |
|---|---|---|---|
| orderNo | 是 | String | 下单返回的实际订单编号，非空白，最多 30 字符。不是 orderId |
| enterpriseNo | 是 | 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>

#### 新数码申请状态

| 编码 | 名称 | 含义 |
|---|---|---|
| `"1"` | 待审核 | 已受理，等待平台审核 |
| `"3"` | 审核驳回 | 本次审核未通过，联系平台处理 |
| `"4"` | 生码中 | 审核通过或免审，正在生成码包 |
| `"5"` | 生码成功 | 码包已生成 |
| `"6"` | 生码异常 | 生码失败，记录订单标识并联系平台处理 |
| `"7"` | 已作废 | 作废完成 |
| `"8"` | 下载中 | 订单进入下载处理阶段 |
| `"9"` | 下载成功 | 下载处理成功 |
| `"10"` | 下载失败 | 下载处理失败 |
| `"11"` | 作废申请中 | 等待作废审核 |
| `"12"` | 作废中 | 作废已受理，等待结果 |
| `"13"` | 作废驳回 | 作废审核未通过 |
| `"14"` | 作废失败 | 作废处理失败 |

### 请求示例

```http
GET {URL}/base/app/v2/open/order/status?orderNo=EXT_20261104_00001&enterpriseNo=100001
```

### 出参示例

```json
{
    "code": 200,
    "message": "success",
    "data": {
        "orderId": "f599234058d34c5db59680b7e49a76c3",
        "orderNo": "100001",
        "enterpriseNo": "133216059248",
        "orderStatus": "1",
        "orderStatusName": "待审核",
        "orderSource": "3"
    },
    "timestamp": 1793771699524,
    "traceId": "",
    "exception": null,
    "meta": null,
    "ext": null
}
```

### Code 错误码说明

| 返回码 | 描述 | 处理建议 |
|---|---|---|
| 200 | 查询成功 | 读取 data.orderStatus 判断订单当前进度 |
| 400 | 缺少必填查询参数 | 传入 orderNo |
| 21820001 | 订单编号为空白或超过 30 字符 | 核对下单响应中的 orderNo |
| 500 | 系统异常或下游请求失败 | 记录请求时间及 traceId（若返回），联系平台排查 |

### 错误出参示例

```json
{
  "code": 21823015,
  "message": "申请单不存在或无权访问",
  "data": null,
  "timestamp": 1793769662000,
  "traceId": "example-trace-error"
}
```