提供統一格式的HTTP POST或GET調用接口,并返回統一格式JSON數據。
https://poll.kuaidi100.com/print/billparcels.do
請求參數:
參數名 | 是否必填 | 類型 | 說明 |
|---|---|---|---|
method | 是 | string | 業務類型(默認:billparcels) |
key | 是 | string | 授權碼,請<a target="_blank">申請企業版</a>獲取 |
sign | 是 | string | 32位大寫 簽名,用于驗證身份,按MD5 (param +t+key+ secret)的順序進行MD5加密,不需要加上“+”號。secret可在企業管理后臺查看。 |
t | 是 | string | 時間戳如:1576123932000 |
param | 是 | param | 由其他字段拼接,通過管理后臺的打印發貨單模板配置信息獲取 |
settings | 否 | string | 由其他字段拼接 |
param數據結構:
參數名 | 是否必填 | 類型 | 說明 |
|---|---|---|---|
tempid | 是 | string | 通過管理后臺的打印發貨單模板配置信息獲取 |
siid | 是 | string | 打印設備,通過打印機輸出的設備碼進行獲取 |
callBackUrl | 否 | string | 打印狀態對調地址 |
tab0 | 否 | tab* | 發貨單表格列表內容,JsonArrayString類型,多表格時用tab0,tab1,tab2等追加對象 |
Θimg0 | 否 | object | 多圖片時用img0,img1,img2等追加 |
￢type | 是 | string | BASE_64:base64 圖片格式;URL:圖片地址;QR_CODE:二維碼;CODE_128:code128格式的條形碼 |
￢content | 是 | string | 圖片內容 |
￢width | 是 | number | 圖片寬度 |
￢height | 是 | number | 圖片高度 |
…… | 否 | string | 其他面單特殊需求參數顯示,可以到后臺-面單模板選擇該模板,下方有對應產生列表 |
settings數據結構:
參數名 | 是否必填 | 類型 | 說明 |
|---|---|---|---|
pageWidth | 是 | string | 寬,單位mm,默認值:100 |
pageHeight | 否 | string | 高,單位mm ,續打紙張時,該字段設置為null或空串 |
Θmargins | margins | 邊距 | |
￢top | 否 | string | 上邊距,單位:mm,默認:0 |
￢bottom | 否 | string | 下邊距,單位:mm,默認:0 |
￢left | 否 | string | 左邊距,單位:mm,默認:0 |
￢right | 否 | string | 右邊距,單位:mm,默認:0 |
發貨單模板示例:
<img src="http://www.tacdiversifiedservices.com/uploads/allimg/20240129/-24012ZR625352.png" style="zoom:60%">
注,發貨單模板內容都可以自定義實現,實現規則如下:
1、自定義參數命名格式:#{xxxx}
2、表格標題的設置,右鍵選擇表格屬性->標題單元格->第一行
3、表格邊框線的顯示,右鍵->表格屬性->邊框設置為1->間距和邊距設置為0
param參數示例:
{ "tempid": "129906826866200576", "siid": "L2204140087", "callBackUrl": "http://www.baidu.com/fhd/callback", "petName": "kd100", "recName": "小百", "recPhone": "10086", "payTime": "2021-01-15 15:40:55", "expressName": "德邦快遞", "printTime": "2021-01-15 15:41:30", "printCount": "1", "address": "廣東省深圳市南山區金蝶軟件園", "total": "21", "remark": "購物小票作為購物憑證,請妥善保管,您有任何疑問,請咨詢服務熱線 123456798", "img0": { "type": "code_128", "content": "887921256577", "width": 350, "height": 100 }, "tab0": [ { "prodName": "熱敏紙", "count": "5", "specs": "76*130", "unitPrice": "30", "price": "150" }, { "prodName": "熱敏紙", "count": "10", "specs": "100*180", "unitPrice": "50", "price": "500" }, { "prodName": "續打紙", "count": "5", "specs": "", "unitPrice": "40", "price": "200" }, { "prodName": "云打印機", "count": "1", "specs": "二代", "unitPrice": "499", "price": "499" } ]}settings參數示例
{ "pageWidth": 100, "pageHeight": 180, "margins": { "top": 5, "bottom": 5, "left": 5, "right": 5 }}輸出效果如下:
<img src="http://www.tacdiversifiedservices.com/uploads/allimg/20240129/-24012ZR625F6.png" style="zoom:60%">
字段 | 類型 | 說明 | 備注 |
|---|---|---|---|
result | boolean | 提交結果 | true提交成功,false失敗 |
returnCode | string | 返回編碼 | |
message | string | 返回報文描述 | |
data | data |
data數據結構
字段 | 類型 | 說明 | 備注 |
|---|---|---|---|
taskId | string | 任務ID |
{ "result": true, "returnCode": "200", "message": "提交成功", "data": { "taskId":"" // 任務ID }} 信息代碼 | 信息內容描述 | 原因及建議處理方式 |
|---|---|---|
200 | 提交成功 | 提交成功 |
400 | 參數錯誤 | 請根據技術文檔請求,注意參數類型及是否必填。 |
500 | 服務器錯誤 | 快遞100的服務器出理間隙或臨時性異常,有時如果因為不按規范提交請求,比如快遞公司參數寫錯等,也會報此錯誤 |
503 | 簽名認證失敗 | 請檢查加密方式,param + t + key + secret 的順序進行MD5加密,加密后字符串轉大寫,不用加上“+”號 |
600 | 您不是合法的用戶(即授權Key出錯) | 賬號無可用單量,需要充值 |
601 | KEY已過期 | 賬號無可用單量,需要充值 |
700 | 錯誤的回調地址 | 檢查回調地址,或者聯系快遞100工作人員 |
打印狀態變更是會觸發回調,回調后如果沒有得到合作方正確返回,會重復回調多2次,即最多回調3次。每次回調間隔30分鐘。
提供統一格式的HTTP POST,并返回統一格式JSON數據。
請求報頭:Content-Type=application/x-www-form-urlencoded;charset=UTF-8
請求參數:
字段 | 類型 | 說明 | 備注 |
|---|---|---|---|
taskId | string | 任務ID | |
sign | string | 簽名 | 32位大寫簽名,MD5 (param +salt) |
param | param | 參數主體 |
param數據結構:
字段 | 是否必填 | 類型 | 說明 |
|---|---|---|---|
status | 是 | string | 狀態編碼,200:打印成功,201打印不成功。 |
message | 是 | string | 狀態描述 |
字段 | 說明 | 備注 |
|---|---|---|
result | 提交結果 | true提交成功,false失敗 |
returnCode | 返回編碼 | |
message | 返回報文描述 |
{ "result":true, "returnCode":"200", "message":"成功"} 字段名稱 | 字段含義 |
|---|---|
result | true表示成功,false表示失敗。如果提交回調接口的地址失敗,30分鐘后重新回調,3次仍舊失敗的,自動放棄 |
returnCode | 200: 提交成功 500: 服務器錯誤 其他錯誤請自行定義 |
message | 返回的提示 |
其他信息快遞100會忽略。
發貨單接口提供給電商、企業、商城等打印發貨單、發貨清單等商品單據。該接口支持用戶自定義配置發貨單模板,支持添加條碼、二維碼等信息,實現商品單據的快速打印。
發貨單服務使用預充值付費方式,按單收費,商戶在注冊快遞100賬號后可以在企業管理后臺<a target="_blank">查看套餐</a>并購買單量。
發貨單服務收費標準是0.1元/單,費用套餐請看下表。
價格/元 | 電子面單與云打印單量 | 贈送 | 單價/元 |
|---|---|---|---|
5000 | 60000 | 查詢40000單 | 0.05 |
2000 | 35000 | 約0.057 | |
2000 | 20000 | 查詢15000單 | 約0.057 |
2000 | 25000 | 云盒/云打印機 | / |
1000 | 10000 | 查詢5000單 | 約0.067 |
1000 | 10000 | 云盒/云打印機 | / |
500 | 2000 | 云打印機 | / |
200 | 2000 | 0.1 |
注:電子面單與云打印單量可用于電子面單、發貨單和云打印接口服務。
企業每次成功調用接口,都會扣除單量,若單量已經扣除完畢,需要重新充值購買。
快遞100支持開具增值稅發票,用戶購買完成后可在企業管理后臺-費用中心-支付記錄-請求開票。默認開具電子增值稅普通發票,1000元以上可支持開具增值稅專用發票。
官方文檔:
http://api.kuaidi100.com/document/5f0ff9da2977d50a94e1023a.html
http://api.kuaidi100.com/document/5f0ff9e5bc8da837cbd8aefa.html
本文由 貴州做網站公司 整理發布，部分圖文來源于互聯網，如有侵權，請聯系我們刪除，謝謝！
網絡推廣與網站優化公司（網絡優化與推廣專家）作為數字營銷領域的核心服務提供方，其價值在于通過技術手段與策略規劃幫助企業提升線上曝光度、用戶轉化率及品牌影響力。這...
在當今數字化時代，公司網站已成為企業展示形象、傳遞信息和開展業務的重要平臺。然而，對于許多公司來說，網站建設的價格是一個關鍵考量因素。本文將圍繞“公司網站建設價...
在當今的數字化時代，企業網站已成為企業展示形象、吸引客戶和開展業務的重要平臺。然而，對于許多中小企業來說，高昂的網站建設費用可能會成為其發展的瓶頸。幸運的是，隨...
360xp升級win7安全嗎？360xp升級win7很安全。360安全衛士里面有一個win7你升級助手，可以不很更方便的幫忙能夠完成生級。進入360菜單頁之后，看見右下角的“功能大全”，有去添加的用戶在里面看的到“win7可以升級助手”。鼠標雙擊“win7你升級助手”，這時候它會對電腦參與檢查，看下可不可以參與可以升級，如果不是硬件水平真的太差的話就不能不能升級，不過大部分是都能夠生級的。檢測完之...
QQ游戲下載好了怎么安裝不了？這需要一點電腦知識。進入游戲廳文件夾，刪除相關游戲文件夾。如何找到這個游戲的文件夾？先打開游戲，打開游戲，再打開任務管理器。在[應用程序]中找到游戲名稱，點擊右鍵，從菜單中選擇[轉到進程]?？吹竭M程名，點擊右邊選擇【屬性】，就會看到這個游戲的文件夾。QQ怎么下載各種軟件并安裝？下載軟件有兩種。1.首先，如果你有二維碼，保存它，然后進入主頁點擊右上方的加號，選擇掃描，掃...
windows server自帶的backup怎么恢復？1. 安裝windows server備份服務。2使用Windows Server Backup進行本地一次性備份。選擇一次性備份后，將啟動一次性備份向導，并在備份向導中選擇備份方法。三。除特殊要求外，不建議備份整個服務器。首先，不建議備份不必要的數據。其次，備份過程相當緩慢。因此，您可以選擇自定義備份。4在選擇要備份的項目頁面中，選擇添加項...
免責聲明：本站內容部分文字和圖片來源于網絡，版權屬于原作者所有，若有冒犯，請聯系我們進行刪除，謝謝。聯系郵箱：1051388971#qq.com （把#換成@）