已收件的顺丰为啥在小程序上查不到？

Posted 2023-05-10

如果通过小程序查不到的话，可以通过购买记录里面的物流信息应该可以查询到的。有可能是你的那个小程序时间长了，就删除了以前的信息吧。 参考技术A 应该是小程序的问题，可以下载一个顺丰app进行查阅，也可登陆顺丰官网输入订单号进行查看 参考技术B 可能是小程序还没有更新信息，多刷新试试

顺丰快递商家寄件发货接口API类型和接入流程方案快递100接口Demo

顺丰快递对于商家和个人的隐私保护较为严格，对于操作频次高的用户会进行多次验证码确认信息和服务安全。如果需要大量地邮寄顺丰快递以及查询顺丰的快递物流轨迹信息，必须对接顺丰官方的寄件和查询API接口。企业、电商、微商、快递网点、代收点等经常性寄件的用户可以通过顺丰快递寄件API接口可以满足寄件，快递公司到家收件的需求。

顺丰目前提供了两种技术对接方案：

一种是开发者自主对接顺丰的开放平台接口。在顺丰丰桥上先注册账户后，申请成为开发者后，再根据顺丰的文档要求对接。然而，这种技术对接方案的整个流程较为繁琐冗长，需要一个个地去对接顺丰的各个相应服务的接口。即使对于有开发能力的企业来说，整个开发接入流程也需要一个星期以上的时间才能完成。对于开发和维护能力有限的优先的企业而言，这可能并不是最优解。

还有一种方式就是通过顺丰官方合作的第三方快递寄件API接口技术服务商对接（例如快递100API）。这种技术方案也更适合需要接入多家快递公司，开发和维护接口能力有限的企业。

顺丰快递公司寄件接口类型

顺丰商家寄件服务是专为寄件企业提供的一套解决方案。通过顺丰快递商家寄件服务接口，可以满足企业、电商、微商、快递网点、代收点等经常性寄件用户预约寄件，顺丰快递公司网店到指定地点收件的需求。快递100提供的商家寄件接口支持顺丰、德邦、京东、极兔、圆通、申通和中通等公司的。
若需要个人的预约寄件服务，可对接顺丰快递C端寄件接口。举个例子，这种API接口可接入商家或者企业提供给客户的退换货入口，提供给客户预约快递到家取件退货或者换货，便于商家企业退换货的物流管理。

顺丰商家寄件API应用场景

1、 品牌商家门店发货/调货场景，线下的门店发货，总部统一结算运费；
2、 发货量较小，没有和快递公司合作的微商/工作室发货；
3、 对发货时效性要求较高，需要预约快递员上门收货的场景，如生鲜配送、社区电商、商家退换货系统管理等。

顺丰商家寄件API的技术文档Demo

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": "",
	"pickupStartTime": "",
	"pickupEndTime": "",
	"passwordSigning": "Y",
	"valinsPay": "",
	"op": "0",
	"pollCallBackUrl": "",
	"resultv2": "0",
	"returnType": "",
	"siid": "",
	"tempid": "",
	"printCallBackUrl": ""

返回结果示例

	"result": true,
	"returnCode": "200",
	"message": "提交成功",
	"data": 
		"taskId": "", // 任务ID
		"orderId": "" // 订单ID
		"kuaidinum": "" // 快递单号
		"eOrder": "[\\"destName\\":null,\\"orgName\\":null,\\"pkgCode\\":null,\\"pkgName\\":null,\\"bulkpen\\":\\"上海-S33-K27-P\\",\\"orgExtra\\":null]"
	

说明：

信息代码	信息内容描述	原因及建议处理方式
200	提交成功	提交成功
400	参数错误等	请根据技术文档请求，注意参数类型及是否必填
500	服务器错误	快递100的服务器出理间隙或临时性异常，有时如果因为不按规范提交请求，比如快递公司参数写错等，也会报此错误
501	重复提交	重复提交了请求
503	验证签名失败	请检查加密方式，param + t + key + secret 的顺序进行MD5加密，加密后字符串转大写,不用加上“+”号
600	您不是合法的用户（即授权Key出错）	账号无可用余额，需要充值
601	KEY已过期	账号无可用余额，需要充值
700	错误的回调地址	检查回调地址，或者联系快递100工作人员