Q GDW 11318-2014 95598 互动服务网站接口规范及编制说明.pdf

《Q GDW 11318-2014 95598 互动服务网站接口规范及编制说明.pdf》由会员分享，可在线阅读，更多相关《Q GDW 11318-2014 95598 互动服务网站接口规范及编制说明.pdf（76页珍藏版）》请在麦多课文档分享上搜索。

1、ICS29.240Q /Q Q Q G DWG G G国 家 电 网 公 司 企 业 标 准Q /G DWQ GQ GQ G 1318 20149598互动服务网站接口规范Interfacespecifcationfor9598interactivesrvicewebsite2015-06-03发布 2015-06-03实 施国家电网公司 发 布Q /G DWQ GQ GQ G 11318 2014I目 次前言 1范围 12术语 和定 义 13缩略 语 24服务 接口 框架 25WebService服务 接口 基本 规约 36营销 业务 应用 系统 服务 8795598互动 服务 网站 服务

2、98短信 平台 服务 9附录 A（规 范性 附录 ） 编码 列表 10附录 B（规 范性 附录 ） 技术 规范 12附录 C（规 范性 附录 ） 营销 业务 应用 系统 接口 服务 13附录 D（规 范性 附录 ） 95598互动 服务 网站 接口 服务 59附录 E（规 范性 附录 ） 短信 平台 接口 服务 67编制 说明 69Q /G DWQ GQ GQ G 11318 2014I前 言为了 配合 95598互动 服务 网站 典型 设计 的需 要， 在延 续现 有 “ SG186” 工程 相关 应用 业务 功能 、具体实 现适 当优 化、 业务 系统 交互 安全 、业 务数 据一 致的

3、原则 下， 需要 对 “ SG186” 工程 相关 应用 部分 功能和接口进行拓展，本标准描述 95598互动服务网站与 “ SG186” 工程相关应用信息交互的实现方案。为实现 95598互动 服务 网站 与营 销业 务应 用系 统 集成 ， 制 定 接口 规范 以指 导系 统接 口的 设计 、 开 发 、 测试等 工作 。 本标 准由 国家 电网 公司 营销 部提 出并 解释 。 本标 准由 国家 电网 公司 科技 部归 口。 本标 准起 草单 位： 北京 中电 普华 信息 技术 有限 公司 。 本标 准主 要起 草人 ：欧 阳红 、方 红旺 、吴 佐平 、赵 加奎 、袁 葆、 董丽 娟。

4、本 标准 首次 发布 。本 标准 在 执行 过程 中 的 意见 或 建议 反馈 至 国家 电网 公司 科技 部。Q /G DWQ GQ GQ G 11318 201419598互动服务网站接口规范1范围 本标 准规 范了 95598互动 服务 网站 接口 的服 务接 口框 架、 WebService服务 接口 基本 规约及 95598互动服 务网 站与 营销 业务 应用 系统 、短 信平 台之 间的 接口 服务 规约 。本标 准适 用于 95598互动 服务 网站 系统 的建 设、 应用 和验 收。2术语 和定 义 下 列 术语 和 定义 适用 于 本 文件 ：2.1企业 服务 总线 ente

5、rpiservices bus是指 基于 Web服务 标准 ， 通 过 事件 驱动 和基于 XML消息 引擎 ， 为 复 杂的 面向 服务 的架 构提 供服 务的中 间件 基础 设施 产品 。 企 业 服务 总线 提供 可靠 消息 传输 、 服 务 接入 、 协 议 转换 、 数 据 格式 转换 、 基 于内容 的路 由等 功能 ，屏 蔽了 服务 的物 理位 置、 协议 和数 据格 式。 2.超文 本传 输协 议 hypertxtetransferprotocol是一 个客 户端 和服 务器 端请 求和 应答 的标 准， 是互 联网 上应 用最 为广 泛的 一种 网络 协议 。2.3简单 对象

