山东电力公司营销系统抄表机接口v1

1、更改履历更改的 图表和章节版本号修改更改时间更改简要描述更改人批准人0.7000012008-4-29编写初稿0.7100022008-5-32.2.4增加抄表状态：翻转、倒转、倒转且翻转0.8000032008-5-152.1.2MRDATA.DBF 修改字段名，使长度小于 10 位。2.2.2MRDATA.DBF、MRCODE.DBF 修改数据类型，使数字类型长度不超过15 位，字符型长度不超过 250 位。2.2.32.2.4MRDATA.DBF 增加电价码、抄表间隔月份数字段，用于阶梯电价用户电费计算。2.33.2.3MRCODE.DBF 增加 PRC_TI（电价时段）标准数据，EXC

2、P_TYPE 增加换表。增加 PRICE.DBF，提供阶梯电价对照表。um ，增加入参修改HCNUM（抄表机序列号），并修改返回参数类型，获取抄表机序列号通过入参获取，原有的方式不稳定。0.8100042008-6-42.1.21. MRDATA.DBF 增加 5 个字段：3.1.1抄表员代码（河北提出，打印通知单用）实际抄表方式（是否自动抄表）提出，区分实际上次抄表状态（ 计算和抄表考核）提出，用于倒转自动抄见示数（ 数不一致时填写）提出，内外存读新表时填写）。号（提出，表号不符2. MRDATA.DBF 字段含义中补充：下装时填写还是抄表时填写。3.厂家缩写代码补充：博高抄表机、华南抄表机

3、、华蓝抄表机、抄表机、抄表机0.8200052008-6-42.2.4修改 MRCODE.DBF 中的示数类型代码数据，按照更新标准代码 V1.00.8300062008-6-162.1.21考虑抄表机内存容量，满足系统功能需要的情况下，调整字段长度，去掉部分字段。0.82 总字节数为： 860，调整后为 557。2.2去掉字段：计量点标识、电能表标识、上次抄表状态压缩字段长度：用户名称、用电地址、联系人、号、抄见位数、示数类型、抄表状态、抄表异常类别、计量箱号、资产、用电分类、抄表间隔月份数、实际抄表方式、新表号2.增加字段：连续两个月未见表、通讯规约3增加标准代码：抄表方式、通讯规约4按照

4、标准，抄表状态中没有翻转、倒转、倒转且翻转，已去掉5按照标准，将抄表异常类别中的 06 换表改为 06 现场无表6厂家缩写代码补充：抄表机0.8400072008-6-202.2.4示数类型增加：需量（尖峰）、需量（峰）、需量（谷）、需量（平）0.8500082008-7-22.2.4抄表异常增加：翻转、倒转、倒转且翻转、表烧、表停、内外存不符、表号不符、通讯故障、时钟异常、自报0.8600092008-7-83.2.1修改 3.2.1 数据下装示例的传入参数 APPFILE，增加文件路径 C:，并增加 3.2.1 参数 3 和参数 4 说明，增加3.2.23.2.2 参数 3 说明。0.87

5、00102008-08-254.1增加字段类型对应于 DBF 中的定义格式。0.8800112008-09-022.2.4增加抄表异常类别：20 换表。0.8900122009-03-042.1.2增加说明。明确抄见电量为整数。取整方式为四舍五入。0.9000132009-04-172.2.4增加抄表异常类别：31 卡表用大于购。0.9100142009-05-262.2.4根据的标准代码规范抄表异常代码。增加了几种异常，并修改异常为二级代码。0.9200152009-05-282.1.2第 25 点，增加了 2、3、4 点。增加对上次抄表示数字段含义的说明。注：更改人除形成初稿，以后每次修改

6、在未批准确认前均需采用修订的方式进行修改。目录1概述12抄表机接口数据文件定义规范12.12.1.12.1.22.22.2.12.2.22.2.32.2.42.32.3.12.3.22.3.3抄表机接口数据文件1文件名命名1数据格式说明1标准代码对照文件6文件名命名6数据格式说明6代码类型说明6代码数据8阶梯电价标准对照文件11文件名命名11数据格式说明11代码数据113抄表机通讯接口函数定义规范123.13.1.13.1.23.23.2.13.2.23.2.33.2.4DLL 文件命名规范12DLL 文件名命名12示例12通讯接口函数定义规范13数据下装13数据上装14获取抄表机序列号15设

