国际快递顺丰API接口接入教程&代码示例

快递100企业物流API支持接入国际快递顺丰API接口，而且我们的快递单号查询API接口，供小程序、APP、需实时返回物流轨迹信息即查即走，快递查询将提供输入运单编号立即获取物流最新轨迹，无需快递编码，自动识别物流公司，返回物流轨迹。

一、功能说明

实时查询：实时查询物流轨迹，获取最新状态

实时格式化数据：接口实时格式化数据，并计算当前运单的物流状态

覆盖全部主流快递公司：支持1600+国内外物流公司，主流公司全覆盖，轨迹信息全面、涵盖范围广

查询增长：系统日新增查询订单过千万，日查询次数过亿次，稳定可靠，服务能力强。

支持自动识别单号：支持主流40家快递公司无需传输快递编码自动识别物流公司，返回物流轨迹。

二、物流寄件API支持快递公司说明

支持的快递公司：商家寄件接口支持德邦、京东、顺丰、极兔、圆通、申通和中通下单。

运力及运费问题：可以保证全国地址的运力，运费是官方寄件价格的折扣价，具体运费价格请登录后台查询。

三、国际快递顺丰API下订单接口接入流程

寄件下单接口基础信息

选择快递公司进行下单。

1.1 接口格式

提供统一格式的HTTP POST或GET调用接口,并返回统一格式JSON数据。

1.2 请求地址

https://poll.kuaidi100.com/order/borderapi.do

请求参数：

参数名	是否必填	类型	说明
method	是	string	业务类型（默认：bOrder）
key	是	string	授权码，请到快递100页面申请企业版接口获取
sign	是	string	32位大写签名，用于验证身份，按MD5 (param +t+key+ secret)的顺序进行MD5加密，不需要加上“+”号。secret在企业管理后台获取
t	是	string	时间戳如：1576123932000
param	是	param	由其他字段拼接

param数据结构：

参数名	是否必填	类型	说明
kuaidicom	是	string	快递公司的编码，一律用小写字母，见《快递公司编码》
recManName	是	string	收件人姓名
recManMobile	是	string	收件人的手机号，手机号和电话号二者其一必填
recManPrintAddr	是	string	收件人所在完整地址，如广东深圳市深圳市南山区科技南十二路2号金蝶软件园
sendManName	是	string	寄件人姓名
sendManMobile	是	string	寄件人的手机号，手机号和电话号二者其一必填
sendManPrintAddr	是	string	寄件人所在的完整地址，如广东深圳市深圳市南山区科技南十二路2号金蝶软件园B10
callBackUrl	是	string	callBackUrl订单信息回调地址
cargo	否	string	物品名称,例：文件。当kuaidicom=jd，yuantong时，必填
payment	否	string	支付方式，SHIPPER: 寄付（默认）。不支持到付
serviceType	否	string	业务类型，默认为标准快递，各快递公司业务类型对照参考：七、业务类型参数表
weight	否	string	物品总重量KG，不需带单位，例：1.5
remark	否	string	备注
salt	否	string	签名用随机字符串，用于验证签名sign。salt值不为null时，推送数据将包含该加密签名，加密方式：md5(param+salt)。注意： salt值为空串时，推送的数据也会包含sign，此时可忽略sign的校验。
dayType	否	string	预约日期，例如：今天/明天/后天
pickupStartTime	否	string	预约起始时间（HH:mm），例如：09:00，顺丰必填
pickupEndTime	否	string	预约截止时间（HH:mm），例如：10:00，顺丰必填
valinsPay	否	string	保价额度，单位：元
passwordSigning	否	string	是否口令签收，Y：需要 N: 不需要，默认值为N（德邦快递专属参数）
op	否	string	是否开启订阅功能 0：不开启(默认) 1：开启 说明开启订阅功能时：pollCallBackUrl必须填入 此功能只针对有快递单号的单
pollCallBackUrl	否	string	如果op设置为1时，pollCallBackUrl必须填入，用于跟踪回调
resultv2	否	string	添加此字段表示开通行政区域解析功能 。 0：关闭（默认） 1：开通行政区域解析功能以及物流轨迹增加物流状态名称 4：开通行政解析功能以及物流轨迹增加物流高级状态名称、状态值并且返回出发、目的及当前城市信息(详见：快递信息推送接口文档)
returnType	否	string	面单返回类型，默认为空，不返回面单内容。10：设备打印，20：生成图片短链回调。
siid	否	string	设备码，returnType为10时必填
tempid	否	string	模板编码，通过管理后台的电子面单模板信息获取 ，returnType不为空时必填
printCallBackUrl	否	string	打印状态回调地址，returnType为10时必填

1.3 返回结果

字段	类型	说明	备注
result	boolean	提交结果	true提交成功，false失败
returnCode	string	返回编码
message	string	返回报文描述
data	data

data数据结构

字段	类型	说明	备注
taskId	string	任务ID
orderId	string	订单ID
kuaidinum	string	快递单号
eOrder	string	快递面单附属属性，根据各个快递公司返回属性

eOrder数据结构

字段	类型	说明	备注
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	二维码
kdComOrderNum	string	快递公司订单号
expressCode	string	快递业务类型编码
expressName	string	快递业务类型名称
waterMark	string	水印
agingName	string	时效
abFlag	string	电子产品类型图标
proCode	string	时效产品图标
codingMapping	string	进港映射码
codingMappingOut	string	出港信息
printIcon	string	图标名称
destRouteLabel	string	目的地（路由信息）
twoDimensionCode	string	二维码信息
xbFlag	string	顺丰面单标识，快运必填，xbFlag=1，打印SX标；xbFlag=2，打印融通标

注意：eOrder实际返回的字段各家快递公司不同，以实际返回为准

1.4 提供数据内容

请求参数示例

method = bOrder
key = ******
sign = 4BBDE07660E5EFF90873642CFAE9A8DD
t = 1647258957705
param = {
   
	"kuaidicom": "yuantong",
	"recManName": "王超",
	"recManMobile": "13842569988",
	"recManPrintAddr": "广东深圳市深圳市南山区科技南十二路2号金蝶软件园",
	"sendManName": "王大",
	"sendManMobile": "13842569988",
	"sendManPrintAddr": "广东深圳市深圳市南山区科技南十二路2号金蝶软件园B10",
	"cargo": "文件",
	"callBackUrl": "http: //www.baidu.com",
	"payment": "SHIPPER",
	"serviceType": "标准快递",
	"weight": "1",
	"remark": "",
	"salt": "",
	"dayType"