13 哈尔滨供水营业收费管理信息系统 抄表器接口规范.docx

哈尔滨供水营业收费管理信息系统 抄表器接口规范哈尔滨供水集团抄表器业务说明版本 1.0修订历史版本号作者内容提要核准人发布日期1.0厚凯，韦政抄表机业务交换规范2013-06-181.1于水Sn5变为管理员条码2013-11-281.2于水接口中增加字段：ifdzsb，倒表标志2014-1-91.3于水字段userKard(C36)变更为“表身码”，抄表器所有接口下装时，都要下载表身码；“抄表接口”上传时，不需要更新系统内的表身码；“入户挂签接口”上传时，需要更新系统内的表身码2014-7-231.4于水字段Jing (C19)变更为“表耗”，抄表器接口下装时，需要下载表耗。2014-7-25目 录1 概述11.1 名词解释11.2 目标读者22 抄表器接口22.1 数据源文件转化为文本文件22.2 文本文件转换为数据源文件33 系统功能33.1 系统配置33.2 数据交换文件33.2.1 文件转换63.2.2 下载到抄表机63.2.3 上传抄表数据7III1 概述1.1 名词解释数据交换通用格式自来水系统与抄表器之间的数据传输采用文本文件格式（tab键分割），自来水公司提供的文本文件为 read.txt抄表器数据文件目录用于存放抄表器上传的数据文件，系统默认为 d:read， 用户可以按照实际情况修改,此目录下有swap 交换种子文件（本例不用）down 下装交换文件upload 上传交换文件readlog 下装日志文件目录backlog 上装日志文件目录d:read-down10007-upload10007-readlog10007-backlog10007抄表员数据交换目录系统支持按照抄表员下装和上装，如果本目录不存在系统自动为每个抄表员建立交换目录例如 10007 抄表员下装 初始抄表信息， 系统下装时自动建立 d:readreadlog10007下装交换日志文件例如 10007 抄表员下装 初始抄表信息， 系统下装时在d:readlog10007 目录下生成 read.txt 交换文件上传交换日志文件例如 10007 抄表员下装 抄表信息， 系统上传时在 d:backlog10007 目录下生成 read.txt 交换文件1.2 目标读者l 哈尔滨供水集团信息中心l 抄表机厂家l 中水新华l 武汉易维开发人员2 抄表器接口除已有接口外，抄表器厂商还需要提供2个转换函数以实现抄表器的数据源文件与自来水公司提供的文本文件相互转化，本文档以dbf数据文件为例。2.1 数据源文件转化为文本文件int dbftotxt(filename)传入参数为dbf文件名，将dbf中的表格数据提取到txt文件中，列与列之间用tab键分隔。2.2 文本文件转换为数据源文件int txttodbf(filename)传入参数为txt文件名，首先清空抄表器dbf中的原有数据，然后将txt中的数据导入到dbf文件中。3 系统功能3.1 系统配置为实现抄表器数据的上传与下载，需要修改营业收费系统安装目录中的“system.ini”配置文件，指定抄表器数据文件目录和系统数据源目录。3.2 数据交换文件字段名是否上传中文类型注释MiidN水表号C1Varchar2(10)BarcodeN条码号C2Varchar2(20)原水账标识号AreaN区域C3Varchar2(20)recMonthN调查年月C4Number(6)yyyymmRemarkN用户性质C5Char(60)备注BookidN抄本C6Varchar2(10)BookorderN抄表次序C7NUMBER(10)OperatoridN抄表员编号C8Varchar2(10)OperatorN抄表员姓名C9Varchar2(10)mustReadDateN应抄日期C10datetimeyyyy-mm-dd mastReadDN偏移天数C11Number(2)MetertypeN表态C12Char(2)01正常02表异常03零水量meterStatusN表况C13Char(2)见表况描述VolumeN固定量C14Number(8,0)If_actN是否已入帐C15Char(1)该水量调查信息是否已经导入到系统中。1：已经完成导入；0：未导入系统。ReadokN抄见标志C16Char(1)1 抄见NameY用户名C17Varchar2(60)AddressY地址C18Varchar2(60)JingN表耗C19Varchar2(20)由“表井”变更为“表耗”connect_infoN表位C20Varchar2(30)sn1N封号1C21Varchar2(30)sn2N封号2C22Varchar2(20)sn3N封号3C23Varchar2(20)sn4N封号4C24Varchar2(20)sn5N管理员条码 C25Varchar2(20)PeopleY人口数C26Number(6,0)IstotalN总分表 合收标志C27Char(1)1 普通 2 总表 3 分表meterParentN总分表父表号C28Varchar2(10)总分表父表号MIPRIFLAGN合收表标志C29Varchar2(1)Y合收表 N 普通MIPRIIDN合收表主表号C30Varchar2(10)合收表主表号tel1Y电话C31Varchar2(19)tel2Y手机C32Varchar2(19)flag_mN水表信息是否修改上传C33Char(1)1 走抄表机信息变更流程 0 没有变更（默认）RfidY电子标签C34Varchar2(19)flag_rN电子标签是否匹配C35Char(1)1 存回电子标签，0 不传（默认）userKardY表身码C36Varchar2(19)原“用户卡”字段变更为“表身码”flag_c用户卡是否匹配C37Char(1)1 需要上传用户卡 0 不传（默认）NometerN无表标志C38Char(1)1 无表 读水量， 不读止码 0 读止码LastcodeN起码C39Number(6,0)CurrcodeY止码C40Number(6,0)WateruseY水量C41Number(6,0)PaidflagN计费标志C42Char(1)Y算费 N不算费AvgpriceN综合单价C43Number(6,2)WatertypeN水价类别C44Varchar2(8)字符+数字price_sN水价类别描述C45Varchar2(60)用水信息描述MIIFMPN混合标志C46Number(6,0)Y 混合用水 N 单一用水p1N水价C47Number(6,2)p2N污水价C48Number(6,2)p3N其他费3C49Number(6,2)p4N其他费4C50Number(6,2)p5N其他费5C51Number(6,2)ReadingdateY抄表时间C52Datetimeyyyy-mm-dd hh24:mm:ssLastdateN上次时间C53Datetimeyyyy-mm-dd hh24:mm:ssLastuseN上次水量C54Number(6,0)avg3N前三月平均量C55Number(6,0)DowndateN下载日期C56Datetimeyyyy-mm-dd hh24:mm:ssDischargeN欠费金额C57Number(12,2)余额-真实欠费DiscountN欠费笔数C58Number(6,0)DisdateN最早欠费月C59Varchar2(8)yyyymmddlast_paydateN上次缴费日期C60Datetimeyyyy-mm-dd hh24:mm:sslast_paymoneyN上次缴费金额C61Number(12,2)PaymoneyY收费金额C62Number(12,2)BillnoY票据号C63Varchar2(18)PrintnoY打印次数C64Number(6,0)flag_pN收费数据是否上传C65Char(1)echoLimitN报警限额上线C66Number(6,0)用水性质限额限制 0 不报警MridN抄表流水号C67Varchar2 (10)唯一流水ifdzsbN倒表标志C68char(1)1：倒表 0：正常表抄表表态有三种:正常、表异常、零水量：01正常02表异常03零水量每种表态下属表况描述04正常表况正常 非正常数据05零水量表况本次同上次长期无人停业闭栓不用水非正常数据06表异常表况表停无表计量倒表表锈表失灵水表自转3.2.1 文件转换调用抄表器厂商提供的接口中的txttodbf()函数，将自来水公司生成的txt文档写入抄表器数据文件目录下的dbf文件中。3.2.2 下载到抄表机调用抄表器厂商提供的接口将抄表器数据文件目录下的txt 文件转换成dbf文件下载到抄表机中。追加下载下载时提示：下载数据将清除抄表机数据， 请确认抄表机是否仍有未上传数据。是否继续下载（Y/N）API 调用规范抄表机厂家提供以下的api 供系统调用（兼容pascal 参数传递规则）dll: 函数名：int down(string filename)返回值return0 成功10 通信失败11 文件转换失败3.2.3 上传抄表数据读取upload文件到系统中，将抄表数据更新到数据表的相应字段中去，符合例外数据的则不更新。API 调用规范抄表机厂家提供以下的api 供系统调用（兼容pascal 参数传递规则）dll: 函数名：int upload