新增数码申请下单

#  新增数码申请下单 `公开`

## 支持场景
>  已支持：根据标签id、商品id（可空）、申请数量以及拆单数量进行生码下单

## API描述
>  API描述：根据标签id、商品id（可空）、申请数量以及拆单数量进行生码下单

## 请求流程

>   1. 在超8平台中申请第三方系统的应用Access Key和密钥（线下）。
>   2. 第三方系统根据应用Access Key和密钥向系统发起**Access Token**申请【[如何获取token](https://developers.yesno.com.cn/doc/57/ "如何获取token")】。
>   3. 三方系统调用防伪领域服务的开放接口进行数据对接。

> 具体请求请参阅：
>请参阅  [请求流程](https://developers.yesno.com.cn/doc/56/ "请求流程")

## 请求信息

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

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

## 请求参数

<tr><td> labelId          </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>                            例如：dd2023041201              </td> </tr>
   <tr><td> printMethod        </td> <td> string</td> <td> 必须   </td> <td>        </td> <td> 印刷方式（1 中商印刷，2 自主印刷）           </td> <td>  </td> </tr>
   <tr><td> orderMethod   </td> <td>string    </td> <td> 必须   </td> <td>        </td> <td> 下单方式（1 普通下单）                 </td> <td>                                         </td> </tr>
 <tr><td> applyCount   </td> <td>int    </td> <td> 必须   </td> <td>        </td> <td> 申请数量                      </td> <td>                                         </td> </tr>

<tr><td> productId      </td><td> string    </td> <td> 非必须   </td> <td>        </td> <td> 商品id                      </td> <td>                                         </td> </tr>
  <tr><td> applyOrgId       </td> <td>long    </td> <td> 非必须     </td> <td>        </td> <td> 申请单位id                      </td> <td>                                         </td> </tr>
  <tr><td> useOrgId         </td> <td>long    </td> <td> 非必须     </td> <td>        </td> <td> 使用单位id                      </td> <td>                                         </td> </tr>
  <tr><td> remark   </td> <td>string    </td> <td> 非必须   </td> <td>        </td> <td> 备注                      </td> <td>                                         </td> </tr>
  <tr><td> receiverName</td><td> string</td> <td> 非必须</td> <td></td> <td> 收件人</td><td> </td> </tr>
 <tr> <td> receiverPhone</td> <td>string    </td> <td> 非必须     </td> <td>        </td> <td> 手机号码                        </td> <td>                                         </td> </tr>
  <tr><td> receiverMobile     </td><td> string    </td> <td> 非必须     </td> <td>        </td> <td> 座机号码                    </td> <td>                                        </td> </tr>
<tr><td> receiverAddress     </td><td> string    </td> <td> 非必须     </td> <td>        </td> <td> 详细地址                    </td> <td>                                        </td> </tr>
<tr><td> provinceCode     </td><td> string    </td> <td> 非必须     </td> <td>        </td> <td> 省代码                    </td> <td>                                        </td> </tr>
<tr><td> provinceName     </td><td> string    </td> <td> 非必须     </td> <td>        </td> <td> 省名称                    </td> <td>                                        </td> </tr>
<tr><td> cityCode     </td><td> string    </td> <td> 非必须     </td> <td>        </td> <td> 市代码                    </td> <td>                                        </td> </tr>
<tr><td> cityName     </td><td> string    </td> <td> 非必须     </td> <td>        </td> <td> 市名称                    </td> <td>                                        </td> </tr>
<tr><td> areaCode     </td><td> string    </td> <td> 非必须     </td> <td>        </td> <td> 区域代码                    </td> <td>                                        </td> </tr>
<tr><td> areaName     </td><td> string    </td> <td> 非必须     </td> <td>        </td> <td> 区域名称                    </td> <td>                                        </td> </tr>
  <tr><td> e1               </td> <td> string    </td> <td> 非必须   </td> <td>        </td> <td> e1                            </td> <td>                                         </td> </tr>
  <tr><td> e2               </td> <td> string    </td> <td> 非必须   </td> <td>        </td> <td> e2                            </td> <td>                                          </td> </tr>
  <tr><td> e3               </td> <td> string    </td> <td> 非必须   </td> <td>        </td> <td> e3                            </td> <td>                                         </td> </tr>
 <tr><td> e4               </td> <td> string    </td> <td> 非必须   </td> <td>        </td> <td> e4                            </td> <td>                                          </td> </tr>
 <tr><td> e5               </td> <td> string    </td> <td> 非必须   </td> <td>        </td> <td> e5                            </td> <td>                                         </td> </tr>
 <tr> <td> e6               </td> <td> string    </td> <td> 非必须   </td> <td>        </td> <td> e6                            </td> <td>                                          </td> </tr>
  <tr><td> e7               </td> <td> string    </td> <td> 非必须   </td> <td>        </td> <td> e7                            </td> <td>                                         </td> </tr>
  <tr><td> e8               </td> <td> string    </td> <td> 非必须   </td> <td>        </td> <td> e8                            </td> <td>                                         </td> </tr>
  <tr><td> e9               </td> <td> string    </td> <td> 非必须   </td> <td>        </td> <td> e9                            </td> <td>                                         </td> </tr>
  <tr><td> e10              </td> <td> string    </td> <td> 非必须   </td> <td>        </td> <td> e10                           </td> <td>                                         </td> </tr>
</table>

## 返回消息体

| 名称      | 类型    | 是否必须 | 默认值 | 备注       | 其他信息          |
|-----------|---------|----------|--------|------------|-------------------|
| code      | integer | 非必须   |        | 错误码     | **format:** int32 |
| data      | string  | 非必须   |        | 数据       |                   |
| message   | string  | 非必须   |        | 消息内容   |                   |
| timestamp | integer | 非必须   |        | 时间戳     | **format:** int64 |
| traceId   | string  | 非必须   |        | 链路追踪ID |                   |

## 请求示例
``` text
请求地址：{URL}/base/app/v1/open/order/add
Post参数：{
  {
    "labelId":"173dd8233a9b40b9bc3bb47bf799928e",
    "orderNo":"jianke_order_no_004",
    "printMethod":"1",
    "orderMethod":"1",
    "applyCount":10,
    "splitCount":1000000,
    "productId":"7de84d866d3c48589ef425662b61d2e7",
    "applyOrgId":0,
    "useOrgId":0,
    "remark":"",
    "receiverName":"",
    "receiverPhone":"",
    "receiverMobile":"",
    "receiverAddress":"",
    "provinceCode":"",
    "provinceName":"",
    "cityCode":"",
    "cityName":"",
    "areaCode":"",
    "areaName":"",
    "e1": "",
    "e2": "",
    "e3": "",
    "e4": "",
    "e5": "",
    "e6": "",
    "e7": "",
    "e8": "",
    "e9": "",
    "e10": ""
}
}
```

## 响应示例

```json
{
    "code": 200,
    "message": "success",
    "data": { },
    "timestamp": 1679565957862,
    "traceId": "221198c7-ccf5-444e-a088-12aae8d995fd"
}
```

## 异常示例
```json
{
  "code": 135630001,
  "message": "参数错误",
  "traceId":"xxxxxx",
  "timestamp": 1679368912568
}
```

## 返回码
| 返回码 | 描述 |  解决方案|
| --- | --- | --- | 
200|成功|
21823004|标签不能为空|
21823005|标签不存在|
21823006|标签没有对应的物码规则|
21823010|标签不属于该企业|
21823007|印刷方式不能为空|
21823008|印刷方式不正确|
21823009|订单编号格式不正确|
21823000|订单编号已存在|
21823011|下单方式不能为空|
21823012|下单方式不正确|
21823013|申请数量不能为空且必须大于0|
21823014|申请数量不能超过最大申请数量|
21823017|申请数量与包装比例不成正比|
21823018|商品不存在|
21821011|商品未启用|
21821005|包装比例不一致|
21823019|备注长度不超过256|
21823021|收件人应为2-30位任意字符|
21823022|手机号码格式不正确|
21823023|座机号码格式不正确|
21823024|详细地址不超过256|
21810002|网络出现异常，请稍后重试|