打印类接口
-云打印API(new)
-电子面单API
物流跟踪类接口
-订阅推送API
-实时查询API
增值服务接口
-短信接口API
-智能识别API
寄件服务接口
-B端寄件API

快递100云打印API,简称云打印API

  • 简介:云打印API是通过接口可以满足企业、电商、微商等用户的快递单、发货单、发票等业务单据的打印需求,提升打印效率与打印质量。是专为企业提供的一体化、智能化的打印解决方案。
一、云打印API产品介绍

云打印API是专为寄件企业及快递网点打造的智能化物流打印跟踪解决方案。通过接口可以满足企业、电商、微商、快递网点、代收点等用户的快递单、发货单、发票等业务单据打印需求,提升打印效率与打印质量,为企业提供一体化、智能化打印解决方案。

和传统的快递电子面单打印相比,快递100云打印API最大的优势,就是“无限制打印模式”。它可以帮助传统电子面单打印机完全不用连接电脑、彻底摆脱安转驱动的束缚,真正实现不受限制的打单操作。形成无视距离的无线化远程打印、多人多部门的共享打印、自动打印、手机打印、便携打印等多种打印方式,完美贴合企业方寄件打印的各种使用场景。大大降低系统切换、设备切换带来的工作效率硬损耗,大大降低减低人工、设备、时效和管理成本。

免费申请API
二、接口说明
2.1 自定义打印接口
如有打印发货单等其他类打印需求,可使用该接口。通过管理后台模板配置,配置自定义摸版,实现自定义打印功能。
2.1.1 接口格式
提供统一格式的HTTP POST或GET调用接口,并返回统一格式JSON数据。
2.1.2 请求地址
https://poll.kuaidi100.com/printapi/printtask.do
请求参数:
参数名 是否必填 类型 说明
method string 业务类型(默认:printOrder)
key string 授权码,请到快递100页面申请企业版接口获取 https://api.kuaidi100.com/register/enterprise
sign string 32位大写,签名,用于验证身份,按MD5 (param +t+key+ secret)的顺序进行MD5加密,不需要加上“+”号,secret在企业管理后台的企业信息中查看
t string 时间戳如:1576123932000
param param 由其他字段拼接
param数据结构:
参数名 是否必填 类型 说明
orderId string 贵司内部自定义的订单编号,需要保证唯一性,非必填
tempid string 通过管理后台的打印摸版配置信息获取
siid string 打印设备,通过打印机输出的设备码进行获取
height string 打印纸的高度,以mm为单位,例如:100
width string 打印纸的宽度,以mm为单位,例如:75
salt string 签名用随机字符串
callBackUrl string 打印状态回调地址
****** string 其他面单特殊需求参数显示,可以到后台-面单模板选择该模板,下方有对应产生列表
2.1.3 返回结果
字段 类型 说明 备注
result boolean 提交结果 true提交成功,false失败
returnCode string 返回编码
message string 返回报文描述
data data
data数据结构
字段 类型 说明 备注
taskId string 任务ID
****** ****** 其他报文

2.1.4 提供数据内容

