银电联网省集中.doc

【秘密】黑龙江省电力营销业务应用项目银电联网省集中业务协议方案电力事业部文件编号：EP-PIQM文件版次：QMS2005文档编号版本号分册名称第册/共册总页数正文附录编制审批生效日期东软集团股份有限公司修改记录版本号变更控制报告编号更改条款及内容更改人审批人更改日期0.50.5修改查询、缴费、冲正报文格式2009-8-150.50.5修改银行账号30位2009-8-250.50.5修改对账文件发票的状态2009-9-010.50.5增加对账文件中发票补打的状态2009-9-030.50.5增加对账文件已经读取后不能缴费的报文2009-9-250.50.5修改加密方式为MD5加密报文2009-9-270.50.5修改报文加密的例子2009-9-270.60.6修改请求报文、返回报文中的长度定义2009-10-260.70.7增加查询返回报文的供电局编码2009-10-280.80.8修改月初发票对账的格式2009-11-260.90.9新老户号对账文件格式2009-12-221.01.0修改2位银行编码、5位地市编码、对账报文格式2010-2-22目 录1概述11.1目的11.2范围11.3预期读者12系统功能及业务流程22.1系统拓扑图2-1：22.2系统功能22.2.1用户查询22.2.2用户缴费32.2.3用户冲正32.2.4打印发票32.2.5发票管理32.2.6日终对帐32.2.7报文加密42.3省集中后的调整42.3.1带宽调整42.3.2不再处理非SG186用户的业务需求42.3.3报文加密处理43支持的缴费模式43.1窗口缴费43.2自助终端缴费53.3电话银行缴费53.4网上银行缴费53.5手机银行缴费54与银行接口约定54.1通讯方式54.2数据包格式说明54.2.1查询报文54.2.2缴费报文74.2.3冲正报文84.2.4对账报文94.2.5发票对账报文115附录125.1银行对应表：125.2数据字典：125.3摘要：135.4交易码：135.5地市供电局编码表：141 概述银电联网收费方式有多种，如实时代收、联网托收等。供电企业与各大银行签署电费托收或代收服务协议后，银行代收费系统将完成供电企业与各大商业银 行的收费、对帐等业务处理，电力营销管理信息系统的后台电费收缴管理子系统中将对电费的收缴信息进行处理。随着国网SG186营销业务的推进，过去的银电联网模式在新形式下显得落后，所以制定此方案力求和多家银行同时互联及全省统一规约、统一程序的目的，特制订本规范。1.1 目的明确营销业务应用系统和银行省集中接口交互的数据信息内容和技术实现模式。1.2 范围本标准适用于黑龙江省电力公司所辖各电业局、分公司和关联银行。所有银电联网代收电费应用软件的开发和相关银行均必须严格遵守此标准。1.3 预期读者电力公司相关业务人员、营销业务应用系统设计和开发人员、银行接口系统设计和开发人员。2 系统功能及业务流程2.1 系统拓扑图2-1：图2-1此拓扑图展示了省集中方案的体系结构，具体详解如下：将具备省集中条件的银行通过专线连接到哈局的2台前置机上。由前置机做业务处理后和省公司的数据库进行数据交互完成业务流程。那些没有条件省集中的银行依然保留地市集中的模式进行业务处理。本次银电省集中模式后用户将会用10位的新户号进行缴费，缴费的报文为定长、返回的报文为不定长，为了配合所有银行顺利的进行此项业务，在省集中的初期客户依然用12位老户号进行缴费，则当日的对账文件中需用12位老户号进行对账，全省全部实施省集中后则用10位新户好进行代收电业务。2.2 系统功能..1 用户查询1. 本交易由银行发起，电业局响应。2. 用户通过银行缴费渠道缴费时，先根据地市或供电局编码和用户号统计所有历史欠费信息，电业局返回该户的欠费总额。3. 银行发起本交易后18秒未收到响应时（返回错误码见录附响应码），重新发起，重新发起的交易内容不变，直到响应为止。2.2.2 用户缴费1. 本交易由银行发起，电业局响应。2. 用户通过银行缴费渠道缴费时，先根据地市或供电局编码和用户号统计所有历史欠费信息，电业局返回该户的欠费总额、及其它用电信息，用户根据自己的电费余额购电。3. 银行根据用户的缴费方式受理，用户可以多交，可以少交。4. 电业局收到请求后，进行缴费处理，并将费用信息返回给银行。5. 电业方只接受当天的缴费请求，当银行方发起当日的对账请求后，电业方读取对账文件后则银行需将缴费日期置为第二天（对账后不能再继续缴纳当天的电费）。2.2.3 用户冲正1. 当缴费出错时，可以取消交易。本交易由银行发起，电业局响应。2. 电业局收到该交易后，根据流水号判断原交易是否成功，若成功，则做反销账(即负购电)处理，否则返回错误代码。只有当日进行的交易才可做冲账不可隔日做冲正业务。3. 银行发起本交易后18秒未收到响应时，重新发起，重新发起的交易内容不变，直到响应为止。2.2.4 打印发票1. 本交易由银行发起，电业局响应。2. 电业局在客户缴费成功后将客户信息返回给银行，由银行打印客户电力发票。3. 银行发起缴费交易后18秒未收到响应时，重新发起，重新发起的交易内容不变，直到响应为止。2.2.5 发票管理1. 银行到电业局领取发票，电业局对发放出去的发票统一记录。2. 银行内部记录发票使用情况。3. 每天在对账文件中需将当天有效的使用发票（既每笔业务使用的发票号）和客户补打的发票信息（补打的发票记录不计为有效的流水交易）记录到对账文件中。4. 银行在每月1号将上月作废、丢失的发票号按要求生成在发票文件中并送到电业的FTP上，并发送发票对账请求以便供电局进行发票对账管理。电力方在获取发票对账文件后需要按供电局将发票对账文件进行对账。2.2.6 日终对帐1. 使用对账文件的方式进行对账，由银行发起对账请求并通过FTP把对账文件传送到电业方。2. 本交易由银行发起，电业局响应。3. 银行方把全省当天缴费的用户按要求生成在一个对账文件中。电力方在获取对账文件后需要按供电局进行对账处理。4. 银行方把对账文件生成后发送对账报文，由银行方送到电业方的FTP服务器上并发送对账请求。2.2.7 报文加密根据国家电网标设对银电的规定，在应用软件的设计中借助通讯中间件提供的完整的用户鉴权和数据加密功能。对银行一侧送来的每笔交易都进行用户的合法性检查并对通讯中的数据进行了加密和签字，使攻击者无法获取和改写合法数据，具体规则如下：1. 对原始报文采用MD5加密获取摘要密文，然后对摘要密文采用DES算法加密（加密后的长度为16位即在原始报文长度上追加上16位长度），加密和解密的密码有电业方提供，之后再对原始报文采用base64算法进行编码。2. 将加密的密文放到用base64算法进行编码报文的后面一起发送到电业方，电业方在返回的时候也同样如上操作后返回给银行方。2.3 省集中后的调整2.3.1 带宽调整根据国网标设中对于银电联网的专线描述（营销IT架构设计物理架构设计中银电省集中章节），银电联网交易数据对每用户来说需要两次数据交互，按国网的标设来增加和银行专线的带宽要求。对于前置机放置在哈局需要有足够的网络稳定性保证业务的正常运行。2.3.2 不再处理非SG186用户的业务需求不再对非SG186国网的用户提供转发报文服务，此次省集中后只收取国网直供的用户的电费。2.3.3 报文加密处理根据国家电网标设对银电的规定，需要对每笔业务进行数据加密处理。3 支持的缴费模式系统所支持的缴费模式依赖于银行所提供的缴费方式，大致可以包括：窗口缴费，批量自助转账，自助终端缴费，电话银行缴费，网上银行缴费，手机银行缴费。3.1 窗口缴费现金、卡、折缴费，通过银行前台进行缴费。3.2 自助终端缴费通过银行提供的自助服务终端(地理位置可以延伸到居民小区)进行自助缴费。3.3 电话银行缴费通过银行提供的电话银行系统进行自助缴费。3.4 网上银行缴费通过银行提供的网上银行系统进行自助缴费。3.5 手机银行缴费通过银行提供的手机银行系统进行自助缴费。4 与银行接口约定4.1 通讯方式1. 采用TCP/IP通讯协议。2. 采用SOCKET编程方式。3. 短连接。4.2 数据包格式说明银行请求包由包头和包体组成，包头由固定元素组成，包体的内容由交易决定。响应包用竖线“|”分割信息，信息为不定长（在实际应用中会有用户名、用电地址、供电局名等返回信息中字符过长的情况发生，各大银行可以根据实际情况考虑从后向前截取一定长度的信息来保证正常业务的进行）。4.2.1 查询报文电力客户到银行交电费或查询时, 提供给银行柜员唯一的10位用户号, 银行前置机向电力前置机发送此用户号的查询包, 电力前置机根据地市编码和用户号确定此用户所属的电业局, 然后向相应的供电局数据库读取用户信息，并返回给银行前置机。返回的详细信息见查询应答包定义。交易码：80010（网上商城交易码为80011）。 查询请求包查询请求包，由包头和包体两部分组成。包头信息包括报文长度、银行编码、交易码、机构号、柜员号、银行流水号，地市编码几部分组成。包体包括用户号信息。字段说明数据类型数据最大长度小数位数备注报文长度VARCHAR5不包括长度自己银行编号VARCHAR2英文字母大写，不足2位左补空格交易码VARCHAR5定长机构号VARCHAR8定长柜员号VARCHAR5定长银行流水号VARCHAR8定长地市编码VARCHAR5省集中的银行用空格补齐，非省集中的银行补齐5位地市码用户号VARCHAR1616位户号中不足时在前面填充空格“ ”补齐。电力应答包不变，竖线中为不定长的字符。报文定义例子：加密前：00049 G80010444444445555588888888 020204415378加密后：00082 RzgwMDEwNDQ0NDQ0NDQ1NTU1NTg4ODg4ODg4ICAgICAgMDIwNDQxNTM3OA=d槥钿M躨(灦8? 查询响应包查询响应包由包头和包体两部分组成。包体又由固定信息和明细信息两部分组成。其中明细记录数表示电力上次缴费到现在这段时间内电力扣收明细组成。字段说明数据类型数据最大长度小数位数备注报文长度VARCHAR5不包括长度自己响应码VARCHAR3见响应码定义户名VARCHAR256不定长地址VARCHAR256不定长供电局编码VARCHAR16不定长电价VARCHAR86格式为 dd.dddddd计量装出表号VARCHAR20不定长上次缴费余额VARCHAR182不定长当前余额VARCHAR182不定长违约金VARCHAR182不定长银行利息VARCHAR182不定长明细记录数VARCHAR4不定长日期VARCHAR8格式为YYYYMMDD抄见表示数VARCHAR126不定长电量VARCHAR182不定长电费VARCHAR182不定长优惠电费VARCHAR182不定长摘要VARCHAR6见摘要定义电力应答包例子：加密前：00102000|7-401|富区黎明路92#楼7-401|2340207|0.51|288014440|62.74|7.66|0.0|0.0|1|20081113|7416|108|55.08|0|11|加密后：000145MDAwfMDu1th8y67E4DEjwqUxLjwqUxLTEtMjAxfDAuNTF8MTEwMDg4MTF8MTA1LjczfDg5LjQ0fDAuMHwwLjAzfDF8MjAwOTA2MDV8Njg5NXwxNnw4LjE2fDB8MDZ89N勭緖噙V4.2.2 缴费报文银行柜员在得到用户信息后，通过银行前置机向电力前置机发送缴费请求包，电力前置机接到缴费包后，首先确定用户号中所对应的供电局，然后，进行正常购电处理。在该供电局完成购电后，给银行前置机返回打印票据的详细信息，见缴费应答包的定义。交易码：800 缴费请求包字段说明数据类型数据最大长度小数位数备注报文长度VARCHAR5不包括长度自己银行编号VARCHAR2英文字母大写，不足2位左补空格交易码VARCHAR5定长机构号VARCHAR8定长柜员号VARCHAR5定长银行流水号VARCHAR8定长地市编码VARCHAR5省集中的银行用空格补齐，非省集中的银行补齐5位地市码用户号VARCHAR1616位户号中不足时在前面填充空格“ ”补齐。电力应答包不变，竖线中为不定长的字符。缴费金额VARCHAR152两位小数，含小数点银行帐号VARCHAR30不足30位在前面填充空格“ ”补齐。缴费日期VARCHAR8YYYYMMDD缴费报文例子：加密前：00102GG8002044444444555558X012372 020204471923000000000100.0000000000000000622588532765310120091022加密后：00154MDAwOTZHODAwMjA0NDQ0NDQ0NDU1NTU1OFgwMTIzNzIgICAgICAwMjA0NDcxOTIzMDAwMDAwMDAwMTAwLjAwMDAwMDAwMDAwMDAwMDA2MjI1ODg1MzI3NjUzMTAxMjAwOTEwMjI=鞆?_龁哑c瀧w7_n_ 缴费响应包.1字段说明数据类型数据最大长度小数位数备注报文长度VARCHAR5不包括长度自己响应码VARCHAR3见响应码定义户名VARCHAR256不定长地址VARCHAR256不定长电价VARCHAR86格式为 dd.dddddd计量装出表号VARCHAR20不定长前次缴费余额VARCHAR182不定长本次缴费后余额VARCHAR182不定长本次缴费后预计表示数VARCHAR126不定长违约金VARCHAR182不定长银行利息VARCHAR182不定长售电单位VARCHAR256不定长供电局编码VARCHAR16不定长税务登记号VARCHAR32不定长抄表员VARCHAR40不定长明细记录数VARCHAR4不定长日期VARCHAR8格式为 YYYYMMDD结算表示数VARCHAR126不定长电量VARCHAR182不定长电费VARCHAR182不定长优惠电费VARCHAR182不定长摘要VARCHAR6见摘要定义明细信息说明：上次缴费到现在这段时间内电力扣收明细组成。返回信息例子：加密前：00120000|吴志新|亚麻街7#111|0.51|99473951|201.3|301.3|6091|0.0|0.0|龙沙供电局|2340203|230102127048941|吴道华|0|加密后：00138MDAwfMDu1th8y67E4DEjwqUxLTEtMjAxfDAuNTF8MTEwMDg4MTF8MTA1LjczfDg5LjQ0fDAuMHwwLjAzfDF8MjAwOTA2MDV8Njg5NXwxNnw4LjE2fDB8MDZ89N純?誵櫸療?4.2.3 冲正报文某一柜员发现缴费错误后向电力前置机发送冲正请求包，请求电力方撤消该笔缴费交易；电力前置机接到请求后，撤消该笔缴费交易。交易码：800 冲正请求包字段说明数据类型数据最大长度小数位数备注报文长度VARCHAR5不包括长度自己银行编号VARCHAR2英文字母大写，不足2位左补空格交易码VARCHAR5定长要冲正的那笔机构号VARCHAR8定长要冲正的那笔柜员号VARCHAR5定长银行流水号VARCHAR8定长地市编码VARCHAR5省集中的银行用空格补齐，非省集中的银行补齐5位地市码用户号VARCHAR1616位户号中不足时在前面填充空格“ ”补齐。电力应答包不变，竖线中为不定长的字符。缴费金额VARCHAR152两位小数，含小数点要冲正的那笔业务的银行流水号VARCHAR8定长冲正报文例子：加密前：00072 G80021444444445555518888818 020204471923000000000100.0088888888加密后：00165TF8MTEwMDg4MTF8MTA1LjczfDg5LjQ0fDAuMHwwLjAzfDF8MjAwOTA2MDV8Njg5NXwxNnw4LjE2fDB8MDPyV觽%dx 响应包信息：字段说明数据类型数据最大长度小数位数备注报文长度VARCHAR5不包括长度自己响应码VARCHAR3见响应码定义电力响应包例子：加密前：00004000|加密后：00024MDAxfA=b蛤馇?輻扈檗4.2.4 对账报文银行在日终结账后将当天的电力收费明细按要求生成对账文件通过FTP送到电力前置机上，并发送对账请求进行对账。 对账请求包：字段说明数据类型数据最大长度小数位数备注报文长度VARCHAR5银行编号VARCHAR2英文字母大写，不足2位左补空格交易码VARCHAR580099银行编号VARCHAR2英文字母大写对帐日期VARCHAR8YYYYMMDD地市编码标识VARCHAR5省集中的添加5个Y，非省集中的添加5位地市编码报文例子：加密前：00022G80099G20090707YYYYY加密后：00024MDAxfA=b蛤馇?輻扈檗 响应包信息：字段说明数据类型数据最大长度小数位数备注报文长度VARCHAR5不包括长度自己响应码VARCHAR3见响应码定义电力响应包例子：加密前：00004000|加密后：00024MDAxfA=b蛤馇?輻扈檗对账文件格式和内容如下：第一行：对帐文件名 （银行编号(省集中银行1位，非省集中2位)+日期(8位) + 地市编码(非省集中的银行5位)或者+YYYYY（省集中的银行5位）,没有扩展名, 文件为文本格式。）第二行：交易总笔数（10位）第三行：有效笔数(10位)第四行：交易总金额（15位, 包含小数点和两位小数),只含有效的后续各行为明细信息：机构号(8位)|柜员号（5位）|银行流水号（8位）|交易码（5位）|供电局编码（7位）|户号（在全省银行位全省集中前此处是12位老户号，若全省省集中后此处是10位新户号）|缴费金额（含2位小数）|银行帐号（30位，若没有银行帐号用1个0占位）|发票号码（如果是交费失败的用户发票号部分记录空格、没有打印发票的用户记录空格）不定长|有效位（1位(有效位定义为：0 成功；1 失败；2为发票补打，发票补打用户的信息不算在有效笔数中)最后一行：以end（小写）结束。对账文件例子：N20090520YYYYY（非省集中的银行加5位地市编码例：P2009070723401）42100.0099999999|0EB01|01005800|80020|2340206|010611936327|100.00|6228482690076108113|21212121|099999999|0EB01|01005800|80020|2340207|010611936328|100.00|6228482690076108113| |099999999|0EB01|01005800|80020|2340208|010611936329|100.00|6228482690076108113| |199999999|0EB01|01005800|80020|2340208|010611936329|100.00|6228482690076108113|23232323|2end备注说明：对于那些没有省集中的银行需要在生成对账文件时加上5位的地市编码来进行区分，并且按地市生成在一个对账文件中。省集中的银行需要在文件尾部用Y（大写）补齐。4.2.5 发票对账报文 发票对账请求包字段说明数据类型数据最大长度小数位数备注报文长度INT5不包括长度自己银行编号VARCHAR2英文字母大写交易码INT5见交易码列表银行编号VARCHAR2英文字母大写对帐日期VARCHAR6地市编码标识VARCHAR5省集中的添加5个Y，非省集中的添加5位地市编码报文例子：加密前：00020 P80088 P200901YYYYY（日期为当天日期，发票对账文件内容为上个月的无效发票非省集中的银行加5位地市编码例：00020 P80088 P20090123401）加密后：00024MDAxfA=b蛤馇?輻扈檗 响应包信息：字段说明数据类型数据最大长度小数位数备注报文长度VARCHAR5不包括长度自己响应码VARCHAR3见响应码定义电力响应包例子： 加密前：00004000|加密后：00024MxfA=b蛤馇?輻扈檗发票对账文件内容详解如下格式和内容如下：第一行：对帐文件名 （年月 + 银行编号(省集中银行1位，非省集中2位) + YYYYY（非省集中的银行200905N23401）文件为文本格式且没有扩展名）第二行：发票总笔数（10位）后续各行为明细信息：供电局编码（5位）|发票号码（不定长）|说明标示符定义为：0 发票作废；1 发票丢失；|最后一行：以end（小写）结束。 发票对账文件格式例子200905N YYYY（非省集中的银行加5位地市编码例：200905N23401）323402|8269007610811|123401|2690076108115|023413|8269007610811|0end备注说明：对于那些没有省集中的银行需要在生成对账文件时须加上5位的地市编码来进行区分，并且按地市生成在一个对账文件中。5 附录5.1 银行对应表：序号编码银行序号编码银行1A网上工行11M中国银行2B网上招行12N农业3C冲值卡购电（哈局、哈二局）13P浦发4D光大14Q招商5E邮政储蓄银行15R邮政6F家家通16S商业7G工商17T交通8J建设18X信用社合作9K亚联（齐局）19L联通10V同城缴费5.2 数据字典：响应码000 成功001 无此用户002 有此用户，但不能返回信息003 有此用户，但不能缴费（缴费金额小于违约等）004 缴费日期错误（缴费日期比当前日期小等）005 数据库连接失败006 包体无效007 长度不符008 交易码错误009 数据库已经断开010 当天已经结账不能再缴纳当天的电费或进行冲正操作013 缴费不足违约金拒收899 网络通讯中断111 报文没有用MD5加密555 代收保证金不足，请缴纳保证金888 缴费超时999 未知错误(或其他)5.3 摘要：01-12 一到十二月发行信息13 撤表14 装表15换表16 验表17 追补18 串户发行19购电20结息21冲正5.4 交易码：80010 查询交易80011 网上商城查询80012 充值卡查询80020 缴费交易80021 缴费冲正交易80022 充值卡缴费交易80099 对帐文件生成完毕80088 发票明细对账5.5 地市供电局编码表：地市编