6、 访问 协议 simpleobjectaccesprotocol一种 W3C标准 ，主 要用于 Web服务 （ WebService）的 通讯 规范 。 SOAP的出 现是 为了 让不 同应 用程序 之间 透过 HTP通讯 协定 ， 以 XML格式 互相 交换 彼此 的数 据， 使 其 与编 程语 言、 平 台和 硬件 无关 。2.4统一 描述 、发 现和 集成 协议 universaldescriptiondiscoveryandintegration是一 个基于 XML的跨 平台 的描 述规 范，为 企 业在 互联 网上 发布 自己 所提 供的 服务 提供 统一 的描 述 、发现 和集 成

7、规 范。 2.5Web服务 webservice是基 于网 络的 、分 布 式的 模块 化组 件，它 执 行特 定的 任务 ，遵 守 具体 的技 术规 范，这 些 规范 使得 Web服务 能与 其他 兼容 的组 件进 行互 操作 。 是 支 持通 过网 络进 行的 计算 机到 计算 机交 互的 软件 技术 ， 它 包 含了一 套标 准体 系， 定义 了应 用程 序如 何在 Web上实 现互 操作 。2.6服务 描述 语言 webservicesdescriptionlanguage一种 w3c标准 ， 是 Web服务 接口 的描 述语 言， 描 述与 web服务 进行 交互 时需 要绑 定的

8、协议 和信 息格式 。2.7服务 serviceWSDL中定 义的 服务 它包 含一 系列 操作 ，并 通 过绑 定、端 口 等定 义操 作的 物理 地址 和消 息传 输方 式 。2.8操作 operationWSDL中定 义的 操作 ，可 理解 为函 数、 方法 ， WSDL定义 了操 作的 输入 参数 和返 回参 数。Q /G DWQ GQ GQ G 11318 201422.9新 一代 JavaWeb服务 引擎 xfile它构 建了 POJ和 SOA之间 的桥 梁， 主 要 特性 就是 支持将 POJ通过 非常 简单 的方 式发 布成 Web服务 ， 这 种 处 理 方 式 不 仅 充

9、分 发 挥 了 POJ的作 用 ， 简 化 了 Jav应用 转 化 为 Web服务 的 步 骤 和 过 程，也直 接降 低 了 SOA的实 现难 度， 为企 业转向 SOA架构 提供 了一 种简 单可 行的 方式 。3缩略 语 下列 缩略 语适 用于 本文 件： ESB：企 业服 务总 线（ EnterpriseSrviceBus）POJ： 简单的 Jav对象 （ PlainOrdinaryJavObject）SA：面 向服 务的 体系 结构 （ Service-OrientdArchitecture）SOP：简 单对 象访 问协 议（ Sim plebjectcesProtocol）UDI：

10、统 一描 述、 发现 和集 成协 议（ UniversalDescriptionDiscoveryandIntegration）RL： 统一 资源 定位 器（ Uniform ResoureLocator）WSD：服 务描 述语 言（ WebServicesDescriptionLanguage）XML：可 扩展 标记 语言 （ eXtensibleMarkupLanguage）4服务 接口 框架 WebServices是基 于网 络的 、分 布式 的模 块化 组件 ，它 执行 特定 的任 务， 遵守 具体 的技 术规 范， 这些规范使得 WebSevice能与其他系统进行交互操作。 9559

11、8互动服务网站本身应当提供 WebService供其他 系统 调用 ，其 他系 统也 应当 提供 WebService，供 95598互动 服务 网站 调用 。具 体架 构见 图 1。9598互 动 服 务 网 站业 务 办 理 电 量 电 费 查 询 网 上 缴 费 模 拟 电 费 计 算 投 诉 举 报 逻 辑 强 隔 离 装 置 互 联 网企 业 服 务 总 结 （ ESB） 信 息 内 网XML XML XML XML XML 服 务目 录实 时数 据 库共 享数 据 库“ SG1 8 61 8 61 8 61 8 6 ” 工 程 相 关 应 用营 销 业 务 应 用 系统智 能 测