7、置抄表机系统时间151概述本文档为抄表机接口规范说明，用来指导电力技术支持系统与抄表机之间接口程序的开发，实现抄表机接口功能的。文档共分为概述、抄表机接口数据文件定义规范、抄表机通讯接口函数定义规范三个章节。第 1 章为文档的概述，主要描述了文档的编写目的、内容概述和预期读者。第 2 章抄表机接口数据文件定义规范，主要描述了电力技术支持系统与抄表机交互的抄表机接口数据文件、标准代码数据文件命名方法，以及数据文件的结构定义、标准代码数据的内容。本数据接口满足抄表数据录入、抄见电量计算、居民用户电费通知单打印、抄见电量异常提示、电量异常情况录入、抄表顺序调整、催费、自动抄表等功能的数据要求。第 3

8、 章抄表机通讯接口函数定义规范，主要描述了各型号抄表机与 PC 之间统一的通讯接口函数定义规范，通讯接口函数包括：数据下装、数据上装、获取抄表机序列号、设置抄表机系统时间。各抄表机厂商应按照本文档的定义要求提供动态库（DLL）文件，文件中包含了抄表机通讯所需的通讯接口函数。本文档的预期读者，为电力技术支持系统设计、开发、抄表机厂商。2抄表机接口数据文件定义规范2.1 抄表机接口数据文件2.1.1文件名命名文件名：MRDATA.DBF，全部为英文字母大写。2.1.2数据格式说明序号字段中文名字段英文名字段类型字段含义1抄表接口数据标识DATA_IDNUMBER(15)本实体的唯一标识，产生规则为

9、流水号。下装时填写2申请APP_NOVARCHAR2(16)流程实例的唯一标识，可自行编码。下装时填写3抄表段SECT_NOVARCHAR2(16)抄表段，国家电网公司管理代序号字段中文名字段英文名字段类型字段含义码类集:5110.7 抄表段规则。下装时填写4抄表顺序号MR_SNNUMBER(5)抄表顺序号，用于方便抄表给计量点的排序号。下装时填写5电费年月AMT_YMVARCHAR2(6)电费年月 下装时填写6用户CONS_NOVARCHAR2(16)用户的外部标识国家电网公司管理代码类集:5110.1用电客户规则。下装时填写7用户名称CONS_NAMEVARCHAR2(50)用户的名称，一

10、般等于客户实体中的客户名称，但也允许附加上一些非自然的信息。如（东城），便于通过用户名称直接识别。下装时填写8用电地址ELEC_ADDRVARCHAR2(50)用电客户的用电地址下装时填写9联系人CONTACTVARCHAR2(16)联系人下装时填写10VARCHAR2(16)下装时填写11MOBILEVARCHAR2(16)用户机号码下装时填写12号MADE_NOVARCHAR2(16)电能表号，截取后 16 位。下装时填写13抄见位数MR_DIGITNUMBER(2,1)电能表整数位数，翻转时计算电量用，由整数位和小数位的位数组成。例如：4.0、4.1、 4.2、5.0、5.1、5.2、6

11、.0、6.1、6.2 等。下装时填写14示数类型READ_TYPEVARCHAR2(4)示数类型，正、反，总。见标准代码READ_TYPE下装时填写序号字段中文名字段英文名字段类型字段含义15上次抄见示数LAST_READNUMBER(12,4)上次抄见示数：用于存放用户上次抄见示数。当算费标志为：3 定比电量计费时，本字段填的为该户定比值。当算费标志为：4 定量电量计费，本字段填的为该户定量值。下装时填写16本次抄见示数THIS_READNUMBER(12,4)本次抄见示数。抄表时填写17综合倍率T_FACTORNUMBER(10,2)综合倍率 下装时填写18本次抄见电量THIS_PQNUM

12、BER(12)本次抄见电量。有功表、无功表抄见电量计算：抄见电量 i=（本次示数 i上次示数 i） 综合倍率；需量表抄见电量计算：抄见最大需量 i= 本次示数 i 综合倍率其中 i 表示各时段。注：电量为整数，需要四舍五入。抄表时填写19上次抄见电量LAST_PQNUMBER(12)上次抄见电量：用于存放用户上次 计费抄见电量下装时填写20抄表状态MR_SUSVARCHAR2(4)抄表状态，已抄、未抄。 见标准代码 MR_SUS抄表时填写21抄表异常类别EXCP_TYPEVARCHAR2(4)异常抄表类别，计量异常、门闭、违约用电、窃电、翻转、倒转 、倒转且翻转。见标准代码 EXCP_TYPE

