1、集团公司接口规范

中国石油天然气集团公司矿区水电气远程集抄系统数据交换接口规范

（1.0版）

集团公司矿区服务工作部

矿区服务业务管理信息系统项目组

2008年06月

目录

第1章总则 (2)

1.1 远程集抄数据交换接口 (2)

1.2 版本号 (2)

第2章接口技术方案 (3)

2.1 WEB SERVICE接口说明 (4)

2.2 请求消息 (4)

2.3 响应消息 (5)

2.4 数据架构 (6)

第3章接口内容和协议（格式） (6)

3.1 报送登录 (6)

3.1.1. 请求消息体 (6)

3.1.2. 响应消息体 (6)

3.2 注册计量表类型 (7)

3.2.1. 请求消息体字段说明 (7)

3.2.2. 响应消息体字段说明 (7)

3.3 注册和变更计量表用户信息 (8)

3.3.1. 请求消息体字段说明 (8)

3.3.2. 响应消息体字段说明 (8)

3.4 获取注册反馈 (9)

3.4.1. 请求消息体 (9)

3.4.2. 响应消息体 (9)

3.5 报送计量信息 (10)

3.5.1. 请求消息体字段说明 (10)

3.5.2. 响应消息体字段说明 (10)

第4章附件 (11)

1 总则

1.1 远程集抄数据交换接口

本规范是中国石油天然气集团公司矿区服务业务管理信息系统各类数据交换

接口规范的一部分，它规定了在各单位矿区水电气远程抄表集中监控系统向矿区服务业务管理信息系统报送管理数据的数据交换，具体内容包括：

网络拓扑

接口技术方案

接口内容和协议（格式）

本规范适用于中国石油天然气集团公司各单位矿区服务事业部各类远程集抄

系统的供应商和开发单位。

1.2 版本号

集团公司矿区服务业务管理信息系统各类数据交换接口规范版本号由主版本

号和小版本号两部分构成，均为两位数字。

版本号内部表示为4位数字，主版本号和子版本号串接而成，首位0不可省略。

在书写表示时主版本号和小版本号中间用英文点号分隔，即形如00.00的格式，两部分的首位0均可省略。

当前版本是本规范的初始版本，版本号为01.00，可书写为1.0版(Ver1.0)。网络拓扑

集团总部、各矿区及其下属单位的远程集抄系统根据管理需要就近部署，用于数据交换的数据收集服务器部署在集团公司指定机房，各远程集抄系统（数据报送操作的发起方）通过中国石油企业网连接中国石油矿区服务业务管理信息系统数据收集服务器（数据报送操作的接收方），按指定的接口技术方案及对应的协议（格式）报送数据。

因网络覆盖原因，如有部署暂时不能直接连通中国石油企业网的地区系统，可以向相关信息管理部门申请VPN方式连接中国石油企业网报送数据。

“抄表终端设备（含户表、集中器等）－远程集抄系统”间的通讯网络和“数据收集服务器－矿区管理系统”间的通讯网络不属于接口范畴，本规范不规定它们的网络拓扑。考虑到安全等方面的要求，远程集抄系统不得利用与数据收集服务器间的网络连接从事未经许可的、与数据报送无关的网络行为。

2 接口技术方案

根据接口涉及的相关技术环境和应用系统的特点，中国石油矿区服务业务管理信息系统采用基于TCP/IP网络的HTTP、SOAP、FTP、SMTP等标准协议，基于HTML、XML、Web Services或文件传输等技术路线，实现应用系统之间的数据交换。

矿区服务业务管理信息系统与远程集抄系统的数据报送接口采用Web Service 技术实现，基于SOAP over HTTP协议。

本规范未指定Web Service的服务端点。根据最终部署情况，Web Service的服务端点由矿区服务工作部在实施期间，各远程集抄系统向矿区服务工作部或指定机构申请帐号时一并指定，不得随意更改。因部署或者网络调整发生变化时，矿区服务工作部或指定机构将通知各系统及时调整。

2.1 Web Service接口说明

Web Services 使用Web Services 描述语言(WSDL) 提供服务所支持的所有消息的详细规格。

WSDL 将消息组合成操作。操作是与服务进行交互的逻辑单位，它被定义为请求消息以及与之相关的任何响应消息。本章定义了数据报送Web Service接口统一的请求消息和响应消息框架结构，在附件中提供消息内封装的相关数据架构。具体的数据报送操作和这些操作相关数据项的详细说明详见“接口内容和协议（格式）”一章。

除了指定与服务相关联的操作，WSDL服务规格还记录服务的特定于通信信道的地址。附件RemoteMeterInterface.wsdl文件中的相关通信信道的地址信息并非真正的服务端点，参见本章开头的说明。

本规范规定远程集抄数据交换Web Service接口各数据报送操作同步调用处理，数据报送的接收方在接收到请求操作后及时进行处理，并反馈规定的响应消息给调用方。

在Web Service接口中采用加密校验信息保证数据完整，登录采用预共享密码加密校验信息，成功登录后接收方生成会话共享密码，按指定的加密算法校验数据。

2.2 请求消息

远程集抄数据交换Web Service接口中，所有报送操作的发起方通过向指定服务端点发送请求消息，向数据报送接收方提交数据报送操作。请求消息包括请求消息头和请求消息体两部分，如下图所示。

请求消息：

请求消息头请求消息体

其中，请求消息头包括请求消息序号、规范版本号、连接用户名、请求时间、请求消息体包括的数据条数、用协议指定方式生成的校验码等，参见下表。