企业服务平台技术规范 – 下订单（含筛选）接口 # 属性名 类型（约束） 必填 String(5) String(30) String(100) String(100) String(100) String(100) String(100) String(600) String(600) 默认值 描述 税金付款方式： 43 tax_pay_type 44 tax_set_accounts 45 original_number 46 payment_tool 47 payment_number 48 goods_code 49 in_process_waybill_no 否 否 否 否 否 否 否 否 否 ? 1：寄付 ? 2：到付 税金结算账号 电商原始订单号 支付工具 支付号码 商品编号 头程运单号 货物品牌 货物规格型号 温度范围类型，当express_type为1252 temp_range Number(1,0) 条件 医药温控件时必填： ? 1为冷藏 ? 3为冷冻 53 order_name 54 order_cert_type 55 order_cert_no 56 order_source String(100) String(100) String(100) String(50) 否 否 否 否 客户订单下单人姓名 客户订单下单人证件类型 客户订单下单人证件号 客户订单来源（对于平台类客户，如果需要在订单中区分订单来源，则可使用此字段） 业务模板编码，业务模板指BSP针对57 template String(30) 否 客户业务需求配置的一套接口处理逻辑，一个接入编码可对应多个业务模板。 58 remark String(100) 否 否 50 brand 51 specifications 0 备注 快件自取；1表示客户同意快件自取；非1表示客户不同意快件自取 59 oneself_pickup_flg Number(1) 60 dispatch_sys 注意事项： String(20) 否 订单数据分发的系统编码 第 15页 /共 59页
?版权所有2015顺丰科技有限公司
企业服务平台技术规范 – 下订单（含筛选）接口
1) 可从顺丰商务人员处获取标准的中国省市县/区列表。 2) 可从顺丰商务人员处获取标准的国家/城市代码列表。 4.2.3. 元素<请求>Order/Cargo # 1 2 3 属性名 name count unit 类型（约束） 必填 String(60) Number(5) String(30) 是 条件 条件 默认值 描述 货物名称，如果需要生成电子运单，则为必填。 货物数量 跨境件报关需要填写 货物单位，如：个、台、本，跨境件报关需要填写。 订单货物单位重量，包含子母件，单4 weight Number(16,3) 条件 位千克，精确到小数点后3位跨境件报关需要填写。 5 amount Number(17,3) 条件 货物单价，精确到小数点后3位，跨境件报关需要填写。 第 16页 /共 59页
?版权所有2015顺丰科技有限公司
企业服务平台技术规范 – 下订单（含筛选）接口 # 属性名 类型（约束） 必填 默认值 描述 货物单价的币别： ? CNY: 人民币 ? HKD: 港币 ? USD: 美元 ? NTD: 新台币 ? RUB: 卢布 ? EUR: 欧元 ? MOP: 澳门元 6 currency String(5) 条件 ? SGD: 新元 ? JPY: 日元 ? KRW: 韩元 ? MYR: 马币 ? VND: 越南盾 ? THB: 泰铢 ? AUD: 澳大利亚元 ? MNT: 图格里克 跨境件报关需要填写。 7 8 9 source_area product_record_no good_prepard_no String(5) String(18) String(100) 条件 否 否 原产地国别，跨境件报关需要填写。 货物产品国检备案编号 商品海关备案号 4.2.4. 元素<请求>Order/ AddedService（可选） 属性名 name value value1 类型（约束） 必填 String(20) String(30) String(30) 是 条件 条件 默认值 描述 增值服务名，如COD等。 增值服务扩展属性，参考增值服务传值说明。 增值服务扩展属性 4.2.5. 元素<响应> OrderResponse # 1 属性名 orderid 类型（约束） 必填 String(64) 是 默认值 描述 客户订单号 第 17页 /共 59页
?版权所有2015顺丰科技有限公司
企业服务平台技术规范 – 下订单（含筛选）接口 # 属性名 类型（约束） 必填 默认值 描述 顺丰运单号，一个订单只能有一个母单号，如果是子母单的情况，以半角2 mailno String(4000) 否 逗号分隔，主单号在第一个位置，如“755123456789,001123456789,002123456789” ，可用于顺丰电子运单标签打印。 3 4 5 return_tracking_no origincode destcode String(30) String(10) String(10) 否 否 否 顺丰签回单服务运单号 原寄地区域代码，可用于顺丰电子运单标签打印。 目的地区域代码，可用于顺丰电子运单标签打印。 筛单结果： 6 filter_result Number(2) 否 ? 1：人工确认 ? 2：可收派 ? 3：不可以收派 如果filter_result=3时为必填，不可以收派的原因代码： 7 remark String(100) 条件 ? 1：收方超范围 ? 2：派方超范围 ? 3-：其它原因 4.2.6. 增值服务下单属性说明 # 名称 代码 说明 ? value为货款，以原寄地所在区域币种为1 代收货款 COD 准，如中国大陆为人民币，香港为港币，保留3位小数。 ? value1为代收货款卡号 ? value为声明价值以原寄地所在区域币种2 3 保价 签收短信通知 INSURE MSG 为准，如中国大陆为人民币，香港为港币，保留3位小数。 ? value为手机号码 备注 第 18页 /共 59页
?版权所有2015顺丰科技有限公司
企业服务平台技术规范 – 下订单（含筛选）接口 # 4 5 6 7 名称 包装服务 特殊保价 特殊配送 特殊增值服务 代码 PKFEE SINSURE SDELIVERY SADDSERVICE 说明 ? value为包装费费用，单位与主运费一致 ? value为服务费，单位与主运费一致 ? value为服务费，单位与主运费一致 ? value 为服务费，单位与主运费一致 value为派送日期（格式：YYYYMMDD），8 定时派送 TDELIVERY value1为派送时间段调整为09:00-12:00、12:01-18:00、18:01-21:00三个选项（分别用快捷键1、2、3代表） 9 电商加急 URGENT Esign ? Value 为图片类型： 10 电子签收 1、身份证，2、军官证，3、护照，4、其他 Value1 为照片张数 Value 为图片类型： 10 拍照验证 11 保鲜服务 12 大闸蟹 13 票据专送 4.2.7. 扩展字段信息
此接口支持扩展字段，遵循扩展字段规范，参考XML报文说明。 4.2.8. 报文范例
请求XML，使用公共接口信息开发时，按需修改客户订单号（Order元素中的orderid属性）：
? 中国大陆件：
orderid='TE20150104' j_company='罗湖火车站' 备注 Value和value1必填 Psign FRESH IN98 IN99 1、身份证，2、军官证，3、护照，4、其他 Value1 为照片张数 ? ? ? 第 19页 /共 59页 ?版权所有2015顺丰科技有限公司