13、抄表时填写22本次抄表日期THIS_YMDVARCHAR2(19)本次抄表日期， 精确到秒： yyyy-mm-dd hh24:mi:ss抄表时填写23平均电量AVG_PQNUMBER(12)一般为前三个月的平均电量序号字段中文名字段英文名字段类型字段含义下装时填写24抄表波动值电量波动范围下装时填写ALARM_FUMBER(10,6)25算费标志CALC_FLAGVARCHAR2(1)是否计算电费标识：0 否，1 正常抄表计费 2 拆表电量计费，3 定比电量计费，4 定量电量计费下装时填写26旧表剩余电量REMAIN_PQNUMBER(12)旧表剩余电量(拆尾电量)下装时填写27调整电量ADJ

14、_PQNUMBER(12)退补或者调整的电量(计算电费时使用)下装时填写28结算电量SETTLE_PQNUMBER(12)合计结算电量(计算电费时使用)，：千瓦时抄表时填写29综合电价T_PRCNUMBER(10,6)综合电价(计算电费时使用)，：元/千瓦时下装时填写30本次应收电费THIS_AMTNUMBER(12,2)抄表时计算出来的应收电费，用于打印电费单，：元抄表时填写31欠费总额T_OWENUMBER(12,2)欠费总额，用于抄表员催费，：元下装时填写32卡表剩余电量CARD_PQNUMBER(12)剩余电量(卡表用途需填写)，：千瓦时抄表时填写33自动抄表标志AMR_FLAGVAR

15、CHAR2(1)是否支持自动抄表，如红外抄表：0 否，1是下装时填写34停电标志EROFFVARCHAR2(1)是否停电：0 否，1 是下装时填写35表计对时前日期METER_DATVARCHAR2(19)电能表对时前日期，精确到秒：yyyy-mm-dd hh24:mi:ss抄表时填写序号字段中文名字段英文名字段类型字段含义36计量箱号MEAS_BOXVARCHAR2(16)计量箱的资产，局，截取后 16 位。下装时填写37资产ASSET_NOVARCHAR2(16)电能表的资产，局，截取后 16 位。下装时填写38用电分类ELEC_TYPEVARCHAR2(4)国家电网公司 管理代码类集 5

16、110.4用电类别分类与代码，如：大工业用电、中小化肥、居民生活用电、农业生产用电、贫困县农业排灌用电、一般工商业下装时填写39电价码PRC_CODEVARCHAR2(8)国家电网公司 管理代码类 集:5110.23 电度电价分类与代码，例如： 10022001 大工业.10KV.电价阶梯电价用户计算电费用，具体电价见 2.3阶梯电价对照文件下装时填写40抄表间隔月份数ERVALNUMBER(1)抄表间隔月份数，一个月、两个月、三个月等，用数字表示，为月份数下装时填写41抄表员代码READER_NOVARCHAR2(16)打印在简易电费通知单上下装时填写42实际抄表方式ACT_MODEVARC

17、HAR2(4)实际使用抄表方式：国家电网公司管理代码类集: 5110.31 电能计量抄表方式/方式分抄表时填写43自动抄见示数AUTO_READNUMBER(12,4)自动抄见示数，内外存读数不一致时填写抄表时填写44新表号NEW_NOVARCHAR2(16)新表的电能表号，号不一致时填写，截取后 16 位。抄表时填写45是否连续 2 月未见表LAST_SVARCHAR2(1)连续两次未见表：0 否，1 是。如连续两次门闭、估抄，用于抄表员考核。下装时填写2.2 标准代码对照文件2.2.1文件名命名文件名：MRCODE.DBF，全部为英文字母大写。2.2.2数据格式说明注：对照 MRDATA.

18、DBF 中 READ_TYPE 、MR_SUS、EXCP_TYPE、M_PROT 字段，在抄表机上显示 MRCODE.DBF 中相应的名称，此代码表中的数据不可以随意修改，如需修改将重新修改此规约。2.2.3代码类型说明代码类型含义使用要求PORT_NO端通讯接口函数调用时传入参数使用代码，作为通讯接口约定，该数据不下装到抄表机BAUD_RATE波特率，标准代码通讯接口函数调用时传入参数使用代码，作为通讯接口约定，该数据不下装到抄表机READ_TYPE示数类型，标准代码对应 MRDATA.DBF 中 READ_TYPE 字段，在抄表机上显示名称MR_SUS抄表状态，标准代码对应 MRDATA.

