## 面單接口
請求地址:`https://open-api.10ss.net/expressprint/index`
請求方式:POST
提示：(k4&k6系列機型不建議調用面單API)，請使用k5系列打印機;
### 所需參數
|名 稱|類 型|描 述|
|----|----|----|
|client_id|string|開發者的應用ID，在開放平臺創建應用時獲得|
|access_token|string|授權的token 必要參數|
|machine_code|string|易聯云打印機終端號|
|origin_id|string|商戶系統內部訂單號，要求32個字符內，只能是數字、大小寫字母 ，且在同一個client_id下唯一。詳見商戶訂單號|
|id|string|UUID4 詳見API文檔列表-uuid4|
|sign|string|簽名 詳見API文檔列表-接口簽名|
|timestamp|string|當前服務器時間戳(10位)|
|content|json|詳情請看下方說明|
|sandbox|int|`1`沙箱環境調用，`非必傳參數，正式環境可以不傳入sandbox`|
### content參數說明
* <a href = "http://www.kdniao.com/documents" target="new">詳情可看，快遞鳥接口API文檔說明</a>
備注：R-必填（Required），O-可選（Optional），C-報文中該參數在一定條件下可選（Conditional）
<table class="p-table"><tbody><tr><th colspan="2">參數名稱</th><th class="g-w-80">類型</th><th>說明</th><th width="80">是否必須</th></tr><tr><td colspan="2">MemberID</td><td class="g-w-80">String</td><td>會員標識</td><td>O</td></tr><tr><td colspan="2">CustomerName</td><td class="g-w-80">String</td><td>電子面單客戶賬號（與快遞網點申請）</td><td>O</td></tr><tr><td colspan="2">CustomerPwd</td><td class="g-w-80">String</td><td>電子面單密碼</td><td>O</td></tr><tr><td colspan="2">SendSite</td><td class="g-w-80">String</td><td>收件網點標識</td><td>O</td></tr><tr><td colspan="2">ShipperCode</td><td class="g-w-80">String</td><td>快遞公司編碼</td><td>R</td></tr><tr><td colspan="2">LogisticCode</td><td class="g-w-80">String</td><td>快遞單號</td><td>O</td></tr><tr><td colspan="2">OrderCode</td><td class="g-w-80">String</td><td>訂單編號</td><td>R</td></tr><tr><td colspan="2">ThrOrderCode</td><td class="g-w-80">String</td><td>第三方訂單編號</td><td>O</td></tr><tr><td colspan="2">MonthCode</td><td class="g-w-80">String</td><td>月結編碼</td><td>C</td></tr><tr><td colspan="2">PayType</td><td class="g-w-80">Int</td><td>郵費支付方式:1-現付，2-到付，3-月結，4-第三方支付</td><td>R</td></tr><tr><td colspan="2">ExpType</td><td class="g-w-80">String</td><td>快遞類型：1-標準快件</td><td>R</td></tr><tr><td colspan="2">IsNotice</td><td class="g-w-80">Int</td><td>是否通知快遞員上門攬件：0-通知；1-不通知；不填則默認為1</td><td>O</td></tr><tr><td colspan="2">Cost</td><td class="g-w-80">Double</td><td>寄件費（運費）</td><td>O</td></tr><tr><td colspan="2">OtherCost</td><td class="g-w-80">Double</td><td>其他費用</td><td>O</td></tr><tr><td rowspan="9">Receiver</td><td>Company</td><td class="g-w-80">String</td><td>收件人公司</td><td>O</td></tr><tr><td>Name</td><td class="g-w-80">String</td><td>收件人</td><td>R</td></tr><tr><td>Tel</td><td class="g-w-80">String</td><td rowspan="2">電話與手機，必填一個</td><td rowspan="2">R</td></tr><tr><td>Mobile</td><td class="g-w-80">String</td></tr><tr><td>PostCode</td><td class="g-w-80">String</td><td>收件人郵編（郵政相關快遞必傳）</td><td>O</td></tr><tr><td>ProvinceName</td><td class="g-w-80">String</td><td>收件省（如廣東省，不要缺少“省”，必須是中文！數字、字母、特殊符號無效）</td><td>R</td></tr><tr><td>CityName</td><td class="g-w-80">String</td><td>收件市（如深圳市，不要缺少“市”，必須是中文！數字、字母、特殊符號無效）</td><td>R</td></tr><tr><td>ExpAreaName</td><td class="g-w-80">String</td><td>收件區（如福田區，不要缺少“區”或“縣”，必須是中文！數字、字母、特殊符號無效）</td><td>R</td></tr><tr><td>Address</td><td class="g-w-80">String</td><td>收件人詳細地址</td><td>R</td></tr><tr><td rowspan="9">Sender</td><td>Company</td><td class="g-w-80">String</td><td>發件人公司</td><td>O</td></tr><tr><td>Name</td><td class="g-w-80">String</td><td>發件人</td><td>R</td></tr><tr><td>Tel</td><td class="g-w-80">String</td><td rowspan="2">電話與手機，必填一個</td><td rowspan="2">R</td></tr><tr><td>Mobile</td><td class="g-w-80">String</td></tr><tr><td>PostCode</td><td class="g-w-80">String</td><td>發件人郵編</td><td>O</td></tr><tr><td>ProvinceName</td><td class="g-w-80">String</td><td>發件省（如廣東省，不要缺少“省”，必須是中文！數字、字母、特殊符號無效）</td><td>R</td></tr><tr><td>CityName</td><td class="g-w-80">String</td><td>發件市（如深圳市，不要缺少“市”，必須是中文！數字、字母、特殊符號無效）</td><td>R</td></tr><tr><td>ExpAreaName</td><td class="g-w-80">String</td><td>發件區（如福田區，不要缺少“區”或“縣”，必須是中文！數字、字母、特殊符號無效）</td><td>R</td></tr><tr><td>Address</td><td class="g-w-80">String</td><td>發件人詳細地址</td><td>R</td></tr><tr><td colspan="2">StartDate</td><td class="g-w-80">String</td><td rowspan="2">上門取貨時間段:"yyyy-MM-dd HH:mm:ss"格式化，本文中所有時間格式相同</td><td>O</td></tr><tr><td colspan="2">EndDate</td><td class="g-w-80">String</td><td>O</td></tr><tr><td colspan="2">Weight</td><td class="g-w-80">Double</td><td>物品總重量kg</td><td>O</td></tr><tr><td colspan="2">Quantity</td><td class="g-w-80">Int</td><td>件數/包裹數(最大值為4，超出不會打印子件面單)</td><td>O</td></tr><tr><td colspan="2">Volume</td><td class="g-w-80">Double</td><td>物品總體積m3</td><td>O</td></tr><tr><td colspan="2">Remark</td><td class="g-w-80">String</td><td>備注</td><td>O</td></tr><tr><td colspan="5" style='text-align: center;'>AddServices</td></tr><tr><td rowspan="3">AddService</td><td>Name</td><td class="g-w-80">String</td><td>增值服務名稱</td><td>O</td></tr><tr><td>Value</td><td class="g-w-80">String</td><td>增值服務值</td><td>O</td></tr><tr><td>CustomerID</td><td class="g-w-80">String</td><td>客戶標識（選填）</td><td>O</td></tr><tr><td colspan="5" style=' text-align: center;'>Commoditys</td></tr><tr><td rowspan="7">Commodity</td><td>GoodsName</td><td class="g-w-80">String</td><td>商品名稱</td><td>R</td></tr><tr><td>GoodsCode</td><td class="g-w-80">String</td><td>商品編碼</td><td>O</td></tr><tr><td>Goodsquantity</td><td class="g-w-80">Int</td><td>商品數量</td><td>O</td></tr><tr><td>GoodsPrice</td><td class="g-w-80">Double</td><td>商品價格</td><td>O</td></tr><tr><td>GoodsWeight</td><td class="g-w-80">Double</td><td>商品重量kg</td><td>O</td></tr><tr><td>GoodsDesc</td><td class="g-w-80">String</td><td>商品描述</td><td>O</td></tr><tr><td>GoodsVol</td><td class="g-w-80">Double</td><td>商品體積m3</td><td>O</td></tr><tr><td colspan="2">TemplateSize</td><td class="g-w-80">String(10)</td><td>模板規格(默認的模板無需傳值，非默認模板傳對應模板尺寸)</td><td>O</td></tr></tbody></table>
### 應用場景
目前接口支持了：順豐（SF）、EMS（EMS）、宅急送（ZJS）、圓通（YTO）、百世快遞（HTKY）、中通（ZTO）、韻達（YD）、申通（STO）、德邦（DBL）、優速（UC）、京東（JD）、信豐（XFEX）、全峰（QFKD）、跨越速運（KYSY）、安能小包（ANE）、快捷快遞（FAST）、國通（GTO）、天天快遞（HHTT）、郵政快遞包裹（YZPY）、中鐵快運（ZTKY）、郵政國內標快（YZBK）、全一快遞（UAPEX）、速爾快遞（SURE），后續更多的快遞公司正在對接中。
<table class="p-table"><tbody><tr><th width="200">賬號類型</th><th>支持快遞公司</th></tr><tr><td>無需申請直接打單</td><td>順豐（SF）、EMS（EMS）（僅支持廣東省內發貨）、快捷快遞（FAST）、宅急送（ZJS）、郵政快遞包裹（YZPY）、中鐵快運（ZTKY）、郵政國內標快（YZBK）、全一快遞（UAPEX）</td></tr><tr><td>月結賬號直接打單</td><td>德邦（DBL）、EMS（EMS）</td></tr><tr><td>線下（網點）申請賬號</td><td>EMS（EMS）、中通（ZTO）、申通（STO）、德邦（DBL）、京東（JD）、信豐（XFEX）、全峰（QFKD）、國通（GTO）、天天快遞（HHTT）、速爾快遞（SURE）、優速（UC）、韻達（YD）、圓通（YTO）、遠成（YCWL）、安能（ANE）、百世快遞（HTKY）</td></tr></tbody></table>
### 請求示例 JSON
```json
{
"ShipperCode":"SF",
"OrderCode":"dev-0002",
"EBusinessID":"1615047",
"Receiver":{
"ProvinceName":"四川省",
"Address":"四川省成都市武侯區吉泰路666號福年廣場T2-2205",
"Tel":"18215625507",
"CityName":"成都市",
"ExpAreaName":"武侯區",
"Mobile":"18*****2507",
"Name":"胡1"
},
"Quantity":1,
"PayType":1,
"IsNotice":1,
"Cost":0,
"Weight":0,
"Sender":{
"ProvinceName":"四川省",
"Address":"四川省成都市武侯區吉泰路666號福年廣場T2-2205",
"Tel":"18******507",
"CityName":"成都市",
"ExpAreaName":"武侯區",
"Mobile":"182****507",
"Name":"寧1"
},
"ExpType":"1",
"LogisticCode":"FH-1903-0002",
"Commodity":[
{
"GoodsName":"歐洲紅色A,歐洲紅色B"
}],
"Volume":0,
"IsReturnPrintTemplate":"1",
"IsSendMessage":0,
"TemplateSize":"180"
}
```
### 返回詳情
~~~
{"error":"0","error_description":"success","body":{"id":"訂單號","logistic_code":"快遞單號 ","origin_id":"xxxx","shipper_code":"快遞公司編碼"}}
{"error":"8","error_description":"打印機信息錯誤,參數有誤"}
{"error":"9","error_description":"連接打印機失敗,參數有誤"}
{"error":"10","error_description":"權限不足"}
{"error":"12","error_description":"缺少必要參數"}
{"error":"13","error_description":"打印失敗,參數有誤"}
{'error':'33', 'error_description':'Uuid不合法'}
{'error':'49', 'error_description':'錯誤',"body":{"錯誤詳情"}}
~~~
### 錯誤說明
申通返回錯誤`SiteName`字段不能為`null`是未傳入`sendsite`字段，需要傳入的值是`網點名稱`，還有缺少`772`開頭的運單號，需要充值
- 平臺簡介
- 概念和術語
- 新手指南
- 開發文檔
- 接入API服務指南
- API調用協議說明
- 開放應用服務模式
- 自有應用服務模式
- 掃描二維碼授權模式
- 消息推送協議說明
- API文檔列表
- 文本打印接口
- 圖形打印接口
- 面單打印接口
- 設置內置語音接口
- 刪除內置語音接口
- 刪除終端授權
- 添加應用菜單
- 關機重啟接口
- 聲音調節接口
- 獲取機型打印寬度接口
- 獲取機型軟硬件版本接口
- 取消所有未打印訂單接口
- 取消單條未打印訂單接口
- 設置logo接口
- 取消logo接口
- 打印方式接口
- 接單拒單設置接口
- 設置推送url接口
- 獲取訂單狀態接口
- 獲取訂單列表接口
- 獲取終端狀態接口
- 推送接口
- 簽名規則
- 打印完成推送
- 接單拒單推送
- 按鍵請求推送
- 應用菜單推送
- 打印機實時狀態推送
- 打印機指令
- K7-GHC/K7-WHC排版指令
- K4-GH(新固件)/K4-WH(新固件)排版指令
- K6-WH(新固件)排版指令
- M1-G(新固件)排版指令
- W1(新固件)排版指令
- K5(新固件)排版指令
- K2S、K3S、M1排版指令
- K7、K6、K5、K4排版指令
- X1排版指令
- W1排版指令
- Ai語音播報指令
- 指令詳解
- 二維碼打印
- 條碼打印
- 打印多聯
- 字體加大
- 字體加粗
- 字體加高
- 字體加寬
- 換行
- 居中對齊
- 左右對齊
- 右對齊
- 一行三格或四格對齊排版
- 制表符
- 自定義來單提醒
- 自定義來單聲音控制
- 訂單確認
- SDK使用說明
- 注意事項
- 全局返回碼
- 獲取終端號和特殊密鑰