12、量 管 理 系统分 布 式 电 源 管 理系 统充 放 电 与 储 能 管理 系 统 用 电 信 息 采 集 系 统 客 户 用 能 服 务 系 统 刷 新获 取 相 关 数 据同 步 变 化 数 据 图 195598互动 服务 网站 接口 框架接口 服务 调用 过程 的 WEB服务 结构 见 图 2。Q /G DWQ GQ GQ G 11318 20143UDI注 册 表 WSDL（ 服 务 描 述 语 言 ）Web Service客 户 端（ Jav、 .NET等 ） SOAP消 息 （ 通 过 HTP交 换 XML） Web Service服 务 端（ Jav、 .NET等 ）指 向 描

13、 述 信 息指 向 服 务 描 述 服 务查 找 服 务调 用 服 务图 2WEB服务 结构 图5WebService服务 接口 基本 规约5.1技术 标准 简述5.1简述营销 业务 应用 WebService接口 采用 XFire（ version1.2.6） 技 术实 现。 客 户 端和 服务 器用 SOAP协 议通过 HTP来交互，客户端根据 WSDL描述文档生成 SOAP请求消息发送到服务端，服务端解析收到的 SOA请求 ，调用 Webservice，然 后再 生成 相应的 应答 送回 到客 户端 。5.12服务 设计 原则95598互动 服务 网站 与其 它系 统集 成应 用服 务设

14、 计主 要遵 循以 下原 则：a） 服务 设计 应遵 循 “ 可重 用、 松耦 合、 互操 作 ” 的原 则， 以便 于实 现系 统间 的集 成应 用；b） 使用 成熟 标准 实现 产品 简化 开发 ；c） 服务 接口 无二 义性 ；d） 服务 尽量 考虑 多个 应用 或者 接口 需求 ，增 加可 重用 性；e） 命名 服务 时应 尽量 使用 通用 术语 ，便 于开 发人 员理 解；f） 服务 应对 实现 细节 进行 封装 且粒 度适 中。5.13服务 调用 原则本部 分中 所涉 及业 务系 统提 供的 WebService服务 接收 到请 求后 解析 操作 编码 后再 调用 具体 操作 。5

15、.2命名 规范5.21服务 命名 规范本部 分中 涉及 所有 WebService服务 接口 包括 营销 业务 应用 、 95598互动 服务 网站 及 短信 平 台提 供 的接口 服务 。各 系统 服务 接口 命名 规范 见 表 1。表 1服 务 接 口 命 名 规 范5.2操作 编码 命名 规范本 部 分 中 所 涉 及 的 操 作 编 码 命 名 采 用 “ 2位 集 成 类 别 码 +2位 服 务 端 系 统 编 码 +3位 流 水 号 ” ， 如服务提供系统 服务名 操作名9598互动 服务 网站 cswebService cswebGetDat营销业务应用 sgpm sServic

16、e sgpm sGetDat短信平台 sm Service sm GetDatQ /G DWQ GQ GQ G 11318 201440101001表示 95598业务 支持 系统 提供 的第 一个 接口 操作 ，见 图 3：01 01 01三 位 流 水 号两 位 系 统 编 码两 位 集 成 类 别 码图 3操作 编码 命名 规范“ 2位集 成类 别码 ” 的 “ 01内部 集成 ” 表示 总部 客户 服务 中心 各系 统间 的集 成关 系； “ 02外部 集成 ”表示 总部 客户 服务 中心 和省 （自 治 区、 直辖 市） 公司 业务 系统 间的 集成 关系 。“ 2位服 务端 系统

17、编码 ” 表示 提供 服务 的业 务系 统对 应的 编码 ，编 码对 应关 系参 见附录 A。5.2.3Namespace命名 规范95598互动 服务 网站 所提 供的 服务 描述 WSDL分为 以下 两个 部分 ：a） 数据 类 型 定 义 XMLSchem a文件 ， 类 型 的 命 名 空 间 为： “ http:/ip:port/cspm/service/schem a/” ，简称 “ st” ；b） 服务 定义 WSDL文件 ，其 服务 的命 名空 间为 ： “ http:/w.ip:port/cspm/service/swebservice” ，简称 “ sns” 。Web引用

