顺丰丰桥软件开发工具包 (.NET)

摘要:
丰桥-一站式对接服务平台,打通客户与顺丰系统之间的信息流,实现物流供应链一体化.随着一个电商项目和顺丰合作,信息流对接就是我们开发的事了.顺丰通过丰桥提供了一些开放接口,不过丰桥提供的SDK非常简陋,对.NET的支持就更差了.于是就有了这个项目sf-express-sdk-net主要接口集成:接口接口方式描述下订单接口HTTP/POST客户系统向顺丰系统下达订单,为订单分配运单号下订单(国际件)接

丰桥 - 一站式对接服务平台, 打通客户与顺丰系统之间的信息流, 实现物流供应链一体化.

随着一个电商项目和顺丰合作, 信息流对接就是我们开发的事了.

顺丰通过丰桥提供了一些开放接口, 不过丰桥提供的 SDK 非常简陋, 对 .NET 的支持就更差了. 于是就有了这个项目 sf-express-sdk-net

主要接口集成:

接口接口方式描述
下订单接口HTTP/POST客户系统向顺丰系统下达订单,为订单分配运单号
下订单(国际件)接口HTTP/POST客户系统向顺丰系统下达订单,为订单分配运单号
订单结果查询接口HTTP/POST用于在未收到返回数据时,查询下订单(含筛选)接口客户订单当前的处理情况
订单取消接口HTTP/POST客户在发货前取消订单
订单筛选接口HTTP/POST客户系统通过此接口向顺丰系统发送主动的筛单请求,用于判断客户的收、派地址是否属于顺丰的收派范围
路由查询接口HTTP/POST客户可通过此接口查询顺丰运单路由,顺丰系统会在响应XML报文返回当时点要求的全部路由节点信息
路由推送接口HTTP/POST当路由信息生产后向客户主动推送要求的顺丰运单路由信息。推送方式为增量推送,对于同一个顺丰运单的同一个路由节点,不重复推送
子单号申请接口HTTP/POST客户在通过下单接口提交订单后,可从此接口获取更多的子运单号
订单状态推送接口HTTP/POST推送订单的揽收状态

注: 2个推送接口需要自行开发对接.

单元测试

SDK 中提供了相对完整的单元测试, 完整的调用示例的话小伙伴们可以再源码中找到更多内容...

获取和使用

  • 源码获取 - 有些小伙伴可能需要自行控制和维护依赖内容, 可以克隆一份源码自己修改维护...此项目的 LICENSE 是最宽松的 MIT.
  • NuGet 获取 - 为了方便你我他共同沟通开发维护和使用...笔者这里提供了 NuGet 包 SF.Express.Sdk

集成进来后需要的使用:

using SF.Express.Sdk.Request;
using SF.Express.Sdk.Response;
using System;

// 下订单请求
OrderServiceRequest orderServiceRequest = new OrderServiceRequest();

// 下订单响应
OrderServiceResponse orderServiceResponse = new SFExpressClient().Execute(request: orderServiceRequest);

// 后续逻辑...

封装过后的 SDK, 调用上还是非常简洁直观的...

注意事项

另外这里还是复述一下:

  • 顺丰丰桥开放平台个人也可以非常简单注册和申请
  • 顺丰丰桥接口为了兼容 WebService 数据组成部分保留了 XML 内容...不过 SDK 的封装已经磨平了这个问题
  • 顺丰丰桥有个比较有意思的点, 测试和正式环境是同一个, 每一个接口都必须在测试调用通过3次以后, 才能申请正式调用.
  • 保管好自己的秘钥信息.

免责声明:文章转载自《顺丰丰桥软件开发工具包 (.NET)》仅用于学习参考。如对内容有疑问,请及时联系本站处理。

上篇WPF入门教程系列一——基础springcloud的配置文件的读取顺序下篇

宿迁高防,2C2G15M,22元/月;香港BGP,2C5G5M,25元/月 雨云优惠码:MjYwNzM=

相关文章

如何在Android应用中加入广告

转载自:http://mobile.51cto.com/aprogram-387527.htm 目前我自己的一款小程序中正进行到加入广告阶段,BAIDU了一下,找到如下好文章,非常有必要共享一下,故转载于此。 本文将介绍Android开发中如何加入广告的实际方法,相信你看完之后一定不再会为了加不进去广告而头疼!!! 很多人问到如何在应用中加入广告,今天刚好...

【环境巡检】使用jmeter+ant+Jenkins+企业微信自动化巡检_jmeter实现脚本及响应超时、失败重试(1)

 一、分析准备  由于项目上线了,需要尽快接入巡检避免环境挂了不自知。虽然运维有运维侧的监控,但是测试还是从业务侧的巡检是否成功开展一些工作比较好。经过了一番调研决定使用jmeter+ant+Jenkins+企业微信自动化巡检及相关通知。 经过分析,我们要做如下的准备: 1、jmeter:实现巡检的接口调用,判断前后端接口返回内容、响应时间是否正常; 2、...

NVR硬件录像机web无插件播放方案功能实现之相关接口注意事项说明

该篇博文主要用来说明EasyNVR硬件录像回放版本的相关接口说明和调用的demo; 方便用户的二次开发和集成。 软件根目录会包含接口文档的,因此,本文主要是对一些特定接口的说明和接口实现功能的讲解以及部分demo的展示说明; 对应接口说明; 支持设备类型 由于获取NVR录像机的相关功能是通过SDK来实现功能的,因此,无法想EasyNVR配置摄像机一样,走...

谈谈市面上无线路由器的性能和芯片

  现在市面上无线路由产品的品牌和价格各种各样,如何才能在乱花丛中不被迷眼呢,其实只要看清了各款产品背后的硬件芯片,就可以有个大概的挑选依据了,信息来自网络,只不过总结到一起,方便自己或网友有需要的时候参考。 无线协议IE802.11家族: 协议 发布年份/日期 Op.标准频宽 实际速度 (标准) 实际速度(最大) 范围(室内) 范围(室外)...

new一个接口

首先我们先看看接口的定义:   接口(英文:Interface),在JAVA编程语言中是一个抽象类型,是抽象方法的集合,接口通常以interface来声明。一个类通过继承接口的方式,从而来继承接口的抽象方法。接口并不是类,编写接口的方式和类很相似,但是它们属于不同的概念。类描述对象的属性和方法。接口则包含类要实现的方法。除非实现接口的类是抽象类,否则该类要...

CISCO快速转发

CISCO快速转发 路由器最基本的功能是在网络中转移报文,这种报文的转移基于一张转发表完成的。路由器对于每一种转发报文的协议都有一张独立的转发表,这些协议可能包括IP,IPX,AppleTalk,MPLS等。 有3种基本的方式实现转发:进程交换干扰交换ASIC(通用集成电路)没有查到干扰交换的具体内容,不做介绍。 进程交换是所有交换方式中最慢的一种。当通过...