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

一、雲列印介紹

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

1. 極簡接入：普通印表機接入移動共享雲端

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

3. 極速定製：電子面單列印軟體半天擁有

二、如何使用雲列印

快寶雲列印包括6個API，分別使用與不同的場景，根據軟體使用的流程對接不同

使用雲列印，需要做如下準備：

雲列印API使用步驟，可根據具體業務選擇對接的API：

三、雲列印技術對接（以PHP為例）

介面名稱：cloud.print.do

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

請求方式：HTTP POST

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

公共請求引數：

公共響應引數

請求引數

響應引數

支援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));

$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-