• 顺丰快递商家寄件发货接口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

    请求参数:

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

    param数据结构:

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

    1.3 返回结果

    字段类型说明备注
    resultboolean提交结果true提交成功,false失败
    returnCodestring返回编码
    messagestring返回报文描述
    datadata

    data数据结构

    字段类型说明备注
    taskIdstring任务ID
    orderIdstring订单ID
    kuaidinumstring快递单号
    eOrderstring快递面单附属属性,根据各个快递公司返回属性

    eOrder数据结构

    字段类型说明备注
    bulkpenstring大头笔用于显示于电子面单上规定位置,非必需,是否有值取决于快递公司
    orgCodestring始发地区域编码
    orgNamestring始发地/始发网点名称
    destCodestring目的地区域编码
    destNamestring目的地/到达网点
    orgSortingCodestring始发分拣编码
    orgSortingNamestring始发分拣名称
    destSortingCodestring目的分栋编码
    destSortingNamestring目的分栋中心名称
    orgExtrastring始发其他信息
    destExtrastring目的其他信息
    pkgCodestring集包编码
    pkgNamestring集包地名称
    roadstring路区
    qrCodestring二维码
    kdComOrderNumstring快递公司订单号
    expressCodestring快递业务类型编码
    expressNamestring快递业务类型名称
    waterMarkstring水印
    agingNamestring时效
    abFlagstring电子产品类型图标
    proCodestring时效产品图标
    codingMappingstring进港映射码
    codingMappingOutstring出港信息
    printIconstring图标名称
    destRouteLabelstring目的地(路由信息)
    twoDimensionCodestring二维码信息
    xbFlagstring顺丰面单标识,快运必填,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": ""
    }
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • 23
    • 24
    • 25
    • 26
    • 27
    • 28
    • 29
    • 30
    • 31
    • 32

    返回结果示例

    {
    	"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}]"
    	}
    }
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11

    说明:

    信息代码信息内容描述原因及建议处理方式
    200提交成功提交成功
    400参数错误等请根据技术文档请求,注意参数类型及是否必填
    500服务器错误快递100的服务器出理间隙或临时性异常,有时如果因为不按规范提交请求,比如快递公司参数写错等,也会报此错误
    501重复提交重复提交了请求
    503验证签名失败请检查加密方式,param + t + key + secret 的顺序进行MD5加密,加密后字符串转大写,不用加上“+”号
    600您不是合法的用户(即授权Key出错)账号无可用余额,需要充值
    601KEY已过期账号无可用余额,需要充值
    700错误的回调地址检查回调地址,或者联系快递100工作人员
  • 相关阅读:
    组里来了一个实习生,一行代码引发了一个惨案
    【微众银行秋招】230903三、平均值 <前缀和>
    数据结构与算法编程题9
    去中心化社交媒体:到底是未来 还是鸡肋?
    一个简单HTML5期末考核大作业,学生个人html静态网页制作代码
    报错:axios发送的所有请求都是404
    nginx配置详解
    AWR设置工程仿真频率、原理图仿真频率、默认单位
    【国外框架】—— quasar项目代码结构分析
    从read 系统调用到 C10M 问题
  • 原文地址:https://blog.csdn.net/kuaidi100API/article/details/126750823