企业服务平台技术规范 – 订单确认/取消接口 # 属性名 weight 类型(约束) 必填 Number(10,3) 默认值 描述 订单货物总重量,包含子母件,单位1 否 千克,精确到小数点后2位,如果提供此值,必须>0。 货物的总体积(值为长,宽,高),包含子母件,以半角逗号分隔,单位2 volume String(100) 否 厘米,精确到小数点后2位,会用于计抛(是否计抛具体商务沟通中双方约定)。 3 return_tracking String(30) 否 顺丰签回单服务运单号 快件产品类别,详见附录《快件产品4 express_type String(5) 否 类别表》,只有在商务上与顺丰约定的类别方可使用。如果此字段为空,则以下单时的为准。 5 children_nos String(1000) 否 子单号(以半角逗号分隔)如果此字段为空,则以下订单时为准。 5.2.4. 元素<响应> OrderConfirmResponse # 1 2 属性名 orderid mailno 类型(约束) 必填 String(64) String(20) 是 条件 默认值 描述 客户订单号 顺丰母运单号(如果dealtype=1,必填) 备注 3 res_status Number(1) 是 ? 1:客户订单号与顺丰运单不匹配 ? 2 :操作成功 5.2.5. 扩展字段信息
此接口支持扩展字段,遵循扩展字段规范,参考XML报文说明。 5.2.6. 报文范例
请求XML,使用公共接口信息开发时,按需修改客户订单号及顺丰运单号(OrderConfirm元素中的orderid属性与mailno属性):
第 24页 /共 59页
?版权所有2015顺丰科技有限公司
企业服务平台技术规范 – 订单确认/取消接口
orderid='TE201500104' mailno='444003078326' dealtype='1'> volume=’33,33,33’/>
响应XML:
? 订单确认成功:
? 订单确认失败: o 范例1 o 范例2 第 25页 /共 59页 ?版权所有2015顺丰科技有限公司 企业服务平台技术规范 – 订单结果查询接口 6. 订单结果查询接口 6.1. 功能描述 因Internet环境下,网络不是绝对可靠,用户系统下订单到顺丰后,不一定可以收到BSP返回的数据,此接口用于在未收到返回数据时,查询下订单(含筛选)接口客户订单当前的处理情况。 6.2. 接口定义 6.2.1. 接口基本信息 服务名称 批量交易 接口类型 接口方法 OrderSearchService 不支持 接入 String sfexpressService(String xml, String verifyCode) 6.2.2. 元素<请求> OrderSearch # 1 属性名 orderid 类型(约束) 必填 String(64) 是 默认值 描述 客户订单号 6.2.3. 元素<响应> OrderSearchResponse # 1 属性名 orderid 类型(约束) 必填 String(64) 是 默认值 描述 客户订单号 顺丰运单号,一个订单只能有一个母单号,如果是子母单的情况,以半角2 mailno String(4000) 是 逗号分隔,主单号在第一个位置,如“755123456789,001123456789,002123456789”。 3 4 origincode destcode String(10) String(10) 是 是 原寄地区域代码 目的地区域代码 第 26页 /共 59页 ?版权所有2015顺丰科技有限公司 企业服务平台技术规范 – 订单结果查询接口 # 属性名 类型(约束) 必填 默认值 描述 筛单结果: 5 filter_result Number(2) 否 ? 1:人工确认 ? 2:可收派 ? 3:不可以收派 如果filter_result=3时为必填,不可以收派的原因代码: 6 remark String(100) 否 ? 1:收方超范围 ? 2:派方超范围 ? 3-:其它原因 6.2.4. 报文范例 请求XML,使用公共接口信息开发时,按需修改客户订单号(OrderSearch元素中的orderid属性): 响应XML: ? 订单处理成功: orderid=\mailno=\origincode=\destcode=\ filter_result=\ ? 订单处理失败: 第 27页 /共 59页 ?版权所有2015顺丰科技有限公司