18、URL:http:/IP:端口 /cspm/webservice/pmsWS?WSDL。5.3报文 规范5.31接口 描述 文件WSDL文件 内容 示例 如下 ：wsdl:definitionsnam e=“comm onDatService“targetNam espace“http:/service.is.energy/“xmlns:1=“http:/schem as.xmlsoap.org/soap/htp“xmlns:soap=“http:/schem as.xmlsoap.org/wsdl/soap/“xmlns:tns=“http:/service.is.energy/“xmlns

19、:wsdl“http:/schem as.xmlsoap.org/wsdl/“xmlns:xsd=“http:/w.w3.org/2001/XMLSchem a“xs:schem aelm ntForm Default=“unqualifed“targetNam espace=“http:/service.is.energy/“version=“1.0“xmlns:tns=“http:/service.is.energy/“xmlns:xs“http:/w.w3.org/2001/XMLSchem a“xs:elm ntm inOcurs=“0“nam e=“input“type=“xs:st

20、ring“/xs:complexTypeQ /G DWQ GQ GQ G 11318 20145xs:elm ntm inOcurs=“0“nam e=“output“type=“xs:string“/xs:complexType/wsdl:typeswsdl:partelm nt“tns:getatesponse“nam e=“param etrs“/wsdl:m esagewsdl:partelm nt“tns:getat“nam e=“param etrs“/wsdl:m esagewsdl:operationnam e“getDat“/wsdl:input/wsdl:output/ws

21、dl:portTypesoap:bindingstyle“document“transport=“http:/schem as.xmlsoap.org/soap/htp“/soap:operationsoapAction=“style=“document“/soap:bodyuse“literal“/sdl:outputnam e=“getDatResponse“/wsdl:output/wsdl:bindingwsdl:portbinding=“tns:comm onDatServiceSoapBinding“nam e=“DatServicePort“5.32接口 说明接口 调用 方式 参

22、见 附录 B，请 求报 文输 入描 述及 示例 见表 2。Q /G DWQ GQ GQ G 11318 20146表 2请 求 报 文 说 明参数 说明 见表 3。 表 3参 数 详 细 说 明响应 报文 说明 ：响 应报 文采用 XML格式 的字 符串 ，成 功则 返回 查询 结果 ，失 败则 返回 错误 编码 和错误 描述 。 服务 成功 响应 示例 如下 ： quantiyFeList应收 年月 totalPq总电 量 /totalPq应收 金额 rcvedAm t实收 金额 /rcvedAm t应收 违约 金 rcvdPenalTy实收 违约 金 /rcvdPenalTy费用 状态 s

23、etleMode结算 方式 /setleMode结清 标志 /quantiyeist服务 失败 响应 示例 如下 ： 1名称 类型 描 述Input XML格式字符串 入口参数，采用 XML格式的字符串， XML编码格式为 “ UTF-8” 。示例： serviceode操作编码 调用者标识 省（市）标识 datInput XML格式字符串 用户编号 /dat参数标识 参数名称 数据类型 非空 备 注source 调用者标识 字符串 Y对应设计表卡中的 “ 调用端 ” 系统， 详 见附录 A.。target 省（市）标识 字符串 Y服务提供端系统所属公司编码，详见附录 A。serviceode

24、 操作编码 字符串 Y见 “ 5.2操作编码命名规范 ” ，服 务编码见附录 A。dat 输入参数 字符串 Y包含操作调用的具体入参参数。Q /G DWQ GQ GQ G 11318 20147serviceode:1005doesnotexist服务 失败 时， 响应 报 文 包 含 错 误 编 码 （ erorCode）和 错 误 描 述 （ erorMesage）。 服 务 错 误 编 码 见表 4。 表 4服务 错误 编码 及错 误说 明5.4数据 规约5.41数据 协议采用 WebServiceSoap协议 。客 户 端和 服务 端采用 XML格式 的字 符串 来交 互业 务数 据，

