顺丰快递对于商家和个人的隐私保护较为严格,对于操作频次高的用户会进行多次验证码确认信息和服务安全。如果需要大量地邮寄顺丰快递以及查询顺丰的快递物流轨迹信息,必须对接顺丰官方的寄件和查询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 | 签名用随机字符串&#x |