**系统目前不支持批下单**
## 服务地址:/userbiz/createorder
| 字段 | 类型 | 必填 | 说明 |
| --- | --- |--- |--- |
| shop_order_id | String | 否 | 用户订单Id，若传出则会做存在校栓，未传则默认通过 |
| shipper_code | String | 是 | 快递服务产品代码 |
| sender | address | 是 | 发件人地址,详情查看数据格式中地址信息 |
|recipient|address |是|收件人地址,详情查看数据格式中地址信息|
|payer|String|是|支付方，sender:寄方，recipient:收方,一般传入sender即可|
|pkg_weight|BigDecial|是|包裹毛重，单位见产品详情|
|pkg_volume|BigDecial|是|包裹体积，单位见产品详情|
|pkg_length|BigDecial|否|包裹长度，单位见产品详情|
|pkg\_width|BigDecial|否|包裹宽度，单位见产品详情|
|pkg\_height|BigDecial|否|包裹高度，单位见产品详情|
|pkg_volume|BigDecial|否|包裹体积，单位见产品详情|
|trans\_way|String|是|交运方式，todoor: '网点交运' ,pick: "上门取件", ship: "邮寄交运"|
|declare|List<item>|是|订单产品详情,格式参考数据格式中申报产品信息|
|notify_url|String|是|异步通知地址，如异步面单产品，则系统在产生面单后主动通知客户端，格式同下面的响应格式，系统会在24小时内分四次每次五次重试的方式通知客户端，用户端返回{"ok":true}代表通知接收成功，若超过时间则系统不再通知|
## 响应格式：
**请求成功**
```
{
"timestamp":1617263620854627000,
"code":200,
"msg": "Success",
"data":{
"ok":true,
"error":[],
"order": {
"id": "KD100000135CN",
"label": "",
"fulfill_tracking"：""，
"system_label": "///2021/03/01/a4e5bb2d4fe143a3ab69785c3c04a7df.pdf",
}
}
}
```
| 字段 | 类型 | 必填 | 说明 |
| --- | --- |--- |--- |
| id| String | 选 | 货代公司跟踪号 |
| label| Url| 选 | 尾程面单,PDF地址，若产生则返回，若需收件后产生则通过异步通知返回或则通过查询获得 |
| fulfill_tracking| String | 是 | 尾程跟踪号 |
| system_label| Url| 是 | 贷代公司面单 ，若未产生最终面单 ，则可以通过此面单交运 |
因系统采购异步采购的方式，面单产生会有相应的延迟，需终端通过异步通知获取或则通过面单查询获取。
**请求失败**
```
{
"code": 200,
"msg": "Success",
"data": {
"error": [
{
"field": "shipper_code",
"message": "Can not be empty"
},
{
"field": "recipient",
"message": "Can not be empty"
},
{
"field": "sender",
"message": "Can not be empty"
},
{
"field": "payer",
"message": "Can not be empty"
},
{
"field": "pkg_weight",
"message": "Can not be empty"
},
{
"field": "pkg_volume",
"message": "Can not be empty"
},
{
"field": "trans_way",
"message": "Can not be empty"
},
{
"field": "order_items",
"message": "Can not be empty"
},
{
"field": "notify_url",
"message": "Can not be empty"
}
],
"ok": false,
}
```