25、客 户 端将 业务数据组织成 XML格式的字符串作为入参调用服务端接口，服务端解析 XML格式的字符串得到业务数据 处理 业务 并把 结果 组织成 XML格式 的字 符串 返回 给客 户端 。5.42格式 约定业务 数据 组织成 XML格式 的字 符串 来交 互，该 XML格式 的字 符串 应遵 循以 下规 则：a） XML编码 格式 为 “ UTF-8” ；b） 以 来标 记数 据串 的开 始和 结束 ；c） 以 serviceode/serviceode来标 服务 编码 的开 始和 结束 ；d） 以 来标 记输 入输 出数 据串 参数 的开 始和 结束 ；e） 以 S/S来标 记输 入输

26、出数 据集 串的 开始 和结 束。字段 为日 期的 应 遵循 以下 约定 ：a） 年月 日格 式统 一为 “ YY-M-D” ，如 “ 2006-06-22” ；b） 时间 格式 统一 为 “ -H24:MI:S” ，如 “ 2006-06-2210:09:01” ；c） 年月 格式 为 “ YYM” ，如 “ 200606” 。5.43接口 约定 说明接口 约定 说明 应遵 循以 下规 则：a） 接 口 服 务 名 严 格 按 照 本 部 分 ， 所 有 服 务 名 均 为 大 写 ， 并 以 GET或 SET开 头 。 如 ： StringgetSyncDat（ StringxmlPar）

27、 ；b） XML格式说明： XML节点名称由大小写字母混合组成。 XML节点名称的第一个英文单词的首字 母小 写， 后续 每个 英文 单词 的首 字母 大写 ；c） 入 参 格 式 的 最 外 层 节 点 采 用 全 大 写 形 式 ， 操 作 编 码 节 点 采 用 全 小 写形式 ，数据 项 节 点 也采 用 全 小 写 形 式 ，最后 数 据 项 中 所 传 递 的 各 节 点 均 遵 守 各 个 接 口的定 义 ；d） 出参 格式 的最 外层 节点 采用 全小 写形 式， 其数 据项 中所 传递 的各 节点 均遵 守各 个接 口的定义 。错误编码 错误说明0 内部错误1 报文解析错误2

28、 SQL执行错误3 SQL执行超时4 查询结果数据为空5 传入参数数据为空6 用户名和密码不匹配Q /G DWQ GQ GQ G 11318 201486营销 业务 应用 系统 服务 服务 名称 ： sgpmsService服务功能：由省（自 治区、直辖 市）公司营销业务应用向其他业务系统提供的用户电量电费查询、业务 办理 、充 值缴 费等 外部 集成 功能 。 其中，电量电费查询服务接口包括：用户账户余额查询、电费清单查询、缴费购电明细记录查询、智能 表余 额查 询、 智 能 表用 户费 控信 息查 询、 用 户 阶梯 用电 信息 查询 等日 常用 电查 询功 能； 业 务 办理 服务接 口

29、主 要包 括： 用 户 订阅 及退 订服 务业 务、 用 户 身份 校验 及账 户绑 定服 务、 客 户 查询 密码 修改 、 充 值用户 验证 、 充 值卡 充值 ， 电 费缴 费流 水号 获取 及电 费销 账、 对 账 数据 传送 等服 务接 口， 各 服务 接口 规 范详见 附录 C，接 口服 务列 表见表 5。表 5营销 业务 应用 系统 接口 服务 列表序号 操作编码 接口名称1 02703 用户阶梯电价信息查询2 027018 用户阶梯明细信息查询3 027029 用户订阅服务4 027041 单个用户账户查询5 027042 多个用户账户查询6 027043 用户缴费信息查询7

30、02704 电费清单查询8 027045 明细账单查询9 027046 购电记录信息查询10 027047 业务办理进度列表查询1 02705 智能表余额查询12 027051 信息退订业务13 027052 查询订阅信息14 027056 客户身份校验和账户绑定15 027057 客户查询密码修改16 027058 电费流水号获取17 027059 电费销账18 02706 手机验证码发送19 027062 充值用户验证20 02706 充值卡充值21 027067 日冻结电量查询2 0270 对账数据传送23 027084 费控实时可用余额查询24 027085 费控测算电量电费查询25

