关键规则:
a) Head 元素值为 OK 或 ERR;OK 代表交易正常,ERR 代表发生系统或业务异常;对
于批量交易场景,必须整体成功或整体失败;
b) Head 元素值为 OK 时返回 BODY 元素,为 ERR 时返回 ERROR 元素;BODY 与
ERROR 元素不能同时存在;
c) ERROR 元素中的 code 属性值为四位数字,错误编码的描述请参考文档的最后一个
部分。
批量交易记录数限制为 20 条以下(参考顺丰网站),特定业务可以自定义不支持批量交
易或小于 20 的批量记录数限制。
请求或正常响应数据 XML 中数据元素的定义需遵循将必要字段(包含有默认值的字段)
扩展字段进行分开定义的原则;必要字段使用数据元素本身的属性进行定义,扩展字段使
用数据元素下保留元素<Extra>的属性进行定义;必要字段的数目尽量控制在 10 个以下;
如:
<Order id="XXXX" …>
<Extra e1="XXXX" …/>
</Order>
Extra 元素最大支持 20 个属性,属性名为 e1,…,e20,只支持字符串值。
尽量通过客户个性化服务配置的方式减少接口报文需要传递的字段量,如:在订单报文中
加入发货点代码的方式,可以在后台基于接入编码+发货点代码的方式配置月结账号等等
数据,避免在接口报文中传递附加的月结账号。
请求与响应报文元素命名采用大写字母开头的单词序列,如“OrderResponse”;属性名
统一使用小写,如“orderid”;子元素在定义表格中一律使用“/”径表示,如
“RouteResponse/Route”;
关于数据编码:顺丰使用 MySQL 数据库,以 UTF-8 编码形式保存数据,所以对于中文会
在数据库中占 varchar 类型的两个长度。例:下面的接口定义中的“类型(约束)”如果
为 String(100),则:如果完全为中文汉字,只能保存 50 个。
如果接入接口的默认值中有 “_SYSTEM”,则表示这个字段可由顺丰内部为客户配置。
通用对外服务接口当前已经定义了快递类服务接口,其参考地址参见:
WEBSERVICE : http://120.24.60.8:8003/CBTA/ws/sfexpressService?wsdl
3. 对接流程
地区新业务部与客户确认业务需求后,把客户技术接口人联系方式发给商家物流项目组的 IT
接口人(李秋明,手机:13603088195,邮箱:liqiuming@sf-express.com),商家物流项目组
安排人员与客户技术联系,沟通对接的相关技术问题