19、DBF 中 MR_SUS 字段，在抄表机上显示名称EXCP_TYPE抄表异常类别，标对应 MRDATA.DBF 中 EXCP_TYPE 字字段中文名字段英文名字段类型字段含义代码类型TYPEVARCHAR2(16)代码类型代码CODEVARCHAR2(8)代码名称NAMEVARCHAR2(40)名称序号字段中文名字段英文名字段类型字段含义46通信规约COMM_PROTVARCHAR2(4)通讯规约：国家电网公司管理代码类集:2.10.34 通讯规约。下装时填写2.2.4代码数据代码类型代码名称PORT_NO0USB 或自动搜索端口PORT_NO1COM1PORT_NO2COM2PORT_NO3

20、COM3PORT_NO4COM4BAUD_RATE019600BAUD_RATE0219200BAUD_RATE0338.4kBAUD_RATE0457.6kBAUD_RATE05115.2kBAUD_RATE99无READ_TYPE11有功（总）READ_TYPE12有功（尖峰）READ_TYPE13有功（峰）READ_TYPE14有功（谷）READ_TYPE15有功（平）READ_TYPE21无功（总）READ_TYPE22无功（尖峰）READ_TYPE23无功（峰）READ_TYPE24无功（谷）READ_TYPE25无功（平）准代码段，在抄表机上显示名称ELEC_TYPE用电分类，标准

21、代码对应 MRDATA.DBF 中 ELEC_TYPE 字段，在抄表机上显示名称ACT_MODE抄表方式，标准代码对应 MRDATA.DBF 中 ACT_MODE 字段，抄表时填写代码COMM_PROT通讯规约，标准代码对应MRDATA.DBF 中COMM_PROT 字段，在抄表机上显示名称PRC_TI电价时段，标准代码对应 PRICE.DBF 中 PRC_TI 字段，计算电费时用。READ_TYPE26无功（Q1 象限）READ_TYPE27无功（Q2 象限）READ_TYPE28无功（Q3 象限）READ_TYPE29无功（Q4 象限）READ_TYPE31最大需量READ_TYPE32累

22、加需量READ_TYPE33小时需量READ_TYPE3430 分钟需量READ_TYPE35冻结量READ_TYPE36需量（尖峰）READ_TYPE37需量（峰）READ_TYPE38需量（谷）READ_TYPE39需量（平）MR_SUS01未抄MR_SUS02已抄MR_SUS03估抄EXCP_TYPE01无异常EXCP_TYPE02计量异常EXCP_TYPE03门闭EXCP_TYPE04违约用电EXCP_TYPE05窃电EXCP_TYPE06现场无表EXCP_TYPE0201换表EXCP_TYPE0202翻转EXCP_TYPE0203倒转EXCP_TYPE0204倒转且翻转EXCP_TY

23、PE0205表烧EXCP_TYPE0206表停EXCP_TYPE0207内外存不符EXCP_TYPE0208表号不符EXCP_TYPE0209通讯故障EXCP_TYPE0210时钟异常EXCP_TYPE0211自报EXCP_TYPE0212卡表用大于购EXCP_TYPE0213失窃EXCP_TYPE0214估抄EXCP_TYPE0215表室号错EXCP_TYPE0216缺相EXCP_TYPE0217失电EXCP_TYPE0218门闭估EXCP_TYPE0219门闭停EXCP_TYPE99其它ELEC_TYPE000考核ELEC_TYPE100大工业用电ELEC_TYPE101中小化肥ELEC_

24、TYPE200居民生活用电ELEC_TYPE300农业生成用电ELEC_TYPE400贫困县农业排灌用电ELEC_TYPE500一般工商业ELEC_TYPE501非居民照明ELEC_TYPE502非工业ELEC_TYPE503普通工业ELEC_TYPE504商业用电ELEC_TYPE600趸售ELEC_TYPE900其它用电PRC_TI01尖峰PRC_TI02峰PRC_TI03平PRC_TI04谷PRC_TI05脊谷ACT_MODE101手工（抄表卡）ACT_MODE102普通抄表器ACT_MODE201远红外抄表器ACT_MODE202无线（gprs）抄表器ACT_MODE301远抄ACT_