31、027086 费控策略执行情况查询26 027087 费控用户属性查询Q /G DWQ GQ GQ G 11318 20149795598互动 服务 网站 服务服务 名称 ： cswebService服务 功能 ： 由 95598互动 服务 网站 向其 他业 务系 统提 供的 停电 信息 发布 、 公 告发 布信 息、 上 行消 息接收 、状 态报 告消 息等 内部 集成 功能 ，各 服务 接口 规范 详见 附录 D，接 口服 务列 表见表 6。表 695598互动 服务 网站 接口 服务 列表8短信 平台 服务 服务 名称 ： sm Service服务 功能 ： 由 短信 平台 服务 向其

32、他业 务系 统提 供的 下行 消息 发送 的内 部集 成功 能， 各 服 务接 口规 范详见 附录 E，接 口服 务列 表见表 7。 表 7短信 平台 接口 服务 列表27 02710 账户余额 查询28 02710 阶梯用能 情况查询序号 操作编码 接口名称1 01201 公告信息发布2 01202 网上业务请求信息查询3 01203 网站工单相关信息接收4 01201 上行短息接收5 01201 状态报告返回接口6 012012 网站注册用户验证接口7 0201 电子账单发送接口序号 操作编码 接口名称1 01901 下行消息接口Q /G DWQ GQ GQ G 11318 201410附

33、 录 A（ （ （ （ 规范 性附 录 ） ） ） ）编 码 列 表A.1省 （ （ （ （ 自治 区、 直辖 市 ） ） ） ） 公司 单位 编码 列表省（ 自治 区 、 直辖 市 ）公 司单 位编 码列 表见表 A.1。表 A.1省 （ （ （ （ 自治 区、 直辖 市 ） ） ） ） 公司 单位 编码A.2业务 系统 编码 列表业务 系统 编码 列表 见表 A.2。 表 A.2系 统 编 码 列 表代码 名 称 代码 名 称102 国 网 北京电力 3610 国 网江西电力1201 国网 天津电力 3710 国 网山东电力1302 国网 河北电力 4101 国 网 河南电力6103 国

34、网冀北电力 42102 国 网湖北电力1401 国 网山西电力 4310 国 网 湖南电力1501 国 网内蒙古电力 501 国 网重庆电力2102 国 网辽宁电力 5101 国 网四川 电 力210 国 网吉林电力 5410 国 网西藏电力2310 国 网黑龙江电力 6102 国 网陕西电力3102 国 网上海市电力 6210 国 网甘肃电力3210 国 网江苏电力 6310 国 网青海电力310 国 网浙江电力 6410 国 网宁夏电力3410 国 网安徽电力 6510 国 网新疆电力3510 国 网福建电力 系统名称 系统编码9598业务支持系统 019598互动服务网站 029598呼

35、叫平台 03基础支撑平台统一数据服务 04基础支撑平台公共代码服务 05现场定位服务 06营销业务应用 07Q /G DWQ GQ GQ G 11318 20141表 A.2（ 续 ）系统名称 系统编码车辆系统 08短信平台 09营销 GIS应用 10公共管理平台 1移动微监控系统 12客户服务中心工单池应用服务 13省（市）工单池应用服务 14北京用电信息采集系统服务 15北京售电系统服务 16统一数据发布服务 17运营管理系统 18山西多元化缴费平台 19Q /G DWQ GQ GQ G 11318 201412附 录 B（ （ （ （ 规范 性附 录 ） ） ） ）技 术 规 范B.1调

36、用 方式营销 的所有 Webservice服务 接收 到请 求后 解析 服务 编码 后再 调用 具体 服务 。根据 客 户 端 程 序 语 言 及 调 用 方 式 不 同 ， 设 置 的 方 法 也 不 同 ， 下 面 示 例 说 明 客 户 端 程 序 语 言 为 jav调用 方式 的设 置方 法： 方式 一： 动态 模式 调用 （不 需要 服务 端的 接口 clas）/建立 WS客户 端连 接Clientclient=newClient（ newURL（ WS发布 地址 ） ;/接口 调用client.ivoke（ WS接口 名称 ， newString传递 参数 ） ;方式 二： 传统

