电子面单云打印方案（PHP示例）

最新推荐文章于 2023-09-11 15:52:46 发布
最新推荐文章于 2023-09-11 15:52:46 发布
阅读量1.4k 收藏 1
点赞数
文章标签： php json java
原文链接：https://my.oschina.net/u/3830680/blog/1800430
版权

物流快递、电商、ERP、仓储等都涉及发货业务都需要用到电子面单打印，市面上有各种各样的电子面单打印机，电子面单打印软件，电子面单打印工具满足了打印需求，但未能很好的满足移动端打印。这里介绍一个手机端电子面单打印通用解决方案：快宝电子面单云打印，它的优势：不限打印机型号、品牌，可打印各大快递公司电子面单，可打印菜鸟电子面单，支持批量打印，支持远程打印，实现电子面单打印机共享等。

一、对接流程

1. 注册快宝开放平台（获取ID和API  Key）

2. 安装云打印机代理程序（云端）

3. 将普通电子面单打印机接入云端

4. 调用注册云打印机API，将开发者账号，与云打印机关联

5. 发送打印任务

 

二、对接详细说明

接口名称：cloud.print.do

接口地址：https://kop.kuaidihelp.com/api

请求方式：HTTP POST

编码格式：UTF-8

结果格式：JSON

公共请求参数↓

名称类型是否必须描述
methodstring是

API接口名称

app_idstring是

用户ID（注册开放平台时分配，在控制台中查看）

signstring是

按照规则(md5(app_id + method + ts + api_key))生成的验证合法性签名

tsstring是

当前请求的时间戳

datastring是

JSON格式请求参数设置

公共响应参数↓

名称类型是否必须描述
codeint是

响应状态码。0-成功，非0-失败下载并查看详情

msgstring是

返回结果说明

uidstring是

本次请求唯一业务流水号

datastring是

JSON格式响应数据

 请求参数↓

名称类型是否必须描述
agent_idstring是

云打印机编号

actionstring是

方法标识(print.json.cn)

print_typestring是

1：底单 2：打印 3：底单和打印.(可选,默认3,任务内设置,则以任务内设置为准)

batchstring是

是否为批量

print_datastring是

打印数据

sequencestring是

当前/总数,默认1/1

template_idstring是

模板id查看详情

cp_codestring是

快递品牌下载并查看详情

pickup_codestring是

取件码(可选)

print_typestring是

1：底单 2：打印 3：底单和打印.(可选,默认3)

user_namestring是

打印人的名称，若是业务员，可包括手机号码(可选)

notestring是

备注(可选)

goods_namestring是

物品名(可选)

weightstring是

物品重量(可选)

tidstring是

(建议用订单号之类的唯一标识,提交和回调时将返回该字段, 申请单号时也将使用该字段当订单号)

recipientstring是

收件信息

addressstring是

收件人地址

provincestring是

收件人省份

districtstring是

收件人县级名称

citystring是

收件人市级名称

detailstring是

收件人详细地址

mobilestring是

收件人手机

namestring是

收件人姓名

phonestring是

收件人固话

routing_infostring是

快递路由信息

consolidationstring是

集包地信息

namestring是

集包地名称

originstring是

路由网点公司

codestring是

路由网点公司编号

namestring是

路由网点公司编号名称

route_codestring是

二三段码

sortationstring是

大字及一段码

namestring是

大字名称

senderstring是

发件信息

addressstring是

发件人地址

provincestring是

发件人省份

districtstring是

发件人县级名称

citystring是

发件人市级名称

detailstring是

发件人详细地址

mobilestring是

发件人手机

namestring是

发件人姓名

phonestring是

发件人固话

waybill_codestring是

运单号

响应参数↓

名称类型是否必须描述
statusstring是

状态

task_idstring是

此次请求任务ID

快宝电子面单云打印，支持6中开发语言的对接：Java，C#，Python，PHP，Node.js，Curl。

1. 单个电子面单打印请求代码示例，PHP举例

