企业服务平台技术规范 – 订单确认/取消接口
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顺丰科技有限公司 企业服务平台技术规范 – 订单筛选接口 7. 订单筛选接口 7.1. 功能描述 客户系统通过此接口向BSP发送主动的筛单请求，用于判断客户的收、派地址是否属于顺丰的收派范围。 7.2. 接口定义 7.2.1. 接口基本信息 服务名称 批量交易 接口类型 接口方法 OrderFilterService 最多5个OrderFilter元素 接入 String sfexpressService(String xml, String verifyCode) 7.2.2. 元素<请求> OrderFilter # 属性名 类型（约束） 必填 默认值 描述 筛单类别： ? 1：自动筛单（系统根据地址库进行判断，并返回结果，系统无法检索到可派送的将返回不可派送） 1 filter_type Number(1) 否 1 ? 2：可人工筛单（系统首先根据地址库判断，如果无法自动判断是否收派，系统将生成需要人工判断的任务，后续由人工处理，处理结束后，顺丰可主动推送给客户系统） 2 orderid String(64) 条件 客户订单号，filter_type=2则必须提供。 第 28页 /共 59页 ?版权所有2015顺丰科技有限公司 企业服务平台技术规范 – 订单筛选接口 # 属性名 d_address 类型（约束） 必填 String(150) 默认值 描述 到件方详细地址，需要包括省市区，3 是 如：广东省深圳市福田区新洲十一街万基商务大厦。 7.2.3. 元素<请求> OrderFilter/OrderFilterOption（可选） # 1 2 3 属性名 j_tel country province 类型（约束） 必填 String(20) String (50) String (30) 否 否 否 默认值 CN 描述 寄件方电话 寄件人所在国家代码 寄件方所在省份，必须是标准的省名称称谓 如：广东省，如果是直辖市，请直接传北京、上海等。 4 5 6 7 city county d_country d_province String (100) String (30) String(50) String (30) 否 否 否 否 CN 寄件方所属城市名称，必须是标准的城市称谓 如：深圳市。 寄件人所在县/区，必须是标准的县/区称谓，示例：“福田区”。 到件方国家 到件方所在省份，必须是标准的省名称称谓 如：广东省，如果是直辖市，请直接传北京、上海等。 到件方所属城市名称，必须是标准的8 d_city String (100) 否 城市称谓 如：深圳市，如果是直辖市，请直接传北京（或北京市）、上海（或上海市）等。 9 d_county String (30) 否 到件方所在县/区，必须是标准的县/区称谓，示例：“福田区”。 寄件方详细地址，包括省市区，示10 j_address 11 d_tel 12 j_custid String(150) String(23) String(30) 否 否 否 例：“广东省深圳市福田区新洲十一街万基商务大厦10楼”。 到件方电话 结账号，用于在人工筛单时，筛单人员识别客户使用。 第 29页 /共 59页 ?版权所有2015顺丰科技有限公司