Форматы файлов информационного обмена между
Квартплата ПРО и Автоматизированными системы контроля и учёта
энергопотребления по приборам учета и их показаниям
версия 3.0 от 27 . 04 .20 20
на 12 страницах
Казань 2019
Оглавление
1. Общая схема информационного обмена
2. Формат файла со сведениями об адресах
2. Формат файла со сведениями о приборах учёта и их показаниях
2.1. Требования к наименованию файла
2 .2 . Описание стр у ктуры файла
Приложение 1 - Пример файла «Адресное пространство»
Приложение 2 - Пример файла с информацией по ПУ и их показаниям
Общие положения
Данный документ содержит описание форматов файлов по обеспечению регламентного информационного обмена между программными продуктами Квартплата ПРО и Автоматизированными системами контроля и учёта энергопотребления (далее АСКУЭ)
1. Общая схема информационного обмена
Система АСКУЭ обеспечивает дистанционный сбор информации о потреблении коммунальных услуг. Системы учёта позволяют производить учёт потребления коммунальных услуг на объектах жилого, коммерческого и производственного назначения. Системы могут учитывать потребление коммунальных ресурсов на уровне помещения, дома, районов, города, населенного пункта с единым диспетчерским и финансовым центрами. Информация о приборах учёта и их показаниях (или расходах) передаются по установленным регламентам в систему Квартплата ПРО, для учёта потреблённых коммунальных ресурсов и расчёта их стоимости.
Общая схема взаимодействия участников информационного обмена представлена на рисунке. Информация о приборах учёта и их показаниях передаётся в виде файла установленного формата. Требования к формату файла приведены в разделе 2.
Общая схема информационного взаимодействия
Информационный обмен производиться в 2 этапа:
- Программа Квартплата ПРО выгружает в систему АСКУЭ информацию об адресах, по которым ей нужна информация по приборам учёта и их показаниям (файл « Адресное пространство. xml »)
- Система АСКУЭ выгружает в систему Квартплата ПРО информацию по приборам учёта (индивидуальным и общедомовым) и их показаниям на текущую дату (файл ПУ _ ДД_ MM _ГГГГ_ VV _ NNN . xml )
2. Формат файла со сведениями об адресах
Информация об помещениях и зданиях выгружается в файл «Адресное пространство. xml » из системы Квартплата ПРО по следующей схеме:
<?xml version='1.0' encoding='windows-1251'?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" version="1.2 от 27.02.2014">
<xsd:element name="АдресноеПространство">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="Дом" type="ТипДом" minOccurs="0" maxOccurs="unbounded"/>
</xsd:sequence>
<xsd:attribute type="xsd:short" name="ГодУчета"/>
<xsd:attribute type="xsd:byte" name="МесяцУчета"/>
</xsd:complexType>
</xsd:element>
<xsd:complexType name="ТипКвартира">
<xsd:sequence>
<xsd:element name="НомерКвартиры" type="ТипНомерКвартиры"/>
<xsd:element name="ПлощадьКвартиры" type="ТипПлощадьКвартиры"/>
<xsd:element name="СтатусЛицевогоСчетаКвартиры"/>
<xsd:sequence>
<xsd:element name=" Периоды " type="СтатусЛс"/>
</xsd:sequence>
</xsd:sequence>
<xsd:attribute name="НомерЛицевогоСчетаКвартиры" type="ТипНомерЛицевогоСчета" use="required"/>
</xsd:complexType>
<xsd:complexType name="ТипНомерКвартиры">
<xsd:sequence>
<xsd:element name="Квартира" type="ТипСтрока10"/>
<xsd:element name="Комната" type="ТипСтрока10"
minOccurs="0" maxOccurs="1"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="ТипДом">
<xsd:sequence>
<xsd:element name="АдресДома" type="ТипАдресДома"/>
</xsd:sequence>
<xsd:attribute name="НомерЛицевогоСчетаДома" type="ТипНомерЛицевогоСчета" use="required"/>
</xsd:complexType>
<xsd:complexType name="ТипАдресДома">
<xsd:sequence>
<xsd:element name="Регион" type="ТипСтрока40"/>
<xsd:element name="Район" type="ТипСтрока40" minOccurs="0" maxOccurs="1"/>
<xsd:element name="Город" type="ТипСтрока40" minOccurs="0" maxOccurs="1"/>
<xsd:element name="НаселенныйПункт" type="ТипСтрока40" minOccurs="0" maxOccurs="1"/>
<xsd:element name="Улица" type="ТипСтрока40"/>
<xsd:element name="НомерДома" type="ТипСтрока10"/>
<xsd:element name="Корпус" type="ТипСтрока10" minOccurs="0" maxOccurs="1"/>
<xsd:element name="Квартира" type="ТипКвартира" minOccurs="0" maxOccurs="unbounded"/>
</xsd:sequence>
</xsd:complexType>
<xsd:simpleType name="ТипНомерЛицевогоСчета">
<xsd:restriction base="xsd:decimal">
<xsd:fractionDigits value="0"/>
<xsd:totalDigits value="20"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:complexType name="ТипПлощадьКвартиры">
<xsd:sequence>
<xsd:element name="ОбщаяПлощадь" type="ТипСтрока10"/>
<xsd:element name="ЖилаяПлощадь" type="ТипСтрока10"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="СтатусЛс">
<xsd:sequence>
<xsd:element name="Состояние" type="ТипСтрока10"/>
<xsd:element name="ДатаНачала" type="ТипСтрока10"/>
<xsd:element name="ДатаОкончания" type="ТипСтрока10"/>
</xsd:sequence>
</xsd:complexType>
<xsd:simpleType name="ТипСтрока40">
<xsd:restriction base="xsd:string">
<xsd:maxLength value="40"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="ТипСтрока10">
<xsd:restriction base="xsd:string">
<xsd:maxLength value="10"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:schema>
2. Формат файла со сведениями о приборах учёта и их показаниях
2.1. Требования к наименованию файла
Наименование файла имеет следующую структуру:
ПУ _ ДД_ MM _ГГГГ_ VV _ NNN . xml , где:
- ПУ – идентификатор электронного документа;
- ДД_ММ_ГГ - Дата выгрузки (ДД - день, MM - месяц, ГГГГ - год),
- VV - номер версии формата
- N NN - номер файла по порядку за день.
Кодировка файла должна быть CP 1251 ( win ).
Пример наименования файла:
ПУ_22_12_2019_12_001. xml ,
где
22_12_201 9 - дата выгрузки,
20 - версия формата (версия 2.0)
001 - первая выгрузка за 22.12.201 9
2 . 2 . Описание структуры файла
Описание структуры файла представлено в виде xsd схемы, приведено ниже
В Приложение 1 и Приложении 2 приведены примеры файлов с адресным пространством и информацией по приборам учёта и их показаниям.
<?xml version='1.0' encoding='windows-1251'?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" version="1.2 от 27.02.2014">
<xsd:element name="ПоказанияСчетчиков">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="ТипРаспределения" type="ТипТипРаспределения" minOccurs="0" maxOccurs="1"/>
<xsd:element name="Дом" type="ТипДом" minOccurs="0" maxOccurs="unbounded"/>
<xsd:element name="Квартира" type="ТипКвартира" minOccurs="0" maxOccurs="unbounded"/>
</xsd:sequence>
<xsd:attribute name="МесяцУчета" use="required" type="xsd:integer"/>
<xsd:attribute name="ГодУчета" use="required" type="xsd:integer"/>
</xsd:complexType>
</xsd:element>
<xsd:complexType name="ТипТипРаспределения">
<xsd:sequence >
<xsd:element name="Услуга" minOccurs="1" maxOccurs="5">
<xsd:simpleType>
<xsd:restriction base="xsd:string">
<xsd:enumeration value="ПО ЖИЛЬЦАМ" />
<xsd:enumeration value="ПО ОБЩЕЙ ПЛОЩАДИ" />
<xsd:enumeration value="ПО ОТОПИТЕЛЬНОЙ ПЛОЩАДИ" />
<xsd:enumeration value="ПО СЧЕТАМ" />
</xsd:restriction>
</xsd:simpleType>
<xsd:attribute name="НаименованиеУслуги" use="required" type="ТипНаименованиеУслуги"/>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="ТипКвартира">
<xsd:sequence >
<xsd:element name="АдресДома" type="ТипАдресДома"/>
<xsd:element name="НомерКвартиры" type="ТипНомерКвартиры"/>
<xsd:element name="Услуга" type="ТипУслуга" minOccurs="1" maxOccurs="unbounded"/>
</xsd:sequence>
<xsd:attribute name="НомерЛицевогоСчетаКвартиры" type="ТипНомерЛицевогоСчета" use="required"/>
</xsd:complexType>
<xsd:complexType name="ТипДом">
<xsd:sequence>
<xsd:element name="АдресДома" type="ТипАдресДома"/>
<xsd:element name="Услуга" type="ТипУслуга" minOccurs="1" maxOccurs="unbounded"/>
</xsd:sequence>
<xsd:attribute name="НомерЛицевогоСчетаДома" type="ТипНомерЛицевогоСчета" use="required"/>
</xsd:complexType>
<xsd:complexType name="ТипУслуга">
<xsd:sequence minOccurs="1" maxOccurs="unbounded">
<xsd:element name="Счетчик" type="ТипСчетчик"/>
</xsd:sequence>
<xsd:attribute name="НаименованиеУслуги" use="required" type="ТипНаименованиеУслуги"/>
</xsd:complexType>
<xsd:simpleType name="ТипНаименованиеУслуги">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="ЭЛЕКТРОСНАБЖЕНИЕ" />
<xsd:enumeration value="ОСВЕЩЕНИЕ МОП" />
<xsd:enumeration value="ЭЛЕКТРОСНАБЖЕНИЕ ЛИФТОВ" />
<xsd:enumeration value="ХОЛОДНАЯ ВОДА" />
<xsd:enumeration value="ГОРЯЧАЯ ВОДА" />
<xsd:enumeration value="ГАЗ" />
<xsd:enumeration value="ОТОПЛЕНИЕ" />
</xsd:restriction>
</xsd:simpleType>
<xsd:complexType name="ТипСчетчик">
<xsd:sequence>
<xsd:element name="ТипСчетчика" type="ТипТипСчетчика"/>
<xsd:element name="РазрядностьСчетчика" type="xsd:integer"/>
<xsd:element name="ЗаводскойНомерСчетчика" type="ТипСтрока30"/>
<xsd:sequence minOccurs="1" maxOccurs="3">
<xsd:element name="Показание">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="ПредыдущееПоказание" type="ТипПоказание"/>
<xsd:element name="ДатаСнятияПредыдущегоПоказания" type="ТипДата"/>
<xsd:element name="ТекущееПоказание" type="ТипПоказание"/>
<xsd:element name="ДатаСнятияТекущегоПоказания" type="ТипДата"/>
<xsd:element name="Расход" type="ТипПоказание"/>
</xsd:sequence>
<xsd:attribute name="ТипПоказания">
<xsd:simpleType>
<xsd:restriction base="xsd:string">
</xsd:restriction>
</xsd:simpleType>
</xsd:attribute>
</xsd:complexType>
</xsd:element>
</xsd:sequence>
</xsd:sequence>
<xsd:attribute name="ВидСчетчика" type="xsd:string">
<xsd:simpleType>
<xsd:restriction base="xsd:string">
<xsd:enumeration value="КВАРТИРНЫЙ" />
<xsd:enumeration value="ДОМОВОЙ" />
<xsd:enumeration value="ГРУППОВОЙ" />
</xsd:restriction>
</xsd:simpleType>
</xsd:attribute>
</xsd:complexType>
<xsd:complexType name="ТипАдресДома">
<xsd:sequence>
<xsd:element name="Регион" type="ТипСтрока40"/>
<xsd:element name="Район" type="ТипСтрока40" minOccurs="0" maxOccurs="1"/>
<xsd:element name="Город" type="ТипСтрока40" minOccurs="0" maxOccurs="1"/>
<xsd:element name="НаселенныйПункт" type="ТипСтрока40" minOccurs="0" maxOccurs="1"/>
<xsd:element name="Улица" type="ТипСтрока40"/>
<xsd:element name="НомерДома" type="ТипСтрока10"/>
<xsd:element name="Корпус" type="ТипСтрока10" minOccurs="0" maxOccurs="1"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="ТипНомерКвартиры">
<xsd:sequence>
<xsd:element name="Квартира" type="ТипСтрока10"/>
<xsd:element name="Комната" type="ТипСтрока10" minOccurs="0" maxOccurs="1"/>
</xsd:sequence>
</xsd:complexType>
<xsd:simpleType name="ТипСтрока40">
<xsd:restriction base="xsd:string">
<xsd:maxLength value="40"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="ТипСтрока10">
<xsd:restriction base="xsd:string">
<xsd:maxLength value="10"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="ТипСтрока30">
<xsd:restriction base="xsd:string">
<xsd:maxLength value="30"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="ТипТипСчетчика">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="САТУРН" />
<xsd:enumeration value="МЕРКУРИЙ" />
<xsd:enumeration value="ЭНЕРГОМЕРА" />
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="ТипПоказание">
<xsd:restriction base="xsd:decimal">
<xsd:fractionDigits value="8"/>
<xsd:totalDigits value="18"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="ТипДата">
<xsd:restriction base="xsd:string">
<xsd:pattern value="\d{2}.\d{2}.\d{4}" />
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="ТипНомерЛицевогоСчета">
<xsd:restriction base="xsd:decimal">
<xsd:fractionDigits value="0"/>
<xsd:totalDigits value="20"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:schema>
Приложение 1 - Пример файла «Адресное пространство»
<?xml version="1.0" encoding="windows-1251"?>
<ПривязкаСчетчиков ГодУчета="2014" МесяцУчета="4">
<Счетчик ЗаводскойНомер="167792">
<ВидСчетчика>ДОМОВОЙ</ВидСчетчика>
<Дом НомерЛицевогоСчетаДома="1">
<АдресДома>
<Регион>ТАТАРСТАН РЕСП</Регион>
<Город>КАЗАНЬ Г</Город>
<Улица>ГАБДУЛЛЫ ТУКАЯ</Улица>
<НомерДома>75</НомерДома>
</АдресДома>
</Дом>
</Счетчик>
<Счетчик ЗаводскойНомер="Д-75Г-Э">
<ВидСчетчика>ДОМОВОЙ</ВидСчетчика>
<Дом НомерЛицевогоСчетаДома="1">
<АдресДома>
<Регион>ТАТАРСТАН РЕСП</Регион>
<Город>КАЗАНЬ Г</Город>
<Улица>ГАБДУЛЛЫ ТУКАЯ</Улица>
<НомерДома>75</НомерДома>
</АдресДома>
</Дом>
</Счетчик>
<Счетчик ЗаводскойНомер="00490743">
<ВидСчетчика>КВАРТИРНЫЙ</ВидСчетчика>
<Дом НомерЛицевогоСчетаДома="1">
<АдресДома>
<Регион>ТАТАРСТАН РЕСП</Регион>
<Город>КАЗАНЬ Г</Город>
<Улица>ГАБДУЛЛЫ ТУКАЯ</Улица>
<НомерДома>75</НомерДома>
</АдресДома>
</Дом>
< Домохозяйство НомерЛицевогоСчетаКвартиры="5016000857">
<НомерКвартиры>
<Квартира>85</Квартира>
<ФИО>Петров</ФИО>
</НомерКвартиры>
</ Домохозяйство >
</Счетчик>
<Счетчик ЗаводскойНомер="00491650">
<ВидСчетчика>КВАРТИРНЫЙ</ВидСчетчика>
<Дом НомерЛицевогоСчетаДома="1">
<АдресДома>
<Регион>ТАТАРСТАН РЕСП</Регион>
<Город>КАЗАНЬ Г</Город>
<Улица>ГАБДУЛЛЫ ТУКАЯ</Улица>
<НомерДома>75</НомерДома>
</АдресДома>
</Дом>
<Домохозяйство НомерЛицевогоСчетаКвартиры="5016000097">
<НомерКвартиры>
<Квартира>9</Квартира>
<ФИО>Иванов</ФИО>
</НомерКвартиры>
</ Домохозяйство >
</Счетчик>
<КоличествоСчетчиков>4</КоличествоСчетчиков>
</ПривязкаСчетчиков>
Приложение
2
- Пример файла с информацией по ПУ и их показаниям
<ПоказанияСчетчиков ГодУчета="2006" МесяцУчета="12">
<Дом НомерЛицевогоСчетаДома="1234567890">
<АдресДома>
<Регион>ТАТАРСТАН РЕСП</Регион>
<Район/>
<Город>КАЗАНЬ Г</Город>
<НаселенныйПункт/>
<Улица>МОРОЗОВА ПАВЛИКА УЛ</Улица>
<НомерДома>1</НомерДома>
<Корпус>А</Корпус>
</АдресДома>
<Услуга НаименованиеУслуги="ЭЛЕКТРОСНАБЖЕНИЕ МОП">
<Счетчик ВидСчетчика="ДОМОВОЙ">
<ТипСчетчика>ПЯТИЗНАЧНЫЙ</ТипСчетчика>
<ЗаводскойНомерСчетчика>AAA01</ЗаводскойНомерСчетчика>
<Разрядность>5</Разрядность>
<Показание ТипПоказания="ДНЕВНОЙ">
<ПредыдущееПоказание>123.12</ПредыдущееПоказание>
<ДатаСнятияПредыдущегоПоказания>01.01.2007</ДатаСнятияПредыдущегоПоказания>
<ТекущееПоказание>321.5</ТекущееПоказание>
<ДатаСнятияТекущегоПоказания>10.06.2007</ДатаСнятияТекущегоПоказания>
<Расход>198.38</Расход>
</Показание>
<Показание ТипПоказания="НОЧНОЙ">
<ПредыдущееПоказание>23.12</ПредыдущееПоказание>
<ДатаСнятияПредыдущегоПоказания>01.01.2007</ДатаСнятияПредыдущегоПоказания>
<ТекущееПоказание>35.26</ТекущееПоказание>
<ДатаСнятияТекущегоПоказания>10.06.2007</ДатаСнятияТекущегоПоказания>
<Расход>12.14</Расход>
</Показание>
<Показание ТипПоказания="СУММАРНЫЙ">
<ПредыдущееПоказание>146.24</ПредыдущееПоказание>
<ДатаСнятияПредыдущегоПоказания>01.01.2007</ДатаСнятияПредыдущегоПоказания>
<ТекущееПоказание>356.76</ТекущееПоказание>
<ДатаСнятияТекущегоПоказания>10.06.2007</ДатаСнятияТекущегоПоказания>
<Расход>210.52</Расход>
</Показание>
</Счетчик>
</Услуга>
</Дом>
<Квартира НомерЛицевогоСчетаКвартиры="123000">
<АдресДома>
<Регион>ТАТАРСТАН РЕСП</Регион>
<Район/>
<Город>КАЗАНЬ Г</Город>
<НаселенныйПункт/>
<Улица>МОРОЗОВА ПАВЛИКА УЛ</Улица>
<НомерДома>1</НомерДома>
<Корпус>А</Корпус>
</АдресДома>
<НомерКвартиры>
<Квартира>1</Квартира>
</НомерКвартиры>
<Услуга НаименованиеУслуги="ЭЛЕКТРОСНАБЖЕНИЕ">
<Счетчик ВидСчетчика="КВАРТИРНЫЙ">
<ТипСчетчика>ПЯТИЗНАЧНЫЙ</ТипСчетчика>
<ЗаводскойНомерСчетчика>AAA01</ЗаводскойНомерСчетчика>
<Разрядность>5</Разрядность>
<Показание ТипПоказания="ДНЕВНОЙ">
<ПредыдущееПоказание>123.12</ПредыдущееПоказание>
<ДатаСнятияПредыдущегоПоказания>01.01.2007</ДатаСнятияПредыдущегоПоказания>
<ТекущееПоказание>321.5</ТекущееПоказание>
<ДатаСнятияТекущегоПоказания>10.06.2007</ДатаСнятияТекущегоПоказания>
<Расход>198.38</Расход>
</Показание>
<Показание ТипПоказания="НОЧНОЙ">
<ПредыдущееПоказание>234.12</ПредыдущееПоказание>
<ДатаСнятияПредыдущегоПоказания>01.01.2007</ДатаСнятияПредыдущегоПоказания>
<ТекущееПоказание>235.5</ТекущееПоказание>
<ДатаСнятияТекущегоПоказания>10.06.2007</ДатаСнятияТекущегоПоказания>
<Расход>1.38</Расход>
</Показание>
<Показание ТипПоказания="СУММАРНЫЙ">
<ПредыдущееПоказание>100.12</ПредыдущееПоказание>
<ДатаСнятияПредыдущегоПоказания>01.01.2007</ДатаСнятияПредыдущегоПоказания>
<ТекущееПоказание>200.12</ТекущееПоказание>
<ДатаСнятияТекущегоПоказания>10.06.2007</ДатаСнятияТекущегоПоказания>
<Расход>100.00</Расход>
</Показание>
</Счетчик>
</Услуга>
</Квартира>
<Квартира НомерЛицевогоСчетаКвартиры="123321">
<АдресДома>
<Регион>ТАТАРСТАН РЕСП</Регион>
<Район/>
<Город>КАЗАНЬ Г</Город>
<НаселенныйПункт/>
<Улица>МОРОЗОВА ПАВЛИКА УЛ</Улица>
<НомерДома>1</НомерДома>
<Корпус>А</Корпус>
</АдресДома>
<НомерКвартиры>
<Квартира>2</Квартира>
</НомерКвартиры>
<Услуга НаименованиеУслуги="ЭЛЕКТРОСНАБЖЕНИЕ">
<Счетчик ВидСчетчика="КВАРТИРНЫЙ123">
<ТипСчетчика>ПЯТИЗНАЧНЫЙ</ТипСчетчика>
<ЗаводскойНомерСчетчика>AAA01</ЗаводскойНомерСчетчика>
<Разрядность>5</Разрядность>
<Показание ТипПоказания="ДНЕВНОЙ">
<ПредыдущееПоказание>123.12</ПредыдущееПоказание>
<ДатаСнятияПредыдущегоПоказания>01.01.2007</ДатаСнятияПредыдущегоПоказания>
<ТекущееПоказание>321.5</ТекущееПоказание>
<ДатаСнятияТекущегоПоказания>10.06.2007</ДатаСнятияТекущегоПоказания>
<Расход>198.38</Расход>
</Показание>
</Счетчик>
</Услуга>
</Квартира>
</ПоказанияСчетчиков>