EMS自助服务系统及大客户接口规范V0.9(取单号打印后回传数据).docVIP

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? XMLInfo sysAccount/sysAccount//大客户号，必填，代码调试期间请务必传入大客户号：A1234567890Z passWord/passWord//大客户密码，必填，小写md5加密， e10adc3949ba59abbe56e057f20f883e appKey/appKey//对接方平台id，作为接口调用方的身份凭据，由接口提供方提供 businessType/businessType//业务类型，必填，1为标准快递，4为经济快递（传数字） billNoAmount/billNoAmount需要详情单数量，最多输入100个 /XMLInfo 字段类型Limit说明订单信息sysAccountVARCHAR2(20 CHAR)Not Null大客户号passWordVARCHAR2(40 CHAR)Not Null密码（MD5 加密，全小写，32位）appKeyVARCHAR2(20 CHAR)平台id，暂时留空billNoAmountVARCHAR2(5 CHAR)Not Null 请求数量（1-100）返回值格式定义使用BASE64加密返回值 XML标记串： ?xmlversion=1.0 encoding=UTF-8? response result/result//是否执行成功，1是成功，0是失败 errorDesc/errorDesc//错误原因描述 assignIds assignId billno/billno//详情单号 /assignId assignId ...... /assignId .......... assignIds /response参考方法名getBillNoBySys(xml)Webservice_path:8081/zkweb/services/getPrintDatas?wsdlWebservice_name实现类EmsPrintService备注 详情单打印信息更新到EMS自助服务系统接口 功能描述将详情单打印信息更新到自助服务系统服务端EMS自助服务系统客户端大客户系统接口方式HTTP接口地址:8081/zkweb/bigaccount/getBigAccountDataAction.do?method=updatePrintDatasxml=输入参数大客户号、打印类型 将详情单信息按照xml格式封装成一个字符串传入系统进行数据更新输入参数格式定义使用BASE64加密输入参数 XML标记串： ?xml version=1.0 encoding=UTF-8? XMLInfo sysAccount/sysAccount//大客户号，必填 passWord/passWord//大客户密码，必填，小写md5加密， e10adc3949ba59abbe56e057f20f883e appKey/appKey//对接方平台id，作为接口调用方的身份凭据，由接口提供方提供 printKind/printKind//打印类型，1为五联单打印，2为热敏打印，必填 printDatas