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

电子面单API

1 电子面单图片接口
通过快递公司或网点、菜鸟与淘宝提供的电子面单账号,提交生成电子面单;通过管理后台模板配置,自定义面单摸版,生成图片输出,可自选方式打印。
1.1 接口格式
提供统一格式的HTTP POST或GET调用接口,并返回统一格式JSON数据。
1.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 string 由其他字段拼接
param数据结构:
参数名 是否必填 类型 说明
type string 业务类型,默认为10
partnerId string 电子面单客户账户或月结账号,需贵司向当地快递公司网点申请;
是否必填该属性,请查看参数字典
partnerKey string 电子面单密码,需贵司向当地快递公司网点申请;
是否必填该属性,请查看参数字典
net string 收件网点名称,由快递公司当地网点分配, 若使用淘宝授权填入(taobao),使用菜鸟授权填入(cainiao)。
是否必填该属性,请查看参数字典
kuaidicom string 快递公司的编码,一律用小写字母,见参数字典
recManName string 收件人姓名
recManMobile string 收件人的手机号,手机号和电话号二者其一必填
recManPrintAddr string 收件人所在完整地址,如广东深圳市深圳市南山区科技南十二路2号金蝶软件园
sendManName string 寄件人姓名
sendManMobile string 寄件人的手机号,手机号和电话号二者其一必填
sendManPrintAddr string 寄件人所在的完整地址,如广东深圳市深圳市南山区科技南十二路2号金蝶软件园B10
tempid string 通过管理后台的打印摸版配置信息获取
cargo string 物品名称,例:文件
count string 物品总数量。
另外该属性与子单有关,如果需要子单(指同一个订单打印出多张电子面单,即同一个订单返回多个面单号),needChild = 1、count 需要大于1,如count = 2 则一个主单 一个子单,count = 3则一个主单 二个子单;返回的子单号码见返回结果的childNum字段
weight string 物品总重量KG,例:1.5,单位kg
payType string 支付方式:
SHIPPER:寄方付(默认)
CONSIGNEE:到付
MONTHLY:月结
THIRDPARTY:第三方支付
(详细请参考参数字典
expType string 快递类型:
标准快递(默认)
顺丰标快(陆运)
EMS经济
(详细请参考参数字典
remark string 备注
面单扩展属性
valinsPay string 保价额度
collection string 代收货款额度
needChild string 是否需要子单:
1:需要
0:不需要(默认)
如果需要子单(指同一个订单打印出多张电子面单,即同一个订单返回多个面单号);
needChild = 1、count 需要大于1,如count = 2 一个主单 一个子单,count = 3 一个主单 二个子单,返回的子单号码见返回结果的childNum字段
needBack string 是否需要回单:
1:需要
0:不需要(默认)
返回的回单号见返回结果的returnNum字段
orderId string 贵司内部自定义的订单编号,需要保证唯一性
height string 生成图片的高,以mm为单位,例如:100
width string 生成图片的宽,以mm为单位,例如:75
salt string 签名用随机字符串
op string 是否开启订阅功能
0:不开启(默认)
1:开启
说明开启订阅功能时:pollCallBackUrl必须填入
此功能只针对有快递单号的单
pollCallBackUrl string 如果op设置为1时,pollCallBackUrl必须填入,用于跟踪回调
resultv2 string 添加此字段表示开通行政区域解析功能,
详细见:快递信息推送接口文档见3.1.2相关说明。
0:关闭(默认)
1:开通行政区域解析功能
1.3 返回结果
字段 类型 说明 备注
result boolean 提交结果 true提交成功,false失败
returnCode string 返回编码
message string 返回报文描述
data data
data数据结构
字段 类型 说明 备注
taskId string 任务ID
kuaidicom string 快递公司编码
kuaidinum string 快递单号
imgBase64 string 面单BASE64编码图片 该属性为JsonArray结构,如果只有一个面单size为1,如果有字母单,或回单该size>1
***** string 快递面单附属属性,根据各个快递公司返回属性
1.4 提供数据内容
{  
"result": true,
"returnCode": "200",
"message": "提交成功",
"data": {
"taskId": "****", // 任务ID "kuaidicom": "****", // 快递公司编码 "kuaidinum": "****", // 快递单号 "imgBase64": "****", // 面单BASE64编码图片 ****** }
}
说明:
  200: 提交成功
  400: 参数错误
  600: 您不是合法的用户(即授权Key出错
  601: KEY已过期
  500: 服务器错误(即快递100的服务器出理间隙或临时性异常,有时如果因为不按规范提交请求,比如快递公司参数写错等,也会报此错误)
  501: 重复提交
  503: 验证签名失败
1.5 获取历史生成图片接口
1.5.1 请求地址
http://poll.kuaidi100.com/printapi/printtask.do
 
请求参数
参数名 是否必填 类型 说明
method string 业务类型(默认:getOldImg)
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数据结构
参数名 是否必填 类型 说明
kuaidicom string 快递公司的编码,一律用小写字母,见《快递公司编码》,选填
kuaidinum string 快递单号
1.5.2 返回结果
字段 类型 说明 备注
result boolean 提交结果 true提交成功,false失败
returnCode string 返回编码
message string 返回报文描述
data data
data数据结构
字段 类型 说明 备注
taskId string 任务ID
kuaidicom string 快递公司编码
kuaidinum string 快递单号
imgBase64 string 面单BASE64编码图片 该属性为JsonArray结构,如果只有一个面单size为1,如果有字母单,或回单该size>1
1.5.3 提供数据内容
{  
"result": true,
"returnCode": "200",
"message": "提交成功",
"data": {
"taskId": "****", // 任务ID "kuaidicom": "****", // 快递公司编码 "kuaidinum": "****", // 快递单号 "imgBase64": "****", // 面单BASE64编码图片 ****** }
}
说明:
  200: 提交成功
  400: 参数错误
  600: 您不是合法的用户(即授权Key出错)
  601: KEY已过期
  500: 服务器错误(即快递100的服务器出理间隙或临时性异常,有时如果因为不按规范提交请求,比如快递公司参数写错等,也会报此错误)
  503: 验证签名失败
2 电子面单打印接口
通过快递公司或网点、菜鸟与淘宝提供的电子面单账号,提交生成电子面单,调用云打印机打印输出,可自定义面单模板,支持远程打印机和共享打印。
2.1 接口格式
提供统一格式的HTTP POST或GET调用接口,并返回统一格式JSON数据。
2.2 请求地址
https://poll.kuaidi100.com/printapi/printtask.do
请求参数:
参数名 是否必填 类型 说明
method string 业务类型(默认:eOrder)
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 业务类型,默认为10
partnerId string 电子面单客户账户或月结账号,需贵司向当地快递公司网点申请;
是否必填该属性,请查看参数字典
partnerKey string 电子面单密码,需贵司向当地快递公司网点申请;
是否必填该属性,请查看参数字典
net string 收件网点名称,由快递公司当地网点分配, 若使用淘宝授权填入(taobao),使用菜鸟授权填入(cainiao)。
是否必填该属性,请查看参数字典
kuaidicom string 快递公司的编码,一律用小写字母,见参数字典
recMan name string 收件人姓名
mobile string 收件人的手机号,手机号和电话号二者其一必填
printAddr string 收件人所在完整地址,如广东深圳市深圳市南山区科技南十二路2号金蝶软件园B10
company string 收件人所在公司名称
sendMan name string 寄件人姓名
mobile string 寄件人的手机号,手机号和电话号二者其一必填
printAddr string 寄件人所在的完整地址,如广东深圳市深圳市南山区科技南十二路2号金蝶软件园B10
company string 寄件人所在公司名称
cargo string 物品名称,例:文件
count string 物品总数量。
另外该属性与子单有关,如果需要子单(指同一个订单打印出多张电子面单,即同一个订单返回多个面单号),needChild = 1、count 需要大于1,如count = 2 则一个主单 一个子单,count = 3则一个主单 二个子单;返回的子单号码见返回结果的childNum字段
weight string 物品总重量KG,例:1.5,单位kg
payType string 支付方式:
SHIPPER:寄方付(默认)
CONSIGNEE:到付
MONTHLY:月结
THIRDPARTY:第三方支付
(详细请参考参数字典
expType string 快递类型:
标准快递(默认)
顺丰标快(陆运)
EMS经济
(详细请参考参数字典
remark string 备注
tempid string 通过管理后台的打印摸版配置信息获取
siid string 打印设备,通过打印机输出的设备码进行获取
面单扩展属性
valinsPay string 保价额度
collection string 代收货款额度
needChild string 是否需要子单:
1:需要
0:不需要(默认)
如果需要子单(指同一个订单打印出多张电子面单,即同一个订单返回多个面单号);
needChild = 1、count 需要大于1,如count = 2 一个主单 一个子单,count = 3 一个主单 二个子单,返回的子单号码见返回结果的childNum字段
needBack string 是否需要回单:
1:需要
0:不需要(默认)
返回的回单号见返回结果的returnNum字段
orderId string 贵司内部自定义的订单编号,需要保证唯一性,非必填
height string 打印纸的高度,以mm为单位,例如:100
width string 打印纸的宽度,以mm为单位,例如:75
callBackUrl string 打印状态回调地址
salt string 签名用随机字符串
op string 是否开启订阅功能
0:不开启(默认)
1:开启
说明开启订阅功能时:pollCallBackUrl必须填入
此功能只针对有快递单号的单
pollCallBackUrl string 如果op设置为1时,pollCallBackUrl必须填入,用于跟踪回调
resultv2 string 添加此字段表示开通行政区域解析功能,
详细见:快递信息推送接口文档见3.1.2相关说明。
0:关闭(默认)
1:开通行政区域解析功能
****** string 其他面单特殊需求参数显示,可以到后台-面单模板选择该模板,下方有对应产生列表
2.3 返回结果
字段 类型 说明 备注
result boolean 提交结果 true提交成功,false失败
returnCode string 返回编码
message string 返回报文描述
data data
data数据结构
字段 类型 说明 备注
taskId string 任务ID
kuaidicom string 快递公司编码
kuaidinum string 快递单号
***** ***** 其他报文
2.4 提供数据内容
{  
"result": true,
"returnCode": "200",
"message": "提交成功",
"data": {
"taskId": "****", // 任务ID "kuaidicom": "****", // 快递公司编码 "kuaidinum": "****", // 快递单号 ****** }
}
说明:
  200: 提交成功
  400: 参数错误
  600: 您不是合法的用户(即授权Key出错)
  601: Print:KEY已过期
  500: 服务器错误(即快递100的服务器出理间隙或临时性异常,有时如果因为不按规范提交请求,比如快递公司参数写错等,也会报此错误)
  501: 重复提交
  503: 验证签名失败
2.5 复打历史面单接口
2.5.1 请求地址
http://poll.kuaidi100.com/printapi/printtask.do
 
请求参数
参数名 是否必填 类型 说明
method string 业务类型(默认:getOldImg)
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
kuaidicom string 快递公司的编码,一律用小写字母,见参数字典
kuaidinum string 快递单号,单号的最大长度是32个字符
recMan name string 收件人姓名
mobile string 收件人的手机号,手机号和电话号二者其一必填
printAddr string 收件人所在完整地址,如广东深圳市深圳市南山区科技南十二路2号金蝶软件园B10
company string 收件人所在公司名称
sendMan name string 寄件人姓名
mobile string 寄件人的手机号,手机号和电话号二者其一必填
printAddr string 寄件人所在的完整地址,如广东深圳市深圳市南山区科技南十二路2号金蝶软件园B10
company string 寄件人所在公司名称
cargo string 物品名称,例:文件
count string 物品总数量
weight string 物品总重量KG,例:1.5,单位kg
payType string 支付方式:
SHIPPER:寄方付(默认)
CONSIGNEE:到付
MONTHLY:月结
THIRDPARTY:第三方支付
(详细请参考参数字典
expType string 快递类型:
标准快递(默认)
顺丰标快(陆运)
EMS经济
(详细请参考参数字典
remark string 备注
tempid string 通过管理后台的打印摸版配置信息获取
siid string 打印设备,通过打印机输出的设备码进行获取
eOrder string type=10时快递公司返回的内容。
如果eOrder,系统会自动调用历史7内该快递单号的eOrder内容
面单扩展属性
valinsPay string 保价额度
collection string 代收货款额度
orderId string 贵司内部自定义的订单编号,需要保证唯一性,非必填
height string 打印纸的高度,以mm为单位,例如:100
width string 打印纸的宽度,以mm为单位,例如:75
****** string 其他面单特殊需求参数显示,可以到后台-面单模板选择该模板,下方有对应产生列表
2.5.2 返回结果
字段 类型 说明 备注
result boolean 提交结果 true提交成功,false失败
returnCode string 返回编码
message string 返回报文描述
data data
data数据结构
字段 类型 说明 备注
taskId string 任务ID
kuaidicom string 快递公司编码
kuaidinum string 快递单号
****** ****** 其他报文
2.5.3 提供数据内容
{  
"result": true,
"returnCode": "200",
"message": "提交成功",
"data": {
"taskId": "****", // 任务ID "kuaidicom": "****", // 快递公司编码 "kuaidinum": "****", // 快递单号 ****** }
}
说明:
  200: 提交成功
  400: Print:参数错误
  600: 您不是合法的用户(即授权Key出错
  601: Print:KEY已过期
  500: 服务器错误(即快递100的服务器出理间隙或临时性异常,有时如果因为不按规范提交请求,比如快递公司参数写错等,也会报此错误)
  501: 重复提交
  503: 验证签名失败
3 电子面单HTML接口
通过快递公司或网点、菜鸟与淘宝提供的电子面单账号,提交生成电子面单号,返回固定面单模板,调用本地打印机即可打印出电子面单。
3.1 接口格式
提供统一格式的HTTP POST或GET调用接口,并返回统一格式JSON数据。
3.2 请求地址
http://poll.kuaidi100.com/eorderapi.do
 
请求参数
参数名 是否必填 类型 说明
method string 业务类型(默认:getElecOrder)
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数据结构
参数名 是否必填 类型 说明
partnerId string 电子面单客户账户或月结账号,需贵司向当地快递公司网点申请;
是否必填该属性,请查看参数字典
partnerKey string 电子面单密码,需贵司向当地快递公司网点申请;
是否必填该属性,其他请查看参数字典
net string 收件网点名称,由快递公司当地网点分配, 若使用淘宝授权填入(taobao),使用菜鸟授权填入(cainiao)。 是否必填该属性,其他请查看参数字典
kuaidicom string 快递公司的编码,一律用小写字母,见参数字典
recMan name string 收件人姓名
mobile string 收件人的手机号,手机号和电话号二者其一必填
printAddr string 收件人所在完整地址,如广东深圳市深圳市南山区科技南十二路2号金蝶软件园B10
company string 收件人所在公司名称
sendMan name string 寄件人姓名
mobile string 寄件人的手机号,手机号和电话号二者其一必填
printAddr string 寄件人所在的完整地址,如广东深圳市深圳市南山区科技南十二路2号金蝶软件园B10
company string 寄件人所在公司名称
cargo string 物品名称,例:文件
count string 物品总数量
另外该属性与子单有关,如果需要子单(指同一个订单打印出多张电子面单,即同一个订单返回多个面单号),needChild = 1、count 需要大于1,如count = 2 则一个主单 一个子单,count = 3则一个主单 二个子单;返回的子单号码见返回结果的childNum字段
weight string 物品总重量KG,例:1.5,单位kg
payType string 支付方式:
SHIPPER:寄方付(默认)
CONSIGNEE:到付
MONTHLY:月结
THIRDPARTY:第三方支付
(详细请参考参数字典
expType string 快递类型:
标准快递(默认)
顺丰标快(陆运)
EMS经济
(详细请参考参数字典
remark string 备注
面单扩展属性
valinsPay string 保价额度
collection string 代收货款额度
needChild string 是否需要子单:
1:需要
0:不需要(默认)
如果需要子单(指同一个订单打印出多张电子面单,即同一个订单返回多个面单号);
needChild = 1、count 需要大于1,如count = 2 一个主单 一个子单,count = 3 一个主单 二个子单,返回的子单号码见返回结果的childNum字段
needBack string 是否需要回单:
1:需要
0:不需要(默认)
返回的回单号见返回结果的returnNum字段
orderId string 贵司内部自定义的订单编号,需要保证唯一性,非必填
needTemplate string 是否返回面单:
0:不需要(默认)
1:需要
如果需要,则返回要打印的模版的HTML代码,贵司可以直接将之显示到IE等浏览器,然后通过浏览器进行打印
salt string 签名用随机字符串
op string 是否开启订阅功能:
0:不开启(默认)
1:开启
说明开启订阅功能时:pollCallBackUrl必须填入此功能只针对有快递单号的单
pollCallBackUrl string 如果op设置为1时,pollCallBackUrl必须填入,用于跟踪回调
resultv2 string 添加此字段表示开通行政区域解析功能,
详细见:快递信息推送接口文档见3.1.2相关说明。
0:关闭(默认)
1:开通行政区域解析功能
3.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 电子面单模板内容
3.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://www.kuaidi100.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: 请求快递公司失败,请稍候重试
4 菜鸟淘宝账号授权
通过第三方授权获取月结账号授权码。
4.1 接口格式
提供统一格式的HTTP POST或GET调用接口,并返回统一格式JSON数据。
4.2 请求地址
https://poll.kuaidi100.com/printapi/authThird.do
请求参数:
参数名 是否必填 类型 说明
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数据结构:
参数名 是否必填 类型 说明
net string 请求的第三方平台,淘宝:taobao,菜鸟:cainiao
callBackUrl string 授权完后的信息回调地址
partnerId string 已经授权完需要重新获取授权信息
4.3 返回结果
字段 说明 备注
result 提交结果 true提交成功,false失败
returnCode 返回编码
message 返回报文描述
data 数据内容
returnCode=200时,说明系统已经授权完成,data的内容
参数名 是否必填 类型 说明
partnerKey string 授权partnerKey
parterId string 授权parterId
net string 授权net
customerId string 内部参数
createTime string 内部参数
data string 内部参数
returnCode=201时,说明系统未授权需要需要进行第三方授权,data的内容
参数名 是否必填 类型 说明
url string 授权链接
4.4 提供数据内容
returnCode=200时,说明系统已经授权完成:
{  
"result": true,
"returnCode": "200",
"message": "成功",
"data": {
"customerId": null, "createTime": null, "partnerKey": "****", // 面单需要的partnerKey "parterId": "****", // 面单需要的parterId "data": null, "net": "****", // 面单需要的net }
}
returnCode=201时,说明系统未授权需要需要进行第三方授权:
{  
"result": false,
"returnCode": "201",
"message": "成功",
"data": {
"url": "****", // 通过返回的URL调转到第三方进行授权登录 }
}
说明:
  200: 成功
  500: 服务器错误
  400: 参数错误
  其他错误请自行定义
  result: true表示成功,false表示失败
5 第三方授权回调
通过2.3提交的第三方授权中,通过返回的url进行提交后,系统会根据填入的callBackUrl进行数据回传。
5.1 接口格式
提供统一格式的HTTP POST,并返回统一格式JSON数据。
5.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 内部参数
5.3 返回结果
例如:
字段 说明 备注
result 提交结果 true提交成功,false失败
returnCode 返回编码
message 返回报文描述
5.4 提供数据内容
{  
"result": true,
"returnCode": "200",
"message": "成功" }
说明:
  200: 成功
  500: 服务器错误
  其他错误请自行定义
result:true表示回调成功,false表示失败,如果提交回调接口的地址失败,30分钟后重新回调,3次仍旧失败的,自动放弃。
其他信息快递100会忽略。
6 参数字典
快递公司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(全一快递) *

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