37、POJ模式 调用 （能 得到 服务 端的 接口 Clas和 Entiy类）/根据 接口 clas创建 服务 模型ServicesrvcModel=newObjectServiceFactory（） .creat（ Helo.clas） ;XFireProxyFactoryfactory=newXFireProxyFactory（ireFactory.newInstance（） .getire（ ） ;/WS发布 地址tringheloWorldURL=“http:/localhost:8080/webservice/srvices/Helo“;Helosrvc=（ Helo） factory.

38、creat（ srvcModel， heloWorldURL） ;/接口 调用srvc.sayHelo（ “WS调用 “） ;其他 的调 用方 式及 其他 语言 调用 方式 请查阅 XFire相关 文档 。Q /G DWQ GQ GQ G 11318 201413附 录 C（ （ （ （ 规范 性附 录 ） ） ） ）营销 业务 应用 系统 接口 服务C.1用户 阶梯 电价 信息 查询 接口 规范查询 营销 业务 应用 系统 中居 民用 户阶 梯电 价信 息， 接口 规范 见表 C.1：表 C.1用户 阶梯 电价 信息 查询 接口 规范接口名称 用户阶梯电价信息查询接口描述 根据输入的用户编号

39、、阶梯年、供电单位调用营销业务应用逻辑功能获取阶梯电价信息接口方式 WebService调用端 9598互动服务网站代理端 ESB服务端 营销业务应用数据频率 实时操作编码 02703 输入输出参数数据类型定义输入参数 参数代码 参数名称 数据格式 非空 参数说明consNo 用户编号 VARHCAR2（ 16） Y用电客户编号levlYea 阶梯年 RCR2（ 6） orgNo 供电单位 VARCHAR2（ 16） Y 输出参数参数代码 参数名称 数据格式 非空 参数说明levlYear 阶梯年 VARCHAR2（ 6） N acuPq 年阶梯累计用电量 NUMBER（ 16） levlOn

40、ePq 一阶电量额度 BER（ 16） N levlnePqSum 一已用电量 NUMBER（ 16） levlOnePqRem ain 一阶剩余可用电量 BER（ 16） N levlTwoPq 二阶电量额度 NUMBER（ 16） levlToPqRem ain 二阶剩余可用电量 BER（ 16） N levlTwoPqSum 二阶已用电量 NUMBER（ 16） levlThrePqSum 三阶已用电量 BER（ 16） N contFlag 低保与五保户标识 VARCHAR2（ 6） N返回中文名称： 低保、五保户输入输出 XML参数数据串输入 XML格式参数 serviceode操作

41、编码 调用者标识 /sourcetarget省（市）标识 Q /G DWQ GQ GQ G 11318 201414表 C.1（ 续 ）C.2用户 阶梯 明细 信息 查询 接口 规范用户 阶梯 明细 信息 查询 接口 ，接 口规 范见表 C.2。表 C.2用户 阶梯 明细 信息 查询 接口 规范输入 XML格式参数 用户编号 阶梯年 供电单位 /datlevlYear阶梯年 年阶梯累计用电量 一阶电量额度 一阶已用电量 一阶剩余可用电量 二阶电量额度 二阶剩余可用电量 二阶已用电量 三阶已用电量 低保与五保户标识 /dat接口名称 用户阶梯明细信息查询接口描述 根据输入的用户编号、 开 始电费

42、年月、 结 束电费年月等调用营销业务应用逻辑功能获取阶梯明细 信息接口方式 WebService调用端 9598互动服务网站代理端 ESB服务端 营销业务应用数据频率 实时操作编码 027018输入输出参数数据类型定义输入参数 参数代码 参数名称 数据格式 非空 参数说明consNo 用户编号 VARCHAR2（ 16） Y用电客户编号am tStartYm 起始电费年月 VARCHAR2（ 6） Y am tEndYm 结束电费年月 VARCHAR2（ 6） YorgNo 供电单位 VARCHAR2（ 16） Y pageNum 请求页码 NUMBER（ 16） YrowNum 返回记录数

