社群 學習 工具庫 休閒
搜尋
繁体中文
首頁 > 後端開發 > php教程 > PHP程式碼範例之電子麵單列印通用解決方案

PHP程式碼範例之電子麵單列印通用解決方案

不言
發布： 2023-03-24 19:16:01
原創
5328 人瀏覽過

這篇文章介紹的內容是關於PHP程式碼範例之電子麵單列印通用解決方案，有著一定的參考價值，現在分享給大家，有需要的朋友可以參考一下

物流快遞、電商、ERP、倉儲等都涉及發貨業務都需要用到電子麵單打印，市面上有各種各樣的電子麵單打印機，電子麵單打印軟體，電子麵單打印工具滿足了列印需求，但未能很好的滿足行動端列印。這裡介紹一個手機端電子麵單列印通用解決方案：快寶電子麵單雲列印，它的優點：不限印表機型號、品牌，可列印各大快遞公司電子麵單，可列印菜鳥電子麵單，支援大量列印，支援遠端列印，實現電子麵單印表機共用等。


#一、雲端列印介紹

#快寶電子麵單雲列印，將普通熱敏印表機一鍵接入雲端，並提供封裝好的印表機管理、列印任務發送、任務狀態更新等接口，助力開發者一天就可開發出一個功能完整、使用便利的行動電子麵單列印程式。有以下特點：

1. 極簡存取：普通印表機存取行動共享雲端

2.極速請求：一個http請求就可以完成列印

3. 極速客製化：電子麵單列印軟體半天擁有


#二、如何使用雲端列印


將開發者帳號與雲端印表機關聯解除開發者帳號與雲端印表機關聯##傳送列印任務傳送列印任務給雲端印表機
#快寶雲列印包含6個API，分別使用與不同的場景，依照軟體所使用的流程對接不同
雲端列印API清單
介面名稱 介面描述
#註冊雲端印表機
刪除雲端印表機

取得雲端印表機清單

# 取得開發者帳號已關聯的雲端印表機資訊

取得某個列印任務資訊 取得某個雲端印表機資訊使用雲端列印，需要做以下準備：對接準備工作準備工作備註
#查詢列印任務詳情
#取得雲端印表機資訊
####電子麵單印表機######不限品牌，不限型號# ###########安裝雲端列印代理程式（下載網址：http://ckd.so/ydy）######win 7以上系統，不支援Mac系統#### ########獲的快寶開放平台開發者帳號資訊（ID和API  Key）######註冊快寶開放平台即可取得（http://open.kuaidihelp.com/） ############

雲端列印API使用步驟，可依特定業務選擇對接的API：



#2、雲端列印技術對接（以PHP為例）

介面名稱：cloud.print.do

正式網址：https://kop.kuaidihelp.com/api

#請求方式：HTTP POST

請求方法編碼格式：utf-8

#公用請求參數：


#名稱##data
類型是否必須 描述
methodstring 是 API介面名稱
app_idstring 是 使用者ID（註冊開放平台時分配，在控制台中查看）
signstring 是 依照規則(md5(app_id method ts api_key))產生的驗證合法性簽章
tsstring 是 目前請求的時間戳記
###string######是######JSON格式請求參數設定#############

公共回應參數


# #

請求參數


