企业服务平台接入技术规范V36160507.doc

顺丰科技有限公司 企业服务平台接入规范 V3.6 系统与数据集成研发中心 16.2.19 ? 版权所有 2015 顺丰科技有限公司，未经顺丰科技有限公司 / 顺丰速运有限公司授权，不 得向任何第三方透露本文档所含信息的全部或部分内容。 企业服务平台技术规范 –目录 目录 1. 目录 1 2. 前言 5 3. 接口规范说明 6 3.1. 报文及报文编码 6 3.2. 通讯协议 6 3.3. 接口规范说明 6 3.3.1. 接口基本信息说明 6 3.3.2. XML 报文说明 7 3.3.3. 元素及元素属性说明 8 3.4. 开发用公共接口信息 9 4. 下订单（含筛选）接口 10 4.1. 功能描述 10 4.2. 接口定义 10 4.2.1. 接口基本信息 10 4.2.2. 元素 请求 Order 10 4.2.3. 元素 请求 Order/Cargo 16 4.2.4. 元素 请求 Order/ AddedService（可选） 17 4.2.5. 元素 响应 OrderResponse 17 4.2.6. 增值服务下单属性说明 18 4.2.7. 扩展字段信息 19 4.2.8. 报文范例 19 5. 订单确认 / 取消接口 23 5.1. 功能描述 23 5.2. 接口定义 23 5.2.1. 接口基本信息 23 5.2.2. 元素 请求 OrderConfirm 23 5.2.3. 元素 请求 OrderConfirm/OrderConfirmOption （可选） 23 5.2.4. 元素 响应 OrderConfirmResponse 24 5.2.5. 扩展字段信息 24 5.2.6. 报文范例 24 第1页/共59页 ? 版权所有 2015 顺丰科技有限公司 企业服务平台技术规范 –目录 6. 订单结果查询接口 26 6.1. 功能描述 26 6.2. 接口定义 26 6.2.1. 接口基本信息 26 6.2.2. 元素 请求 OrderSearch 26 6.2.3. 元素 响应 OrderSearchResponse 26 6.2.4. 报文范例 27 7. 订单筛选接口 28 7.1. 功能描述 28 7.2. 接口定义 28 7.2.1. 接口基本信息 28 7.2.2. 元素 请求 OrderFilter 28 7.2.3. 元素 请求 OrderFilter/OrderFilterOption （可选） 29 7.2.4. 元素 响应 OrderFilterResponse 30 7.2.5. 报文范例 30 8. 人工筛单结果推送接口 32 8.1. 功能描述 32 8.2. 接口定义 32 8.2.1. 接口基本信息 32 8.2.2. 元素 请求 OrderFilterResult 32 8.2.3. 报文范例 33 9. 路由查询接口 35 9.1. 功能描述 35 9.2. 接口定义 35 9.2.1. 接口基本信息 35 9.2.2. 元素 请求 RouteRequest 35 9.2.3. 元素 响应 RouteResponse 36 9.2.4. 元素 响应 RouteResponse/Route 36 9.2.5. 报文范例 37 10. 路由推送接口 38 10.1. 功能描述 38 10.2. 接口定义 38 10.2.1. 接口基本信息 38 第2页/共59页 ? 版权所有 2015 顺丰科技有限公司 企业服务平台技术规范 –目录 10.2.2. 元素 请求 WaybillRoute 38 10.2.3. 报文范例 39 11. 时效查询接口 41 11.1. 功能描述 41 11.2. 接口定义 41 11.2.1. 接口基本信息 41 11.2.2. 元素 请求 DeliverTmRequest 41 11.2.3. 元素 请求 DeliverTmRequest/SrcAddress 42 11.2.4. 元素 请求 DeliverTmRequest/DestAddress 43 11.2.5. 元素 响应 DeliverTmResponse/DeliverTm 43 11.2.6. 报文范例 44 12. 产品及增值服务查询接口 46 12.1. 功能描述 46 12.2. 接口定义 46 12.2.1. 接口基本信息 46 12.2.2. 元素 请求 Scope 46 12.2.3. 元素 响应 Scope/Service 46 12.2.4. 产品 / 增值服务客户属性说明 47 12.2.5. 报文范例 47 13. 子单号申请接口 48 13.1. 功能描述 48 13.2. 接口定义 48 13.2.1. 接