43、NUBER（ 16） Y Q /G DWQ GQ GQ G 11318 201415表 C.2（ 续 ）输出参数参数代码 参数名称 数据格式 非空 参数说明levlYear 阶梯年 VARCHAR2（ 6） Y按照电费年月构造阶梯 明细信息循环体levlBgnYm D 阶梯起始年月 VARCHAR2（ 8） YlevlEndYm D 阶梯结束年月 VARCHAR2（ 8） YacuPq 年阶梯累计用电量 NUMBER（ 16） YlevlOnePq 一阶电量额度 NUBER（ 16） YlevlTwoPq 二阶电量额度 NUMBER（ 6） Yam tYm 电费年月 VARCHAR2（ 6）

44、YlevlOnePqSum 一阶已用电量 NUMBER（ 6） YlevlOnePqRem ain 一阶剩余可用电量 NUBER（ 16） YlevlTwoPqRem ain 二阶剩余可用电量 NUMBER（ 16） Y 输入输出 XML参数数据串输入 XML格式参数操作编码 source调用者标识 /source用户编号 am tStartYm 起始电费年月 结束电费年月 /am tEndmorgNo供电单位 请求页码 /pageum rowNum 返回记录数 输出 XML格式参数lelricetailist阶梯年 levlBgnm D阶梯起始年月 阶梯结束年月 /levlEndmacuPq

45、年阶梯累计用电量 一阶电量额度 /levlOnePqlevlTwoq二阶电量额度 电费年月 levlOnePqSum 一阶已用电量 levlTwoPqSum 二阶已用电量 levlThrePqSum 三阶已用电量 totalCount总记录数 Q /G DWQ GQ GQ G 11318 201416C.3信息 订阅 业务 接口 规范信息 订阅 业务 接口 ，接 口规 范见表 C.3。表 C.3信息 订阅 业务 接口 规范接口名称 信息订阅业务接口描述 根据输入的用户编号、用 户名称、订 阅项目等调用相应的营销业务应用应用逻辑功能实现信息订 阅 。接口方式 WebService调用端 9598

46、互动服务网站代理端 ESB服务端 营销业务应用数据频率 实时操作编码 027029输入输出参数数据类型定义输入参数参数代码 参数名称 数据格式 非空 参数说明orgNo 供电单位 VARCHAR2（ 16） Y用电供电单位consNo 用户编号 VARCHAR2（ 16） Y用电客户编号custNo 客户编号 VARCHAR2（ 16） Y客户编号consNam e 用户名称 VARCHAR2（ 56） N用电客户名称item Code 订阅项目 VARCHAR2（ 8） Y统一标准代码rcvMode 接收方式 VARCHAR2（ 8） Y标 准 代 码 ： 01电 话（ 自 动 语 音 传

47、9）； 02电子邮件； 03短信； 4传 真 ； 05信 件 ； 06现 场 ；07网 站 消 息 ； 8电能 采集 ； 09自 动 语 音 ； 9其它rcvObj 接收目标 VARCHAR2（ 32） Y电 话 号 码 或 Em ail地址等。bgnDate 订阅开始日期 DATE N订阅有效的开始时间endDate 订阅结束日期 DATE N订阅有效的结束时间sendTS 订阅发送时间段 VARCHAR2（ 8） N统一标准代码输出参数 参数代码 参数名称 数据格式 非空 参数说明输入输出 XML参数数据串输入 XML格式参数 操作编码 Q /G DWQ GQ GQ G 11318 201417表 C.3（ 续 ）C.4单个 用户 账户 查询 接口 规范单个 用户 账户 查询 接口 ，接 口 规范 见表 C.4。表 C.4单个 用户 账户 查询 接口 规范输入 XML格式参数调用者标识 省（市）标识 供电单位 用户编号 客户编号 用户名称 订阅项目 接收方式 接收目标 订阅开始日期 订阅结束日期 订阅发送时间段 输出 X