#
名稱 類型 是否必須 描述
code #int 是 回應狀態碼。 0-成功，非0-失敗
msg string 是 #傳回結果說明
uid string #是 本次請求唯一業務管線編號
data string 是 JSON格式回應資料
string是範本id查看詳情是##pickup_code string是取件碼(可選) #print_typestring是1：底單2：列印3：底單與列印.(可選,預設3)user_namestring#是列印人的名稱，若是業務員，可包含手機號碼(可選)notestring是#備註(可選)#goods_namestring物品名稱(可選)##string是收件訊息string是收件者位址string是收件者省string是收件者縣級名稱string是收件者市級名稱是#收件者手機是收件者名稱是收件者固話是快遞路由資訊是集包地資訊是集包地名稱string是路由網點公司編號名稱string是二三段碼string是大字及一段碼string是大字名稱string是寄件訊息string 是寄件者位址string是寄件人省string是寄件者市級名稱string是寄件者詳細位址是寄件者名稱是#寄件者固話# waybill_codestring
名稱 類型 是否必須
#agent_id string #是 雲端印表機編號
action string 是 方法識別(print.json.cn)
print_type string 是 1：底單2：列印3：底單和列印.(可選,預設3,任務內設定,則以任務內設定為準)
batch string 是 是否為批次
print_data
print_data string是######列印資料########################sequence string 是 目前/總數,預設1/1
##template_id
cp_code string
快遞品牌
##是
#######weight string 是 物品重量(可選)
tid string 是 (建議用訂單號碼之類的唯一識別,提交和回調時將返回該欄位, 申請單號時也會使用該欄位當訂單號碼)
#recipient
address
#province
district
city
#detail string 是 收件者詳細位址
# mobilestring
name string
phonestring
routing_infostring
consolidation string
namestring
originstring###是######路由網點公司########################code string 是 #路由網點公司編號
##name
route_code
sortation
name
sender
address
#province
#district string 是 寄件者縣級名稱
# #city
detail
##mobilestring 是 寄件者手機
# #namestring
phonestring
###是######運單號碼############

回應參數


描述#狀態此請求任務ID
名稱 類型 是否必須
status string 是
task_id string 是

支援Java，C#，Python，PHP，Node.js，Curl等6中語言接入，下面以PHP為例，展示
發送請求任務

程式碼範例。

1. 單一列印任務，請求範例

$host = "https://kop.kuaidihelp.com/api";
$method = "POST";
$headers = array();
//根据API的要求，定义相对应的Content-Type
array_push($headers, "Content-Type".":"."application/x-www-form-urlencoded; charset=UTF-8");
$querys = "";
$bodys = [
"app_id"=>'50001',
"method"=>'cloud.print.do',
"sign"=>"bdf3b5f50865ac813cbdfd6c9b572b79",
"ts"=>'1524209949',
"data"=>'{		
			"action":"print.json.cn(菜鸟标准格式JSON)", //
			"agent_id":"目标打印代理", //必填
			"print_type":"打印类型", //1:预览, 2:打印, 3:打印预览. 未设置则默认为3.(任务内设置,则以任务内设置为准)
			"batch":"", //字符串"true"或者bool值 true则为批量,其他值则为非批量 是否为批量
			"print_data": {
				"sequence": "1/1", //可选,打印文档当前序列:当前/总数,默认1/1
				"template_id": "模板id",
				"cp_code": "快递品牌(提供模板id,此字段会被忽略)",//参照“快递品牌列表”,兼容菜鸟和快宝品牌编码
				"pickup_code": "取件码(可选)",
				"print_type": "1：底单 2：打印 3：底单和打印.(可选,默认3)",
				"user_name": "打印人的名称，若是业务员，可包括手机号码(可选)",
				"note": "备注(可选)",
				"goods_name": "物品名(可选)",
				"weight": "物品重量(可选)",
				"tid": "(建议用订单号之类的唯一标识,提交和回调时将返回该字段, 申请单号时也将使用该字段当订单号)",
				"recipient": {
					"address": {
					"city": "宁德市",
					"detail": "哦里咯啦咯啦",
					"district": "福鼎市",
					"province": "福建省"
					},
					"mobile": "13344556677",
					"name": "XXX",
					"phone": ""
				},
				"routing_info": {
					"consolidation": {"name": "温州转福鼎包(集包名)"},
					"origin": {"code": "610025","name": "四川邛崃公司"},
					"route_code": "009 030(二三段码)",
					"sortation": {"name": "福鼎351(大字 一段码)"}
				},
			"sender": {
				"address": {
					"city": "成都市",
					"detail": "兴民街55号",
					"district": "邛崃市",
					"province": "四川省"
				},
				"mobile": "13344556677",
				"name": "XXX",
				"phone": ""
			},
			"waybill_code": "333333333333"
			}
			}'
];
$bodys = http_build_query($bodys);
$url = $host;
$curl = curl_init();
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
curl_setopt($curl, CURLOPT_FAILONERROR, false);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, true);
if (1 == strpos("$".$host, "https://"))
{
    curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
    curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);
}
curl_setopt($curl, CURLOPT_POSTFIELDS, $bodys);
var_dump(curl_exec($curl));
登入後複製

