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

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

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

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

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

免费申请API
二、接口说明
2.1 带打印功能电子面单接口
通过快递公司或网点、菜鸟与淘宝提供的电子面单账号,提交生成电子面单,调用云打印机打印输出,可自定义面单模板,支持远程打印机和共享打印。
2.1.1 接口格式
提供统一格式的HTTP POST或GET调用接口,并返回统一格式JSON数据。
2.1.2 请求地址
http://poll.kuaidi100.com/printapi/printtask.do
参数名 是否必填 类型 说明
method string 业务类型(默认:eOrder)
key string 授权码,请到快递100页面申请企业版接口获取 http://vmm33.com/openapi
sign string 32位大写,签名,用于验证身份,按MD5 (param +t+key+ secret)的顺序进行MD5加密,不需要加上“+”号,secret在授权邮件里面有
t string 时间戳如:1576123932000
param string 由其他字段拼接
param数据结构:
type为10时(电子面单)格式:
参数名 是否必填 类型 说明
type string 内容打印默认参数,10默认是电子面单
partnerId string 电子面单客户账户或月结账号,需向快递公司在贵司当地的网点申请;
若所选快递公司为京东或德邦全国快递,可联系快递100进行账号授权操作,则此项可不填。
其他请查看参数字典
partnerKey string 电子面单密码,需向快递公司在贵司当地的网点申请;
若所选快递公司为京东或德邦全国快递,可联系快递100进行账号授权操作,则此项可不填。
其他请查看参数字典
net string 收件网点名称,由快递公司当地网点分配, 若使用淘宝授权填入(taobao),使用菜鸟授权填入(cainiao)。
其他请查看参数字典
kuaidicom string 快递公司的编码,一律用小写字母,见《快递公司编码》
recMan name string 收件人姓名
mobile string 收件人的手机号,手机号和电话号二者其一必填
tel string 收件人的电话号,手机号和电话号二者其一必填
zipCode string 收件人所在地的编箱号
province string 收件人所在省份,如广东省,province, city, district, addr 和 printAddr 任选一个必填
city string 收件人所在市,如深圳市, province, city, district, addr 和 printAddr 任选一个必填
district string 收件人所在区,如南山区, province, city, district, addr 和 printAddr 任选一个必填
addr string 收件人所在地址,如科技南十二路2号金蝶软件园, province, city, district, addr 和 printAddr 任选一个必填
printAddr string 收件人所在完整地址,如广东深圳市深圳市南山区科技南十二路2号金蝶软件园, province, city, district, addr 和 printAddr 任选一个必填。如果有填写province、city、district、addr 则系统优先读取province, city、district、addr;如果只填写printAddr,系统将自动识别对应的省、市与区
company string 收件人所在公司名称
sendMan name string 寄件人姓名
mobile string 寄件人的手机号,手机号和电话号二者其一必填
tel string 寄件人的电话号,手机号和电话号二者其一必填
zipCode string 寄件人所在地的邮编号
province string 寄件人所在省份,如广东省,province, city, district, addr 和 printAddr 任选一个必填。
city string 寄件人所在市,如深圳市, province, city, district, addr 和 printAddr 任选一个必填
district string 寄件人所在区,如南山区, province, city, district, addr 和 printAddr 任选一个必填
addr string 寄件人所在地址,如高新南十八道20号xxx, province, city, district, addr 和 printAddr 任选一个必填
printAddr string 寄件人所在的完整地址,如广东深圳市深圳市南山区科技南十二路2号金蝶软件园B10, province, city, district, addr 和 printAddr 任选一个必填。如果有填写province、city、district、addr 则系统优先读取province, city、district、addr;如果只填写printAddr,系统将自动识别对应的省、市与区
company string 寄件人所在公司名称
code string 系统标识(目前申通44面单需要填写此项code=44),其他无需
cargo string 物品名称
count string 物品总数量,int类型,必填;如果需要子单(指同一个订单打印出多张电子面单,即同一个订单返回多个面单号),needChild = 1、count 需要大于1,如count = 2 则一个主单 一个子单,count = 3则一个主单 二个子单;返回的子单号码见返回结果的childNum字段
weight string 物品总重量KG,double类型
volumn string 物品总体积,CM*CM*CM,double类型
payType string 支付方式:SHIPPER:寄方付(默认)、CONSIGNEE:到付、MONTHLY:月结、THIRDPARTY:第三方支付(详细看参数字典)
expType string 快递类型:标准快递(默认)、顺丰特惠、EMS经济(详细看参数字典)
remark string 备注
valinsPay double 保价额度
collection double 代收货款额度
needChild string 是否需要子单:1:需要、0:不需要(默认) ,String类型,非必填;如果需要子单(指同一个订单打印出多张电子面单,即同一个订单返回多个面单号),needChild = 1、count 需要大于1,如count = 2 一个主单 一个子单,count = 3 一个主单 二个子单,返回的子单号码见返回结果的childNum字段
needBack string 是否需要回单:1:需要、 0:不需要(默认) ,String类型,非必填;返回的回单号见返回结果的returnNum字段
orderId string 贵司内部自定义的订单编号,需要保证唯一性,非必填
tempid string 通过管理后台的打印摸版配置信息获取
height string 打印纸的高度
width string 打印纸的宽度
siid string 打印设备,通过打印机输出的设备码进行获取
salt string 签名用随机字符串
op string 是否开启订阅功能,默认是:0(不开启),如果是1说明开启订阅功能此时pollCallBackUrl必须填入,此功能只针对有快递单号的单
callBackUrl string 打印状态回调地址
pollCallBackUrl string 如果op设置为1时,pollCallBackUrl必须填入
resultv2 string 添加此字段表示开通行政区域解析功能,见3.1.2相关说明。
0:关闭(默认),1:开通行政区域解析功能,2:开通行政解析功能并且返回出发、目的及当前城市信息
****** string 其他面单参数显示,可以到后台-面单模板选择该模板,下方有对应产生列表
type为30时(内容)格式:
参数名 是否必填 类型 说明
type string 内容打印默认参数,参数为30
kuaidicom string 快递公司的编码,一律用小写字母,见《快递公司编码》
kuaidinum string 快递单号,单号的最大长度是32个字符
recMan name string 收件人姓名
mobile string 收件人的手机号,手机号和电话号二者其一必填
tel string 收件人的电话号,手机号和电话号二者其一必填
zipCode string 收件人所在地的编箱号
province string 收件人所在省份,如广东省,province, city, district, addr 和 printAddr 任选一个必填
city string 收件人所在市,如深圳市, province, city, district, addr 和 printAddr 任选一个必填
district string 收件人所在区,如南山区, province, city, district, addr 和 printAddr 任选一个必填
addr string 收件人所在地址,如科技南十二路2号金蝶软件园, province, city, district, addr 和 printAddr 任选一个必填
printAddr string 收件人所在完整地址,如广东深圳市深圳市南山区科技南十二路2号金蝶软件园, province, city, district, addr 和 printAddr 任选一个必填。如果有填写province、city、district、addr 则系统优先读取province, city、district、addr;如果只填写printAddr,系统将自动识别对应的省、市与区
company string 收件人所在公司名称
sendMan name string 寄件人姓名
mobile string 寄件人的手机号,手机号和电话号二者其一必填
tel string 寄件人的电话号,手机号和电话号二者其一必填
zipCode string 寄件人所在地的邮编号
province string 寄件人所在省份,如广东省,province, city, district, addr 和 printAddr 任选一个必填。
city string 寄件人所在市,如深圳市, province, city, district, addr 和 printAddr 任选一个必填
district string 寄件人所在区,如南山区, province, city, district, addr 和 printAddr 任选一个必填
addr string 寄件人所在地址,如高新南十八道20号xxx, province, city, district, addr 和 printAddr 任选一个必填
printAddr string 寄件人所在的完整地址,如广东深圳市深圳市南山区科技南十二路2号金蝶软件园B10, province, city, district, addr 和 printAddr 任选一个必填。如果有填写province、city、district、addr 则系统优先读取province, city、district、addr;如果只填写printAddr,系统将自动识别对应的省、市与区
company string 寄件人所在公司名称
cargo string 物品名称
count string 物品总数量,int类型,必填;如果需要子单(指同一个订单打印出多张电子面单,即同一个订单返回多个面单号),needChild = 1、count 需要大于1,如count = 2 则一个主单 一个子单,count = 3则一个主单 二个子单;返回的子单号码见返回结果的childNum字段
weight string 物品总重量KG,double类型
volumn string 物品总体积,CM*CM*CM,double类型
payType string 支付方式:SHIPPER:寄方付(默认)、CONSIGNEE:到付、MONTHLY:月结、THIRDPARTY:第三方支付(详细看参数字典
expType string 快递类型:标准快递(默认)、顺丰特惠、EMS经济(详细看参数字典
remark string 备注
valinsPay double 保价额度
collection double 代收货款额度
needBack string 是否需要回单:1:需要、 0:不需要(默认) ,String类型,非必填;返回的回单号见返回结果的returnNum字段
orderId string 贵司内部自定义的订单编号,需要保证唯一性,非必填
tempid string 通过管理后台的打印摸版配置信息获取
height string 打印纸的高度
width string 打印纸的宽度
siid string 打印设备,通过打印机输出的设备码进行获取
salt string 签名用随机字符串
op string 是否开启订阅功能,默认是:0(不开启),如果是1说明开启订阅功能此时pollCallBackUrl必须填入,此功能只针对有快递单号的单
callBackUrl string 打印状态回调地址
pollCallBackUrl string 如果op设置为1时,pollCallBackUrl必须填入
resultv2 string 添加此字段表示开通行政区域解析功能,见3.1.2相关说明。
0:关闭(默认),1:开通行政区域解析功能,2:开通行政解析功能并且返回出发、目的及当前城市信息
****** string 其他面单参数显示,可以到后台-面单模板选择该模板,下方有对应产生列表
2.1.3 返回结果
字段 类型 说明 备注
result boolean 提交结果 true提交成功,false失败
returnCode string 返回编码
message string 返回报文描述
data data
data数据结构
字段 类型 说明 备注
taskId string 任务ID
kuaidicom string 快递公司编码
kuaidinum string 快递单号
****** ****** 其他报文

2.1.4 提供数据内容

      {
        "result":true,
        "returnCode":"200",
        "message":"提交成功",
        "data":{
          "taskId":"****",	//任务ID
          "kuaidicom":"****",	//快递公司编码
          "kuaidinum":"****" //快递单号
          ******
        }
      }
         
说明:
  200: 提交成功
  400: Print:参数错误
  600: 您不是合法的用户(即授权Key出错)
  601: Print:KEY已过期
  500: 服务器错误(即快递100的服务器出理间隙或临时性异常,有时如果因为不按规范提交请求,比如快递公司参数写错等,也会报此错误)
  501:重复提交
  503: 验证签名失败
2.2 自定义生成图片接口
通过快递公司或网点、菜鸟与淘宝提供的电子面单账号,提交生成电子面单;通过管理后台模板配置,自定义面单摸版,生成图片输出,可自选方式打印。
2.2.1 接口格式
提供统一格式的HTTP POST或GET调用接口,并返回统一格式JSON数据。
2.2.2 请求地址
http://poll.kuaidi100.com/printapi/printtask.do
请求参数:
参数名 是否必填 类型 说明
method string 业务类型(默认:getPrintImg)
key string 授权码,请到快递100页面申请企业版接口获取 http://vmm33.com/openapi
sign string 32位大写,签名,用于验证身份,按MD5 (param +t+key+ secret)的顺序进行MD5加密,不需要加上“+”号,secret在授权邮件里面有
t string 时间戳如:1576123932000
param param 由其他字段拼接
param数据结构:
type为10时(电子面单)格式:
参数名 是否必填 类型 说明
type string 内容打印默认参数,10默认是电子面单
partnerId string 电子面单客户账户或月结账号,需向快递公司在贵司当地的网点申请;
若所选快递公司为京东或德邦全国快递,可联系快递100进行账号授权操作,则此项可不填。
其他请查看参数字典
partnerKey string 电子面单密码,需向快递公司在贵司当地的网点申请;
若所选快递公司为京东或德邦全国快递,可联系快递100进行账号授权操作,则此项可不填。
其他请查看参数字典
net string 收件网点名称,由快递公司当地网点分配, 若使用淘宝授权填入(taobao),使用菜鸟授权填入(cainiao)。
其他请查看参数字典
kuaidicom string 快递公司的编码,一律用小写字母,见《快递公司编码》
recManName string 收件人姓名
recManMobile string 收件人的手机号,手机号和电话号二者其一必填
recManTel string 收件人的电话号,手机号和电话号二者其一必填
recManZipCode string 收件人所在地的编箱号
recManProvince string 收件人所在省份,如广东省,province, city, district, addr 和 printAddr 任选一个必填
recManCity string 收件人所在市,如深圳市, province, city, district, addr 和 printAddr 任选一个必填
recManDistrict string 收件人所在区,如南山区, province, city, district, addr 和 printAddr 任选一个必填
recManAddr string 收件人所在地址,如科技南十二路2号金蝶软件园, province, city, district, addr 和 printAddr 任选一个必填
recManPrintAddr string 收件人所在完整地址,如广东深圳市深圳市南山区科技南十二路2号金蝶软件园, province, city, district, addr 和 printAddr 任选一个必填。如果有填写province、city、district、addr 则系统优先读取province, city、district、addr;如果只填写printAddr,系统将自动识别对应的省、市与区
recManCompany string 收件人所在公司名称
sendManName string 寄件人姓名
sendManMobile string 寄件人的手机号,手机号和电话号二者其一必填
sendManTel string 寄件人的电话号,手机号和电话号二者其一必填
sendManZipCode string 寄件人所在地的邮编号
sendManProvince string 寄件人所在省份,如广东省,province, city, district, addr 和 printAddr 任选一个必填。
sendManCity string 寄件人所在市,如深圳市, province, city, district, addr 和 printAddr 任选一个必填
sendManDistrict string 寄件人所在区,如南山区, province, city, district, addr 和 printAddr 任选一个必填
sendManAddr string 寄件人所在地址,如高新南十八道20号xxx, province, city, district, addr 和 printAddr 任选一个必填
sendManPrintAddr string 寄件人所在的完整地址,如广东深圳市深圳市南山区科技南十二路2号金蝶软件园B10, province, city, district, addr 和 printAddr 任选一个必填。如果有填写province、city、district、addr 则系统优先读取province, city、district、addr;如果只填写printAddr,系统将自动识别对应的省、市与区
sendManCompany string 寄件人所在公司名称
code string 系统标识(目前申通44面单需要填写此项code=44),其他无需
cargo string 物品名称
count string 物品总数量,int类型,必填;如果需要子单(指同一个订单打印出多张电子面单,即同一个订单返回多个面单号),needChild = 1、count 需要大于1,如count = 2 则一个主单 一个子单,count = 3则一个主单 二个子单;返回的子单号码见返回结果的childNum字段
weight string 物品总重量KG,double类型
volumn string 物品总体积,CM*CM*CM,double类型
payType string 支付方式:SHIPPER:寄方付(默认)、CONSIGNEE:到付、MONTHLY:月结、THIRDPARTY:第三方支付(详细看参数字典)
expType string 快递类型:标准快递(默认)、顺丰特惠、EMS经济(详细看参数字典)
remark string 备注
valinsPay double 保价额度
collection double 代收货款额度
needChild string 是否需要子单:1:需要、0:不需要(默认) ,String类型,非必填;如果需要子单(指同一个订单打印出多张电子面单,即同一个订单返回多个面单号),needChild = 1、count 需要大于1,如count = 2 一个主单 一个子单,count = 3 一个主单 二个子单,返回的子单号码见返回结果的childNum字段
needBack string 是否需要回单:1:需要、 0:不需要(默认) ,String类型,非必填;返回的回单号见返回结果的returnNum字段
orderId string 贵司内部自定义的订单编号,需要保证唯一性,非必填
tempid string 通过管理后台的打印摸版配置信息获取
height string 打印纸的高度
width string 打印纸的宽度
salt string 签名用随机字符串
op string 是否开启订阅功能,默认是:0(不开启),如果是1说明开启订阅功能此时pollCallBackUrl必须填入,此功能只针对有快递单号的单
pollCallBackUrl string 如果op设置为1时,pollCallBackUrl必须填入
resultv2 string 添加此字段表示开通行政区域解析功能,见3.1.2相关说明。
0:关闭(默认),1:开通行政区域解析功能,2:开通行政解析功能并且返回出发、目的及当前城市信息
****** string 其他面单参数显示,可以到后台-面单模板选择该模板,下方有对应产生列表
type为30时(内容)格式:
参数名 是否必填 类型 说明
type string 内容打印默认参数,参数为30
kuaidicom string 快递公司的编码,一律用小写字母,见《快递公司编码》
kuaidinum string 快递单号,单号的最大长度是32个字符
orderId string 贵司内部自定义的订单编号,需要保证唯一性,非必填
tempid string 通过管理后台的打印摸版配置信息获取
height string 打印纸的高度
width string 打印纸的宽度
salt string 签名用随机字符串
op string 是否开启订阅功能,默认是:0(不开启),如果是1说明开启订阅功能此时pollCallBackUrl必须填入,此功能只针对有快递单号的单
pollCallBackUrl string 如果op设置为1时,pollCallBackUrl必须填入
resultv2 string 添加此字段表示开通行政区域解析功能,见3.1.2相关说明。
0:关闭(默认),1:开通行政区域解析功能,2:开通行政解析功能并且返回出发、目的及当前城市信息
****** string 其他面单参数显示,可以到后台-面单模板选择该模板,下方有对应产生列表
2.2.3 返回结果
字段 类型 说明 备注
result boolean 提交结果 true提交成功,false失败
returnCode string 返回编码
message string 返回报文描述
data data
data数据结构
字段 类型 说明 备注
taskId string 任务ID
kuaidicom string 快递公司编码
kuaidinum string 快递单号
imgBase64 string 面单BASE64编码图片
****** ****** 其他报文
2.2.4 提供数据内容
      {
        "result":true,
        "returnCode":"200",
        "message":"提交成功",
        "data":{
          "taskId":"****",	//任务ID
          "kuaidicom":"****",	//快递公司编码
          "kuaidinum":"****" //快递单号
          "imgBase64":"****", //面单BASE64编码图片
          ******
        }
      }
         
说明:
  200: 提交成功
  400: Print:参数错误
  600: 您不是合法的用户(即授权Key出错)
  601: Print:KEY已过期
  500: 服务器错误(即快递100的服务器出理间隙或临时性异常,有时如果因为不按规范提交请求,比如快递公司参数写错等,也会报此错误)
  501:重复提交
  503: 验证签名失败
2.3 自定义打印接口
如有打印发货单,发票等其他类打印需求,可使用该接口。通过管理后台模板配置,配置自定义摸版,实现自定义打印功能。
2.3.1 接口格式
提供统一格式的HTTP POST或GET调用接口,并返回统一格式JSON数据。
2.3.2 请求地址
http://poll.kuaidi100.com/printapi/printtask.do
请求参数:
参数名 是否必填 类型 说明
method string 业务类型(默认:printOrder)
key string 授权码,请到快递100页面申请企业版接口获取 http://vmm33.com/openapi
sign string 32位大写,签名,用于验证身份,按MD5 (param +t+key+ secret)的顺序进行MD5加密,不需要加上“+”号,secret在授权邮件里面有
t string 时间戳如:1576123932000
param param 由其他字段拼接
param数据结构:
参数名 是否必填 类型 说明
kuaidicom string 快递公司的编码,一律用小写字母,见《快递公司编码》
kuaidinum string 快递单号,单号的最大长度是32个字符
orderId string 贵司内部自定义的订单编号,需要保证唯一性,非必填
tempid string 通过管理后台的打印摸版配置信息获取
height string 打印纸的高度
width string 打印纸的宽度
salt string 签名用随机字符串
siid string 打印设备,通过打印机输出的设备码进行获取
op string 是否开启订阅功能,默认是:0(不开启),如果是1说明开启订阅功能此时pollCallBackUrl必须填入,此功能只针对有快递单号的单
callBackUrl string 打印状态回调地址
pollCallBackUrl string 如果op设置为1时,pollCallBackUrl必须填入
resultv2 string 添加此字段表示开通行政区域解析功能,见3.1.2相关说明。
0:关闭(默认),1:开通行政区域解析功能,2:开通行政解析功能并且返回出发、目的及当前城市信息
****** string 其他面单参数显示,可以到后台-面单模板选择该模板,下方有对应产生列表
2.3.3 返回结果
字段 类型 说明 备注
result boolean 提交结果 true提交成功,false失败
returnCode string 返回编码
message string 返回报文描述
data data
data数据结构
字段 类型 说明 备注
taskId string 任务ID
kuaidicom string 快递公司编码
kuaidinum string 快递单号
****** **** 其他报文
2.3.4 提供数据内容
      {
        "result":true,
        "returnCode":"200",
        "message":"提交成功",
        "data":{
          "taskId":"****",	//任务ID
          "kuaidicom":"****",	//快递公司编码
          "kuaidinum":"****" //快递单号
          ******
        }
      }
         
说明:
  200: 提交成功
  400: Print:参数错误
  600: 您不是合法的用户(即授权Key出错)
  601: Print:KEY已过期
  500: 服务器错误(即快递100的服务器出理间隙或临时性异常,有时如果因为不按规范提交请求,比如快递公司参数写错等,也会报此错误)
  501: 重复提交
  503: 验证签名失败
2.4 附件打印接口
为各应用产品提供的智能化打印解决方案。对接后可以让企业、个人实现PC/手机无线打印,远程打印,多人共享打印。打印内容包括但不限于文档、发票、发货单、快递单等,搭配云盒使用,支持激光、喷墨、针式、热敏打印机类型。让企业和个人打印更高效、更便捷。
通过接口上传打印内容,图片或PDF、Word等文件,即可打印该内容。
2.4.1 接口格式
提供统一格式的HTTP POST或GET调用接口,并返回统一格式JSON数据。
2.4.2 请求地址
http://poll.kuaidi100.com/printapi/printtask.do
请求参数:
参数名 是否必填 类型 说明
method string 业务类型(默认:printOrder)
key string 授权码,请到快递100页面申请企业版接口获取 http://vmm33.com/openapi
sign string 32位大写,签名,用于验证身份,按MD5 (param +t+key+ secret)的顺序进行MD5加密,不需要加上“+”号,secret在授权邮件里面有
t string 时间戳如:1576123932000
param param 由其他字段拼接
file file 需要打印的附件
param数据结构:
参数名 是否必填 类型 说明
kuaidicom string 快递公司的编码,一律用小写字母,见《快递公司编码》
kuaidinum string 快递单号,单号的最大长度是32个字符
orderId string 贵司内部自定义的订单编号,需要保证唯一性,非必填
height string 打印纸的高度
width string 打印纸的宽度
copyNum string 需要打印的份数,默认是一份
startPage string 打印范围,起始页,仅对多页文件支持,默认是打印整个文档
endPage string 打印范围,结束页,仅对多页文件支持,默认是打印整个文档
salt string 签名用随机字符串
siid string 打印设备,通过打印机输出的设备码进行获取
op string 是否开启订阅功能,默认是:0(不开启),如果是1说明开启订阅功能此时pollCallBackUrl必须填入,此功能只针对有快递单号的单
callBackUrl string 打印状态回调地址
pollCallBackUrl string 如果op设置为1时,pollCallBackUrl必须填入
resultv2 string 添加此字段表示开通行政区域解析功能,见3.1.2相关说明。
0:关闭(默认),1:开通行政区域解析功能,2:开通行政解析功能并且返回出发、目的及当前城市信息
2.4.3 返回结果
字段 类型 说明 备注
result boolean 提交结果 true提交成功,false失败
returnCode string 返回编码
message string 返回报文描述
data data
data数据结构
字段 类型 说明 备注
taskId string 任务ID
kuaidicom string 快递公司编码
kuaidinum string 快递单号
****** **** 其他报文
2.4.4 提供数据内容
      {
        "result":true,
        "returnCode":"200",
        "message":"提交成功",
        "data":{
          "taskId":"****",	//任务ID
          "kuaidicom":"****",	//快递公司编码
          "kuaidinum":"****" //快递单号
          ******
        }
      }
         
说明:
  200: 提交成功
  400: Print:参数错误
  600: 您不是合法的用户(即授权Key出错)
  601: Print:KEY已过期
  500: 服务器错误(即快递100的服务器出理间隙或临时性异常,有时如果因为不按规范提交请求,比如快递公司参数写错等,也会报此错误)
  501: 重复提交
  503: 验证签名失败
2.5 打印接口回调
通过上述接口提交的打印请求,进行打印状态返回。
2.5.1 接口格式
提供统一格式的HTTP POST或GET调用接口,并返回统一格式JSON数据。
2.5.2 请求地址
例如:
      <form method="post" name="" action="[callbackurl]">
        <input type="text" name="taskId" value="{XXX}" >
        <input type="text" name="param" value="{XXX}" >
        <input type="text" name="sign" value="签名字符串" />
      </form>
          
请求参数:
字段 类型 说明 备注
taskId string 任务ID
sign string 32位大写,签名,用于验证身份,按MD5 (param +t+key+ secret)的顺序进行MD5加密,不需要加上“+”号,secret在授权邮件里面有
param param 由其他字段拼接
param数据结构:
参数名 是否必填 类型 说明
status string 状态编码,200:打印成功,201打印不成功。
message string 状态描述。
kuaidicom string 快递公司的编码,一律用小写字母,见《快递公司编码》
kuaidinum string 快递单号,单号的最大长度是32个字符
2.5.3 返回结果
字段 说明 备注
result 提交结果 true提交成功,false失败
returnCode 返回编码
message 返回报文描述
2.5.4 提供数据内容
      {
        "result":true,
        "returnCode":"200",
        "message":"成功"
      }
         
说明:
  200: 提交成功
  500: 服务器错误
  其他错误请自行定义
result:true表示回调成功,false表示失败,如果提交回调接口的地址失败,30分钟后重新回调,3次仍旧失败的,自动放弃。
其他信息快递100会忽略。
2.6 电子面单接口
通过快递公司或网点、菜鸟与淘宝提供的电子面单账号,提交生成电子面单号,返回固定面单模板,调用本地打印机即可打印出电子面单。
2.6.1 接口格式
提供统一格式的HTTP POST或GET调用接口,并返回统一格式JSON数据。
2.6.2 请求地址
http://poll.kuaidi100.com/eorderapi.do
请求参数:
参数名 是否必填 类型 说明
method string 业务类型(默认:getElecOrder)
key string 授权码,请到快递100页面申请企业版接口获取 http://vmm33.com/openapi
sign string 32位大写,签名,用于验证身份,按MD5 (param +t+key+ secret)的顺序进行MD5加密,不需要加上“+”号,secret在授权邮件里面有
t string 时间戳如:1576123932000
param string 由其他字段拼接
param数据结构:
参数名 是否必填 类型 说明
partnerId string 电子面单客户账户或月结账号,需向快递公司在贵司当地的网点申请;
若所选快递公司为京东或德邦全国快递,可联系快递100进行账号授权操作,则此项可不填。
其他请查看参数字典
partnerKey string 电子面单密码,需向快递公司在贵司当地的网点申请;
若所选快递公司为京东或德邦全国快递,可联系快递100进行账号授权操作,则此项可不填。
其他请查看参数字典
net string 收件网点名称,由快递公司当地网点分配, 若使用淘宝授权填入(taobao),使用菜鸟授权填入(cainiao)。
其他请查看参数字典
kuaidicom string 快递公司的编码,一律用小写字母,见《快递公司编码》
recMan name string 收件人姓名
mobile string 收件人的手机号,手机号和电话号二者其一必填
tel string 收件人的电话号,手机号和电话号二者其一必填
zipCode string 收件人所在地的编箱号
province string 收件人所在省份,如广东省,province, city, district, addr 和 printAddr 任选一个必填
city string 收件人所在市,如深圳市, province, city, district, addr 和 printAddr 任选一个必填
district string 收件人所在区,如南山区, province, city, district, addr 和 printAddr 任选一个必填
addr string 收件人所在地址,如科技南十二路2号金蝶软件园, province, city, district, addr 和 printAddr 任选一个必填
printAddr string 收件人所在完整地址,如广东深圳市深圳市南山区科技南十二路2号金蝶软件园, province, city, district, addr 和 printAddr 任选一个必填。如果有填写province、city、district、addr 则系统优先读取province, city、district、addr;如果只填写printAddr,系统将自动识别对应的省、市与区
company string 收件人所在公司名称
sendMan name string 寄件人姓名
mobile string 寄件人的手机号,手机号和电话号二者其一必填
tel string 寄件人的电话号,手机号和电话号二者其一必填
zipCode string 寄件人所在地的邮编号
province string 寄件人所在省份,如广东省,province, city, district, addr 和 printAddr 任选一个必填。
city string 寄件人所在市,如深圳市, province, city, district, addr 和 printAddr 任选一个必填
district string 寄件人所在区,如南山区, province, city, district, addr 和 printAddr 任选一个必填
addr string 寄件人所在地址,如高新南十八道20号xxx, province, city, district, addr 和 printAddr 任选一个必填
printAddr string 寄件人所在的完整地址,如广东深圳市深圳市南山区科技南十二路2号金蝶软件园B10, province, city, district, addr 和 printAddr 任选一个必填。如果有填写province、city、district、addr 则系统优先读取province, city、district、addr;如果只填写printAddr,系统将自动识别对应的省、市与区
company string 寄件人所在公司名称
cargo string 物品名称
count string 物品总数量,int类型,必填;如果需要子单(指同一个订单打印出多张电子面单,即同一个订单返回多个面单号),needChild = 1、count 需要大于1,如count = 2 则一个主单 一个子单,count = 3则一个主单 二个子单;返回的子单号码见返回结果的childNum字段
weight string 物品总重量KG,double类型
volumn string 物品总体积,CM*CM*CM,double类型
payType string 支付方式:SHIPPER:寄方付(默认)、CONSIGNEE:到付、MONTHLY:月结、THIRDPARTY:第三方支付(详细看参数字典
expType string 快递类型:标准快递(默认)、顺丰特惠、EMS经济(详细看参数字典
remark string 备注
valinsPay double 保价额度
collection double 代收货款额度
needChild string 是否需要子单:1:需要、0:不需要(默认) ,String类型,非必填;如果需要子单(指同一个订单打印出多张电子面单,即同一个订单返回多个面单号),needChild = 1、count 需要大于1,如count = 2 一个主单 一个子单,count = 3 一个主单 二个子单,返回的子单号码见返回结果的childNum字段
needBack string 是否需要回单:1:需要、 0:不需要(默认) ,String类型,非必填;返回的回单号见返回结果的returnNum字段
orderId string 贵司内部自定义的订单编号,需要保证唯一性,非必填
needTemplate string 是否需要打印模板:1:需要、 0 不需要(默认) ,如果需要,则返回要打印的模版的HTML代码,贵司可以直接将之显示到IE等浏览器,然后通过浏览器进行打印
salt string 签名用随机字符串
op string 是否开启订阅功能,默认是:0(不开启),如果是1说明开启订阅功能此时pollCallBackUrl必须填入,此功能只针对有快递单号的单
callBackUrl string 打印状态回调地址
pollCallBackUrl string 如果op设置为1时,pollCallBackUrl必须填入
resultv2 string 添加此字段表示开通行政区域解析功能,见3.1.2相关说明。
0:关闭(默认),1:开通行政区域解析功能,2:开通行政解析功能并且返回出发、目的及当前城市信息
2.6.3 返回结果
字段 类型 说明 备注
result boolean 提交结果 true提交成功,false失败
status string 返回编码
message string 返回报文描述
data data Json
data数据结构
字段 类型 说明 备注
taskId string 任务ID
kuaidinum string 快递单号
returnNum string 回单号
childNum string 子单号,如果有多个,逗号分隔 如果需要子单,则需要提交报文needChild = 1、count 需要大于1,如count = 2则一个主单、一个子单,count=3则一个主单、二个子单
bulkpen string 大头笔 用于显示于电子面单上规定位置,非必需,是否有值取决于快递公司
orgCode string 始发地区域编码
orgName string 始发地/始发网点名称
destCode string 目的地区域编码
destName string 目的地/到达网点
orgSortingCode string 始发分拣编码
orgSortingName string 始发分拣名称
destSortingCode string 目的分栋编码
destSortingName string 目的分栋中心名称
orgExtra string 始发其他信息
destExtra string 目的其他信息
pkgCode string 集包编码
pkgName string 集包地名称
road string 路区
qrCode string 二维码
orderNum string 快递公司订单号
expressCode string 快递业务类型编码
expressName string 快递业务类型名称
templateurl string 在线显示电子面单模版的网址 用浏览器打开该网址,就能看到生成的电子面单,直接通过浏览器的打印功能即可完成打印
template string 电子面单模板内容
2.6.4 提供数据内容
1) 不带模版返回
      {
        "result":true,
        "message":"成功",
        "status": "200",
        "data":[
          {
            "kuaidinum":"606568155331", 
            "returnNum":" ", 
            "childNum":"", 
            "bulkpen":"大头笔", 
            "orgCode":"755", 
            "orgName":"始发地区域编码", 
            "destCode":"755", 
            "destName":"目的地/到达网点" 
            "orgSortingCode":"始发分拣编码", 
            "orgSortingName":"始发分拣名称", 
            "destSortingCode":"目的分栋编码", 
            "destSortingName":"目的分栋中心名称", 
            "orgExtra":"始发其他信息", 
            "destExtra":"目的其他信息", 
            "pkgCode":"集包编码", 
            "pkgName":"集包地名称", 
            "road":"路区", 
            "qrCode":"二维码", 
            "orderNum":"快递公司订单号", 
            "expressCode":"快递业务类型编码", 
            "expressName":"标准快递" 
            "templateurl":"http://vmm33.com/XXX" 
          }
        ]
      }
         
2) 带模版返回
      {
        "result":true,
        "message":"成功",
        "status": "200",
        "data":[
          {
            "kuaidinum":"611399236259", 
            "returnNum":" ", 
            "childNum":"", 
            "bulkpen":"大头笔", 
            "orgCode":"755", 
            "orgName":"始发地区域编码", 
            "destCode":"755", 
            "destName":"目的地/到达网点", 
            "orgSortingCode":"始发分拣编码", 
            "orgSortingName":"始发分拣名称", 
            "destSortingCode":"目的分栋编码", 
            "destSortingName":"目的分栋中心名称", 
            "orgExtra":"始发其他信息", 
            "destExtra":"目的其他信息", 
            "pkgCode":"集包编码", 
            "pkgName":"集包地名称", 
            "road":"路区", 
            "qrCode":"二维码", 
            "orderNum":"快递公司订单号", 
            "expressCode":"快递业务类型编码", 
            "expressName":"标准快递", 
            "templateurl":" http://ckd.im/u2WB5", 
            "template": [
            "<!DOCTYPE html>
              <html>
              <head>
                <meta charset=\"utf-8\">
                <title>顺丰</title>
                <style>
                  *{margin:0;padding:0}
                  table{margin-top:-1px;
                    font:12px \"Microsoft YaHei\",Verdana,arial,sans-serif;
                    border-collapse:collapse}
                  table.container{width:375px}table td{border:1px solid #000}
                  table.nob{width:100%}
                  table.nob td{border:0}
                  table td.center{text-align:center}
                  table td.right{text-align:right}
                  ……………
                </table>
                </body>
              </html>"
            ]
          }
        ]
      }
         
返回的打印模版示例(即template或访问templateurl后显示的效果)
将template字段写到一个html文件后通过浏览器打开并显示出来后的效果示例:顺丰:
其他返回说明:
  200: 成功
  401:参数错误
  402:未指明服务
  601:电子面单账号配置出错/非法的数据签名,请与快递公司当地网点分配的账号密码核对
  602:电子面单可用单号不足,请联系网点增加后继续打印
  603:该订单省市区信息不完整无法打印
  604:暂不支持子单号
  605:暂不支持回单
  606:快递业务类型错误
  699:请求快递公司失败,请稍候重试
2.7 第三方授权回调
通过2.5提交的第三方授权中,通过返回的url进行提交后,系统会根据填入的callBackUrl进行数据回传。
2.7.1 接口格式
提供统一格式的HTTP POST,并返回统一格式JSON数据。
2.7.2 请求地址
例如:
      <form method="post" name="" action="[callBackUrl]">
        <input type="text" name="param" value="{XXX}" >
      </form>
         
请求参数:
字段 类型 说明 备注
param param 参数主体
param数据结构:
参数名 是否必填 类型 说明
result Boolean true:成功,false:失败。
returnCode string 200成功
message string 具体报文内容
message数据结构:
参数名 是否必填 类型 说明
partnerKey string 授权partnerKey
parterId string 授权parterId
net string 授权net
customerId string 内部参数
createTime string 内部参数
data string 内部参数
2.7.3 返回结果
例如:
字段 说明 备注
result 提交结果 true提交成功,false失败
returnCode 返回编码
message 返回报文描述
2.7.4 提供数据内容
      {
        "result":true,
        "returnCode":"200",
        "message":"成功"
      } 
         
说明:
  200: 成功
  500: 服务器错误
  其他错误请自行定义
  result:true表示回调成功,false表示失败,如果提交回调接口的地址失败,30分钟后重新回调,3次仍旧失败的,自动放弃。
其他信息快递100会忽略。
三、参数字典
快递公司partnerId,partnerKey,net是否必填(*为必填)
快递公司 partnerId partnerKey net
ane66(安能快递) *
debangkuaidi(德邦快递) *
ems(EMS) * *
guotongkuaidi(国通快递) * * *
huitongkuaidi(百世快递) * *
jd(京东物流) *
kuayue(跨越速运) * *
pjbest(品骏快递) * *
shentong(申通快递) * * *
shunfeng(顺丰速运) *
suer(速尔快递) * *
xinfengwuliu(信丰物流) * *
youshuwuliu(优速物流) * *
youzhengguonei(邮政快递包裹) * *
yuantong(圆通速递) * *
yuantongguoji(圆通国际) * *
yunda(韵达快递) * *
zhaijisong(宅急送)
zhongtong(中通快递) * *
ewe(EWE全球快递) * *
quanyikuaidi(全一快递) *
tiantian(天天快递) * * *

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

北京快三 北京快三 北京快三 北京快三 北京快三 北京快三 北京快三 北京快三 北京快三 极速快乐十分 极速快乐十分开户