$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":"打印机ID，通过获取打印机列表查看打印机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. 批量电子面单打印请求代码示例，PHP举例

$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":"打印机ID，通过获取打印机列表获得打印机的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. 结合“微快递小邮筒”（微信公众号）里面配置的单号源自动获取单号、打印模板、路由信息PHP示例

$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":"打印机ID，通过获取打印机列表获取打印机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));

成功返回结果示例（json）

{
"code":int0
"msg":string"success"
"uid":string"a6934adee62d8ba3430d4ac678dd5f46c7a79d6e"
"data":{
"提交任务时的tid":{
"status":string"success"
"task_id":int46208
}
}
}

失败返回结果示例(json)

{
"code":int200115
"msg":string"业务参数有误，请检查"
"uid":string"a6934adee62d8ba3430d4ac678dd5f46c7a79d6e"
"data":{}
}

-the end-

转载于:https://my.oschina.net/u/3830680/blog/1800430

chenshuan5320
关注
  • 0
    点赞
  • 踩
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
菜鸟云打印接入Demo
weixin_34346099的博客
02-06 6637
菜鸟云打印接入Demo 0. 接入流程图 1. 连接打印客户端 首先要打开打印客户端,然后使用下面的方法,连接客户端(WebSocket协议): 地址 :  连接打印客户端 function doConnect() { socket = new WebSocket('ws://127.0.0.1:13528'); // 打开Socket ...
丰桥-顺丰快递单生成及打印功能实现 php （原）
weixin_30713953的博客
06-14 3542
这里讲的以 BS为例(CS跟BS还是有区别) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 先讲我理解的整个流程及遇到的问题,再上最终源码 我调用...
快速了解什么是“云打印”
jiaxinlaile的博客
04-20 1008
由本质上将传统打印机变成一个可以有自己独立思维逻辑的云打印机，而非仅仅配合电脑使用的外设装备。云打印突破空间的限制，可以广泛应用在移动办公、异地发货、餐饮外卖、自助设备等领域。例如一款已对接云打印平台的手机进销存APP，用户在APP里绑定云打印机，填写好单据，点击打印，就可以将单据远程打印到云打印机上，即使用户身在北京，而云打印机在广州，只要云打印机有联网，都能实现打印。云打印机有不同的类型，例如打印多联单据的针式云打印机、打印小票的热敏云打印机、打印不干胶标签的标签云打印机、打印文件的喷墨云打印机。
菜鸟云打印接入流程
Sqsdhc的博客
06-14 3553
1.注册ivs账号 https://cnlogin.cainiao.com/login?showoa=true&type=OTHERS&meta=tbu&isEnterprise=true&showin=true&showreg=true&domain=lcp&redirectURL=http%3A%2F%2Fcloud.cainiao.com%2Fpermission%2Findex
电子面单批量打印Demo工具PHP版.rar
06-22
首先，标题“电子面单批量打印Demo工具PHP版.rar”表明这是一个基于PHP编程语言的电子面单批量打印解决方案的示例代码。.rar文件是一种常见的压缩格式，通常包含多个文件或目录，这里可能包括了实现电子面单打印功能...
PHP云打印类完整示例
10-21
主要介绍了PHP云打印类,结合完整实例形式分析了php实现网络打印数据的搜集与队列排序整理及数据打印等功能,具有一定参考借鉴价值,需要的朋友可以参考下
拼多多云打印JAVA-SDK包
07-19
拼多多云打印JAVA-SDK包是拼多多开放平台提供的一款软件开发工具包，专为开发者设计，以便于实现电子面单的脱敏对接。这个SDK主要针对Java编程语言，旨在简化商家和物流服务提供商在拼多多平台上进行电子面单打印的...
云打印快递电子面单
09-25
"云打印快递电子面单"是一项利用云计算技术实现的高效快递管理服务。它允许用户通过网页或手机应用程序方便地输入快递信息，然后通过云平台进行处理，最终将生成的电子面单发送到指定的打印机进行打印。这项技术的...
顺丰电子面单接口 delphi 示例
08-31
通过 Dx10.1封装顺丰webservice接口，然后安装顺丰加密转换要求实现相关电子面单下单功能。（备注：我是D7调用，因此才需要使用Dx10.1做成DLL，如果直接使用Dx10.1则直接调用即可）
顺丰丰桥面单打印.rar
09-16
总之，“顺丰丰桥面单打印.rar”压缩包提供的代码示例，旨在帮助开发者快速集成顺丰的电子面单打印功能，提升物流效率。通过理解和应用这些知识点，开发者可以在自己的物流系统中实现顺畅的面单打印流程。
.NET电子面单接口批量打印Dem源码o.rar
06-22
总结来说，`.NET电子面单接口批量打印Dem源码o.rar`提供的`KdPrintOrderDemo`是一个示例项目，展示了如何在.NET环境中集成快递鸟的电子面单接口进行批量打印操作。开发者可以根据这个Demo学习如何对接电子面单API，...
电子面单API接口Demo.PHP版源码.rar
06-23
在这个"电子面单API接口Demo.PHP版源码.rar"压缩包中，包含了一个基于PHP语言的示例代码，用于演示如何集成电子面单服务。 首先，你需要访问快递鸟官网并注册账号，以获取必要的身份标识——`EBusinessID`和`APIKey...
电子面单接口Demo工具JAVA版.rar
06-22
5. 分析返回的响应，检查电子面单是否成功生成，如果成功，可以下载或打印面单。 在实际开发中，开发者还需要考虑以下问题： - 异步处理：电子面单生成可能需要时间，因此可能需要异步调用接口，避免阻塞主线程。 ...
Caysn云打印安卓示例程序
06-27
【Caysn云打印安卓示例程序】是一个专为开发者设计的应用示例，它展示了如何在Android平台上利用Caysn云打印技术进行远程打印操作。这个示例程序使用了Mqtt（Message Queuing Telemetry Transport）协议，这是一种轻...
PHP调用快递100电子面单接口API接口
心学的博客
04-11 2508
PHP调用快递100电子面单接口API接口1.注册申请快递100接口2.接口调用 1.注册申请快递100接口 https://poll.kuaidi100.com/pollquery/pollStep.do?method=myApiKey. 申请快递100企业版-快递查询接口(API) 截图如下 申请通过快递100接口会已邮件的形式发送给你对应的配置参数 截图如下 2.接口调用 // 快递1...
PHP调用API接口的方法及实现(内附电商平台商品详情接口案例）
最新发布
APItesterCris的博客
09-11 1849
随着互联网、云计算和大数据时代的到来，越来越多的应用程序需要调用第三方的API接口来获取数据，实现数据互通和协同工作。PHP作为一种常用的服务器端语言，也可以通过调用API接口来实现不同系统的数据交互和整合。本文将介绍PHP调用API接口的方法及实现过程。
PHP实现云打印
Seventeen
06-04 640
PHP实现云打印机打印 打印机 是易联云云打印机 K4 HW 云打印机一般都会有接口文档,京东淘宝上都有卖 可以问客服都会告诉你文档路径可不可以二次开发 技术文档 以此为例技术文档里面有sdk 可以直接下载看 ...
顺丰丰桥 php,顺丰 丰桥对接 订单路由查询 ruby rails
weixin_35318343的博客
03-11 423
def self.get_express_route_testurl = ‘http://bsp-oisp.sf-express.com/bsp-oisp/sfexpressService‘xml = "4545"keyword = ‘dsadsa‘md5_str = Digest::MD5.digest((xml + keyword).encode(‘utf-8‘))verifyCode = B...
php 请求 响应,PHP - 模拟请求和操作响应
weixin_33249310的博客
03-09 224
模拟请求fsockopen// 建立连接$link = fsockopen('localhost', '80');define('CRLF', "\r\n");// 请求行$request_data = 'GET /'.CRLF;// 请求头$request_data .= 'Host: localhost'.CRLF;$request_data .= 'User-Agent: Mozilla/5...

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值