**系統目前不支持批下單**
## 服務地址:/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,
}
```