{  
"result": true,
"returnCode": "200",
"message": "提交成功",
"data": {
"taskId": "****", //任务ID ****** }
}
说明:
  200: 提交成功
  400: Print:参数错误
  600: 您不是合法的用户(即授权Key出错)
  601: Print:KEY已过期
  500: 服务器错误(即快递100的服务器出理间隙或临时性异常,有时如果因为不按规范提交请求,比如快递公司参数写错等,也会报此错误)
  501:重复提交
  503: 验证签名失败
2.2 附件打印接口
为各应用产品提供的智能化打印解决方案。对接后可以让企业、个人实现PC/手机无线打印,远程打印,多人共享打印。打印内容包括但不限于文档、发票、发货单、快递单等,搭配云盒使用,支持激光、喷墨、针式、热敏打印机类型。让企业和个人打印更高效、更便捷。
通过接口上传打印内容,图片或PDF、Word等文件,即可打印该内容。
2.2.1 接口格式
提供统一格式的HTTP POST或GET调用接口,并返回统一格式JSON数据。
2.2.2 请求地址
https://poll.kuaidi100.com/printapi/printtask.do
请求参数:
参数名 是否必填 类型 说明
method string 业务类型(默认:imgOrder)
key string 授权码,请到快递100页面申请企业版接口获取 https://api.kuaidi100.com/register/enterprise
sign string 32位大写,签名,用于验证身份,按MD5 (param +t+key+ secret)的顺序进行MD5加密,不需要加上“+”号,secret在企业管理后台的企业信息中查看
t string 时间戳如:1576123932000
param param 由其他字段拼接
file file 需要打印的附件
param数据结构:
参数名 是否必填 类型 说明
orderId string 贵司内部自定义的订单编号,需要保证唯一性,非必填
height string 打印纸的高度,以mm为单位,例如:100
width string 打印纸的宽度,以mm为单位,例如:75
copyNum string 需要打印的份数,默认是一份
startPage string 打印范围,起始页,仅对多页文件支持,默认是打印整个文档
endPage string 打印范围,结束页,仅对多页文件支持,默认是打印整个文档
salt string 签名用随机字符串
siid string 打印设备,通过打印机输出的设备码进行获取
callBackUrl string 打印状态回调地址
2.2.3 返回结果
字段 类型 说明 备注
result boolean 提交结果 true提交成功,false失败
returnCode string 返回编码
message string 返回报文描述
data data
data数据结构
字段 类型 说明 备注
taskId string 任务ID
****** ****** 其他报文
2.2.4 提供数据内容
{  
"result": true,
"returnCode": "200",
"message": "提交成功",
"data": {
"taskId": "****", //任务ID ****** }
}
说明:
  200: 提交成功
  400: Print:参数错误
  600: 您不是合法的用户(即授权Key出错)
  601: Print:KEY已过期
  500: 服务器错误(即快递100的服务器出理间隙或临时性异常,有时如果因为不按规范提交请求,比如快递公司参数写错等,也会报此错误)
  501:重复提交
  503: 验证签名失败
2.3 打印接口回调
通过上述接口提交的打印请求,进行打印状态返回。
2.3.1 接口格式
提供统一格式的HTTP POST或GET调用接口,并返回统一格式JSON数据。
2.3.2 请求地址
method=
"post" name="" action="[callbackUrl]"> type="text" name="taskId" value="{XXX}" /> type="text" name="param" value="{XXX}" /> type="text" name="sign" value="签名字符串" />
请求参数:
字段 类型 说明 备注
taskId string 任务ID
sign string 签名 MD5 (param +salt)
param param 参数主体
param数据结构:
参数名 是否必填 类型 说明
status string 状态编码,200:打印成功,201打印不成功
message string 状态描述
2.3.3 返回结果
字段 说明 备注
result 提交结果 true提交成功,false失败
returnCode 返回编码
message 返回报文描述
2.3.4 提供数据内容
{  
"result": true,
"returnCode": "200",
"message": "提交成功"
}
说明:
  200: 提交成功
  500: 服务器错误
  其他错误请自行定义
result:true表示回调成功,false表示失败,如果提交回调接口的地址失败,30分钟后重新回调,3次仍旧失败的,自动放弃。 其他信息快递100会忽略。
2.4 自定义生成图片接口
在没有硬件打印机的程度上,使用该接口可以自定义生成面单,发货的等信息图片。然后在有已经时候实现本地化或云打印进行图片打印。
2.4.1 接口格式
提供统一格式的HTTP POST或GET调用接口,并返回统一格式JSON数据。
2.4.2 请求地址
https://poll.kuaidi100.com/printapi/printtask.do
请求参数:
参数名 是否必填 类型 说明
method string 业务类型(默认:getPrintImg)
key string 授权码,请到快递100页面申请企业版接口获取 https://api.kuaidi100.com/register/enterprise
sign string 32位大写,签名,用于验证身份,按MD5 (param +t+key+ secret)的顺序进行MD5加密,不需要加上“+”号,secret在企业管理后台的企业信息中查看
t string 时间戳如:1576123932000
param param 由其他字段拼接
param数据结构:
参数名 是否必填 类型 说明
type string 业务类型,值为:30
orderId string 贵司内部自定义的订单编号,需要保证唯一性,非必填
tempid string 通过管理后台的打印摸版配置信息获取
height string 打印纸的高度
width string 打印纸的宽度
****** string 其他面单参数显示,可以到后台-面单模板选择该模板,下方有对应产生列表
2.4.3 返回结果
字段 类型 说明 备注
result boolean 提交结果 true提交成功,false失败
returnCode string 返回编码
message string 返回报文描述
data data
data数据结构
字段 类型 说明 备注
taskId string 任务ID
imgBase64 string 面单BASE64编码图片
****** ****** 其他报文
2.4.4 提供数据内容
{  
"result": true,
"returnCode": "200",
"message": "提交成功",
"data": {
"taskId": "****", //任务ID "imgBase64": "****", //面单BASE64编码图片 ****** }
}
说明:
  200: 提交成功
  400: Print:参数错误
  600: 您不是合法的用户(即授权Key出错)
  601: Print:KEY已过期
  500: 服务器错误(即快递100的服务器出理间隙或临时性异常,有时如果因为不按规范提交请求,比如快递公司参数写错等,也会报此错误)
  501:重复提交
  503: 验证签名失败
2.5 复打接口
对短期内打印过的面单进行复打操作。
该接口支持在提交打印请求2天内的打印任务进行复打10次的操作。
2.5.1 接口格式
提供统一格式的HTTP POST或GET调用接口,并返回统一格式JSON数据。
2.5.2 请求地址
https://poll.kuaidi100.com/printapi/printtask.do
请求参数:
参数名 是否必填 类型 说明
method string 业务类型(默认:printOld)
key string 授权码,请到快递100页面申请企业版接口获取 https://api.kuaidi100.com/register/enterprise
sign string 32位大写,签名,用于验证身份,按MD5 (param +t+key+ secret)的顺序进行MD5加密,不需要加上“+”号,secret在企业管理后台的企业信息中查看
t string 时间戳如:1576123932000
param param 由其他字段拼接
param数据结构:
参数名 是否必填 类型 说明
taskId string 任务ID
2.5.3 返回结果
字段 类型 说明 备注
result boolean 提交结果 true提交成功,false失败
returnCode string 返回编码
message string 返回报文描述
2.5.4 提供数据内容
{  
"result": true,
"returnCode": "200",
"message": "复打成功",
}
说明:
  200: 提交成功
  201: 查无此单,可能调用过期或复打次数超
  400: 参数错误
  600: 您不是合法的用户(即授权Key出错)
  601: Print:KEY已过期
  500: 服务器错误(即快递100的服务器出理间隙或临时性异常,有时如果因为不按规范提交请求,比如快递公司参数写错等,也会报此错误)
  501:重复提交
  503: 验证签名失败
三、参数字典
快递公司partnerId,partnerKey,net,code是否必填(*为必填)
快递公司 partnerId partnerKey partnerSecret net code checkMan
ane66(安能快递) *
debangkuaidi(德邦快递) *
ems(EMS) * *
guotongkuaidi(国通快递) * * *
huitongkuaidi(百世快递) * *
jd(京东物流) *
kuayue(跨越速运) * *
pjbest(品骏快递) * *
shentong(申通快递) * * * *(44号单需要加code=44)
shunfeng(顺丰速运) * *(顺丰丰密面单需要填入:顾客编码) *(检验码:丰密面单需要填入) *( 顺丰面单类型,丰密: sf_srcret 普通: sf_normal )
suer(速尔快递) * * *
xinfengwuliu(信丰物流) * *
youshuwuliu(优速物流) * *
youzhengguonei(邮政快递包裹) * *
yuantong(圆通速递) * *
yuantongguoji(圆通国际) * *
yunda(韵达快递) * *
zhaijisong(宅急送)
zhongtong(中通快递) * *
ewe(EWE全球快递) * *
tiantian(天天快递) * * *
ytchengnuoda(承诺达) * *
quanyikuaidi(全一快递) *

payType:
说明
SHIPPER 寄方付
CONSIGNEE 到付
MONTHLY 月结
THIRDPARTY 第三方支付

expType:
ne66(安能快递) 标准快递
次日达
次晨达
当日达
debangkuaidi(德邦快递) 360特惠件
电商尊享
特准快件
德邦快递
ems 标准快递
EMS经济
代收到付
快递包裹
guotongkuaidi(国通快递) 标准快递
huitongkuaidi(百世快递) 标准快递
jd(京东物流) 标准快递
京东到付
特准送
填仓
特配
鲜活
控温
冷藏
冷冻
深冷
kuayue(跨越速运) 标准快递
陆运件
同城次日
同城即日
隔日达
次日达
当天达
pjbest(品骏快递) 标准快递
标准快运
整车运输
shentong(申通快递) 标准快递
shunfeng(顺丰速运) 标准快递
顺丰标快(陆运)
电商特惠
顺丰次晨
顺丰即日
电商速配
顺丰宝平邮
顺丰宝挂号
医药常温
医药专递
物流普运
冷运到家
生鲜速配
大闸蟹专递
汽配专线
重货快运
国际特惠(试点)
行邮专列
医药专运(常温)
医药专运(温控)
国际特惠-文件
国际特惠-B类包裹
国际特惠-D类包裹
国际特惠(保税)
国际特惠(商家代理)
电商专配
重货包裹
顺丰干配
suer(速尔快递) 标准快递
xinfengwuliu(信丰物流) 标准快递
youshuwuliu(优速物流) 标准快递
youzhengguonei(邮政快递包裹) 快递包裹
yuantong(圆通速递) 标准快递
yuantongguoji(圆通国际) 标准快递
yunda(韵达快递) 标准快递
zhaijisong(宅急送) 标准快递
zhongtong(中通快递) 标准快递
ewe(EWE全球快递) 标准快递
经济奶粉
标准杂货
经济杂货
快速奶粉
杂货
quanyikuaidi(全一快递) 标准快递

关注快递100接口API