EMS自助服务系统和大客户接口规范V09(取单号打印后回传数据)22.doc

EMS自助服务系统和大客户 接口规范 变更历史 日期 变更描述 版本号 变更人 批准 2013-03-18 创建文档 V0.9 王一松 总体说明 接口目的 本文包含了相关接口的数据格式、通讯格式。本文附录包含了接口使用的基础代码信息。 该文档约束了中国邮政速递物流EMS自助服务系统和大客户的接口规范，文档内容需严格保密。 接口规范 EMS自助服务系统和大客户接口建议采用http接口方式，同时支持webservice接口方式； http接口编码格式均为UTF-8格式。 为保证单号正常获取，不影响用户使用。需在当天将打印后的数据更新到EMS自助服务系统（接口2.2）。 EMS自助服务客户端和大客户接口规范 根据大客户号、业务类型获取详情单号接口 功能描述 通过大客户号，业务类型获取详情单号 服务端 EMS自助服务系统 客户端 大客户系统 接口方式 HTTP 接口地址 :8081/zkweb/bigaccount/getBigAccountDataAction.do?method getBillNumBySysxml 输入参数 大客户号、密码、业务种类、获取数量 输入参数格式定义 使用BASE64加密输入参数 ！！！特别注意：单号是唯一的，获取后本地保存时必须作为唯一索引。！！！ XML标记串： ?xml version 1.0 encoding UTF-8 //大客户号，必填，代码调试期间请务必传入大客户号：A1座机电话号码0Z //大客户密码，必填，小写md5加密， e10adc3949ba59abbe56e057f20f883e //对接方平台id，作为接口调用方的身份凭据，由接口提供方提供 //业务类型，必填，1为标准快递，4为经济快递（传数字） 需要详情单数量，最多输入100个 返回值格式定义 使用BASE64加密返回值 XML标记串： ?xmlversion 1.0 encoding UTF-8 //是否执行成功，1是成功，0是失败 //错误原因描述 //详情单号 ...... .......... 参考方法名 getBillNoBySys xml Webservice_path :8081/zkweb/services/getPrintDatas?wsdl Webservice_name 实现类 EmsPrintService 备注 详情单打印信息更新到EMS自助服务系统接口 功能描述 将详情单打印信息更新到自助服务系统 服务端 EMS自助服务系统 客户端 大客户系统 接口方式 HTTP 接口地址 :8081/zkweb/bigaccount/getBigAccountDataAction.do?method updatePrintDatasxml 输入参数 大客户号、打印类型 将详情单信息按照xml格式封装成一个字符串传入系统进行数据更新 输入参数格式定义 使用BASE64加密输入参数 XML标记串： ?xml version 1.0 encoding UTF-8 //大客户号，必填 //大客户密码，必填，小写md5加密， e10adc3949ba59abbe56e057f20f883e //对接方平台id，作为接口调用方的身份凭据，由接口提供方提供 //打印类型，1为五联单打印，2为热敏打印，必填 //大客户数据的唯一标识，如某电商公司的配货单号，必填 订单如果打印条码,应为非13位数字 //详情单号，和配货单号对应，必填（详情单号打印条形码必须128码） //寄件人姓名 //寄件人联系方式1 //寄件人联系方式2 选填 //寄件人邮编 //寄件人地址 //寄件人公司 //收件人姓名 //收件人联系方式1 //收件人联系方式2 选填 //收件人邮编 //收件人地址 //收件人公司 //到件省 //到件市 //到件县 //寄件重量 //物品长度 保价，每件最高投保金额以人民币5万元为限 //保险 //小写金额，代收货款和收件人付费不保留小数点； 标准快递和经济快递保留两位小数点 //大写金额（代收货款和收件人付费需要填写） //业务类型，1为标准快递，2为代收货款，3为收件人付费，4为经济快递（传数字） //内件信息，根据货品的实际情况填写（对个别已与EMS和买家达成协议的，可只写货号，不写实际货物名称） //内件类型：（文件、物品） //备注 //对揽投员的投递要求，填写客户的个性化投递要求 //产品代码 //预留字段1 //预留字段2 //预留字段3 //预留字段4 //预留字段5 …… ........ 字段 类型 Limit 说明 订单信息 scontactor VARCHAR2 50 CHAR Not