企业服务平台接入技术规范_V3.6_160507(5)

企业服务平台技术规范 – 下订单（含筛选）接口

j_contact='小雷' j_tel='13810744' j_mobile='13111744' j_province='广东省' j_city='深圳' j_county='福田区'

j_address='罗湖火车站东区调度室' d_company='顺丰速运' d_contact='小邱' d_tel='15819050'

d_mobile='15539050'

d_address='北京市海淀区中关村' express_type='1' pay_method='1'

parcel_quantity='1' cargo_length='33' cargo_width='33' cargo_height='33' remark=''>

name='LV1' count='3' unit='a' weight='' amount='' currency=''

source_area=''>

name='LV2' count='3' unit='a' weight='' amount='' currency=''

source_area=''>

value1='0123456789'>

第 20页 /共 59页

?版权所有2015顺丰科技有限公司

企业服务平台技术规范 – 下订单（含筛选）接口

e2=”abc”/>

? 跨境件：

BSPdevelop

orderid='TEST_201501290001' j_company='SFSingapore' j_contact='PeterK' j_tel='12345678' j_mobile='12345678' j_shippercode='SIN01D' j_country='SG'

j_province='Singapore' j_city='Singapore' j_county='Singapore'

j_address='7SixthLokYangRoad#11-11Singapore628105' j_post_code='628105' d_deliverycode='852' d_country='HK'

d_company='Daniel' d_contact='DanielLi' d_tel='87654321' d_mobile='87654321' d_province='Hong Kong' d_city='Hong Kong' d_county='Hong Kong'

d_address='27/Ftestaddress,Kowloon,HongKong' d_post_code='852852' custid='0650000001' pay_method='1' express_type='23' parcel_quantity='1'

cargo_total_weight='2.18' declared_value='1'

declared_value_currency='CNY'

sendstarttime='2014-12-1707:08:38' remark='beizhu'>

name='nailcare' count='20' unit='pcs'

weight='0.003' amount='0.05' currency='CNY'

source_area='China'>

响应XML：

? 订单处理成功：

o 中国大陆件：

第 21页 /共 59页

?版权所有2015顺丰科技有限公司

企业服务平台技术规范 – 下订单（含筛选）接口

OK

orderid=\mailno=\origincode=\destcode=\

filter_result=\

o 跨境件：

OK

orderid=\mailno=\origincode=\destcode=\

filter_result=\

? 订单处理失败：

o 范例1：

ERR

o 范例2：

ERR

第 22页 /共 59页

?版权所有2015顺丰科技有限公司

企业服务平台技术规范 – 订单确认/取消接口

5. 订单确认/取消接口

5.1. 功能描述

该接口用于：

? 客户在确定将货物交付给顺丰托运后，将运单上的一些重要信息，如快件重量通过

此接口发送给顺丰。 ? 客户在发货前取消订单。

注意：订单取消之后，订单号也是不能重复利用的。

5.2. 接口定义

5.2.1. 接口基本信息 服务名称 批量交易 接口类型 接口方法 OrderConfirmService 不支持 接入 String sfexpressService(String xml, String verifyCode) 5.2.2. 元素<请求> OrderConfirm # 1 2 3 属性名 orderid mailno dealtype 类型（约束） 必填 String(64) String(20) Number(1) 是 条件 否 默认值 1 描述 客户订单号 顺丰母运单号(如果dealtype=1，必填) 客户订单操作标识： ? 1：确认 ? 2：取消 5.2.3. 元素<请求> OrderConfirm/OrderConfirmOption（可选） # 属性名 类型（约束） 必填 默认值 描述 第 23页 /共 59页

?版权所有2015顺丰科技有限公司

企业服务平台技术规范 – 订单确认/取消接口 # 属性名 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顺丰科技有限公司