2. 批次列印任務，請求範例

$host = "https://kop.kuaidihelp.com/api";
$method = "POST";
$headers = array();
//根据API的要求，定义相对应的Content-Type
array_push($headers, "Content-Type".":"."application/x-www-form-urlencoded; charset=UTF-8");
$querys = "";
$bodys = [
"app_id"=>'50001',
"method"=>'cloud.print.do',
"sign"=>"bdf3b5f50865ac813cbdfd6c9b572b79",
"ts"=>'1524209949',
"data"=>'{
    "action":"print.json.cn(菜鸟标准格式JSON)", //
    "agent_id":"目标打印代理", //必填
    "print_type":"打印类型", //1:预览, 2:打印, 3:打印预览. 未设置则默认为3.(任务内设置,则以任务内设置为准)
    "batch":"", //字符串"true"或者bool值 true则为批量,其他值则为非批量 是否为批量
    "print_data":  [
  {
    "cod_amount": 200, //如果是货到付款服务,则使用该字段
    "sequence": "1/1", //可选,打印文档当前序列:当前/总数,默认1/1
    "template_id": "模板id",
    "cp_code": "快递品牌",//参照“快递品牌列表”,兼容菜鸟和快宝品牌编码
    "pickup_code": "取件码(可选)",
    "print_type": "1：底单 2：打印 3：底单和打印.(可选,默认3)",
    "user_name": "打印人的名称，若是业务员，可包括手机号码(可选)",
    "note": "备注(可选)",
    "goods_name": "物品名(可选)",
    "weight": "物品重量(可选)",
    "tid": "(建议用订单号之类的唯一标识,提交和回调时将返回该字段, 申请单号时也将使用该字段当订单号)",
    "recipient": {
      "address": {
        "city": "宁德市",
        "detail": "哦里咯啦咯啦",
        "district": "福鼎市",
        "province": "福建省"
      },
      "mobile": "13344556677",
      "name": "XXX",
      "phone": ""
    },
    "routing_info": {
      "consolidation": {
        "name": "温州转福鼎包(集包名)"
      },
      "origin": {
        "code": "610025",
        "name": "四川邛崃公司"
      },
      "route_code": "009 030(二三段码)",
      "sortation": {
        "name": "福鼎351(大字 一段码)"
      }
    },
    "sender": {
      "address": {
        "city": "成都市",
        "detail": "兴民街55号",
        "district": "邛崃市",
        "province": "四川省"
      },
      "mobile": "13344556677",
      "name": "XXX",
      "phone": ""
    },
    "waybill_code": "333333333333"
  }
]

}'
];
$bodys = http_build_query($bodys);
$url = $host;
$curl = curl_init();
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
curl_setopt($curl, CURLOPT_FAILONERROR, false);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, true);
if (1 == strpos("$".$host, "https://"))
{
    curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
    curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);
}
curl_setopt($curl, CURLOPT_POSTFIELDS, $bodys);
var_dump(curl_exec($curl));
登入後複製

3.結合「微快遞小郵筒」（微信公眾號）裡面配置的單號來源自動取得單號、列印範本、路由資訊範例

