德阳银行应用集成平台ESB-移动代收与核心接口文档-V1.0

移动代收ESB与核心系统接口说明书德阳银行应用集成平台ESB工程组2011-11-0文档信息工程名称文档编号德阳银行应用集成平台ESB工程用户信息用户名称德阳银行合作开发方信息合作开发方名称北京先进数通信息技术修订记录版本号日期修订说明编写或修订人审核2011-11-初稿李海超2012-2-9与中间业务前置人员讨论后确定李海超孙开乾目录TOC\o"1-2"\h\z\u1 引言 4 编写目的 4 工程背景 4 参考资料 42 移动代收系统架构 5 系统结构图 52.2 协议 5 SOAP报文封装 6 交易报文格式 7 文件传输 9 平安控制 93 交易列表 104 ESB与核心接口 11 接口说明 11 签到〔交易号900001〕 11 签退〔交易号900002〕 12 缴费查询〔交易码100012〕 13 缴费〔交易号200010〕 15 退费〔交易号100013〕 15 查询已交费〔交易码100010〕 16 对账处理〔交易码900003〕 17引言编写目的本文档为德阳银行应用集成平台ESB工程编写的移动代收业务ESB系统与核心系统之间的接口说明。本文档为德阳银行应用集成平台ESB所需的其他设计文件编制提供参考，也可作为有关技术主管部门、专家对本系统进行评审、审批的参考资料。主要读者包括：本次工程所有相关的设计、开发、测试及维护人员。工程背景工程名称：应用集成平台ESB工程系统代号：ESB任务的提出者：德阳银行系统的开发者：北京先进数通信息技术系统使用部门：德阳银行参考资料《移动代收接口文档.doc》移动代收系统架构系统结构图通讯协议：移动代收系统采用协议，对WEBSERVICE的调用采用SOAP调用方法，即所有与核心之间请求或相应的交互信息封装为SOAP消息，所有SOAP消息均用XML形式编码(UTF-8)。协议ESB与核心系统通讯采用绑定与协议的SOAP方式，所有SOAP消息均包含于消息。消息主要内容如下。请求在TCP/IP之上进行通信。客户机使用TCP连接到效劳器。在建立连接之后，客户机可向效劳器发送请求消息，主要包含以下内容：POSTESB与核心之间对WebService的调用采用SOAP调用方法，承载SOAP调用的请求头中使用POST命令。URLESB要求目的地址的URL格式均为/交易码。例如交易码为cc0003，那么URL为/cc0003。Host不做特定要求。Content-TypeESB支持SOAP消息绝大局部常见的MIME类型，例如text/plain、application/soap+xml等。XML编码采用UTF-8，即charset=”utf-8”。Content-LengthSOAP的请求和响应的Content-Length头规定请求或响应主体的字节数。请求头实例： POST/cc0003 Host: Content-Type:text/plain;charset=”utf-8 Content-Length:200响应效劳器收到客户机的请求后，效劳器会处理此请求，然后向客户机发送一个响应。此响应包含了如下信息：1.1超文本传输协议版本。200OK应答信息，处理成功返回200OK，假设效劳器无法对请求进行解码，它可能会返回类似这样的信息：400BadRequest。Content-Type响应报文的MIME类型以及响应报文的XML编码方式。Content-LengthSOAP的请求和响应的Content-Length头规定请求或响应主体的字节数。响应头实例： 1.1200OK Content-Type:text/plain; charset=”utf-8 Content-Length:200SOAP报文封装一条SOAP消息就是一个普通的XML文档，包含以下元素：必需的Envelope元素，可把此XML文档标识为一条SOAP消息可选的Header元素，包含头部信息必需的Body元素，包含所有的调用和响应信息可选的Fault元素，提供有关在处理此消息所发生错误的信息、ESB采用的SOAP报文封装例如：<?xmlversion="1.0"?><soapenv:Envelopexmlns:soapenv=":///2001/12/soap-envelope"soapenv:encodingStyle=":///2001/12/soap-encoding"><soapenv:Header>......</soapenv:Header><soapenv:Body>......<soapenv:Fault>......</soapenv:Fault></soapenv:Body></soapenv:Envelope>交易报文格式本章节所讨论报文格式均包含于SOAP报文封装的Body元素下，即上层标记为：<soapenv:Body>。请求报文请求报文根元素为ns:Request。请求报文头请求报文头标记为RequestHeader，其父标记为ns:Request。主要字段如下(此处字段为暂定，需讨论后决定。第五章节的交易接口中将不再列出请求报文头字段)。注：标记名前横线数量表示包含与被包含层次，下同。请求信息体请求信息体以RequestBody作为根元素，其父标记为ns:Request。根元素下即为交易元素。如有多条记录的情况，每条记录标记为RecMsg。请求报文例如暂未提供响应报文响应报文根元素为ns:Response。响应报文头响应报文头标记为ResponseHeader。其父标记为ns:Response。字段待定。(第五章节的交易接口中不再给出报文头字段)。响应信息体请求信息体以ResponseBody作为根元素，其父标记为ns:Response。根元素下即为交易元素。如有多条记录的情况，每条记录标记为RecMsg。错误报文每个响应报文必须包含一个错误报文。其父标记为ns:Response。错误报文以soapenv:Fault为根元素，包含一个错误代码字段、一个错误信息字段以及一个Detail子标记，Detail包含一个交易状态字段。序号域名称数据类型中文描述必输说明-soapenv:Body请求\响应报文封装元素--ns:Response响应报文根元素Fault错误报文标记FaultCodeChar(15)错误代码FaultStringChar(255)错误信息Detail错误报文子标记TxnStatusChar(8)交易处理状态SUCCESSFAIL响应报文例如暂未提供文件传输平安控制ESB通过对XML报文体(即去除头之后的报文内容)字串进行MD5信息摘要计算来防止被篡改以及认证交易的合法性。请求报文由ESB生成MD5值并提交核心校验，并对核心返回的应答报文获取核心提交的MD5值并校验。MD5值存放于头中Content-Md5字段中。交易列表序号交易名称描述功能描述900001签到900002签退100012缴费查询200010缴费100013退费100010查询已交费900003对账处理ESB与核心接口接口说明IPP－综合前置平台ESB－企业效劳总线业务流程中蓝色字体标识接口所属区域，如IPP->ESB标识综合前置平台到ESB之间的接口签到〔交易号900001〕(IPP调用S004046110900001)柜台->ESB(穿透)->IPP->ESB->中间业务小前置->移动公司请求信息体序号标记属性中文描述数据类型必输数据元素说明-soapenv:Body请求\响应报文封装元素--ns:Request请求报文根元素RequestBody请求报文体标记交易码Char(7)TxnCd固定为’900001’报文明细Char(217)ListDtl文件名Char(40)FileNme未用报文类型Char(1)MsgKind固定值为’1’是否等待标识Char(1)WaitFlg用于某些交易如：现金缴费确认交易报文明细组成格式memcpy(send_mb.dts,"68",2);memcpy(send_mb.dts+2,sbuf,16);sbuf有下面方式生成：sprintf(sbuf,"%s%02X",sbuf,m_rzm[i]);DES_64(0,mbexchkey,a_rzm,m_rzm,8);intDES_64(intop,unsignedchar*key,unsignedchar*in,unsignedchar*out,intlen){des_ctxdc;unsignedlong*xkey,work[2];inti,x;/*printf("desmac--%s-%d;\n",__FILE__,__LINE__);*/des_key(&dc,key);xkey=op==0?dc.ek:dc.dk;x=len/8;if(len%8)x++;for(i=0;i<x;i++){scrunch(in,work);desfunc(work,xkey);unscrun(work,out);in+=8;}returnx*8;}响应信息体序号标记属性中文描述数据类型必输数据元素说明-soapenv:Body请求\响应报文封装元素--ns:Response响应报文根元素ResponseBody响应报文体标记返回码Char(5)FaultCode认证码Char(17)AuthIDMac校验码Char(17)HMac签退〔交易号900002〕(IPP调用S004046070900002)柜台->ESB(穿透)->IPP->ESB->中间业务小前置->移动公司请求信息体序号标记属性中文描述数据类型必输数据元素说明-soapenv:Body请求\响应报文封装元素--ns:Request请求报文根元素RequestBody请求报文体标记交易码Char(7)TxnCd固定为’900002’报文明细Char(217)ListDtl文件名Char(40)FileNme未用报文类型Char(1)MsgKind固定值为’1’是否等待标识Char(1)WaitFlg用于某些交易如：现金缴费确认交易报文明细组成格式与签到相同，请参照签到响应信息体序号标记属性中文描述数据类型必输数据元素说明-soapenv:Body请求\响应报文封装元素--ns:Response响应报文根元素ResponseBody响应报文体标记返回码Char(5)FaultCode假设为’-1’，buff为0601返回内容Char(37)FaultString包含返回码、认证码的信息缴费查询〔交易码100012〕(IPP调用S004046010100012)柜台->ESB(穿透)->IPP->ESB->中间业务小前置->移动公司请求信息体序号标记属性中文描述数据类型必输数据元素说明-soapenv:Body请求\响应报文封装元素--ns:Request请求报文根元素RequestBody请求报文体标记号Char(14)MbPhnNo代理工程编号Char(3)ProjCd固定值‘01’操作员号Char(9)OperNo代理行号Char(9)AgtBkNo固定值‘68010141’响应信息体下传的文件名在报文的公共局部的RcvFileNme标记中序号标记属性中文描述数据类型必输数据元素说明-soapenv:Body请求\响应报文封装元素--ns:Response响应报文根元素ResponseBody响应报文体标记姓名Char(12)CustNme客户姓名状态Char(1)CustStat0-正常1-高频3-欠停4-报停5-挂失6预拆7-预销8-强开9-强关a-销号b-拆机未出单话费Char(12)NoChagAcctAmt预存Char(12)RmnAmt补收月租费Char(12)Fee文件明细条数Char(4)DetlNum返回码Char(4)FaultCode‘0000’响应下传文件文件格式：序号域名数据类型说明年Char(4)月Char(2)本月欠费Char(12)应收款Char(12)滞纳金Char(12)优惠款Char(12)预存款划拨Char(12)新交款Char(12)月租费Char(12)特服费Char(12)本网费Char(12)漫游Char(12)长途费Char(12)附加费Char(12)其它费Char(12)代收信息费Char(12)频占费Char(12)农话费Char(12)补收费Char(12)假设条数为多条，那么记录依次循环。缴费〔交易号200010〕(IPP调用S004046030200010)柜台->ESB(穿透)->IPP->ESB->中间业务小前置->移动公司请求信息体序号标记属性中文描述数据类型必输数据元素说明-soapenv:Body请求\响应报文封装元素--ns:Request请求报文根元素RequestBody请求报文体标记号Char(14)MbPhnNo代理工程编号Char(3)ProjCd固定值‘01’操作员Char(9)OperNo实缴金额Char(13)DpstAmt交易流水号Char(9)TxnSeqNo交易日期Char(9)TxnDt交易时间Char(7)TxnTm代理行号Char(9)BrchNo固定为’68010141’Mac码Char(9)HMac报文明细组成格式memcpy(send_mb.dts,"b000",4);//交易区分码memcpy(send_mb.dts+4,"17",2);//地区码memcpy(send_mb.dts+6,"01",2);memcpy(send_mb.dts+8,srcv.brno,8);//机构号memcpy(send_mb.dts+16,srcv.tlsrno,8);//流水号memcpy(send_mb.dts+24,srcv.agekey,11);//号码memcpy(send_mb.dts+35,srcv.txamt,12);//金额，12位串memcpy(send_mb.dts+47,srcv.cdate,8);//系统日期memcpy(send_mb.dts+55,srcv.ctime,6);//时间memcpy(send_mb.dts+61,sbuf,16);sbuf由下面方法生成：sprintf(macInBlock,"%8.8s%8.8s%11.11s%12.12s%8.8s%6.6s",srcv.brno,srcv.tlsrno,srcv.agekey,srcv.txamt,srcv.cdate,srcv.ctime);memcpy(todaymac,srcv.mackey,sizeof(todaymac));/*if(MacKey(todaymac,"01"))return_200010("0608")todaymac[8]='\0';*/PRN("\ntlsrno=%s;srcv.mackey=%s;\n",srcv.tlsrno,todaymac);if(genMAC(MAC_STAND,macInBlock,strlen(macInBlock),todaymac,vMac))return_200010("0609")memset(sbuf,'\0',sizeof(sbuf));for(i=0;i<8;i++)sprintf(sbuf,"%s%02X",sbuf,vMac[i]);PRN("sbuf=%s\n",sbuf);memcpy(send_mb.dts+61,sbuf,16);响应信息体序号标记属性中文描述数据类型必输数据元素说明-soapenv:Body请求\响应报文封装元素--ns:Response响应报文根元素ResponseBody响应报文体标记返回码Char(1)FaultCode‘0’标识正确返回信息Char(5)FaultString机构号Char(9)BrchNo交易流水号Char(9)_HostSeqNo校验字符串Char(86)ChkMsg退费〔交易号100013〕(IPP调用S004046030100013)柜台->ESB(穿透)->IPP->ESB->中间业务小前置->移动公司请求信息体序号标记属性中文描述数据类型必输数据元素说明-soapenv:Body请求\响应报文封装元素--ns:Request请求报文根元素RequestBody请求报文体标记号Char(12)MbPhnNo代理工程编号Char(3)ProjCd固定值‘01地区Char(3)AreaCd固定为’17’所属城市Char(3)CityCd此处为’01’机构号Char(9)BrchNo固定为’68010141’主机流水号Char(9)HostSeqNo新的主机流水号Char(9)NewHostSeqNo交易时间Char(15)TxnTm新的交易时间Char(15)NewTxnTmMac校验码Char(9)HMac响应信息体序号标记属性中文描述数据类型必输数据元素说明-soapenv:Body请求\响应报文封装元素--ns:Response响应报文根元素ResponseBody响应报文体标记返回码Char(1)FaultCode为’0’标识正确返回信息Char(5)FaultString校验字符串Char(86)ChkMsg查询已交费〔交易码100010〕(IPP调用S004046010100010)柜台->ESB(穿透)->IPP->ESB->中间业务小前置->移动公司请求信息体序号标记属性中文描述数据类型必输数据元素说明-soapenv:Body请求\响应报文封装元素--ns:Request请求报文根元素RequestBody请求报文体标记号Char(12)MbPhnNo代理工程编号Char(3)ProjCd固定值01代理行号Char(9)AgtBkNo固定值68010141操作员号Char(9)OperNo起始时间Char(15)StartTm终止时间Char(15)EndTm报文明细组成格式memcpy(send_mb.dts,"b000",4);//交易区分码memcpy(send_mb.dts+4,recv_get_string(varname(key)),11);//号memcpy(send_mb.dts+15,"68010141",8);//代理行号memcpy(send_mb.dts+23,strlen(recv_get_string(varname(sttime)))==0?SYS.wkday:recv_get_string(varname(sttime)),8);//起始时间memcpy(send_mb.dts+31,"000000",6);memcpy(send_mb.dts+37,strlen(recv_get_string(varname(endtime)))==0?SYS.wkday:recv_get_string(varname(endtime)),8);//终止时间memcpy(send_mb.dts+45,"235959",6);响应信息体(报文+文件)下传的文件名在报文的公共局部的RcvFileNme标记中序号标记属性中文描述数据类型必输数据元素说明-soapenv:Body请求\响应报文封装元素--ns:Response响应报文根元素ResponseBody响应报文体标记返回码Char(1)FaultCode为’0’标识正确返回信息Char(5)FaultS