25、MODE302网络ACT_MODE303低压载波集抄ACT_MODE401负控终端ACT_MODE999其它COMM_PROT01DL/T645COMM_PROT02IEC1107COMM_PROT03GB/T19897.1-2005（IEC62056-21）COMM_PROT04DL/T6982.3 阶梯电价对照文件2.3.1文件名命名文件名：PRICE.DBF，全部为英文字母大写。2.3.2数据格式说明2.3.3代码数据注：以上数据为示例数据，仅做参考，以实际电价为准。电价码电价时段单价阶梯级数电量区间起始值电量区间结束值00000001030.500011030.600021514000

26、0000001030.7000340199999999999999900000002030.40001110000000002030.5000210120000000002030.60003201999999999999999字段英文名字段中文名字段类型字段含义TYPE电价码VARCHAR2(8)国家电网公司 管理代码类集:5110.23 电度电价分类与代码，例如：10022001 大工业.10KV.电价PRC_TI电价时段VARCHAR2(8)电价时段：如尖峰、峰、平、谷、脊谷。见标准代码。PRICE单价NUMBER(10,6)综合电价，含目录电度电价和代征电价PRC_CLASS阶梯级数NU

27、MBER(5)阶梯级数：第几级阶梯，1 代表第 1 级阶梯，2 代表第 2 级阶梯BGN_VALUE电量区间起始值NUMBER(15)阶梯电价电量区间的起始值END_VALUE电量区间结束值NUMBER(15)阶梯电价电量区间的结束值3抄表机通讯接口函数定义规范3.1 DLL 文件命名规范3.1.1DLL 文件名命名文件名：小写厂家缩写代码+com+抄表机型号.dll注：抄表机型号可选，一个 DLL 兼容多种型号抄表机时，文件名中的抄表机型号可以不加。3.1.2示例.dll.dll.dll.dll.dll.dll.dll.dll.dll抄表机：振中抄表机：抄表机：捷宝抄表机：博高抄表机：华南抄

28、表机：华蓝抄表机：抄表机：抄表机：厂家缩写代码厂家名称xn抄表机tp振中抄表机ht抄表机jb捷宝抄表机bg博高抄表机hn华南抄表机hl华蓝抄表机hh抄表机zm抄表机3.2 通讯接口函数定义规范3.2.1数据下装函数名称：SendFileToHc传入参数返回参数返回参数数据类型为，各返回值代码的意义如下：示例SendFileToHc(charPROMPT);PORT,char BAUDRATE,char DATAFILE,char APPFILE, charSendFileToHc(1, 05,C:F1.DBF; F2.DBF, C:F3.dwn; F4.mid,1);注：参数 1：1表述端为

29、COM1，见标准代码 PORT_NO参数 2：05表示波特率为 115.2k，见标准代码 BAUD_RATE参数 3：F2.DBF 的路径同 F1.DBF 的路径。参数 4：F4.mid 的路径同 F3.dwn 的路径。代码说明0成功。1搜寻端口出错。2指定的端口不能打开。3超时4文件传输出现错误999其他顺序代码类型说明1PORTchar通讯端，参见标准代码 PORT_NO2BAUDRATEchar通讯波特率，参见标准代码 BAUD_RATE3DATAFILEchar需要下装到抄表机中的文件名称(带路径)。如果存在多个需要下装的文件，则用“;”进行分隔。4APPFILEchar需要下装到抄表

30、机的机内程序文件名称(带路径)。如果存在多个需要下装的文件，则用“;”进行分隔。5PROMPTchar是否覆盖标识(0：表示不覆盖；1：表示不提示直接覆；2：表示提示并由用户进行选择)3.2.2数据上装函数名称：SendFileToPc传入参数返回参数返回参数数据类型为，各返回参数代码的意义如下：示例SendFileToPc(char PORT,char BAUDRATE,char DATAFILE, char FILESAVEAS, charPROMPT);SendFileToPc(1, 05, F1.DBF;F2.DBF, C:F1.DBF; F2.DBF, 1);注：参数 1：1表述端为 COM1，见标准代码 PORT_NO参数 2：05表示波特率为 115.2k，见标准代码 BAUD_RATE参数 3：F2.DBF 的路径同 F1.DBF