$host = "https://kop.kuaidihelp.com/api";
$method = "POST";
$headers = array();
//根据API的要求，定义相对应的Content-Type
array_push($headers, "Content-Type".":"."application/x-www-form-urlencoded; charset=UTF-8");
$querys = "";
$bodys = [
"app_id"=>'50001',
"method"=>'cloud.print.do',
"sign"=>"bdf3b5f50865ac813cbdfd6c9b572b79",
"ts"=>'1524209949',
"data"=>'{
    "action":"print.json.cn(菜鸟标准格式JSON)", //
    "agent_id":"目标打印代理", //必填
    "print_type":"打印类型", //1:预览, 2:打印, 3:打印预览. 未设置则默认为3.(任务内设置,则以任务内设置为准)
    "batch":"", //字符串"true"或者bool值 true则为批量,其他值则为非批量 是否为批量
    "print_data":  {
  "cod_amount": 200, //如果是货到付款服务,则使用该字段
  "sequence": "1/1", //可选,打印文档当前序列:当前/总数,默认1/1
  "template_id": "模板id",
  "cp_code": "快递品牌(提供模板id,此字段会被忽略)",//参照“快递品牌列表”,兼容菜鸟和快宝品牌编码
  "pickup_code": "取件码(可选)",
  "print_type": "1：底单 2：打印 3：底单和打印.(可选,默认3)",
  "user_name": "打印人的名称，若是业务员，可包括手机号码(可选)",
  "note": "备注(可选)",
  "goods_name": "物品名(可选)",
  "weight": "物品重量(可选)",
  "tid": "(建议用订单号之类的唯一标识,提交和回调时将返回该字段, 申请单号时也将使用该字段当订单号)",
  "sender": {
      "address": {
          "province": "江西省",
          "city": "赣州市",
          "district": "寻乌县",
          "detail": "寻乌县"
      },
      "mobile": "13344556677",
      "phone": "",
      "name": "XXX"
  },
  "recipient": {
      "address": {
          "province": "江西省",
          "city": "宜春市",
          "district": "袁州区",
          "detail": "秀江外滩电13栋"
      },
      "mobile": "13344556677",
      "phone": "",
      "name": "XXX"
  },
  "routing_info": {},
  "waybill_code": "" //留空!留空!留空!
  }


}'
];
$bodys = http_build_query($bodys);
$url = $host;
$curl = curl_init();
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
curl_setopt($curl, CURLOPT_FAILONERROR, false);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, true);
if (1 == strpos("$".$host, "https://"))
{
    curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
    curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);
}
curl_setopt($curl, CURLOPT_POSTFIELDS, $bodys);
var_dump(curl_exec($curl));
登入後複製


################## ##########-the end-###

以上是PHP程式碼範例之電子麵單列印通用解決方案的詳細內容。更多資訊請關注PHP中文網其他相關文章！

相關標籤：
php 列印 一般
來源：php.cn
上一篇：php的正規表​​示式 下一篇：PHP實作執行外部程式的方法詳解
本網站聲明
本文內容由網友自願投稿，版權歸原作者所有。本站不承擔相應的法律責任。如發現涉嫌抄襲或侵權的內容，請聯絡admin@php.cn
作者最新文章
最新問題
PHP數組從URL參數中取得的行為不如預期 我有一個包含類別ID的URL參數，我想將其視為一個數組，如下所示：http://example.com?cat[]=3,9,13在PHP中，我使用它從URL參數取得數組：$catI...
來自於 2024-04-06 22:09:02
0
1
1428
我應該在 apache 中哪裡放置 CustomLog 指令 我正在使用php:7.2-apachedocker。我需要禁用運行狀況檢查url登入訪問日誌。基於此鏈接，他們提到了有關修改Customlog指令的資訊。我不是關於需要更改Cust...
來自於 2024-04-06 22:03:59
0
1
990
傳回值中變數的格式是什麼？ 我是php的新學習者。我發現有一段程式碼：if($x<time()){return[false,'error'];}邏輯或變數並不重要，但我不明白[false,'error'...
來自於 2024-04-06 21:55:20
0
1
778
使用opentbs產生odt檔案時遇到的問題：相同key的值顯示在同一行而不是單獨的欄位中。 我正在使用一個名為OpenTbs的庫來使用PHP建立odt，我使用它是因為動態生成列和行。我知道如何建立行和列，但我不知道如何組織它們。讓我加入一個例子：所以首先我會將其添加到我的...
來自於 2024-04-06 20:18:18
0
1
483
依照ID對MySQL結果進行分組以便循環遍歷 我有一個表，其中有mysql中的航班資料。我正在編寫一個php程式碼，它將使用codeigniter3對資料進行分組和顯示journey_idair_idFlightDuratio...
來自於 2024-04-06 17:27:56
0
1
406
相關專題
更多>
熱門推薦
熱門教學
更多>
相關教學
熱門推薦
最新課程
最新下載
更多>
網站特效
網站源碼
網站素材
前端模板