Регламент - Реформа ЖКХ

реклама
ГК - Фонд содействия реформированию ЖКХ
РЕГЛАМЕНТ ЭЛЕКТРОННОГО ВЗАИМОДЕЙСТВИЯ С
ИНФОРМАЦИОННЫМИ СИСТЕМАМИ РЕГИОНАЛЬНОГО И
МУНИЦИПАЛЬНОГО УРОВНЯ В РАМКАХ ОБМЕНА ИНФОРМАЦИИ ПО
ПОСТАНОВЛЕНИЮ ПРАВИТЕЛЬСТВА РОССИЙСКОЙ ФЕДЕРАЦИИ ОТ
23 СЕНТЯБРЯ 2010 ГОДА №731
Версия 1.0.32
Москва 2016
СОДЕРЖАНИЕ
СОДЕРЖАНИЕ ..............................................................................................................................2
1
ОБЩИЕ СВЕДЕНИЯ ............................................................................................................4
2
СТРУКТУРА XML-ДОКУМЕНТОВ ...................................................................................5
3
ПЕРЕЧЕНЬ МЕТОДОВ.........................................................................................................6
4
СХЕМА ВЫЗОВА МЕТОДОВ ...........................................................................................10
5
ОПИСАНИЕ МЕТОДОВ.....................................................................................................16
5.1
Метод Logout .................................................................................................................20
5.2
Метод SetRequestForSubmit .........................................................................................21
5.3
Метод GetRequestList ....................................................................................................23
5.4
Метод GetReportingPeriodList ......................................................................................25
5.5
Метод SetCompanyProfile .............................................................................................27
5.6
Метод SetNewCompany ................................................................................................58
5.7
Метод GetHouseList ......................................................................................................62
5.8
Метод SetUnlinkFromOrganization ...............................................................................66
5.9
Метод SetHouseLinkToOrganization .............................................................................69
5.10 Метод SetHouseProfile ..................................................................................................71
5.11 Метод SetNewHouse ....................................................................................................100
5.12 Метод GetHouseInfo ....................................................................................................102
5.13 Метод SetUploadFile ...................................................................................................105
5.14 Метод GetFileByID ......................................................................................................107
5.15 Метод GetCompanyProfile .......................................................................................... 110
5.16 Метод GetHouseProfile ................................................................................................ 112
5.17 Метод GetCompanyProfileSF ...................................................................................... 115
5.18 Метод GetHouseProfileSF ........................................................................................... 118
5.19 Метод GetCompanyProfileSF988 ................................................................................121
5.20 Метод GetCompanyProfile988 ....................................................................................133
5.21 Метод GetHouseProfileSF988 .....................................................................................135
5.22 Метод GetHouseProfile988 ..........................................................................................180
5.23 Метод SetCompanyProfile988 .....................................................................................182
5.24 Метод SetHouseProfile988 ..........................................................................................187
6 СОСТАВ ПОКАЗАТЕЛЕЙ АНКЕТ, СОГЛАСНО ПОСТАНОВЛЕНИЮ
ПРАВИТЕЛЬСТВА РФ №731 от 23.09.2010, КОТОРЫЕ НЕ МОГУТ ПРИНИМАТЬ
ЗНАЧЕНИЕ «0» ..........................................................................................................................196
7
СПИСОК ОШИБОК ПЕРЕДАЧИ ИНФОРМАЦИИ ......................................................199
8
ТЕРМИНЫ И ОПРЕДЕЛЕНИЯ .......................................................................................204
Лист регистрации изменений ...................................................................................................206
2
3
1
ОБЩИЕ СВЕДЕНИЯ
Настоящий документ определяет форматы XML-документов, передаваемых в
электронной форме по телекоммуникационным каналам связи для обеспечения
интеграции системы «Реформа ЖКХ» с внешними системами.
В системе «Реформа ЖКХ» для взаимодействия с внешними системами реализован
API-сервис. API-сервис предоставляет возможность, внешним системам, раскрывать
информацию по управляющим организациям, которые дали на то разрешение, а также по
домам, находящимся в управлении.
API позволяет:
1)
авторизоваться для получения доступа к использованию API-методов;
2)
получить данные организаций, раскрывших сведения о своей деятельности
согласно Постановлению Правительства РФ № 731 от 23.09.2010 в «Реформа
ЖКХ», и данные обслуживаемых ими домов;
3)
получить данные организаций, раскрывших сведения о своей деятельности
согласно Постановлению Правительства РФ № 988 от 27.09.2014 в «Реформа
ЖКХ», и данные обслуживаемых ими домов;
4)
загрузить (обновить) данные организаций, зарегистрированных в «Реформа
ЖКХ», отредактировать список обслуживаемых ими домов, загрузить данные об
обслуживаемых ими домах на «Реформа ЖКХ».
Для начала работы:
1)
внешняя система должна предварительно подать заявку в Фонд, после
рассмотрения, которой она (внешняя система) будет зарегистрирована в «Реформа
ЖКХ» и ей будут выданы соответствующие права на внешнее взаимодействие;
2)
внешняя система, с помощью вызова метода SetRequestForSubmit, должна
подать запрос на раскрытие управляющей организации. После одобрения заявки,
администратором организации, внешняя система может начать раскрытие данных
по анкете организации и анкетам домов в управлении.
Входные структуры данных GET и SET - методов передаются в теле запроса. API
«Реформа ЖКХ» поддерживает протокол SOAP (Simple Object Access Protocol). Обмен
данными по этому протоколу ведется посредством XML-сообщений.
При SOAP-протоколе генерируется WSDL-документ, описывающий формат
данных для взаимодействия.
4
2
СТРУКТУРА XML-ДОКУМЕНТОВ
XML-документ состоит из строк, содержащих элементы и атрибуты, а также их
значения. Реквизиты XML-документа могут быть элементами или атрибутами. Элемент
является составной частью XML-документа, обычно представляющую собой некоторую
законченную смысловую единицу. Элемент может содержать один или несколько
вложенных элементов и/или атрибутов. Атрибут представляет собой составную часть
элемента, задающую его параметры. В XML-документе описывается пролог с указанием
кодировки UTF-8: <?xml version = “1.0” encoding = “UTF-8”?>.
Описание типов данных, используемых при определении полей документов.
Описание приведено в разделе описания методов. В графе "Категория" записывается
условное обозначение элемента сообщения. В графе "Параметр" записывается условное
обозначение атрибута или другого элемента, входящего в состав элемента. В графе "Тип"
для каждого атрибута указывается тип параметра. В графе "Max символов" указывается
длина атрибута. В графе "Обязательность" указывается обязательность поля на ввод.
"Обязательность" имеет следующие обозначения:
1) «Да» - обязательный атрибут;
2) « » - необязательный атрибут.
Обязательный атрибут – это атрибут, который должен обязательно присутствовать
в XML-документе. Необязательный атрибут – это атрибут, который может, как
присутствовать, так и отсутствовать в XML-документе.
В графе "Описание" указывается описание элемента или атрибута.
5
ПЕРЕЧЕНЬ МЕТОДОВ
3
Красным цветом выделены методы, которые на данный момент не доступны для работы.
Таблица 1– Описание методов API
Метод
Авторизация
Данные по API
взаимодействию
Тип
Общий
Login
Название
Общий
Logout
Импорт
SetRequestForSubmit
Экспорт GetRequestList
Справочники
Экспорт GetReportingPeriodList
Управляющая
организация
Экспорт GetCompanyProfile
Экспорт GetCompanyProfile988
Экспорт GetCompanyProfileSF
Назначение
Выполняет авторизацию
внешней системы и
открывает сеанс работы
Завершает авторизованный
сеанс работы внешней
системы
Подача запроса на
подписку (по списку ИНН)
Возвращает список
запросов подписки
внешней системы на
раскрытие данных,
поданных внешней
системой (с детализацией
статуса запроса)
Возвращает список
отчетных периодов
системы
Возвращает данные анкеты
(текущей и архивной)
управляющей организации
с соответствующим
ИНН,согласно
Постановлению
Правительства РФ №731
от 27.09.2010
Возвращает данные анкеты
(текущей и архивной)
управляющей организации
с соответствующим
ИНН,cогласно
Постановлению
Правительства РФ № 988
от 27.09.2014
Возвращает данные анкеты
(текущей и архивной)
управляющей организации
по указанному субъекту
федерации за указанный
Метод
Тип
Название
Экспорт GetCompanyProfileSF988
Импорт
SetCompanyProfile
Импорт
SetCompanyProfile988
Импорт
SetNewCompany
Экспорт GetHouseList
7
Назначение
период,согласно
Постановлению
Правительства РФ №731
от 27.09.2010
Возвращает данные анкеты
(текущей и архивной)
управляющей организации
по указанному субъекту
федерации за указанный
период,согласно
Постановлению
Правительства РФ № 988
от 27.09.2014
Изменяет данные по
текущей/архивной анкете
организации с
соответствующим ИНН за
указанный отчетный
период,согласно
Постановлению
Правительства РФ №731
от 27.09.2010
Изменяет данные по
текущей/архивной анкете
организации с
соответствующим ИНН за
указанный отчетный
период,cогласно
Постановлению
Правительства РФ № 988
от 27.09.2014
Подает заявку на
регистрацию новой
управляющей организации
в системе
Возвращает список домов,
находящихся в управлении
организации с
соответствующим ИНН.
(по каждому дому
возвращается
идентификатор дома и
адрес по ФИАС)
Метод
Договора
Тип
Импорт
Название
SetUnlinkFromOrganization
Назначение
Прекращает управление
домом с соответствующим
идентификатором
Импорт
SetHouseLinkToOrganization
Добавляет дом с
соответствующим
идентификатором в
управление организации с
соответствующим ИНН
Возвращает данные анкеты
(текущей) дома с
соответствующим
идентификатором
дома,согласно
Постановлению
Правительства РФ №731
от 27.09.2010
Возвращает данные анкеты
(текущей) дома с
соответствующим
идентификатором
дома,согласно
Постановлению
Правительства РФ № 988
от 27.09.2014
Возвращает данные анкеты
(текущей) дома по
указанному субъекту
федерации,согласно
Постановлению
Правительства РФ №731
от 27.09.2010
Возвращает данные анкеты
(текущей) дома по
указанному субъекту
федерации,согласно
Постановлению
Правительства РФ № 988
от 27.09.2014
Изменяет данные текущей
анкеты дома с
соответствующим
идентификатором
дома,согласно
Постановлению
Многоквартирный Экспорт GetHouseProfile
дом
Экспорт GetHouseProfile988
Экспорт GetHouseProfileSF
Экспорт GetHouseProfileSF988
Импорт
SetHouseProfile
8
Метод
Тип
Название
Импорт
SetHouseProfile988
Импорт
SetNewHouse
Экспорт GetHouseInfo
Файлы
Импорт
SetUploadFile
Экспорт GetFileById
Назначение
Правительства РФ №731
от 27.09.2010
Изменяет данные текущей
анкеты дома с
соответствующим
идентификатором
дома,согласно
Постановлению
Правительства РФ № 988
от 27.09.2014
Добавляет новый дом в
систему с
соответствующим адресом
по ФИАС
Возвращает
идентификатор дома с
соответствующим адресом
по ФИАС
Загружает файл в систему
Возвращает файл с
соответствующим
идентификатором
9
СХЕМА ВЫЗОВА МЕТОДОВ
4
Ниже описаны уровни зависимости методов. Уровни зависимости методов – это
порядок вызова методов. Невозможно выполнить методы со второго уровня, пока не
выполнены методы первого уровня. Например, без авторизации нельзя вызвать ни один из
методов, без подачи запроса на раскрытие невозможно выполнить раскрытие данных по
анкете организации. При вызове метода из уровня ниже, если метод уровня выше был
выполнен ранее, то вызов этого метода пропускается.
Ниже представлена ситуация, когда: управляющая организация не создана, заявка
на раскрытие от внешней системы не подана, дом не добавлен в систему, дом не добавлен
в управление, отчетные периоды не получены, название разделов анкет не получены, файл
не добавлен.
УРОВЕНЬ №1
1.1 Авторизация(Login)
УРОВЕНЬ №2
2.1
Создание
заявки
на
регистрацию
новой
управляющей
организации
(SetNewCompany) не может быть выполнено, пока не выполнена авторизация (1.1).
2.2 Подача запроса (SetRequestForSubmit) не может быть выполнена, пока не
выполнена авторизация (1.1).
2.3
Получение списка запросов (GetRequestList) не может быть выполнено, пока
не выполнена авторизация (1.1).
2.4 Получение списка отчетных периодов (GetReportingPeriodList) не может быть
выполнено, пока не выполнена авторизация (1.1).
2.5
Создание нового дома (SetNewHouse) не может быть выполнено, пока не
выполнена авторизация (1.1).
2.6 Получение информации о доме (GetHouseInfo) не может быть выполнено, пока
не выполнена авторизация (1.1).
2.7
Создание
заявки
для
регистрации
новой
управляющей
организации
(SetNewCompany) не может быть выполнено, пока не выполнена авторизация (1.1).
2.8 Получение данных анкеты (текущей и архивной) управляющей организации с
соответствующим ИНН за указанный отчетный период (1.1).
10
2.9 Получение данных анкеты (текущей и архивной) дома с соответствующим
идентификатором дома (1.1).
2.10 Получение данных анкеты (текущей и архивной) управляющей организации
по указанному субъекту федерации за указанный отчетный период (1.1).
2.11 Получение данных анкеты (текущей и архивной) дома по указанному субъекту
федерации (1.1).
УРОВЕНЬ №3
3.1
Раскрытие
по
анкете
управляющей
организации
(SetCompanyProfile,
SetCompanyProfile988) не может быть выполнено, пока не выполнены следующие методы:
(1.1), (2.1), (2.2), (2.4), (2.6), (2.7), (2.8), (2.10).
3.2 Получение списка домов в управлении (GetHouseList) не может быть
выполнено, пока не выполнены следующие методы: (1.1), (2.1), (2.2).
УРОВЕНЬ №4
4.1 Добавление дома в управление (SetHouseLinkToOrganization) не может быть
выполнено, пока не выполнены следующие методы: (1.1), (2.1), (2.2), (2.5), (3.2).
УРОВЕНЬ №5
5.1 Прекращение управления домом (SetUnlinkFromOrganization) не может быть
выполнено, пока не выполнены следующие методы: (1.1), (2.1), (2.2), (2.5), (3.2), (4.1).
УРОВЕНЬ №6
6.1 Раскрытие данных по анкете дома (SetHouseProfile, SetHouseProfile988) не
может быть выполнено, пока не выполнены следующие методы: (1.1), (2.1), (2.2), (2.5),
(2.9), (2.10), (4.1).
УРОВЕНЬ №7
7.2 Загрузка файла в систему не может быть выполнено, пока не выполнены
следующие методы: (1.1).
7.1 Получение файла с соответствующим идентификатором (GetFileByID) не может
быть выполнено, пока не выполнены следующие методы: (1.1), (2.1), (2.2), (2.5), (4.1),
(3.1), (6.1), (7.2).
УРОВЕНЬ № 8
8.1. Завершение сеанса(Logout)
11
Рисунок 1 - Схема взаимодействия системы «Реформа ЖКХ» с внешней системой.
Часть 1
12
Рисунок 2– Схема взаимодействия системы «Реформа ЖКХ» с внешней
системой. Часть 2
13
Рисунок 3– Схема порядка вызова методов для раскрытия данных по анкеты
управляющей организации
14
Рисунок 4– Схема порядка вызова методов для раскрытия данных по анкеты
многоквартирного дома
15
ОПИСАНИЕ МЕТОДОВ
5
Для тестирования выполненности методов API развернут тестовый контур.
Переданные данные будут доступны для просмотра на Портале по раскрытию
информации по адресу https://p-api-beta.reformagkh.ru/
Доступны два стиля WSDL- документа:
1.
PC\ encoded
•
Внешним системам, которые проходят бета-тестирование API, доступен
WSDL – документ по адресу https://api-beta.reformagkh.ru/api/wsdl.
•
Внешние системы, которые прошли бета-тестирование API сайта Реформа
ЖКХ, могут начать работу с боевым контуром (адрес WSDL – документа
боевого контура: https://api.reformagkh.ru/api/wsdl).
2.
Document\ literal
•
Внешним системам, которые проходят бета-тестирование API, доступен
WSDL
–
документ
по
адресу
https://api-
beta.reformagkh.ru/api_document_literal/wsdl.
•
Внешние системы, которые прошли бета-тестирование API сайта Реформа
ЖКХ, могут начать работу с боевым контуром (адрес WSDL – документа
боевого контура: https://api.reformagkh.ru/api_document_literal/wsdl)
Во всех методах, кроме метода «Login», необходимо передавать ключ авторизации.
Ключ передается в заголовке метода <soapenv:Header/>, в теге <authenticate>
</authenticate>.
Время жизни ключа авторизации 10 минут. По истечению 10 минут
необходимо снова вызвать метод «Login» и получить новый ключ для продолжения
работы.
Категория
Параметр
Authenticate
session_guid
Тип
character
varying
Max
Обязател
символов
ьность
36
Да
Описание
Уникальный ключ
сеанса
(идентификатор сессии)
Пример передачи авторизационного ключа в методе «SetRequestForSubmit»:
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:api="http://api.reformagkh.ru/api"
xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/">
<soapenv:Header>
16
<authenticate>meulr41c6up5uoc2ehufeslc14</authenticate>
</soapenv:Header>
<soapenv:Body>
<api:SetRequestForSubmit
soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<inns xsi:type="api:ArrayOfString"
soapenc:arrayType="xsd:string[2]">
<inn xsi:type="xsd:string">7842311056</inn>
</inns>
</api:SetRequestForSubmit>
</soapenv:Body>
</soapenv:Envelope>
Есть возможность прямой авторизации, указав логин и пароль в заголовке запроса:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:api="https://api-beta.reformagkh.ru/api_document_literal"
xmlns:xsi="xsi">
<soapenv:Header>
<api:Login
soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<login xsi:type="xsd:string">diana.nizamova</login>
<password xsi:type="xsd:string">WAFqy1hk</password>
</api:Login>
</soapenv:Header>
...
В методах раскрытия данных по анкетам (текущим и архивным) управляющей
организации и анкетам (текущим) домов в ее управлении передаются все значения
входных параметров, а не только те значения параметров, которые были изменены. В
случае, если значение поля не указано, система воспринимает это как поле на удаление, и
ранее введенное значение удалится.
Во избежании затирания данных на сайте "Реформа ЖКХ" необходимо прочитать
данные анкеты управляющей организации и анкет домов в ее управлении с помощью
методов GetCompanyProfile/GetCompanyProfile988 и GetHouseProfile/GetHouseProfile988.
После этого данные в анкетах, не соответствующие данным на сайте "Реформа ЖКХ",
необходимо изменить с помощью методов SetCompanyProfile/SetCompanyProfile988 и
SetHouseProfile/ SetHouseProfile988.
Для безошибочного выполнения запроса необходимо строго соблюдать порядок
следования параметров в тексте запроса.
17
Метод Login
1) Описание метода
Метод выполняет авторизацию внешней системы и открывает сеанс работы. Перед
началом работы должна быть проверка, что учетные данные пользователя существуют в
системе “Реформа ЖКХ”, не заблокированы и соответствуют внешней системе.
Есть возможность авторизации не вызывая метод “Login”. В заголовке каждого
метода можно указать учетные данные и тем самым авторизовываться. Пример вызова
метода:
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:api="http://api.reformagkh.ru/api"
xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/">
<soapenv:Header>
<api:Login
soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<login xsi:type="xsd:string">diana.nizamova</login>
<password xsi:type="xsd:string">WAFqy1hk</password>
</api:Login>
</soapenv:Header>
<soapenv:Body>
<api:SetCompanyProfile988
soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
…
</api:SetCompanyProfile988>
</soapenv:Body>
</soapenv:Envelope>
2) Входные данные
В таблице представлены входные параметры метода (Таблица 2).
Таблица 2 – Входные параметры метода Login
Категория
LoginIn
Параметр
login
password
Тип
character
varying
character
varying
Max
Обязател
символов
ьность
255
Да
255
Да
Описание
Имя пользователя, для
ввода в систему.
Набор символов, для
подтверждения
личности или
полномочий.
3) Выходные параметры
В таблице представлены выходные параметры метода (Таблица 3).
Таблица 3– Выходные параметры метода Login
Категория
Параметр
Тип
Max
символов
18
Обязател
ьность
Описание
LoginOut
session_guid
character
varying
Получение временного
ключа для работы с API
36
Таблица 4– Выходные параметры метода Login в случае ошибочного выполнения
SoapFault
code
name
description
Код результата запроса
Наименование
Описание
integer
text
text
4) Пример вызова метода
SOAP-запрос:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:api="http://api.reformagkh.ru/api_document_literal">
<soapenv:Header/>
<soapenv:Body>
<api:Login>
<login>?</login>
<password>?</password>
</api:Login>
</soapenv:Body>
</soapenv:Envelope>
SoapFault:
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="http://api.reformagkh.ru/api_document_literal"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<SOAP-ENV:Body>
<SOAP-ENV:Fault>
<faultcode>SOAP-ENV:Client</faultcode>
<faultstring>Mandatory field is null</faultstring>
<detail xsi:type="ns1:ErrorDetails">
<code>1009</code>
<name>Mandatory field is null</name>
<description>Обязательное поле «login» не заполнено</description>
</detail>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Отсутствие SoapFault означает успешное выполнение запроса.
5) Ошибки
Таблица 5 – Результаты вызова метода Login
Code
(Код результата
запроса)
1002
Name
(Наименование)
Description
(Описание)
Логин не найден или логин не
соответствует паролю.
Authentication failed
19
1009
Mandatory field is null
Обязательное поле «НАЗВАНИЕ
ПОЛЯ» не заполнено
1003
User is blocked
Пользователь заблокирован
1006
User doesn't conform to
external system
Пользователь не соответствует
внешней системе
1016
No interaction
Взаимодействие с системой "Реформа
ЖКХ" запрещено
1025
Technical works in the
system
Ведутся технические работы.
Попробуйте обратиться позже
5.1
Метод Logout
1) Описание метода
Метод завершает авторизованный сеанс работы внешней системы.
2) Выходные параметры
В таблице представлены выходные параметры метода (Таблица 6).
Таблица 6– Выходные параметры метода Logout в случае ошибочного выполнения
Категория
SoapFault
Параметр
code
name
description
Тип
Max
символов
Обязател
ьность
Описание
Код результата запроса
Наименование
Описание
integer
text
text
3) Пример вызова метода
SOAP-запрос:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:api="http://api.reformagkh.ru/api_document_literal">
<soapenv:Header>
<authenticate
xsi:type="xsd:string">9gm0m3ntqrqf0sf24egvcqls66</authenticate>
</soapenv:Header>
<soapenv:Body>
<api:Logout
soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>
</soapenv:Body>
</soapenv:Envelope>
SoapFault:
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="http://api.reformagkh.ru/api_document_literal"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<SOAP-ENV:Body>
<SOAP-ENV:Fault>
20
<faultcode>SOAP-ENV:Client</faultcode>
<faultstring>Mandatory field is null</faultstring>
<detail xsi:type="ns1:ErrorDetails">
<code>1009</code>
<name>Mandatory field is null</name>
<description>Обязательное поле «sessionId» не
заполнено</description>
</detail>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Отсутствие SoapFault означает успешное выполнение запроса.
4) Ошибки
Таблица 7 – Результаты вызова метода Logout
Code
(Код результата
запроса)
Name
(Наименование)
Description
(Описание)
401
Authorization failed
Неавторизованный запрос
1009
Unauthorized
Обязательное поле «НАЗВАНИЕ
ПОЛЯ» не заполнено
5.2
Метод SetRequestForSubmit
1) Описание метода
Метод подачи запроса на раскрытие данных. Внешняя система подает на вход
список ИНН управляющих организаций, по которым собирается раскрывать данные.
При условии, что Вы администратор УО подтверждение запроса на раскрытие
информации проставиться автоматически.
2) Входные данные
В таблице представлены входные параметры метода (Таблица 8).
Таблица 8 – Входные параметры метода SetRequestForSubmit
Категория
SetRequest
ForSubmitI
n
Параметр
inns
Тип
ArrayOfStri
ng
Max
Обязател
символов
ьность
12
Да
21
Описание
На вход передается
список ИНН
управляющих
организаций, с
запросом о разрешении
раскрытия информации
Категория
Параметр
Тип
Max
символов
Обязател
ьность
Описание
по указанной
организации
3) Выходные параметры
В таблице представлены выходные параметры метода (Таблица 9).
Таблица 9– Выходные параметры метода SetRequestForSubmit
Категория
SetRequest
ForSubmitI
nnStatus
Параметр
inn
Тип
character
varying
SetRequest
ForSubmitI
nnStatusEn
um
status
Max
символов
12
Обязател
ьность
Описание
ИНН управляющей
организации
Идентификатор статуса
запроса внешней
системы. (Возможные
значения в Таблица 11)
Таблица 10– Выходные параметры метода SetRequestForSubmit в случае ошибочного
выполнения
SoapFault
code
name
description
Код результата запроса
Наименование
Описание
integer
text
text
Таблица 11– Возможные значения SetRequestForSubmitInnStatusEnum
Тип
SetRequestForSubmitIn
nStatusEnum
Идентификатор
Значения
Success. (Ошибок нет. Заявка подана)
Missing INN
INN is not valid (Указан некорректный
ИНН)
Request have been already submitted
(Запрос на подписку был уже подан
ранее)
0
1
2
3
4) Пример вызова метода
SOAP-запрос:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:api="http://api.reformagkh.ru/api_document_literal">
<soapenv:Header>
<authenticate>o0tnkvsrs9c79hrhmdslqrg3b0</authenticate>
</soapenv:Header>
<soapenv:Body>
<api:SetRequestForSubmit>
<inns>
<!--Zero or more repetitions:-->
<item>7702707386</item>
</inns>
22
</api:SetRequestForSubmit>
</soapenv:Body>
</soapenv:Envelope>
SoapFault:
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="http://api.reformagkh.ru/api_document_literal"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<SOAP-ENV:Body>
<SOAP-ENV:Fault>
<faultcode>SOAP-ENV:Client</faultcode>
<faultstring>Unauthorized</faultstring>
<detail xsi:type="ns1:ErrorDetails">
<code>401</code>
<name>Unauthorized</name>
<description>Неавторизованный запрос</description>
</detail>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Отсутствие SoapFault означает успешное выполнение запроса.
5) Ошибки
Таблица 12 – Результаты вызова метода SetRequestForSubmit
Code
(Код результата
запроса)
Name
(Наименование)
Description
(Описание)
401
Unauthorized
Неавторизованный запрос
403
Forbidden
Нет прав на выполнение запроса
500
Internal Server Error
Внутренняя ошибка сервера. Сервер
неспособен выполнить запрос.
Попробуйте обратиться позже
1011
Mandatory field is null
Обязательное поле «НАЗВАНИЕ
ПОЛЯ» не заполнено
1012
Field "NAME" is not valid
Поле «НАЗВАНИЕ ПОЛЯ» заполнено
не верно
5.3
Метод GetRequestList
1) Описание метода
Метод возвращает список запросов подписки на управляющую организацию,
поданных внешней системой (с детализацией статуса запроса).
23
2) Выходные параметры
В таблице представлены выходные параметры метода (Таблица 13).
Таблица 13– Выходные параметры метода GetRequestList
Категория
RequestStat
e
Параметр
inn
date_created
status
update_date
Тип
character
varying
timestamp(0
)
RequestStat
us
Max
Обязател
символов
ьность
12
Да
Да
Да
Да
timestamp(0
)
Описание
ИНН управляющей
организации
Дата подачи запроса
внешней системой
Идентификатор статуса
запроса
(Возможные значения в
Таблица 15)
Дата обработки заявки
Таблица 14– Выходные параметры метода GetRequestList в случае ошибочного
выполнения
SoapFault
code
name
description
Код результата запроса
Наименование
Описание
integer
text
text
Таблица 15– Возможные значения GetRequestList
Тип
RequestStatus
Идентификатор
Значения
approved(Заявка подтверждена)
declined(Заявка отклонена)
pending(В ожидании рассмотрения)
1
2
3
3) Пример вызова метода
SOAP-запрос:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:api="http://api.reformagkh.ru/api_document_literal">
<soapenv:Header>
<authenticate>nteu389j2k4d76c9p6fl0oal93</authenticate>
</soapenv:Header>
<soapenv:Body>
<api:GetRequestList/>
</soapenv:Body>
</soapenv:Envelope>
SoapFault:
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="http://api.reformagkh.ru/api_document_literal"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<SOAP-ENV:Body>
<SOAP-ENV:Fault>
<faultcode>SOAP-ENV:Client</faultcode>
24
<faultstring>Mandatory field is null</faultstring>
<detail xsi:type="ns1:ErrorDetails">
<code>1009</code>
<name>Mandatory field is null</name>
<description>Обязательное поле «sessionId» не
заполнено</description>
</detail>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Отсутствие SoapFault означает успешное выполнение запроса.
4) Ошибки
Таблица 16 – Результаты вызова метода GetRequestList
Code
(Код результата
запроса)
Name
(Наименование)
Description
(Описание)
401
Unauthorized
Неавторизованный запрос
403
Forbidden
Нет прав на выполнение запроса
500
Internal Server Error
Внутренняя ошибка сервера. Сервер
неспособен выполнить запрос.
Попробуйте обратиться позже.
1011
Mandatory field is null
Обязательное поле «НАЗВАНИЕ
ПОЛЯ» не заполнено
5.4
Метод GetReportingPeriodList
1) Описание метода
Метод возвращает список отчетных периодов системы.
2) Выходные параметры
В таблице представлены выходные параметры метода (Таблица 17).
Таблица 17– Выходные параметры метода GetReportingPeriodList
Категория
Параметр
ReportingPe id
riod
date_start
date_end
name
state
Тип
Max
символов
bigint
date
date
character
255
varying
ReportingPe
25
Обязател
ьность
Да
Описание
Да
Да
Да
Идентификатор
отчетного периода
Дата начала
Дата окончания
Наименование
Да
Текущее состояние.
riodStateEn
um
boolean
is_988
Да
(Возможные значения в
Таблица 19)
Признак, отчетный
период относится к
старым формам
(Постановление №731)
(is_988 is true) или к
новым формам
(Постановление №988)
(is_988 is false)
Таблица 18– Выходные параметры метода GetReportingPeriodList в случае ошибочного
выполнения
SoapFault
code
name
description
Код результата запроса
Наименование
Описание
integer
text
text
Таблица 19– Возможные значения ReportingPeriodStateEnum
Тип
ReportingPeriodStateE
num
Идентификатор
Значения
current (текущий)
1
2
archive (архивный)
3) Пример вызова метода
SOAP-запрос:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:api="http://api.reformagkh.ru/api_document_literal">
<soapenv:Header>
<authenticate>fl205gaavfncd3rplkllrv8rj1</authenticate>
</soapenv:Header>
<soapenv:Body>
<api:GetReportingPeriodList/>
</soapenv:Body>
</soapenv:Envelope>
SoapFault:
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="http://api.reformagkh.ru/api_document_literal"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<SOAP-ENV:Body>
<SOAP-ENV:Fault>
<faultcode>SOAP-ENV:Client</faultcode>
<faultstring>Mandatory field is null</faultstring>
<detail xsi:type="ns1:ErrorDetails">
<code>1009</code>
<name>Mandatory field is null</name>
<description>Обязательное поле «sessionId» не
заполнено</description>
</detail>
</SOAP-ENV:Fault>
26
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Отсутствие SoapFault означает успешное выполнение запроса.
4) Ошибки
Таблица 20 – Результаты вызова метода GetReportingPeriodList
Code
(Код результата
запроса)
Name
(Наименование)
Description
(Описание)
401
Unauthorized
Неавторизованный запрос
403
Forbidden
Нет прав на выполнение запроса
500
Internal Server Error
Внутренняя ошибка сервера. Сервер
неспособен выполнить запрос.
Попробуйте обратиться позже.
1011
Mandatory field is null
Обязательное поле «НАЗВАНИЕ
ПОЛЯ» не заполнено
5.5
Метод SetCompanyProfile
1) Описание метода
Метод изменяет данные по текущей/архивной анкете управляющей организации с
соответствующим ИНН за указанный отчетный период. Внешняя система может
обновлять анкеты только тех организаций, по которым разрешена подписка.
2) Входные данные
В таблице представлены входные параметры метода (Таблица 21).
Таблица 21 – Входные параметры метода SetCompanyProfile
Категор
Параметр
ия
SetComp inn
anyProfil
eIn
reporting_period_
id
data
Тип
character
varying
bigint
Max
символов
12
Обязательн
ость
Да
Да
Да
CompanyProfi
leData
Описание типа CompanyProfileData:
27
Описание
ИНН
Идентификатор
отчетного
периода
Массив данных
(Описано в
Таблица 22)
Таблица 22– Массив данных(CompanyProfileData) метода SetCompanyProfile
Категория
CompanyPr
ofileData
Параметр
Тип
okopf
Okopf
surname
character
varying
character
varying
character
varying
character
varying
character
varying
date
middlename
firstname
position
ogrn
Max
символов
Обязател
ьность
Да
Описание
255
Да
ОКОПФ. Передается
код всероссийского
справочника ОКОПФ в
формате «2 80 17».
(Возможные значения в
Таблица 45)
Фамилия
255
Да
Отчество
255
Да
Имя
255
Да
Должность
255
Да
ОГРН
Дата регистрации
date_assignm
ent_ogrn
name_authori text
2500
ty_assigning_
ogrn
legal_address FiasAddress
Да
actual_addres
s
FiasAddress
Да
post_address
FiasAddress
Да
work_time
phone
email
text
text
character
varying
2500
32
255
site
proportion_sf
text
decimal
2500
15.2
Да
28
Наименование органа,
принявшего решение о
регистрации
Идентификатор
юридического адреса
(Описано в
Таблица 23)
Идентификатор
фактического
адреса
(Описано в
Таблица 23)
Идентификатор
почтового
адреса
(Описано в
Таблица 23)
Режим работы
Телефон
Электронный адрес.
Формат:
example@mail.ru.
Интернет сайт
Доля участия в
уставном капитале
Категория
Параметр
proportion_m
o
Тип
decimal
additional_in text
fo
participation_ text
in_associatio
ns
srf_count
integer
mo_count
integer
offices_count
staff_regular
_total
staff_regular
_administrati
ve
integer
integer
staff_regular
_engineers
integer
staff_regular
_labor
integer
count_dismis
sed
count_dismis
sed_admins
integer
count_dismis
integer
Max
символов
Обязател
ьность
Описание
Субъекта РФ, %
Доля участия в
уставном капитале
муниципального
образования, %
Дополнительная
информация
Сведения об участии в
саморегулируемых
организациях или в
объединениях ТСЖ и
ЖСК
Количество Субъектов
РФ, в которых
организация
осуществляет свою
деятельность
Количество
муниципальных
образований, в которых
организация
осуществляет свою
деятельность
Количество офисов
Штатная численность
на отчетную дату, чел.
Штатная численность
на отчетную дату,
административный
персонал, чел.
Штатная численность
на отчетную дату,
инженеры, чел.
Штатная численность
на отчетную дату,
рабочий персонал, чел.
Уволено за отчетный
период, чел.
Уволено за отчетный
период,
административный
персонал, чел.
Уволено за отчетный
15.2
2500
2500
integer
integer
29
Категория
Параметр
sed_engineer
s
count_dismis
sed_workers
Тип
Max
символов
Описание
период, инженеры, чел.
Уволено за отчетный
период, рабочий
персонал, чел.
Число несчастных
случаев за отчетный
период
Число случаев
привлечения
организации к
административной
ответственности
Копии документов о
применении мер
административного
воздействия, а также
мер, принятых для
устранения нарушений,
повлекших применение
административных
санкций
Массив
идентификаторов
файлов. Если
идентификатор файла
не указан - это означает
удаление файла из
анкеты.
Массив
идентификаторов
файлов. Если
идентификатор файла
не указан - это означает
удаление файла из
анкеты.
Члены правления ТСЖ
integer
accidents_co
unt
integer
prosecute_co
unt
integer
prosecute_co
pies_of_docu
ments
text
2500
prosecute_do ArrayOfInt
cuments_copi
es_files
additional_fil
es
Обязател
ьность
ArrayOfInt
tsg_managem text
ent_members
audit_commi text
sion_member
s
additional_in text
fo_freeform
2500
2500
Члены ревизионной
комиссии
2500
Дополнительные
сведения в
30
Категория
Параметр
residents_cou
nt
count_houses
_under_mng_
report_date
Тип
Max
символов
CountHouse
sUnderMng
ReportDate
count_houses CountHouse
_under_mng_ sUnderMng
start_period
StartPeriod
sum_sq_hous SumSqHous
es_under_mn esUnderMn
g_report_date gReportDat
e
sum_sq_hous SumSqHous
es_under_mn esUnderMn
g_start_perio gStartPeriod
d
avg_time_ser AvgTimeSe
vice_mkd
rviceMkd
income_of_m IncomeOfM
ng
ng
IncomeOfU
sage
income_of_k
u
IncomeOfK
u
spending_of_
SpendingOf
Описание
произвольной форме
Число жителей в
обслуживаемых домах
Количество домов под
управлением на
отчетную дату.
(Описано в Таблица 24)
Количество домов под
управлением на начало
периода. (Описано в
Таблица 25)
Общая площадь домов
под управлением на
отчетную дату.
(Описано в Таблица 26)
Общая площадь домов
под управлением на
начало периода.
(Описано в Таблица 27)
Средний
срок
обслуживания
многоквартирного
дома. (Описано в
Таблица 28)
Доходы, полученные за
оказание услуг по
управлению
многоквартирными
домами. (Описано в
Таблица 29)
Сумма доходов,
полученных от
использования общего
имущества за отчетный
период. (Описано в
Таблица 30)
Сумма доходов,
полученных от
использования общего
имущества за отчетный
период. (Описано в
Таблица 31)
Расходы, полученные в
integer
income_of_u
sage
Обязател
ьность
31
Категория
Параметр
mng
Тип
Max
символов
claims_by_co ClaimsByC
ntracts_mng
ontractsMn
g
ClaimsByR
so
net_assets
float
annual_finan
cial_statemen
ts
annual_finan
cial_statemen
ts_files
text
2500
Массив
идентификаторов
файлов. Если
идентификатор файла
не указан - это означает
удаление файла из
анкеты.
Сметы доходов и
расходов ТСЖ или
ЖСК
Массив
идентификаторов
файлов. Если
идентификатор файла
не указан - это означает
удаление файла из
анкеты.
Отчет о выполнении
сметы доходов и
расходов
Массив
идентификаторов
файлов. Если
идентификатор файла
ArrayOfInt
revenues_exp text
enditures_esti
mates
revenues_exp ArrayOfInt
enditures_esti
mates_files
2500
performance_ text
report
2500
Описание
связи с оказанием услуг
по управлению
многоквартирными
домами. (Описано в
Таблица 32)
Выплаты по искам по
договорам управления
за отч
етный период.
(Описано в Таблица 33)
Выплата по искам РСО
за отчетный период.
(Описано в Таблица 34)
Чистые активы
управляющей
организации, тыс. руб.
Годовая бухгалтерская
отчетность
Mng
claims_by_rs
o
Обязател
ьность
performance_ ArrayOfInt
report_files
32
Категория
Параметр
Тип
members_me
etings_minut
es
text
members_me
etings_minut
es_files
ArrayOfInt
audit_commi
sion_report
text
audit_commi
sion_report_f
iles
ArrayOfInt
audit_report
text
audit_report_
files
ArrayOfInt
debt_for_mn
g
DebtForMn
g
Max
символов
Обязател
ьность
Описание
не указан - это означает
удаление файла из
анкеты.
Протоколы общих
собраний членов
товарищества или
кооператива, заседаний
правления и
ревизионной комиссии
Массив
идентификаторов
файлов. Если
идентификатор файла
не указан - это означает
удаление файла из
анкеты.
Заключения
ревизионной комиссии
(ревизора)
товарищества или
кооператива по
результатам проверки
годовой бухгалтерской
(финансовой)
отчетности
Массив
идентификаторов
файлов. Если
идентификатор файла
не указан - это означает
удаление файла из
анкеты.
Аудиторские
заключения
Массив
идентификаторов
файлов. Если
идентификатор файла
не указан - это означает
удаление файла из
анкеты.
Задолженность
собственников за
2500
2500
2500
33
Категория
Параметр
Тип
debt_owners
decimal
debt_owners
_for_ku
DebtOwner
sForKu
debt_uo_for_
ku
DebtUoFor
Ku
debt_owners
_communal
decimal
charged_for_
mng
ChargedFor
Mng
charged_for_
resources
ChargedFor
Resources
spending_rep
air
SpendingRe
pair
spending_bea
ty
SpendingBe
auty
spending_rep
SpendingRe
Max
символов
Обязател
ьность
Описание
услуги управления на
отчетную дату.
(Описано в Таблица 35)
Просроченная
задолженность жителей
за услуги по
управлению на начало
отчетного периода
Задолженность
собственников за КУ на
текущую дату, тыс.руб.
(Описано в Таблица 36)
Задолженность
собственников за КУ на
отчетную дату.
(Описано в Таблица 37)
Просроченная
задолженность
собственников за
коммунальные услуги
на начало отчетного
периода, тыс. руб.
Взыскано с
собственников за
услуги управления за
отчетный период.
(Описано в Таблица 38)
Взыскано с
собственников за
поставленные ресурсы
за отчетный период.
(Описано в Таблица 39)
Объем средств,
затраченных на работы
по текущему ремонту
за отчетный период.
(Описано в Таблица 40)
Объем средств,
затраченных на работы
по благоустройству за
отчетный период.
(Описано в Таблица 41)
Объем привлеченных
15.2
15.2
34
Категория
Параметр
Тип
air_invests
pairInvests
payed_ku_by
_statements
PayedKuBy
Statements
payed_ku_by
_needs
PayedKuBy
Needs
Max
символов
management text
_contract
management ArrayOfInt
_contract_file
s
2500
services_cost
text
2500
services_cost
_files
ArrayOfInt
tariffs
tariffs_files
text
ArrayOfInt
Обязател
ьность
Описание
средств на ремонт,
модернизацию и
благоустройство за
отчетный период.
(Описано в Таблица 42)
Оплачено КУ по
показаниям
общедомовых ПУ за
отчетный период.
(Описано в Таблица 43)
Оплачено КУ по счетам
на общедомовые
нужды за отчетный
период. (Описано в
Таблица 44)
Проект договора
управления
Массив
идентификаторов
файлов. Если
идентификатор файла
не указан - это означает
удаление файла из
анкеты.
Стоимость услуг
Массив
идентификаторов
файлов. Если
идентификатор файла
не указан - это означает
удаление файла из
анкеты.
Тарифы
Массив
идентификаторов
файлов. Если
идентификатор файла
не указан - это означает
удаление файла из
анкеты.
2500
35
Таблица 23– Описание типа FiasAddress
Категория
Параметр
Тип
FiasAddress city_id
character
varying
street_id
character
varying
house_numbe character
r
varying
building
character
varying
block
character
varying
room_numbe character
r
varying
letter
character
varying
Max
символов
36
Обязател
ьность
36
Да
36
Описание
Идентификатор города
(GUID из ФИАС)
Идентификатор улицы
(GUID из ФИАС)
Номер дома
36
Строение
36
Корпус
36
Номер квартиры
36
Литера
Таблица 24– Описание типа CountHousesUnderMngReportDate
Категория
Параметр
Тип
CountHouse count_houses decimal
sUnderMng _under_mng_
ReportDate report_date
Max
символов
15.2
Обязател
ьность
Описание
Домов под
управлением на
отчетную дату. Всего
serviced_by_
tsg
decimal
15.2
Домов, обслуживаемых
ТСЖ, на отчетную дату
serviced_by_
tsg_uo
decimal
15.2
serviced_by_
owner_uo
decimal
15.2
serviced_by_
competition
decimal
15.2
Домов, обслуживаемых
по договору между
ТСЖ и управляющей
организацией, на
отчетную дату
Домов, обслуживаемых
по договору между
собственниками и
управляющей
организацией, на
отчетную дату
Домов, обслуживаемых
по результатам
открытого конкурса
органов местного
36
самоуправления, на
отчетную дату
Таблица 25– Описание типа CountHousesUnderMngStartPeriod
Категория
Параметр
Тип
CountHouse count_houses decimal
sUnderMng _under_mng_
StartPeriod start_period
Max
символов
15.2
serviced_by_
tsg
decimal
15.2
serviced_by_
tsg_uo
decimal
15.2
serviced_by_
owner_uo
decimal
15.2
serviced_by_
competition
decimal
15.2
Обязател
ьность
Описание
Количество домов под
управлением на начало
периода
Домов, обслуживаемых
ТСЖ, на начало
периода
Домов, обслуживаемых
по договору между
ТСЖ и управляющей
организацией, на
начало периода
Домов, обслуживаемых
по договору между
собственниками и
управляющей
организацией, на
начало периода
Домов, обслуживаемых
по результатам
открытого конкурса
органов местного
самоуправления, на
начало периода
Таблица 26– Описание типа SumSqHousesUnderMngReportDate
Категория
Параметр
Тип
SumSqHous sum_sq_hous decimal
esUnderMn es_under_mn
gReportDat g_report_date
e
Max
символов
15.2
by_houses_2
5
decimal
15.2
by_houses_2
6_50
decimal
15.2
Обязател
ьность
Описание
Общая площадь домов
под управлением на
отчетную дату,
тыс.кв.м.
Общая площадь домов
под управлением на
отчетную дату по
домам до 25 лет
Общая площадь домов
под управлением на
37
Категория
Параметр
Тип
Max
символов
by_houses_5
1_75
decimal
15.2
by_houses_7
6
decimal
15.2
by_houses_al
arm
decimal
15.2
Обязател
ьность
Описание
отчетную дату по
домам от 26 до 50 лет
Общая площадь домов
под управлением на
отчетную дату по
домам от 51 до 75 лет
Общая площадь домов
под управлением на
отчетную дату по
домам 76 лет и более
Общая площадь домов
под управлением на
отчетную дату по
аварийным домам
Таблица 27– Описание типа SumSqHousesUnderMngStartPeriod
Категория
Параметр
Тип
SumSqHous sum_sq_hous
esUnderMn es_under_mn
gStartPeriod g_start_perio
d
sum_sq_hous
es_concluded
_contracts
decimal
Max
символов
15.2
decimal
15.2
sum_sq_hous
es_terminate
d_contracts
decimal
15.2
Обязател
ьность
Описание
Общая площадь домов
под управлением на
начало периода
Изменение общей
площади домов за
отчетный период по
заключенным
договорам, кв.м.
Изменение общей
площади домов за
отчетный период по
расторгнутым
договорам, кв.м.
Таблица 28– Описание типа AvgTimeServiceMkd
Категория
Параметр
Тип
AvgTimeSe
rviceMkd
avg_time_ser
vice_mkd
decimal
Max
символов
15.2
by_houses_2
5
decimal
15.2
38
Обязател
ьность
Описание
Средний срок
обслуживания
многоквартирного дома
Средний срок
обслуживания по
домам до 25 лет
Категория
Параметр
Тип
by_houses_2
6_50
decimal
Max
символов
15.2
by_houses_5
1_75
decimal
15.2
by_houses_7
6
decimal
15.2
by_houses_al
arm
decimal
15.2
Обязател
ьность
Описание
Средний срок
обслуживания по
домам от 26 до 50 лет
Средний срок
обслуживания по
домам от 51 до 75 лет
Средний срок
обслуживания по
домам 76 лет и более
Средний срок
обслуживания по
аварийным домам
Таблица 29– Описание типа IncomeOfMng
Категория
Параметр
Тип
IncomeOfM income_of_m decimal
ng
ng
Max
символов
15.2
by_houses_2
5
decimal
15.2
by_houses_2
6_50
decimal
15.2
by_houses_5
1_75
decimal
15.2
by_houses_7
6
decimal
15.2
by_houses_al
arm
decimal
15.2
Обязател
ьность
Описание
Доходы, полученные за
оказание услуг по
управлению
многоквартирными
домами, тыс.руб
Доход от управления за
отчетный период по
домам до 25 лет
Доход от управления за
отчетный период по
домам от 26 до 50 лет
Доход от управления за
отчетный период по
домам от 51 до 75 лет
Доход от управления за
отчетный период по
домам 76 лет и более
Доход от управления за
отчетный период по
аварийным домам
Таблица 30– Описание типа IncomeOfUsage
Категория
Параметр
Тип
IncomeOfU
sage
income_of_u
sage
decimal
Max
символов
15.2
39
Обязател
ьность
Описание
Сумма доходов,
полученных от
Категория
Параметр
Тип
Max
символов
by_houses_2
5
decimal
15.2
by_houses_2
6_50
decimal
15.2
by_houses_5
1_75
decimal
15.2
by_houses_7
6
decimal
15.2
by_houses_al
arm
decimal
15.2
Обязател
ьность
Описание
использования общего
имущества за отчетный
период, тыс.руб.
Доход от
использования общего
имущества за отчетный
период по домам до 25
лет
Доход от
использования общего
имущества за отчетный
период по домам от 26
до 50 лет
Доход от
использования общего
имущества за отчетный
период по домам от 51
до 75 лет
Доход от
использования общего
имущества за отчетный
период по домам 76 лет
и более
Доход от
использования общего
имущества за отчетный
период по аварийным
домам
Таблица 31– Описание типа IncomeOfKu
Категория
Параметр
Тип
IncomeOfK
u
income_of_k
u
decimal
Max
символов
15.2
by_heating
decimal
15.2
by_electro
decimal
15.2
40
Обязател
ьность
Описание
Доход от
предоставления КУ за
отчетный период
Доход от
предоставления
отопления за отчетный
период
Доход от
предоставления
электричества за
отчетный период
Категория
Параметр
Тип
by_gaz
decimal
Max
символов
15.2
by_hot_water
decimal
15.2
by_cold_wat
er
decimal
15.2
by_sewerage
decimal
15.2
Обязател
ьность
Описание
Доход от
предоставления газа за
отчетный период
Доход от
предоставления
горячего
водоснабжения за
отчетный период
Доход от
предоставления
холодного
водоснабжения за
отчетный период
Доход от
предоставления
водоотведения за
отчетный период
Таблица 32– Описание типа SpendingOfMng
Категория
Параметр
Тип
SpendingOf
Mng
spending_of_
mng
by_houses_2
5
decimal
Max
символов
15.2
decimal
15.2
by_houses_2
6_50
decimal
15.2
by_houses_5
1_75
decimal
15.2
by_houses_7
6
decimal
15.2
by_houses_al
arm
decimal
15.2
Обязател
ьность
Описание
Расходы на управление
за отчетный период
Расходы на управление
за отчетный период по
домам до 25 лет
Расходы на управление
за отчетный период по
домам от 26 до 50 лет
Расходы на управление
за отчетный период по
домам от 51 до 75 лет
Расходы на управление
за отчетный период по
домам 76 лет и более
Расходы на управление
за отчетный период по
аварийным домам
Таблица 33– Описание типа ClaimsByContractsMng
Категория
Параметр
Тип
Max
символов
41
Обязател
ьность
Описание
Категория
ClaimsByC
ontractsMn
g
Параметр
Тип
claims_by_co decimal
ntracts_mng
claims_for_d
amage
Max
символов
15.2
decimal
15.2
claims_for_re decimal
fusal
15.2
claims_for_s
hort_shipmen
t
15.2
decimal
Обязател
ьность
Описание
Выплаты по искам по
договорам управления
за отчетный период,
тыс. руб.
Выплаты по искам по
компенсации
нанесенного ущерба
Выплаты по искам по
снижению платы в
связи с неоказанием
услуг
Выплаты по искам по
снижению платы в
связи с недопоставкой
ресурсов
Таблица 34– Описание типа ClaimsByRso
Категория
Параметр
Тип
ClaimsByR
so
claims_by_rs
o
by_heating
decimal
Max
символов
15.2
decimal
15.2
by_electro
decimal
15.2
by_gaz
decimal
15.2
by_hot_water
decimal
15.2
by_cold_wat
er
decimal
15.2
by_sewerage
decimal
15.2
42
Обязател
ьность
Описание
Выплаты по искам РСО
за отчетный период
Выплаты по искам за
отопление за отчетный
период
Выплаты по искам за
электричество за
отчетный период
Выплаты по искам за
газ за отчетный период
Выплаты по искам за
горячее водоснабжение
за отчетный период
Выплаты по искам за
холодное
водоснабжение за
отчетный период
Выплаты по искам за
водоотведение за
отчетный период
Таблица 35– Описание типа DebtForMng
Категория
Параметр
Тип
DebtForMn
g
debt_for_mn
g
decimal
Max
символов
15.2
by_houses_2
5
decimal
15.2
by_houses_2
6_50
decimal
15.2
by_houses_5
1_75
decimal
15.2
by_houses_7
6
decimal
15.2
by_houses_al
arm
decimal
15.2
Обязател
ьность
Описание
Просроченная
задолженность
собственников за
услуги управления на
отчетную дату, тыс.
руб.
Просроченная
задолженность жителей
за услуги по
управлению за
отчетный период по
домам до 25 лет
Просроченная
задолженность жителей
за услуги по
управлению за
отчетный период по
домам от 26 до 50 лет
Просроченная
задолженность жителей
за услуги по
управлению за
отчетный период по
домам от 51 до 75 лет
Просроченная
задолженность жителей
за услуги по
управлению за
отчетный период по
домам 76 лет и более
Просроченная
задолженность жителей
за услуги по
управлению за
отчетный период по
аварийным домам
Таблица 36– Описание типа DebtOwnersForKu
Категория
Параметр
Тип
Max
символов
43
Обязател
ьность
Описание
Категория
Параметр
Тип
DebtOwner
sForKu
debt_owners
_for_ku
decimal
Max
символов
15.2
by_heating
decimal
15.2
by_electro
decimal
15.2
by_gaz
decimal
15.2
by_hot_water
decimal
15.2
by_cold_wat
er
decimal
15.2
by_sewerage
decimal
15.2
Обязател
ьность
Описание
Просроченная
задолженность
собственников за КУ на
отчетную дату
Просроченная
задолженность
собственников за
отопление на отчетную
дату
Просроченная
задолженность
собственников за
электричество на
отчетную дату
Просроченная
задолженность
собственников за газ на
отчетную дату
Просроченная
задолженность
собственников за
горячее водоснабжение
на отчетную дату
Просроченная
задолженность
собственников за
холодное
водоснабжение на
отчетную дату
Просроченная
задолженность
собственников за
водоотведение на
отчетную дату
Таблица 37– Описание типа DebtUoForKu
Категория
Параметр
DebtUoFor
Ku
debt_uo_for_
ku
Тип
decimal
Max
символов
15.2
44
Обязател
ьность
Описание
Просроченная
задолженность
организации за
предоставленные
коммунальные услуги,
Категория
Параметр
Тип
Max
символов
by_heating
decimal
15.2
by_electro
decimal
15.2
by_gaz
decimal
15.2
by_hot_water
decimal
15.2
by_cold_wat
er
decimal
15.2
by_sewerage
decimal
15.2
Обязател
ьность
Описание
накопленная за весь
период обслуживания
на отчетную дату
Задолженность
управляющей
организации за
отопление на отчетную
дату
Задолженность
управляющей
организации за
электричество на
отчетную дату
Задолженность
управляющей
организации за газ на
отчетную дату
Задолженность
управляющей
организации за горячее
водоснабжение на
отчетную дату
Задолженность
управляющей
организации за
холодное
водоснабжение на
отчетную дату
Задолженность
управляющей
организации за
водоотведение на
отчетную дату
Таблица 38– Описание типа ChargedForMng
Категория
Параметр
Тип
ChargedFor
Mng
charged_for_
mng
decimal
Max
символов
15.2
45
Обязател
ьность
Описание
Сумма взысканной за
отчетный период
просроченной
задолженности
собственников
помещений и иных лиц,
Категория
Параметр
Тип
Max
символов
by_houses_2
5
decimal
15.2
by_houses_2
6_50
decimal
15.2
by_houses_5
1_75
decimal
15.2
by_houses_7
6
decimal
15.2
by_houses_al
arm
decimal
15.2
Обязател
ьность
Описание
пользующихся или
проживающих в
помещениях на
законных основаниях
за услуги по
управлению, тыс. руб.
Взыскано с
собственников за
услуги управления за
отчетный период по
домам до 25 лет
Взыскано с
собственников за
услуги управления за
отчетный период по
домам от 26 до 50 лет
Взыскано с
собственников за
услуги управления за
отчетный период по
домам от 51 до 75 лет
Взыскано с
собственников за
услуги управления за
отчетный период по
домам 76 лет и более
Взыскано с
собственников за
услуги управления за
отчетный период по
аварийным домам
Таблица 39– Описание типа ChargedForResources
Категория
Параметр
Тип
ChargedFor
Resources
charged_for_
resources
decimal
Max
символов
15.2
by_heating
decimal
15.2
by_electro
decimal
15.2
46
Обязател
ьность
Описание
Взыскано с
собственников за КУ за
отчетный период
Взыскано с
собственников за
отопление за отчетный
период
Взыскано с
Категория
Параметр
Тип
Max
символов
by_gaz
decimal
15.2
by_hot_water
decimal
15.2
by_cold_wat
er
decimal
15.2
by_sewerage
decimal
15.2
Обязател
ьность
Описание
собственников за
электричество за
отчетный период
Взыскано с
собственников за газ за
отчетный период
Взыскано с
собственников за
горячее водоснабжение
за отчетный период
Взыскано с
собственников за
холодное
водоснабжение за
отчетный период
Взыскано с
собственников за
водоотведение за
отчетный период
Таблица 40– Описание типа SpendingRepair
Категория
Параметр
Тип
SpendingRe
pair
spending_rep
air
decimal
Max
символов
15.2
by_houses_2
5
decimal
15.2
by_houses_2
6_50
decimal
15.2
by_houses_5
1_75
decimal
15.2
by_houses_7
6
decimal
15.2
by_houses_al
decimal
15.2
47
Обязател
ьность
Описание
Объем работ по
ремонту за отчетный
период, тыс.руб.
Объем работ по
ремонту за отчетный
период по домам до 25
лет
Объем работ по
ремонту за отчетный
период по домам от 26
до 50 лет
Объем работ по
ремонту за отчетный
период по домам от 51
до 75 лет
Объем работ по
ремонту за отчетный
период по домам 76 лет
и более
Объем работ по
ремонтуза отчетный
период по аварийным
домам
arm
Таблица 41– Описание типа SpendingBeauty
Категория
Параметр
Тип
SpendingBe
auty
spending_bea
ty
decimal
Max
символов
15.2
by_houses_2
5
decimal
15.2
by_houses_2
6_50
decimal
15.2
by_houses_5
1_75
decimal
15.2
by_houses_7
6
decimal
15.2
by_houses_al
arm
decimal
15.2
Обязател
ьность
Описание
Объем работ по
благоустройству за
отчетный период
Объем работ по
благоустройству за
отчетный период по
домам до 25 лет
Объем работ по
благоустройству за
отчетный период по
домам от 26 до 50 лет
Объем работ по
благоустройству за
отчетный период по
домам от 51 до 75 лет
Объем работ по
благоустройству за
отчетный период по
домам 76 лет и более
Объем работ по
благоустройству
отчетный период по
аварийным домам
Таблица 42– Описание типа SpendingRepairInvests
Категория
Параметр
Тип
SpendingRe
pairInvests
spending_rep
air_invests
decimal
Max
символов
15.2
subsidy
credits
fin_lising
decimal
decimal
decimal
15.2
15.2
15.2
fin_service
decimal
15.2
48
Обязател
ьность
Описание
Объем привлеченных
средств за отчетный
период
Субсидии
Кредиты
Финансирование по
договорам лизинга
Финансирование по
энергосервисным
договорам
contributions decimal
_residents
other_sources decimal
Целевые взносы
жителей
Другие источники
15.2
15.2
Таблица 43– Описание типа PayedKuByStatements
Категория
Параметр
Тип
PayedKuBy
Statements
payed_ku_by
_statements
decimal
Max
символов
15.2
by_heating
decimal
15.2
by_electro
decimal
15.2
by_gaz
decimal
15.2
by_hot_water
decimal
15.2
by_cold_wat
er
decimal
15.2
Обязател
ьность
Описание
Оплачено КУ по
показаниям
общедомовых ПУ за
отчетный период
Оплачено за отопление
по показаниям
общедомовых ПУ за
отчетный период
Оплачено за
электричество по
показаниям
общедомовых ПУ за
отчетный период
Оплачено за газ по
показаниям
общедомовых ПУ за
отчетный период
Оплачено за горячее
водоснабжение по
показаниям
общедомовых ПУ за
отчетный период
Оплачено за холодное
водоснабжение по
показаниям
общедомовых ПУ за
отчетный период
Таблица 44– Описание типа PayedKuByNeeds
Категория
Параметр
Тип
PayedKuBy
Needs
payed_ku_by
_needs
decimal
Max
символов
15.2
by_heating
decimal
15.2
49
Обязател
ьность
Описание
Оплачено КУ по счетам
на общедомовые
нужды за отчетный
период
Оплачено за отопление
по счетам на
Категория
Параметр
Тип
Max
символов
by_electro
decimal
15.2
by_gaz
decimal
15.2
by_hot_water
decimal
15.2
by_cold_wat
er
decimal
15.2
Обязател
ьность
Описание
общедомовые нужды за
отчетный период
Оплачено за
электричество по
счетам на
общедомовые нужды за
отчетный период
Оплачено за газ по
счетам на
общедомовые нужды за
отчетный период
Оплачено за горячее
водоснабжение по
счетам на
общедомовые нужды за
отчетный период
Оплачено за холодное
водоснабжение по
счетам на
общедомовые нужды за
отчетный период
Таблица 45– Возможные значения Okopf
Тип
Okopf
Код
1 10 00
1 10 51
1 10 64
1 20 00
1 21 00
1 21 65
1 21 66
1 22 00
1 22 47
1 22 67
1 30 00
1 40 00
1 41 00
1 42 00
1 50 00
Значения
Хозяйственные товарищества
Полные товарищества
Товарищества на вере (коммандитные товарищества)
Хозяйственные общества
Общества с ограниченной или дополнительной
ответственностью
Общества с ограниченной ответственностью
Общества с дополнительной ответственностью
Акционерные общества
Открытые акционерные общества
Закрытые акционерные общества
Хозяйственные партнерства
Производственные кооперативы (артели)
Сельскохозяйственные производственные кооперативы
Производственные кооперативы (кроме
сельскохозяйственных производственных кооперативов)
Унитарные предприятия
50
Тип
Код
1 51 00
1 51 41
1 51 43
1 52 00
1 52 41
1 52 42
1 52 43
1 53 00
1 90 00
2 01 00
2 01 02
2 01 03
2 01 04
2 01 07
2 02 00
2 02 10
2 02 11
2 04 00
2 05 00
2 06 00
2 06 01
2 06 03
2 06 05
2 06 08
2 09 00
2 09 01
2 09 03
2 09 04
2 09 05
2 09 06
2 10 01
2 80 00
2 80 01
2 80 04
2 80 05
Значения
Унитарные предприятия, основанные на праве оперативного
управления (казенные предприятия)
Федеральные казенные предприятия
Муниципальные казенные предприятия
Унитарные предприятия, основанные на праве
хозяйственного ведения
Федеральные государственные унитарные предприятия
Государственные унитарные предприятия субъектов
Российской Федерации
Муниципальные унитарные предприятия
Крестьянские (фермерские) хозяйства
Прочие юридические лица, являющиеся коммерческими
организациями
Потребительские кооперативы
Жилищные и жилищно-строительные кооперативы
Жилищные накопительные кооперативы
Кредитные потребительские кооперативы
Потребительские общества
Общественные организации (объединения)
Общественные движения
Органы общественной самодеятельности
Фонды
Некоммерческие партнерства
Ассоциации (союзы)
Ассоциации (союзы) экономического взаимодействия
субъектов Российской Федерации
Советы муниципальных образований субъектов Российской
Федерации
Союзы (ассоциации) кооперативов
Союзы потребительских обществ
Учреждения
Автономные учреждения
Бюджетные учреждения
Казенные учреждения
Общественные учреждения
Частные учреждения
Садоводческие, огороднические или дачные некоммерческие
товарищества
Юридические лица, являющиеся некоммерческими
организациями, не включенные в другие группировки
Автономные некоммерческие организации
Государственные компании
Государственные корпорации
51
Тип
Код
2 80 13
2 80 15
2 80 16
2 80 17
2 90 00
3 00 01
3 00 02
3 00 03
3 00 04
3 00 06
5 01 02
Значения
Объединения (союзы) крестьянских (фермерских) хозяйств
Товарищество собственников недвижимости
Товарищества собственников жилья
Территориальные общественные самоуправления
Иные некоммерческие организации, не включенные в другие
группировки
Представительства юридических лиц
Филиалы юридических лиц
Обособленные подразделения юридических лиц
Структурные подразделения обособленных подразделений
юридических лиц
Простые товарищества
Индивидуальные предприниматели
3) Выходные параметры
В таблице представлены выходные параметры метода (Таблица 46).
Таблица 46– Выходные параметры метода SetCompanyProfile в случае ошибочного
выполнения
Категория
SoapFault
Параметр
code
name
description
Тип
Max
символов
Обязател
ьность
Описание
Код результата запроса
Наименование
Описание
integer
text
text
4) Пример вызова метода
SOAP-запрос:
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:api="http://api.reformagkh.ru/api">
<soapenv:Header>
<authenticate
xsi:type="xsd:string">r3r3ct27sala7p283h4btkpe75</authenticate>
</soapenv:Header>
<soapenv:Body>
<api:SetCompanyProfile
soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<inn xsi:type="xsd:string">?</inn>
<reporting_period_id xsi:type="xsd:int">?</reporting_period_id>
<data xsi:type="api:CompanyProfileData">
<work_time xsi:type="xsd:string">?</work_time>
<additional_info xsi:type="xsd:string">?</additional_info>
<participation_in_associations
xsi:type="xsd:string">?</participation_in_associations>
<srf_count xsi:type="xsd:int">?</srf_count>
<mo_count xsi:type="xsd:int">?</mo_count>
<offices_count xsi:type="xsd:int">?</offices_count>
<staff_regular_total xsi:type="xsd:int">?</staff_regular_total>
52
<staff_regular_administrative
xsi:type="xsd:int">?</staff_regular_administrative>
<staff_regular_engineers
xsi:type="xsd:int">?</staff_regular_engineers>
<staff_regular_labor xsi:type="xsd:int">?</staff_regular_labor>
<count_dismissed xsi:type="xsd:int">?</count_dismissed>
<count_dismissed_admins
xsi:type="xsd:int">?</count_dismissed_admins>
<count_dismissed_engineers
xsi:type="xsd:int">?</count_dismissed_engineers>
<count_dismissed_workers
xsi:type="xsd:int">?</count_dismissed_workers>
<accidents_count xsi:type="xsd:int">?</accidents_count>
<prosecute_count xsi:type="xsd:int">?</prosecute_count>
<prosecute_copies_of_documents
xsi:type="xsd:string">?</prosecute_copies_of_documents>
<tsg_management_members
xsi:type="xsd:string">?</tsg_management_members>
<audit_commision_members
xsi:type="xsd:string">?</audit_commision_members>
<additional_info_freeform
xsi:type="xsd:string">?</additional_info_freeform>
<residents_count xsi:type="xsd:int">?</residents_count>
<count_houses_under_mng_report_date
xsi:type="api:CountHousesUnderMngReportDate">
<count_houses_under_mng_report_date
xsi:type="xsd:int">?</count_houses_under_mng_report_date>
<serviced_by_tsg xsi:type="xsd:int">?</serviced_by_tsg>
<serviced_by_tsg_uo xsi:type="xsd:int">?</serviced_by_tsg_uo>
<serviced_by_owner_uo
xsi:type="xsd:int">?</serviced_by_owner_uo>
<serviced_by_competition
xsi:type="xsd:int">?</serviced_by_competition>
</count_houses_under_mng_report_date>
<count_houses_under_mng_start_period
xsi:type="api:CountHousesUnderMngStartPeriod">
<count_houses_under_mng_start_period
xsi:type="xsd:int">?</count_houses_under_mng_start_period>
<serviced_by_tsg xsi:type="xsd:int">?</serviced_by_tsg>
<serviced_by_tsg_uo xsi:type="xsd:int">?</serviced_by_tsg_uo>
<serviced_by_owner_uo
xsi:type="xsd:int">?</serviced_by_owner_uo>
<serviced_by_competition
xsi:type="xsd:int">?</serviced_by_competition>
</count_houses_under_mng_start_period>
<sum_sq_houses_under_mng_report_date
xsi:type="api:SumSqHousesUnderMngReportDate">
<sum_sq_houses_under_mng_report_date
xsi:type="xsd:float">?</sum_sq_houses_under_mng_report_date>
<by_houses_25 xsi:type="xsd:float">?</by_houses_25>
<by_houses_26_50 xsi:type="xsd:float">?</by_houses_26_50>
<by_houses_51_75 xsi:type="xsd:float">?</by_houses_51_75>
<by_houses_76 xsi:type="xsd:float">?</by_houses_76>
<by_houses_alarm xsi:type="xsd:float">?</by_houses_alarm>
</sum_sq_houses_under_mng_report_date>
<sum_sq_houses_under_mng_start_period
xsi:type="api:SumSqHousesUnderMngStartPeriod">
<sum_sq_houses_under_mng_start_period
xsi:type="xsd:float">?</sum_sq_houses_under_mng_start_period>
<sum_sq_houses_concluded_contracts
xsi:type="xsd:float">?</sum_sq_houses_concluded_contracts>
<sum_sq_houses_terminated_contracts
xsi:type="xsd:float">?</sum_sq_houses_terminated_contracts>
53
</sum_sq_houses_under_mng_start_period>
<avg_time_service_mkd xsi:type="api:AvgTimeServiceMkd">
<avg_time_service_mkd
xsi:type="xsd:float">?</avg_time_service_mkd>
<by_houses_25 xsi:type="xsd:float">?</by_houses_25>
<by_houses_26_50 xsi:type="xsd:float">?</by_houses_26_50>
<by_houses_51_75 xsi:type="xsd:float">?</by_houses_51_75>
<by_houses_76 xsi:type="xsd:float">?</by_houses_76>
<by_houses_alarm xsi:type="xsd:float">?</by_houses_alarm>
</avg_time_service_mkd>
<income_of_mng xsi:type="api:IncomeOfMng">
<income_of_mng xsi:type="xsd:float">?</income_of_mng>
<by_houses_25 xsi:type="xsd:float">?</by_houses_25>
<by_houses_26_50 xsi:type="xsd:float">?</by_houses_26_50>
<by_houses_51_75 xsi:type="xsd:float">?</by_houses_51_75>
<by_houses_76 xsi:type="xsd:float">?</by_houses_76>
<by_houses_alarm xsi:type="xsd:float">?</by_houses_alarm>
</income_of_mng>
<income_of_usage xsi:type="api:IncomeOfUsage">
<income_of_usage xsi:type="xsd:float">?</income_of_usage>
<by_houses_25 xsi:type="xsd:float">?</by_houses_25>
<by_houses_26_50 xsi:type="xsd:float">?</by_houses_26_50>
<by_houses_51_75 xsi:type="xsd:float">?</by_houses_51_75>
<by_houses_76 xsi:type="xsd:float">?</by_houses_76>
<by_houses_alarm xsi:type="xsd:float">?</by_houses_alarm>
</income_of_usage>
<income_of_ku xsi:type="api:IncomeOfKu">
<income_of_ku xsi:type="xsd:float">?</income_of_ku>
<by_heating xsi:type="xsd:float">?</by_heating>
<by_electro xsi:type="xsd:float">?</by_electro>
<by_gaz xsi:type="xsd:float">?</by_gaz>
<by_hot_water xsi:type="xsd:float">?</by_hot_water>
<by_cold_water xsi:type="xsd:float">?</by_cold_water>
<by_sewerage xsi:type="xsd:float">?</by_sewerage>
</income_of_ku>
<spending_of_mng xsi:type="api:SpendingOfMng">
<spending_of_mng xsi:type="xsd:float">?</spending_of_mng>
<by_houses_25 xsi:type="xsd:float">?</by_houses_25>
<by_houses_26_50 xsi:type="xsd:float">?</by_houses_26_50>
<by_houses_51_75 xsi:type="xsd:float">?</by_houses_51_75>
<by_houses_76 xsi:type="xsd:float">?</by_houses_76>
<by_houses_alarm xsi:type="xsd:float">?</by_houses_alarm>
</spending_of_mng>
<claims_by_contracts_mng xsi:type="api:ClaimsByContractsMng">
<claims_by_contracts_mng
xsi:type="xsd:float">?</claims_by_contracts_mng>
<claims_for_damage xsi:type="xsd:float">?</claims_for_damage>
<claims_for_refusal
xsi:type="xsd:float">?</claims_for_refusal>
<claims_for_short_shipment
xsi:type="xsd:float">?</claims_for_short_shipment>
</claims_by_contracts_mng>
<claims_by_rso xsi:type="api:ClaimsByRso">
<claims_by_rso xsi:type="xsd:float">?</claims_by_rso>
<by_heating xsi:type="xsd:float">?</by_heating>
<by_electro xsi:type="xsd:float">?</by_electro>
<by_gaz xsi:type="xsd:float">?</by_gaz>
<by_hot_water xsi:type="xsd:float">?</by_hot_water>
<by_cold_water xsi:type="xsd:float">?</by_cold_water>
<by_sewerage xsi:type="xsd:float">?</by_sewerage>
</claims_by_rso>
<net_assets xsi:type="xsd:string">?</net_assets>
54
<annual_financial_statements
xsi:type="xsd:string">?</annual_financial_statements>
<revenues_expenditures_estimates
xsi:type="xsd:string">?</revenues_expenditures_estimates>
<performance_report xsi:type="xsd:string">?</performance_report>
<members_meetings_minutes
xsi:type="xsd:string">?</members_meetings_minutes>
<audit_commision_report
xsi:type="xsd:string">?</audit_commision_report>
<audit_report xsi:type="xsd:string">?</audit_report>
<debt_for_mng xsi:type="api:DebtForMng">
<debt_for_mng xsi:type="xsd:float">?</debt_for_mng>
<by_houses_25 xsi:type="xsd:float">?</by_houses_25>
<by_houses_26_50 xsi:type="xsd:float">?</by_houses_26_50>
<by_houses_51_75 xsi:type="xsd:float">?</by_houses_51_75>
<by_houses_76 xsi:type="xsd:float">?</by_houses_76>
<by_houses_alarm xsi:type="xsd:float">?</by_houses_alarm>
</debt_for_mng>
<debt_owners xsi:type="xsd:float">?</debt_owners>
<debt_owners_for_ku xsi:type="api:DebtOwnersForKu">
<debt_owners_for_ku
xsi:type="xsd:float">?</debt_owners_for_ku>
<by_heating xsi:type="xsd:float">?</by_heating>
<by_electro xsi:type="xsd:float">?</by_electro>
<by_gaz xsi:type="xsd:float">?</by_gaz>
<by_hot_water xsi:type="xsd:float">?</by_hot_water>
<by_cold_water xsi:type="xsd:float">?</by_cold_water>
<by_sewerage xsi:type="xsd:float">?</by_sewerage>
</debt_owners_for_ku>
<debt_uo_for_ku xsi:type="api:DebtUoForKu">
<debt_uo_for_ku xsi:type="xsd:float">?</debt_uo_for_ku>
<by_heating xsi:type="xsd:float">?</by_heating>
<by_electro xsi:type="xsd:float">?</by_electro>
<by_gaz xsi:type="xsd:float">?</by_gaz>
<by_hot_water xsi:type="xsd:float">?</by_hot_water>
<by_cold_water xsi:type="xsd:float">?</by_cold_water>
<by_sewerage xsi:type="xsd:float">?</by_sewerage>
</debt_uo_for_ku>
<debt_owners_communal
xsi:type="xsd:float">?</debt_owners_communal>
<charged_for_mng xsi:type="api:ChargedForMng">
<charged_for_mng xsi:type="xsd:float">?</charged_for_mng>
<by_houses_25 xsi:type="xsd:float">?</by_houses_25>
<by_houses_26_50 xsi:type="xsd:float">?</by_houses_26_50>
<by_houses_51_75 xsi:type="xsd:float">?</by_houses_51_75>
<by_houses_76 xsi:type="xsd:float">?</by_houses_76>
<by_houses_alarm xsi:type="xsd:float">?</by_houses_alarm>
</charged_for_mng>
<charged_for_resources xsi:type="api:ChargedForResources">
<charged_for_resources
xsi:type="xsd:float">?</charged_for_resources>
<by_heating xsi:type="xsd:float">?</by_heating>
<by_electro xsi:type="xsd:float">?</by_electro>
<by_gaz xsi:type="xsd:float">?</by_gaz>
<by_hot_water xsi:type="xsd:float">?</by_hot_water>
<by_cold_water xsi:type="xsd:float">?</by_cold_water>
<by_sewerage xsi:type="xsd:float">?</by_sewerage>
</charged_for_resources>
<spending_repair xsi:type="api:SpendingRepair">
<spending_repair xsi:type="xsd:float">?</spending_repair>
<by_houses_25 xsi:type="xsd:float">?</by_houses_25>
<by_houses_26_50 xsi:type="xsd:float">?</by_houses_26_50>
<by_houses_51_75 xsi:type="xsd:float">?</by_houses_51_75>
55
<by_houses_76 xsi:type="xsd:float">?</by_houses_76>
<by_houses_alarm xsi:type="xsd:float">?</by_houses_alarm>
</spending_repair>
<spending_beauty xsi:type="api:SpendingBeauty">
<spending_beauty xsi:type="xsd:float">?</spending_beauty>
<by_houses_25 xsi:type="xsd:float">?</by_houses_25>
<by_houses_26_50 xsi:type="xsd:float">?</by_houses_26_50>
<by_houses_51_75 xsi:type="xsd:float">?</by_houses_51_75>
<by_houses_76 xsi:type="xsd:float">?</by_houses_76>
<by_houses_alarm xsi:type="xsd:float">?</by_houses_alarm>
</spending_beauty>
<spending_repair_invests xsi:type="api:SpendingRepairInvests">
<spending_repair_invests
xsi:type="xsd:float">?</spending_repair_invests>
<subsidy xsi:type="xsd:float">?</subsidy>
<credits xsi:type="xsd:float">?</credits>
<fin_lising xsi:type="xsd:float">?</fin_lising>
<fin_service xsi:type="xsd:float">?</fin_service>
<contributions_residents
xsi:type="xsd:float">?</contributions_residents>
<other_sources xsi:type="xsd:float">?</other_sources>
</spending_repair_invests>
<payed_ku_by_statements xsi:type="api:PayedKuByStatements">
<payed_ku_by_statements
xsi:type="xsd:float">?</payed_ku_by_statements>
<by_heating xsi:type="xsd:float">?</by_heating>
<by_electro xsi:type="xsd:float">?</by_electro>
<by_gaz xsi:type="xsd:float">?</by_gaz>
<by_hot_water xsi:type="xsd:float">?</by_hot_water>
<by_cold_water xsi:type="xsd:float">?</by_cold_water>
</payed_ku_by_statements>
<payed_ku_by_needs xsi:type="api:PayedKuByNeeds">
<payed_ku_by_needs xsi:type="xsd:float">?</payed_ku_by_needs>
<by_heating xsi:type="xsd:float">?</by_heating>
<by_electro xsi:type="xsd:float">?</by_electro>
<by_gaz xsi:type="xsd:float">?</by_gaz>
<by_hot_water xsi:type="xsd:float">?</by_hot_water>
<by_cold_water xsi:type="xsd:float">?</by_cold_water>
</payed_ku_by_needs>
<management_contract
xsi:type="xsd:string">?</management_contract>
<services_cost xsi:type="xsd:string">?</services_cost>
<tariffs xsi:type="xsd:string">?</tariffs>
<okopf xsi:type="xsd:string">?</okopf>
<firstname xsi:type="xsd:string">?</firstname>
<surname xsi:type="xsd:string">?</surname>
<middlename xsi:type="xsd:string">?</middlename>
<position xsi:type="xsd:string">?</position>
<ogrn xsi:type="xsd:string">?</ogrn>
<date_assignment_ogrn
xsi:type="xsd:date">?</date_assignment_ogrn>
<name_authority_assigning_ogrn
xsi:type="xsd:string">?</name_authority_assigning_ogrn>
<legal_address xsi:type="api:FiasAddress">
<city_id xsi:type="xsd:string">?</city_id>
<street_id xsi:type="xsd:string">?</street_id>
<house_number xsi:type="xsd:string">?</house_number>
<building xsi:type="xsd:string">?</building>
<block xsi:type="xsd:string">?</block>
<room_number xsi:type="xsd:string">?</room_number>
</legal_address>
<actual_address xsi:type="api:FiasAddress">
<city_id xsi:type="xsd:string">?</city_id>
56
<street_id xsi:type="xsd:string">?</street_id>
<house_number xsi:type="xsd:string">?</house_number>
<building xsi:type="xsd:string">?</building>
<block xsi:type="xsd:string">?</block>
<room_number xsi:type="xsd:string">?</room_number>
</actual_address>
<post_address xsi:type="api:FiasAddress">
<city_id xsi:type="xsd:string">?</city_id>
<street_id xsi:type="xsd:string">?</street_id>
<house_number xsi:type="xsd:string">?</house_number>
<building xsi:type="xsd:string">?</building>
<block xsi:type="xsd:string">?</block>
<room_number xsi:type="xsd:string">?</room_number>
</post_address>
<phone xsi:type="xsd:string">?</phone>
<email xsi:type="xsd:string">?</email>
<site xsi:type="xsd:string">?</site>
<proportion_sf xsi:type="xsd:float">?</proportion_sf>
<proportion_mo xsi:type="xsd:float">?</proportion_mo>
</data>
</api:SetCompanyProfile>
</soapenv:Body>
</soapenv:Envelope>
SoapFault:
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="http://api.reformagkh.ru/api_document_literal"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<SOAP-ENV:Body>
<SOAP-ENV:Fault>
<faultcode>SOAP-ENV:Client</faultcode>
<faultstring>Mandatory field is null</faultstring>
<detail xsi:type="ns1:ErrorDetails">
<code>1009</code>
<name>Mandatory field is null</name>
<description>Обязательное поле «sessionId» не
заполнено</description>
</detail>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Отсутствие SoapFault означает успешное выполнение запроса.
5) Ошибки
Таблица 47 – Результаты вызова метода SetCompanyProfile
Code
(Код результата
запроса)
Name
(Наименование)
Description
(Описание)
401
Unauthorized
Неавторизованный запрос
403
Forbidden
Нет прав на выполнение запроса
500
Internal Server Error
Внутренняя ошибка сервера. Сервер
неспособен выполнить запрос.
57
Code
(Код результата
запроса)
Name
(Наименование)
Description
(Описание)
Попробуйте обратиться позже.
1007
Missing reporting period
Отчетный период с указанным
идентификатором не найден
1005
INN wasnt found
Управляющая организация с
указанным ИНН не найдена
1024
Missing OKOPF
ОКОПФ с указанным кодом не найдена
1027
Missing company profile in
this reporting period
Анкета управляющей организации за
указанный отчетный период не найдена
1020
External system has no
request
Внешняя система не подписана на
раскрытие данных по управляющей
организации
No permissions
У внешней системы нет разрешения на
раскрытие данных от управляющей
организации
1042
Reporting period is not
related to the Resolution 731
Данные по старым формам раскрытия
информации, согласно Постановлению
Правительства РФ № 731 от 23.09.2010
не относятся к запрашиваемому
отчетному периоду
1009
Mandatory field is null
Обязательное поле «НАЗВАНИЕ
ПОЛЯ» не заполнено
1010
Field "NAME" is not valid
Поле «НАЗВАНИЕ ПОЛЯ» заполнено
не верно
1021
5.6
Метод SetNewCompany
1) Описание метода
Метод подачи запроса на регистрацию новой управляющей организации.
Подтверждение регистрации управляющей организации производит модератор Фонда
согласно регламенту.
2) Входные данные
В таблице представлены входные параметры метода (Таблица 48).
Таблица 48 – Входные параметры метода SetNewCompany
Категор
ия
Параметр
Тип
Max
символов
58
Обязательн
ость
Описание
SetNewC inn
ompanyI
n
new_company_da
te
character
varying
NewCompany
ProfileData
12
Да
ИНН
Да
Массив данных
(Описано в
Таблица 49)
Таблица 49– Массив данных (NewCompanyProfileData) метода SetNewCompany
Категор
Параметр
ия
NewCom name_full
panyProf
ileData
name_short
okopf
surname
middlename
firstname
ogrn
legal_address
actual_address
post_address
phone
Тип
character
varying
character
varying
Okopf
character
varying
character
varying
character
varying
character
varying
FiasAddress
Max
символов
255
Обязательн
ость
Да
255
Да
Да
255
255
Полное
наименование
Краткое
наименование
ОКОПФ.
Передается код
всероссийского
справочника
ОКОПФ в
формате «2 80
17». (Описано в
Таблица 45)
Фамилия
Отчество
255
Да
Имя
ОГРН
255
Да
Идентификатор
юридического
адреса
(описано в
Таблица 23)
Идентификатор
фактического
адреса
(описано в
FiasAddress
Таблица 23)
Идентификатор
почтового
адреса
(описано в
FiasAddress
text
Да
Описание
32
59
Таблица 23)
Контактный
Категор
ия
Параметр
Тип
Max
символов
email
character
varying
255
site
proportion_sf
text
decimal
2500
15.2
proportion_mo
decimal
15.2
Обязательн
ость
Описание
телефон
Электронный
адрес. Формат:
example@mail.r
u.
Интернет сайт
Доля участия в
уставном
капитале
Субъекта РФ,
%
Доля участия в
уставном
капитале
муниципальног
о образования,
%
3) Выходные параметры
В таблице представлены выходные параметры метода (Таблица 50).
Таблица 50– Выходные параметры метода SetNewCompany в случае ошибочного
выполнения
Категория
SoapFault
Параметр
code
name
description
Тип
Max
символов
Обязател
ьность
Описание
Код результата запроса
Наименование
Описание
integer
text
text
4) Пример вызова метода
SOAP-запрос:
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:api="https://api.reformagkh.ru/api">
<soapenv:Header>
<authenticate>29r2r9ln074jsnigave0pl3ue5</authenticate>
</soapenv:Header>
<soapenv:Body>
<api:SetNewCompany
soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<inn xsi:type="xsd:string">?</inn>
<new_company_data xsi:type="api:NewCompanyProfileData">
<!--You may enter the following 15 items in any order-->
<name_full xsi:type="xsd:string">?</name_full>
<name_short xsi:type="xsd:string">?</name_short>
<okopf xsi:type="api:Okopf">?</okopf>
60
<firstname xsi:type="xsd:string">?</firstname>
<surname xsi:type="xsd:string">?</surname>
<middlename xsi:type="xsd:string">?</middlename>
<ogrn xsi:type="xsd:string">?</ogrn>
<legal_address xsi:type="api:FiasAddress">
<!--You may enter the following 7 items in any order-->
<city_id xsi:type="xsd:string">?</city_id>
<street_id xsi:type="xsd:string">?</street_id>
<house_number xsi:type="xsd:string">?</house_number>
<building xsi:type="xsd:string">?</building>
<block xsi:type="xsd:string">?</block>
<room_number xsi:type="xsd:string">?</room_number>
<letter xsi:type="xsd:string">?</letter>
</legal_address>
<actual_address xsi:type="api:FiasAddress">
<!--You may enter the following 7 items in any order-->
<city_id xsi:type="xsd:string">?</city_id>
<street_id xsi:type="xsd:string">?</street_id>
<house_number xsi:type="xsd:string">?</house_number>
<building xsi:type="xsd:string">?</building>
<block xsi:type="xsd:string">?</block>
<room_number xsi:type="xsd:string">?</room_number>
<letter xsi:type="xsd:string">?</letter>
</actual_address>
<post_address xsi:type="api:FiasAddress">
<!--You may enter the following 7 items in any order-->
<city_id xsi:type="xsd:string">?</city_id>
<street_id xsi:type="xsd:string">?</street_id>
<house_number xsi:type="xsd:string">?</house_number>
<building xsi:type="xsd:string">?</building>
<block xsi:type="xsd:string">?</block>
<room_number xsi:type="xsd:string">?</room_number>
<letter xsi:type="xsd:string">?</letter>
</post_address>
<phone xsi:type="xsd:string">?</phone>
<email xsi:type="xsd:string">?</email>
<site xsi:type="xsd:string">?</site>
<proportion_sf xsi:type="xsd:float">?</proportion_sf>
<proportion_mo xsi:type="xsd:float">?</proportion_mo>
</new_company_data>
</api:SetNewCompany>
</soapenv:Body>
</soapenv:Envelope>
SoapFault:
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="http://api.reformagkh.ru/api_document_literal"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<SOAP-ENV:Body>
<SOAP-ENV:Fault>
<faultcode>SOAP-ENV:Client</faultcode>
<faultstring>Mandatory field is null</faultstring>
<detail xsi:type="ns1:ErrorDetails">
<code>1009</code>
<name>Mandatory field is null</name>
<description>Обязательное поле «sessionId» не
заполнено</description>
</detail>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
61
Отсутствие SoapFault означает успешное выполнение запроса.
5) Ошибки
Таблица 51 – Результаты вызова метода SetNewCompany
Code
(Код результата
запроса)
Name
(Наименование)
Description
(Описание)
401
Unauthorized
Неавторизованный запрос
403
Forbidden
Нет прав на выполнение запроса
500
Internal Server Error
Внутренняя ошибка сервера. Сервер
неспособен выполнить запрос.
Попробуйте обратиться позже.
1024
Missing OKOPF
ОКОПФ с указанным кодом не найдена
1032
The company with INN
already exist
Управляющая организация, с
указанным ИНН, уже зарегистрирована
в системе
1009
Mandatory field is null
Обязательное поле «НАЗВАНИЕ
ПОЛЯ» не заполнено
1010
Field "NAME" is not valid
Поле «НАЗВАНИЕ ПОЛЯ» заполнено
не верно
5.7
Метод GetHouseList
1) Описание метода
Метод получения списка домов, находящихся в управлении организации с
соответствующим ИНН (по каждому дому возвращается идентификатор дома и адрес по
ФИАС). Внешняя система может получать список домов в управлении организаций, по
которым разрешена подписка.
В результате запроса получения списка домов в управлении API - сервис может
вернуть несколько домов с одинаковым адресом. Внешняя система вправе раскрывать
информацию как по всем своим домам-дублям также и по одному из домов.
Необходимо прекратить управление домами, которым внешняя система не нашла
соответствия в своей системе.
2) Входные данные
В таблице представлены входные параметры метода (Таблица 52).
62
Таблица 52 – Входные параметры метода GetHouseList
Категор
Параметр
ия
GetHous inn
eList
Тип
Max
символов
12
character
varying
Обязательн
ость
Да
Описание
ИНН
3) Выходные параметры
В таблице представлены выходные параметры метода (Таблица 53).
Таблица 53– Выходные параметры метода GetHouseList
Категория
Параметр
GetHouseLi
stResponse
house_id
full_address
Тип
Max
символов
Обязател
ьность
Описание
Идентификатор дома
Адрес дома (Описано в
Таблица 55)
integer
FullAddress
Таблица 54– Выходные параметры метода GetHouseList в случае ошибочного выполнения
SoapFault
code
name
description
Код результата запроса
Наименование
Описание
integer
text
text
Таблица 55– Описание типа FullAddress
Категория
Параметр
Тип
FullAddress
region_guid
character
varying
region_forma
l_name
character
varying
Max
символов
36
120
region_short_ character
name
varying
region_code
character
varying
area_ guid
character
varying
12
area_formal_
name
character
varying
120
area_short_n
ame
area_code
character
varying
character
varying
character
varying
12
city1_ guid
17
36
17
36
63
Обязател
ьность
Описание
Идентификатор
региона
(GUID по ФИАС,
aolevel = 1)
Формализованное
наименование региона
(ФИАС)
Краткое наименование
типа региона (ФИАС)
Код региона из КЛАДР
4.0.
Идентификатор района
(GUID по ФИАС,
aolevel = 3)
Формализованное
наименование района
(ФИАС)
Краткое наименование
типа района (ФИАС)
Код района из КЛАДР
4.0.
Идентификатор города
(GUID по ФИАС,
Категория
Параметр
Тип
city1_formal
_name
character
varying
120
city1_short_n
ame
city1_code
character
varying
character
varying
character
varying
12
city2_formal
_name
character
varying
120
city2_short_n
ame
character
varying
12
city2_code
character
varying
17
city3_ guid
character
varying
36
city3_formal
_name
character
varying
120
city3_short_n
ame
character
varying
12
city3_code
character
varying
character
varying
17
character
varying
120
city2_ guid
street_ guid
street_formal
_name
street_short_
name
street_code
character
varying
character
varying
additional_ter character
ritory
varying
Max
символов
Обязател
ьность
Описание
aolevel = 4).
Формализованное
наименование города
(ФИАС)
Краткое наименование
типа города (ФИАС)
Код города из КЛАДР
4.0.
Идентификатор
внутригородской
территории
(GUID по ФИАС,
aolevel = 5).
Формализованное
наименование
внутригородской
территории (ФИАС)
Краткое наименование
внутригородской
территории (ФИАС)
Код внутригородской
территории из КЛАДР
4.0.
Идентификатор
населенного пункта
(GUID по ФИАС,
aolevel = 6).
Формализованное
наименование
населенного пункта
(ФИАС)
Краткое наименование
населенного пункта
(ФИАС)
Код населенного
пункта из КЛАДР 4.0.
Идентификатор улицы
(GUID по ФИАС,
aolevel = 7)
Формализованное
наименование улицы
(ФИАС)
Краткое наименование
типа улицы (ФИАС)
Код улицы из КЛАДР
4.0.
Идентификатор
дополнительной
территории (GUID по
17
36
36
12
17
36
64
Категория
Параметр
Тип
Max
символов
Обязател
ьность
Описание
additional_ter character
ritory_formal varying
_name
120
additional_ter
ritory_short_
name
additional_ter
ritory_code
character
varying
12
character
varying
17
house_numbe
r
building
block
letter
text
ФИАС, aolevel = 90)
Формализованное
наименование
дополнительной
территории (ФИАС)
Краткое наименование
типа дополнительной
территории (ФИАС)
Код дополнительной
территории из КЛАДР
4.0.
Номер дома
text
text
text
Строение
Корпус
Литера
4) Пример вызова метода
SOAP-запрос:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:api="http://api.reformagkh.ru/api_document_literal">
<soapenv:Header>
<authenticate>29r2r9ln074jsnigave0pl3ue5</authenticate>
</soapenv:Header>
<soapenv:Body>
<api:GetHouseList>
<inn>?</inn>
</api:GetHouseList>
</soapenv:Body>
</soapenv:Envelope>
SoapFault:
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="http://api.reformagkh.ru/api_document_literal"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<SOAP-ENV:Body>
<SOAP-ENV:Fault>
<faultcode>SOAP-ENV:Client</faultcode>
<faultstring>Unauthorized</faultstring>
<detail xsi:type="ns1:ErrorDetails">
<code>401</code>
<name>Unauthorized</name>
<description>Неавторизованный запрос</description>
</detail>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Отсутствие SoapFault означает успешное выполнение запроса.
5) Ошибки
65
Таблица 56 – Результаты вызова метода GetHouseList
Code
(Код результата
запроса)
Name
(Наименование)
Description
(Описание)
401
Unauthorized
Неавторизованный запрос
403
Forbidden
Нет прав на выполнение запроса
500
Internal Server Error
Внутренняя ошибка сервера. Сервер
неспособен выполнить запрос.
Попробуйте обратиться позже
1005
INN wasn’t found
Управляющая организация с
указанным ИНН не найдена
1020
External system has no
request
Внешняя система не подписана на
раскрытие данных по управляющей
организации
1009
Mandatory field is null
Обязательное поле «НАЗВАНИЕ
ПОЛЯ» не заполнено
1010
Field "NAME" is not valid
Поле «НАЗВАНИЕ ПОЛЯ» заполнено
не верно
5.8
Метод SetUnlinkFromOrganization
1) Описание метода
Метод прекращения управления домом с соответствующим идентификатором.
Внешняя система может прекращать управление только теми домами, которые находятся
в управлении организаций, по которым внешней системе разрешена подписка на
раскрытие.
2) Входные данные
В таблице представлены входные параметры метода (Таблица 57).
Таблица 57 – Входные параметры метода SetUnlinkFromOrganization
Категор
Параметр
ия
SetUnlin house_id
kFromOr
ganizatio date_stop
nIn
stop_reason_type
Тип
Max
символов
Обязательн
ость
Да
Описание
Идентификатор
дома
Дата
При
stop_reason_t прекращения
ype !=1, поле обслуживания
обязательно,
а иначе не
заполняется
Основание
Да
bigint
date
ContractStopR
66
прекращения
обслуживания
(Описано в
Таблица 58)
Причина
При
stop_reason_t завершения
ype !=1, поле обслуживания
обязательно,
а иначе не
заполняется
easonEnum
stop_reason
text
2500
Таблица 58– Возможные значения ContractStopReasonEnum
Тип
ContractStopReasonEn
um
Идентификатор
Значения
Дом был включен в список по ошибке
Прекращение договора управления /
Выбор иного способа управления
Дом исключен из реестра лицензий
субъекта РФ на основании решения
лицензирующего органа
Вступление в законную силу решения
суда об аннулировании лицензии
Дом исключен на основании отказа в
выдаче лицензии
1
2
3
4
5
3) Выходные параметры
В таблице представлены выходные параметры метода (Таблица 59).
Таблица 59– Выходные параметры метода SetUnlinkFromOrganization в случае
ошибочного выполнения
Категория
SoapFault
Параметр
code
name
description
Тип
Max
символов
Обязател
ьность
Описание
Код результата запроса
Наименование
Описание
integer
text
text
4) Пример вызова метода
SOAP-запрос:
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:api="http://api.reformagkh.ru/api">
<soapenv:Header>
<authenticate
xsi:type="xsd:string">r3r3ct27sala7p283h4btkpe75</authenticate>
</soapenv:Header>
<soapenv:Body>
67
<api:SetUnlinkFromOrganization
soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<house_id xsi:type="xsd:int">?</house_id>
<date_stop xsi:type="xsd:date">?</date_stop>
<stop_reason_type
xsi:type="api:ContractStopReasonEnum">?</stop_reason_type>
<stop_reason xsi:type="xsd:string">?</stop_reason>
</api:SetUnlinkFromOrganization>
</soapenv:Body>
</soapenv:Envelope>
SoapFault:
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="http://api.reformagkh.ru/api"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<SOAP-ENV:Body>
<SOAP-ENV:Fault>
<faultcode>SOAP-ENV:Client</faultcode>
<faultstring>Mandatory field is null</faultstring>
<detail xsi:type="ns1:ErrorDetails">
<code>1009</code>
<name>Mandatory field is null</name>
<description>Обязательное поле «sessionId» не
заполнено</description>
</detail>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Отсутствие SoapFault означает успешное выполнение запроса.
5) Ошибки
Таблица 60 – Результаты вызова метода SetUnlinkFromOrganization
Code
(Код результата
запроса)
Name
(Наименование)
Description
(Описание)
401
Unauthorized
Неавторизованный запрос
403
Forbidden
Нет прав на выполнение запроса
500
Internal Server Error
Внутренняя ошибка сервера. Сервер
неспособен выполнить запрос.
Попробуйте обратиться позже.
1004
House wasn’t found
Дом с указанным идентификатором не
найден
1011
House is not in company
Дом, находится в управлении другой
организации «ИНН, НАЗВАНИЕ», по
которой нет подписки
1036
House unlinked already
Управление домом уже прекращено
1005
INN wasn’t found
Управляющая организация с
указанным ИНН не найдена
1013
Missing management date
Не заполнена дата начала управления
68
Code
(Код результата
запроса)
Name
(Наименование)
Description
(Описание)
домом. Прежде чем прекратить
управление домом, Вам необходимо
заполнить дату начала управления с
помощью метода SetHouseProfile.
1009
Mandatory field is null
Обязательное поле «НАЗВАНИЕ
ПОЛЯ» не заполнено
1010
Field "NAME" is not valid
Поле «НАЗВАНИЕ ПОЛЯ» заполнено
не верно
5.9
Метод SetHouseLinkToOrganization
1) Описание метода
Метод добавления дома, с соответствующим идентификатором, в управление
организации с соответствующим ИНН. Внешняя система может добавлять дома в
управление только тех организаций, по которым внешней системе разрешена подписка на
раскрытие.
2) Входные данные
В таблице представлены входные параметры метода (Таблица 61).
Таблица 61 – Входные параметры метода SetHouseLinkToOrganization
Категор
Параметр
ия
SetHouse house_id
LinkToO
rganizati inn
onIn
Тип
Max
символов
bigint
character
varying
date_start
date
management_reas
on
character
varying
12
Обязательн
ость
Да
Описание
Идентификатор
дома
ИНН
управляющей
организации
Дата начала
управления
Основание
взятия в
управления
домом
Да
Да
255
Да
3) Выходные параметры
В таблице представлены выходные параметры метода (Таблица 62).
Таблица 62– Выходные параметры метода SetHouseLinkToOrganization в случае
ошибочного выполнения
Категория
SoapFault
Параметр
code
Тип
Max
символов
Обязател
ьность
Описание
Код результата запроса
integer
69
name
description
Наименование
Описание
text
text
4) Пример вызова метода
SOAP-запрос:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:api="https://api.reformagkh.ru/api_document_literal">
<soapenv:Header>
<authenticate>29r2r9ln074jsnigave0pl3ue5</authenticate>
</soapenv:Header>
<soapenv:Body>
<api:SetHouseLinkToOrganization>
<house_id>?</house_id>
<inn>?</inn>
<date_start>?</date_start>
<management_reason>?</management_reason>
</api:SetHouseLinkToOrganization>
</soapenv:Body>
</soapenv:Envelope>
SoapFault:
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="http://api.reformagkh.ru/api"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<SOAP-ENV:Body>
<SOAP-ENV:Fault>
<faultcode>SOAP-ENV:Client</faultcode>
<faultstring>Mandatory field is null</faultstring>
<detail xsi:type="ns1:ErrorDetails">
<code>1009</code>
<name>Mandatory field is null</name>
<description>Обязательное поле «sessionId» не
заполнено</description>
</detail>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Отсутствие SoapFault означает успешное выполнение запроса.
5) Ошибки
Таблица 63 – Результаты вызова метода SetHouseLinkToOrganization
Code
(Код результата
запроса)
Name
(Наименование)
Description
(Описание)
401
Unauthorized
Неавторизованный запрос
403
Forbidden
Нет прав на выполнение запроса
500
Internal Server Error
Внутренняя ошибка сервера. Сервер
неспособен выполнить запрос.
Попробуйте обратиться позже.
1004
House wasn’t found
Дом с указанным идентификатором не
70
найден
INN wasn’t found
Управляющая организация с
указанным ИНН не найдена
1011
House is not in company
Дом, находится в управлении другой
организации «ID УО, ИНН,
НАЗВАНИЕ», по которой нет
подписки
1012
House under the management
Дом уже под управлением
1009
Mandatory field is null
Обязательное поле «НАЗВАНИЕ
ПОЛЯ» не заполнено
1010
Field "NAME" is not valid
Поле «НАЗВАНИЕ ПОЛЯ» заполнено
не верно
1005
5.10 Метод SetHouseProfile
1) Описание метода
Метод изменяет данные текущей/архивной анкеты дома с соответствующим
идентификатором дома. Внешняя система может изменять данные текущих анкет домов в
управлении организаций, по которым разрешена подписка. Проверка на принадлежность
дома управляющей организации, по которой есть разрешение на подписку раскрытия
данных.
2) Входные данные
В таблице представлены входные параметры метода (Таблица 64).
Таблица 64 – Входные параметры метода SetHouseProfile
Категор
Параметр
ия
SetHouse house_id
ProfileIn
reporting_period_
id
data
Тип
bigint
Обязательн
ость
Да
integer
Да
HouseProfile
Data
Да
Max
символов
Описание
Идентификатор
дома
Идентификатор
отчетного
периода
Массив данных
(Описано в
Таблица 65)
Таблица 65– Массив данных (HouseProfileData) метода SetHouseProfile
Категор
Параметр
ия
HousePr area_total
Тип
decimal
Max
символов
15.2
71
Обязательн
ость
Да
Описание
Общая
площадь
Категор
ия
ofileData
Параметр
area_residental
Тип
Max
символов
decimal
15.2
area_non_resident decimal
al
15.2
cadastral_number
text
exploitation_start
_year
project_type
text
character
varying
character
varying
255
individual_name
character
varying
255
house_type
HouseTypeEn
um
wall_material
HouseWallMa
terialEnum
floor_type
HouseFloorTy
peEnum
storeys_count
entrance_count
integer
integer
elevators_count
integer
area_private
area_municipal
decimal
decimal
location_descripti
on
255
15.2
15.2
72
Обязательн
ость
Описание
помещений
В том числе
жилых
помещений
Общая
площадь
нежилых
помещений
Кадастровый
номер
Год ввода в
эксплуатацию
Серия, тип
проекта
Описание
местоположени
я
Индивидуально
е наименование
дома
Идентификатор
типа жилого
дома
(Описано в
Таблица 68)
Идентификатор
материала
несущих стен
(Описание в
Таблица 69)
Идентификатор
типа
перекрытий
(Описание в
Таблица 70)
Этажность
Количество
подъездов
Количество
лифтов
Частная
Муниципальна
я
Категор
ия
Параметр
Тип
area_national
decimal
Max
символов
15.2
area_land
decimal
15.2
area_territory
decimal
15.2
inventory_numbe
r
flats_count
character
varying
bigint
255
residents_count
text
accounts_count
bigint
constuction_featu
res
character
varying
255
thermal_actual_e
xpense
decimal
15.2
thermal_normativ
e_expense
decimal
15.2
energy_efficiency
HouseEnergy
EfficiencyClas
sEnum
energy_audit_dat
e
date
privatization_start
_date
deterioration_tota
l
deterioration_fou
ndation
deterioration_bear
date
decimal
15.2
decimal
15.2
decimal
15.2
73
Обязательн
ость
Описание
Государственн
ая
Площадь
участка, м2
Площадь
придомовой
территории, м2
Инвентарный
номер
Количество
квартир
Количество
жителей
Количество
лицевых счетов
Конструктивны
е особенности
дома
фактический
удельный
расход,
Вт/М3Сград
нормативный
удельный
расход,
Вт/М3Сград
Идентификатор
класса
энергоэффекти
вности
(Описано в
Таблица 71)
Дата
проведения
энергетическог
о аудита
Дата начала
приватизации
Общая степень
износа
Степень износа
фундамента
Степень износа
Категор
ия
Параметр
ing_walls
deterioration_floo
r
facade
Тип
decimal
Max
символов
15.2
Facade
roof
Roof
basement
Basement
common_space
CommonSpac
e
chute
Chute
heating_system
HeatingSyste
m
hot_water_system
HotWaterSyst
em
cold_water_syste
m
ColdWaterSys
tem
sewerage_system
SewerageSyst
em
electricity_system
ElectricitySyst
em
74
Обязательн
ость
Описание
несущих стен
Степень износа
перекрытий
Фасад
(Описано в
Таблица 72)
Кровля
(Описано в
Таблица 73)
Подвал
(Описание в
Таблица 74)
Помещения
общего
пользования
(Описание в
Таблица 76)
Мусоропровод
ы (Описание в
Таблица 77)
Система
отопления
(Описание в
Таблица 78)
Система
горячего
водоснабжения
(Описание в
Таблица 81)
Система
холодного
водоснабжения
(Описание в
Таблица 83)
Система
водоотведения
(канализация).
(Описание в
Таблица 85)
Система
электроснабже
ния (Описание
в Таблица 87)
Категор
ия
Параметр
Тип
gas_system
GasSystem
lifts
Lift
Max
символов
Provider
electricity_provid
er
Provider
gas_provider
Provider
hot_water_provid
er
Provider
cold_water_provi
der
Provider
drainage_provider Provider
finance
Описание
Система
газоснабжения
(Описание в
Таблица 89)
Лифт
(Описание в
Таблица 91)
Управление
(Описание в
Таблица 92)
Поставщик
отопления
(Описание в
Таблица 94)
Поставщик
электричества
(Описание в
Таблица 94)
Поставщик газа
(Описание в
Таблица 94)
Поставщик
горячей воды
(Описание в
Таблица 94)
Поставщик
холодной воды
(Описание в
Таблица 94)
Поставщик
водоотведения
(Описание в
Таблица 94)
Финансы
(Описание в
Таблица 95)
management_cont ManagementC
ract
ontract
heating_provider
Обязательн
ость
Finance
Таблица 66– Возможные значения HouseStateEnum
Тип
HouseStateEnum
Идентификатор
Значения
1
2
3
normal
warning
alarm
75
Тип
Идентификатор
Значения
4
noinfo
Таблица 67– Возможные значения HouseStageEnum
Тип
HouseStageEnum
Идентификатор
Значения
exploited
decommissioned – пока запретили
изменение
drifting – пока запретили изменение
1
2
3
Таблица 68– Возможные значения HouseTypeEnum
Тип
HouseTypeEnum
Идентификатор
Значения
Общежитие
Объект индивидуального жилищного
строительства
Жилой дом блокированной застройки
Многоквартирный дом
1
2
3
4
Таблица 69– Возможные значения HouseWallMaterialEnum
Тип
HouseWallMaterialEnu
m
Идентификатор
Значения
Нет данных
Каменные, кирпичные
Панельные
Блочные
Смешанные
Монолитные
Деревянные
Прочие
1
2
3
4
5
6
7
8
Таблица 70– Возможные значения HouseFloorTypeEnum
Тип
HouseFloorTypeEnum
Идентификатор
Значения
Нет данных
Железобетонные
Деревянные
Смешанные
1
2
3
4
Таблица 71– Возможные значения HouseEnergyEfficiencyClassEnum
Тип
HouseEnergyEfficiency
ClassEnum
Идентификатор
Значения
Нет данных
Не присвоен
A
B
1
2
3
4
76
Тип
Идентификатор
Значения
5
6
7
8
9
B+
B++
C
D
E
Таблица 72– Описание типа Facade
Тип
Facade
Параметр
Тип
area_total
decimal
Max
символов
15.2
area_plastere
d
area_unplaste
red
area_panel
decimal
15.2
decimal
15.2
decimal
15.2
area_tiled
decimal
15.2
area_lined_si
ding
decimal
15.2
area_wooden
decimal
15.2
area_insulate
d_decorative
_plaster
decimal
15.2
area_insulate
d_tiles
decimal
15.2
area_insulate
d_siding
decimal
15.2
area_riprap
area_glazing
_common_w
ooden
decimal
decimal
15.2
15.2
area_glazing
_common_pl
decimal
15.2
Обязател
ьность
Описание
Площадь фасада общая,
м2
Площадь фасада
оштукатуренная, м2
Площадь фасада
неоштукатуренная, м2
Площадь фасада
панельная, м2
Площадь фасада,
облицованная плиткой,
м2
Площадь фасада,
облицованная
сайдингом, м2
Площадь фасада
деревянная, м2
Площадь утепленного
фасада с отделкой
декоративной
штукатуркой, м2
Площадь утепленного
фасада с отделкой
плиткой, м2
Площадь утепленного
фасада с отделкой
сайдингом, м2
Площадь отмостки, м2
Площадь остекления
мест общего
пользования (дерево),
м2
Площадь остекления
мест общего
77
Тип
Параметр
Тип
Max
символов
Обязател
ьность
Описание
пользования (пластик),
м2
astic
area_glazing
_individual_
wooden
area_door_fil
lings_metal
decimal
15.2
decimal
15.2
area_door_fil
lings_others
last_overhaul
_date
decimal
15.2
Площадь
индивидуального
остекления (дерево), м2
Площадь
металлических дверных
заполнений, м2
Площадь иных дверных
заполнений, м2
Год проведения
последнего
капитального ремонта
text
Таблица 73– Описание типа Roof
Тип
Roof
Параметр
Тип
area_total
decimal
Max
символов
15.2
area_pitched
_slate
area_pitched
_metal
decimal
15.2
decimal
15.2
area_pitched
_others
area_flat
decimal
15.2
decimal
15.2
last_overhaul
_date
text
Обязател
ьность
Описание
Площадь кровли общая,
м2
Площадь кровли
шиферная скатная, м2
Площадь кровли
металлическая скатная,
м2
Площадь кровли иная
скатная, м2
Площадь кровли
плоская, м2
Год проведения
последнего
капитального ремонта
кровли
Таблица 74– Описание типа Basement
Тип
Basement
Параметр
Тип
basement_sta
ge
BasementSt
ageEnum
basement_are
a
decimal
Max
символов
Обязател
ьность
Описание
Сведения о подвале
(Возможные значения в
Таблица 75)
Площадь подвальных
помещений (включая
помещения подвала и
15.2
78
Тип
Параметр
basement_las
t_overhaul_d
ate
Тип
Max
символов
Обязател
ьность
Описание
техподполье, если оно
требует ремонта), м2
Год проведения
последнего
капитального ремонта
подвальных помещений
text
Таблица 75– Возможные значения BasementStageEnum
Тип
BasementStageEnum
Идентификатор
Значения
нет данных
отсутствует
эксплуатируемый
неэксплуатируемый
1
2
3
4
Таблица 76– Описание типа CommonSpace
Категория
Параметр
Тип
CommonSp
ace
common_spa
ce_area
decimal
common_spa
ce_overhaul_
date
text
Max
символов
15.2
Обязател
ьность
Max
символов
Обязател
ьность
Описание
Площадь помещений
общего пользования,
м2
Год проведения
последнего ремонта
помещений общего
пользования. Формат
поля 4 цифры,
например, ‘2015’.
Таблица 77– Описание типа Chute
Категория
Chute
Параметр
chute_count
Тип
Описание
Количество
мусоропроводов в доме
Год проведения
последнего
капитального ремонта
мусоропроводов
integer
chute_last_ov text
erhaul_date
Таблица 78– Описание типа HeatingSystem
Категория
Параметр
Тип
HeatingSyst
system_name
HeatingSyst
Max
символов
Обязател
ьность
Описание
Идентификатор типа
79
Категория
Параметр
em
Тип
Max
символов
Обязател
ьность
(Возможные значения в
Таблица 79)
Количество
элеваторных узлов
системы отопления
Длина трубопроводов
системы отопления, м
emNameEn
um
bigint
elevators
system_lengt
h
decimal
last_overhaul
_date
text
Описание
10.2
input_points_ integer
count
Год проведения
последнего
капитального ремонта
системы отопления
Количество точек ввода
отопления
control_node
s_count
integer
Количество узлов
управления отоплением
metering_dev
ices_count
integer
provisioning
Provisionin
gEnum
Количество
общедомовых приборов
учета отопления
Идентификатор
отпуска отопления
(Возможные значения в
Таблица 80)
Таблица 79– Возможные значения HeatingSystemNameEnum
Тип
HeatingSystemNameEn
um
Идентификатор
Значения
нет данных
отсутствует
центральное
автономное
поквартирное
печное
1
2
3
4
5
6
Таблица 80– Возможные значения ProvisioningEnum
Тип
ProvisioningEnum
Идентификатор
Значения
нет данных
по нормативам или квартирным ПУ
по показаниям общедомовых ПУ
1
2
3
80
Таблица 81– Описание типа HotWaterSystem
Категория
Параметр
HotWaterSy system_name
stem
system_lengt
h
last_overhaul
_date
Тип
Max
символов
Обязател
ьность
Тип
(Возможные значения в
Таблица 82)
Длина трубопроводов
системы горячего
водоснабжения, м
Год проведения
последнего
капитального ремонта
системы горячего
водоснабжения
Количество точек ввода
горячей воды
HotWaterSy
stemNameE
num
decimal
10.2
text
input_points_ integer
count
control_node
s_count
integer
metering_dev
ices_count
integer
provisioning
Provisionin
gEnum
Описание
Количество узлов
управления поставкой
горячей воды
Количество
общедомовых приборов
учета горячей воды
Отпуск горячей воды
производится
(Возможные значения в
Таблица 80)
Таблица 82– Возможные значения HotWaterSystemNameEnum
Тип
HotWaterSystemName
Enum
Идентификатор
Значения
нет данных
отсутствует
централизованная открытая
централизованная закрытая
поквартирная
автономная
1
2
3
4
5
6
Таблица 83– Описание типа ColdWaterSystem
Категория
Параметр
ColdWaterS system_name
ystem
Тип
Max
символов
Обязател
ьность
Описание
Тип
(Возможные значения в
Таблица 84)
ColdWaterS
ystemName
Enum
81
Категория
Параметр
Тип
system_lengh
t
decimal
last_overhaul
_date
text
Max
символов
10.2
Обязател
ьность
Длина трубопроводов
системы холодного
водоснабжения, м
Год проведения
последнего
капитального ремонта
системы холодного
водоснабжения
Количество точек ввода
холодной воды
input_points_ integer
count
metering_dev
ices_count
integer
provisioning
Provisionin
gEnum
Описание
Количество
общедомовых приборов
учета холодной воды
Отпуск холодной воды
производится
(Возможные значения в
Таблица 80)
Таблица 84– Возможные значения ColdWaterSystemNameEnum
Тип
ColdWaterSystemNam
eEnum
Идентификатор
Значения
нет данных
отсутствует
централизованное
автономное
1
2
3
4
Таблица 85– Описание типа SewerageSystem
Категория
Параметр
SewerageSy system_name
stem
system_lengt
h
last_overhaul
_date
Тип
Max
символов
Обязател
ьность
Описание
Идентификатор типа
(Возможные значения в
Таблица 86)
Длина трубопроводов
системы
водоотведения, м
Год проведения
последнего
капитального ремонта
системы водоотведения
(канализации)
SewerageSy
stemNameE
num
decimal
10.2
text
82
Таблица 86– Возможные значения SewerageSystemNameEnum
Тип
SewerageSystemName
Enum
Идентификатор
Значения
нет данных
отсутствует
централизованная
автономная
1
2
3
4
Таблица 87– Описание типа ElectricitySystem
Категория
Параметр
Тип
ElectricityS
ystem
system_name
ElectricityS
ystemName
Enum
system_lengt
h
decimal
last_overhaul
_date
text
Max
символов
Обязател
ьность
Система
электроснабжения
(Возможные значения в
Таблица 88)
Длина сетей в местах
общего пользования, м
10.2
Год проведения
последнего капремонта
системы
электроснабжения
Количество точек ввода
электричества
input_points_ integer
count
metering_dev
ices_count
integer
provisioning
Provisionin
gEnum
Описание
Количество
общедомовых приборов
учета электричества
Отпуск электричества
производится
(Возможные значения в
Таблица 80)
Таблица 88– Возможные значения ElectricitySystemNameEnum
Тип
ElectricitySystemName
Enum
Идентификатор
Значения
нет данных
отсутствует
централизованное
комбирированное
1
2
3
4
Таблица 89– Описание типа GasSystem
Категория
Параметр
Тип
GasSystem
system_name
GasSystem
Max
символов
Обязател
ьность
Описание
Вид системы
83
Категория
Параметр
Тип
Max
символов
Обязател
ьность
газоснабжения
(Возможные значения в
Таблица 90)
Длина сетей
соответствующих
требованиям
Длина сетей не
соответствующих
требованиям
Год проведения
последнего капремонта
системы газоснабжения
Количество точек ввода
газа
NameEnum
system_lengt
h
decimal
10.2
system_lengt
h_no_require
ments
last_overhaul
_date
decimal
10.2
text
input_points_ integer
count
metering_dev
ices_count
integer
provisioning
Provisionin
gEnum
Описание
Количество
общедомовых приборов
учета газа
Отпуск газа
производится
(Возможные значения в
Таблица 80)
Таблица 90– Возможные значения GasSystemNameEnum
Тип
GasSystemNameEnum
Идентификатор
Значения
нет данных
отсутствует
централизованное
1
2
3
Таблица 91– Описание типа Lift
Категория
Lift
Параметр
porch_numbe
r
factory_num
ber
stops_count
capacity
date_exploita
tion
date_last_rep
air
Тип
character
varying
character
varying
integer
integer
text
Max
символов
255
Обязател
ьность
Описание
номер подъезда
заводской номер
255
количество остановок
грузоподъемность, кг
год ввода в
эксплуатацию
год проведения
последнего капремонта
text
84
Категория
Параметр
Тип
plan_period
date
manufacturer
text
Max
символов
Обязател
ьность
Описание
плановый срок замены
(вывода из
эксплуатации)
изготовитель
Таблица 92– Описание типа ManagementContract
Категория
Параметр
Managemen contract_type
tContract
date_start
Тип
Max
символов
Обязател
ьность
Описание
Тип договора
управления
(Возможные значения в
Таблица 93)
Дата начала
обслуживания дома по
договору управления
ContractTy
peEnum
date
Плановая дата
прекращения
обслуживания дома по
договору управления
Выполняемые работы
Массив
идентификаторов
файлов. Если
идентификатор файла
не указан - это означает
удаление файла из
анкеты.
Выполнение
обязательств
Массив
идентификаторов
файлов. Если
идентификатор файла
не указан - это означает
удаление файла из
анкеты.
Примечание
Стоимость услуг
Массив
идентификаторов
файлов. Если
plan_date_sto date
p
jobs
jobs_files
text
ArrayOfInt
2500
responsibility
text
2500
responsibility
_files
ArrayOfInt
notice
service_cost
service_cost_
files
text
text
ArrayOfInt
2500
2500
85
resources_tsz
_zsk
resources_tsz
_zsk_files
text
идентификатор файла
не указан - это означает
удаление файла из
анкеты.
Средства ТСЖ или
ЖСК
Массив
идентификаторов
файлов. Если
идентификатор файла
не указан - это означает
удаление файла из
анкеты.
Условия оказания услуг
ТСЖ или ЖСК
Массив
идентификаторов
файлов. Если
идентификатор файла
не указан - это означает
удаление файла из
анкеты.
2500
ArrayOfInt
terms_service text
_tsz_zsk
terms_service ArrayOfInt
_tsz_zsk_file
s
2500
Таблица 93– Возможные значения ContractTypeEnum
Тип
ContractTypeEnum
Идентификатор
Значения
обслуживаемых ТСЖ
обслуживаемых по договору между
ТСЖ и управляющей организацией
обслуживаемых по договору между
собственниками и управляющей
организацией
обслуживаемых по результатам
открытого конкурса органов местного
самоуправления
обслуживаемых по договору
управления между застройщиком и
управляющей организацией,
отобранной по результатам открытого
конкурса органом местного
самоуправления
обслуживаемых по договору
управления специализированным
жилищным фондом военных городков
Минобороны РФ
1
2
3
4
5
6
86
Таблица 94– Описание типа Provider
Категория
Provider
Параметр
inn
alias
additional_in
fo
supplied_via
_managemen
t_organizatio
n
is_supported
Тип
character
varying
character
varying
character
varying
boolean
Max
символов
12
Обязател
ьность
Описание
ИНН
Наименование
поставщика
Дополнительная
информация
Поставляется через
управляющую
организацию
255
255
Услуга не
предоставляется
boolean
Таблица 95– Описание типа Finance
Категория
Finance
Параметр
Тип
income_man
agement
decimal
Max
символов
15.2
income_man
agement_co
mmon_prope
rty
management
_costs
decimal
15.2
decimal
15.2
debt_owners
_total
decimal
15.2
charged_own
ers_total
decimal
15.2
payment_clai
ms_compens
ation
decimal
15.2
87
Обязател
ьность
Описание
Доход от управления за
отчетный период, тыс.
руб.
Доход от управления
общим имуществом за
отчетный период, тыс.
руб.
Расходы на управление
за отчетный период,
тыс. руб.
Задолженность
собственников за
услуги управления за
отчетный период, тыс.
руб.
Взыскано с
собственников за
услуги управления за
отчетный период, тыс.
руб.
Иски по компенсации
нанесенного ущерба
Категория
Параметр
Тип
payment_clai
ms_refusal
decimal
Max
символов
15.2
payment_clai
ms_not_deliv
ered
decimal
15.2
repair_work
decimal
15.2
beautification
_work
decimal
15.2
raised_funds
_subsidies
decimal
15.2
raised_funds
_credits
decimal
15.2
raised_funds
_leasing
decimal
15.2
raised_funds
_energy_serv
ice
decimal
15.2
raised_funds
_contribution
s
decimal
15.2
raised_funds
_others
decimal
15.2
income_supp
decimal
15.2
88
Обязател
ьность
Описание
Иски по снижению
платы в связи с
неоказанием услуг
Иски по снижению
платы в связи с
недопоставкой
ресурсов
Объем работ по
ремонту за отчетный
период, тыс. руб.
Объем работ по
благоустройству за
отчетный период, тыс.
руб.
Объем привлеченных
средств за отчетный
период, тыс. руб.
(субсидии)
Объем привлеченных
средств за отчетный
период, тыс. руб.
(кредиты)
Объем привлеченных
средств за отчетный
период, тыс. руб.
(финансирование по
договорам лизинга)
Объем привлеченных
средств за отчетный
период, тыс. руб.
(финансирование по
энергосервисным
договорам)
Объем привлеченных
средств за отчетный
период, тыс. руб.
(целевые взносы
жителей)
Объем привлеченных
средств за отчетный
период, тыс. руб. (иные
источники)
Мой дом – Финансы –
Категория
Параметр
Тип
Max
символов
decimal
15.2
income_supp
ly_gaz
decimal
15.2
income_supp
ly_hot_water
decimal
15.2
income_supp
ly_cold_wate
r
decimal
15.2
income_supp
ly_wastewate
r
decimal
15.2
debt_owners
_heating
decimal
15.2
debt_owners
_electricity
decimal
15.2
Описание
Коммунальные услуги
– Доход от поставки
КУ за отчетный период,
тыс. руб. (отопление)
Мой дом – Финансы –
Коммунальные услуги
– Доход от поставки
КУ за отчетный период,
тыс. руб.
(электричество)
Мой дом – Финансы –
Коммунальные услуги
– Доход от поставки
КУ за отчетный период,
тыс. руб. (газ)
Мой дом – Финансы –
Коммунальные услуги
– Доход от поставки
КУ за отчетный период,
тыс. руб. (горячее
водоснабжение)
Мой дом – Финансы –
Коммунальные услуги
– Доход от поставки
КУ за отчетный период,
тыс. руб. (холодное
водоснабжение)
Мой дом – Финансы –
Коммунальные услуги
– Доход от поставки
КУ за отчетный период,
тыс. руб.
(водоотведение)
Мой дом – Финансы –
Коммунальные услуги
– Задолженность
собственников за КУ за
отчетный период, тыс.
руб (отопление)
Мой дом – Финансы –
Коммунальные услуги
– Задолженность
собственников за КУ за
ly_heating
income_supp
ly_electricity
Обязател
ьность
89
Категория
Параметр
Тип
Max
символов
debt_owners
_gaz
decimal
15.2
debt_owners
_hot_water
decimal
15.2
debt_owners
_cold_water
decimal
15.2
debt_owners
_wastewater
decimal
15.2
charged_serv
ices_heating
decimal
15.2
charged_serv decimal
ices_electricit
y
15.2
charged_serv
ices_gaz
15.2
decimal
Обязател
ьность
Описание
отчетный период, тыс.
руб (электричество)
Мой дом – Финансы –
Коммунальные услуги
– Задолженность
собственников за КУ за
отчетный период, тыс.
руб (газ)
Мой дом – Финансы –
Коммунальные услуги
– Задолженность
собственников за КУ за
отчетный период, тыс.
руб (горячее
водоснабжение)
Мой дом – Финансы –
Коммунальные услуги
– Задолженность
собственников за КУ за
отчетный период, тыс.
руб (холодное
водоснабжение)
Мой дом – Финансы –
Коммунальные услуги
– Задолженность
собственников за КУ за
отчетный период, тыс.
руб (водоотведение)
Мой дом – Финансы –
Коммунальные услуги
– Взыскано с
собственников за КУ за
отчетный период, тыс.
руб. (отопление)
Мой дом – Финансы –
Коммунальные услуги
– Взыскано с
собственников за КУ за
отчетный период, тыс.
руб.(электричество)
Мой дом – Финансы –
Коммунальные услуги
– Взыскано с
90
Категория
Параметр
Тип
Max
символов
charged_serv
ices_hot_wat
er
decimal
15.2
charged_serv
ices_cold_wa
ter
decimal
15.2
charged_serv
ices_wastewa
ter
decimal
15.2
paid_services
_heating
decimal
15.2
paid_services
_electricity
decimal
15.2
paid_services
_gaz
decimal
15.2
Обязател
ьность
Описание
собственников за КУ за
отчетный период, тыс.
руб. (газ)
Мой дом – Финансы –
Коммунальные услуги
– Взыскано с
собственников за КУ за
отчетный период, тыс.
руб. (горячее
водоснабжение)
Мой дом – Финансы –
Коммунальные услуги
– Взыскано с
собственников за КУ за
отчетный период, тыс.
руб. (холодное
водоснабжение)
Мой дом – Финансы –
Коммунальные услуги
– Взыскано с
собственников за КУ за
отчетный период, тыс.
руб. (водоотведение)
Мой дом – Финансы –
Коммунальные услуги
– Оплачено КУ по
показаниям
общедомовых ПУ за
отчетный период, тыс.
руб. (отопление)
Мой дом – Финансы –
Коммунальные услуги
– Оплачено КУ по
показаниям
общедомовых ПУ за
отчетный период, тыс.
руб.(электричество)
Мой дом – Финансы –
Коммунальные услуги
– Оплачено КУ по
показаниям
общедомовых ПУ за
отчетный период, тыс.
91
Категория
Параметр
Тип
Max
символов
paid_services
_hot_water
decimal
15.2
paid_services
_cold_water
decimal
15.2
paid_resourc
es_heating
decimal
15.2
paid_resourc
es_electricity
decimal
15.2
paid_resourc
es_gaz
decimal
15.2
paid_resourc
es_hot_water
decimal
15.2
Обязател
ьность
Описание
руб. (газ)
Мой дом – Финансы –
Коммунальные услуги
– Оплачено КУ по
показаниям
общедомовых ПУ за
отчетный период, тыс.
руб. (горячее
водоснабжение)
Мой дом – Финансы –
Коммунальные услуги
– Оплачено КУ по
показаниям
общедомовых ПУ за
отчетный период, тыс.
руб. (холодное
водоснабжение)
Мой дом – Финансы –
Коммунальные услуги
– Оплачено ресурсов по
счетам на
общедомовые нужды за
отчетный период, тыс.
руб. (отопление)
Мой дом – Финансы –
Коммунальные услуги
– Оплачено ресурсов по
счетам на
общедомовые нужды за
отчетный период, тыс.
руб. (электричество)
Мой дом – Финансы –
Коммунальные услуги
– Оплачено ресурсов по
счетам на
общедомовые нужды за
отчетный период, тыс.
руб. (газ)
Мой дом – Финансы –
Коммунальные услуги
– Оплачено ресурсов по
счетам на
общедомовые нужды за
92
Категория
Параметр
paid_resourc
es_cold_wate
r
Тип
decimal
Max
символов
Обязател
ьность
Описание
отчетный период, тыс.
руб. (горячее
водоснабжение)
Мой дом – Финансы –
Коммунальные услуги
– Оплачено ресурсов по
счетам на
общедомовые нужды за
отчетный период, тыс.
руб. (холодное
водоснабжение)
15.2
3) Выходные параметры
В таблице представлены выходные параметры метода (Таблица 96).
Таблица 96– Выходные параметры метода SetHouseProfile в случае ошибочного
выполнения
Категория
SoapFault
Параметр
code
name
description
Тип
Max
символов
Обязател
ьность
Описание
Код результата запроса
Наименование
Описание
integer
text
text
4) Пример вызова метода
SOAP-запрос:
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:api="http://api.reformagkh.ru/api"
xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/">
<soapenv:Header>
<api:Login
soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<login xsi:type="xsd:string">?</login>
<password xsi:type="xsd:string">?</password>
</api:Login>
</soapenv:Header>
<soapenv:Body>
<api:SetHouseProfile
soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<house_id xsi:type="xsd:int">?</house_id>
<reporting_period_id xsi:type="xsd:int">?</reporting_period_id>
<data xsi:type="api:HouseProfileData">
<!--You may enter the following 53 items in any order-->
<area_total xsi:type="api:Decimal152">?</area_total>
<area_residential xsi:type="api:Decimal152">?</area_residential>
<area_non_residential
xsi:type="api:Decimal152">?</area_non_residential>
<cadastral_number xsi:type="xsd:string">?</cadastral_number>
<project_type xsi:type="xsd:string">?</project_type>
93
<location_description
xsi:type="xsd:string">?</location_description>
<individual_name xsi:type="xsd:string">?</individual_name>
<house_type xsi:type="api:HouseTypeEnum">?</house_type>
<exploitation_start_year
xsi:type="xsd:string">?</exploitation_start_year>
<wall_material
xsi:type="api:HouseWallMaterialEnum">?</wall_material>
<floor_type xsi:type="api:HouseFloorTypeEnum">?</floor_type>
<storeys_count xsi:type="xsd:int">?</storeys_count>
<entrance_count xsi:type="xsd:int">?</entrance_count>
<elevators_count xsi:type="xsd:int">?</elevators_count>
<area_private xsi:type="api:Decimal152">?</area_private>
<area_municipal xsi:type="api:Decimal152">?</area_municipal>
<area_national xsi:type="api:Decimal152">?</area_national>
<area_land xsi:type="api:Decimal152">?</area_land>
<area_territory xsi:type="api:Decimal152">?</area_territory>
<inventory_number xsi:type="xsd:string">?</inventory_number>
<flats_count xsi:type="xsd:int">?</flats_count>
<residents_count xsi:type="xsd:int">?</residents_count>
<accounts_count xsi:type="xsd:int">?</accounts_count>
<construction_features
xsi:type="xsd:string">?</construction_features>
<thermal_actual_expense
xsi:type="api:Decimal152">?</thermal_actual_expense>
<thermal_normative_expense
xsi:type="api:Decimal152">?</thermal_normative_expense>
<energy_efficiency
xsi:type="api:HouseEnergyEfficiencyClassEnum">?</energy_efficiency>
<energy_audit_date xsi:type="xsd:date">?</energy_audit_date>
<privatization_start_date
xsi:type="xsd:date">?</privatization_start_date>
<deterioration_total
xsi:type="api:Decimal152">?</deterioration_total>
<deterioration_foundation
xsi:type="api:Decimal152">?</deterioration_foundation>
<deterioration_bearing_walls
xsi:type="api:Decimal152">?</deterioration_bearing_walls>
<deterioration_floor
xsi:type="api:Decimal152">?</deterioration_floor>
<facade xsi:type="api:Facade">
<!--You may enter the following 18 items in any order-->
<area_total xsi:type="api:Decimal152">?</area_total>
<area_plastered xsi:type="api:Decimal152">?</area_plastered>
<area_unplastered
xsi:type="api:Decimal152">?</area_unplastered>
<area_panel xsi:type="api:Decimal152">?</area_panel>
<area_tiled xsi:type="api:Decimal152">?</area_tiled>
<area_lined_siding
xsi:type="api:Decimal152">?</area_lined_siding>
<area_wooden xsi:type="api:Decimal152">?</area_wooden>
<area_insulated_decorative_plaster
xsi:type="api:Decimal152">?</area_insulated_decorative_plaster>
<area_insulated_tiles
xsi:type="api:Decimal152">?</area_insulated_tiles>
<area_insulated_siding
xsi:type="api:Decimal152">?</area_insulated_siding>
<area_riprap xsi:type="api:Decimal152">?</area_riprap>
<area_glazing_common_wooden
xsi:type="api:Decimal152">?</area_glazing_common_wooden>
<area_glazing_common_plastic
xsi:type="api:Decimal152">?</area_glazing_common_plastic>
94
<area_glazing_individual_wooden
xsi:type="api:Decimal152">?</area_glazing_individual_wooden>
<area_glazing_individual_plastic
xsi:type="api:Decimal152">?</area_glazing_individual_plastic>
<area_door_fillings_metal
xsi:type="api:Decimal152">?</area_door_fillings_metal>
<area_door_fillings_others
xsi:type="api:Decimal152">?</area_door_fillings_others>
<last_overhaul_date
xsi:type="xsd:string">?</last_overhaul_date>
</facade>
<roof xsi:type="api:Roof">
<!--You may enter the following 6 items in any order-->
<area_total xsi:type="api:Decimal152">?</area_total>
<area_pitched_slate
xsi:type="api:Decimal152">?</area_pitched_slate>
<area_pitched_metal
xsi:type="api:Decimal152">?</area_pitched_metal>
<area_pitched_others
xsi:type="api:Decimal152">?</area_pitched_others>
<area_flat xsi:type="api:Decimal152">?</area_flat>
<last_overhaul_date
xsi:type="xsd:string">?</last_overhaul_date>
</roof>
<basement xsi:type="api:Basement">
<!--You may enter the following 3 items in any order-->
<basement_stage
xsi:type="api:BasementStageEnum">?</basement_stage>
<basement_area xsi:type="api:Decimal152">?</basement_area>
<basement_last_overhaul_date
xsi:type="xsd:string">?</basement_last_overhaul_date>
</basement>
<common_space xsi:type="api:CommonSpace">
<!--You may enter the following 2 items in any order-->
<common_space_area
xsi:type="api:Decimal152">?</common_space_area>
<common_space_overhaul_date
xsi:type="xsd:string">?</common_space_overhaul_date>
</common_space>
<chute xsi:type="api:Chute">
<!--You may enter the following 2 items in any order-->
<chute_count xsi:type="xsd:int">?</chute_count>
<chute_last_overhaul_date
xsi:type="xsd:string">?</chute_last_overhaul_date>
</chute>
<heating_system xsi:type="api:HeatingSystem">
<!--You may enter the following 8 items in any order-->
<system_name
xsi:type="api:HeatingSystemNameEnum">?</system_name>
<elevators xsi:type="xsd:int">?</elevators>
<system_length xsi:type="api:Decimal152">?</system_length>
<last_overhaul_date
xsi:type="xsd:string">?</last_overhaul_date>
<input_points_count xsi:type="xsd:int">?</input_points_count>
<control_nodes_count
xsi:type="xsd:int">?</control_nodes_count>
<metering_devices_count
xsi:type="xsd:int">?</metering_devices_count>
<provisioning xsi:type="api:ProvisioningEnum">?</provisioning>
</heating_system>
<hot_water_system xsi:type="api:HotWaterSystem">
<!--You may enter the following 7 items in any order-->
95
<system_name
xsi:type="api:HotWaterSystemNameEnum">?</system_name>
<system_length xsi:type="api:Decimal152">?</system_length>
<last_overhaul_date
xsi:type="xsd:string">?</last_overhaul_date>
<input_points_count xsi:type="xsd:int">?</input_points_count>
<control_nodes_count
xsi:type="xsd:int">?</control_nodes_count>
<metering_devices_count
xsi:type="xsd:int">?</metering_devices_count>
<provisioning xsi:type="api:ProvisioningEnum">?</provisioning>
</hot_water_system>
<cold_water_system xsi:type="api:ColdWaterSystem">
<!--You may enter the following 6 items in any order-->
<system_name
xsi:type="api:ColdWaterSystemNameEnum">?</system_name>
<system_length xsi:type="api:Decimal152">?</system_length>
<last_overhaul_date
xsi:type="xsd:string">?</last_overhaul_date>
<input_points_count xsi:type="xsd:int">?</input_points_count>
<metering_devices_count
xsi:type="xsd:int">?</metering_devices_count>
<provisioning xsi:type="api:ProvisioningEnum">?</provisioning>
</cold_water_system>
<sewerage_system xsi:type="api:SewerageSystem">
<!--You may enter the following 3 items in any order-->
<system_name
xsi:type="api:SewerageSystemNameEnum">?</system_name>
<system_length xsi:type="api:Decimal152">?</system_length>
<last_overhaul_date
xsi:type="xsd:string">?</last_overhaul_date>
</sewerage_system>
<electricity_system xsi:type="api:ElectricitySystem">
<!--You may enter the following 6 items in any order-->
<system_name
xsi:type="api:ElectricitySystemNameEnum">?</system_name>
<system_length xsi:type="api:Decimal152">?</system_length>
<last_overhaul_date
xsi:type="xsd:string">?</last_overhaul_date>
<input_points_count xsi:type="xsd:int">?</input_points_count>
<metering_devices_count
xsi:type="xsd:int">?</metering_devices_count>
<provisioning xsi:type="api:ProvisioningEnum">?</provisioning>
</electricity_system>
<gas_system xsi:type="api:GasSystem">
<!--You may enter the following 7 items in any order-->
<system_name xsi:type="api:GasSystemNameEnum">?</system_name>
<system_length xsi:type="api:Decimal152">?</system_length>
<system_length_no_requirements
xsi:type="api:Decimal152">?</system_length_no_requirements>
<last_overhaul_date
xsi:type="xsd:string">?</last_overhaul_date>
<input_points_count xsi:type="xsd:int">?</input_points_count>
<metering_devices_count
xsi:type="xsd:int">?</metering_devices_count>
<provisioning xsi:type="api:ProvisioningEnum">?</provisioning>
</gas_system>
<lifts xsi:type="api:ArrayOfLift"
soapenc:arrayType="api:Lift[]"/>
<management_contract xsi:type="api:ManagementContract">
<!--You may enter the following 9 items in any order-->
<contract_type
xsi:type="api:ContractTypeEnum">?</contract_type>
96
<date_start xsi:type="xsd:date">?</date_start>
<plan_date_stop xsi:type="xsd:date">?</plan_date_stop>
<jobs xsi:type="xsd:string">?</jobs>
<responsibility xsi:type="xsd:string">?</responsibility>
<notice xsi:type="xsd:string">?</notice>
<service_cost xsi:type="xsd:string">?</service_cost>
<resources_tsz_zsk xsi:type="xsd:string">?</resources_tsz_zsk>
<terms_service_tsz_zsk
xsi:type="xsd:string">?</terms_service_tsz_zsk>
</management_contract>
<heating_provider xsi:type="api:Provider">
<!--You may enter the following 5 items in any order-->
<is_supported xsi:type="xsd:boolean">?</is_supported>
<supplied_via_management_organization
xsi:type="xsd:boolean">?</supplied_via_management_organization>
<inn xsi:type="xsd:string">?</inn>
<alias xsi:type="xsd:string">?</alias>
<additional_info xsi:type="xsd:string">?</additional_info>
</heating_provider>
<electricity_provider xsi:type="api:Provider">
<!--You may enter the following 5 items in any order-->
<is_supported xsi:type="xsd:boolean">?</is_supported>
<supplied_via_management_organization
xsi:type="xsd:boolean">?</supplied_via_management_organization>
<inn xsi:type="xsd:string">?</inn>
<alias xsi:type="xsd:string">?</alias>
<additional_info xsi:type="xsd:string">?</additional_info>
</electricity_provider>
<gas_provider xsi:type="api:Provider">
<!--You may enter the following 5 items in any order-->
<is_supported xsi:type="xsd:boolean">?</is_supported>
<supplied_via_management_organization
xsi:type="xsd:boolean">?</supplied_via_management_organization>
<inn xsi:type="xsd:string">?</inn>
<alias xsi:type="xsd:string">?</alias>
<additional_info xsi:type="xsd:string">?</additional_info>
</gas_provider>
<hot_water_provider xsi:type="api:Provider">
<!--You may enter the following 5 items in any order-->
<is_supported xsi:type="xsd:boolean">?</is_supported>
<supplied_via_management_organization
xsi:type="xsd:boolean">?</supplied_via_management_organization>
<inn xsi:type="xsd:string">?</inn>
<alias xsi:type="xsd:string">?</alias>
<additional_info xsi:type="xsd:string">?</additional_info>
</hot_water_provider>
<cold_water_provider xsi:type="api:Provider">
<!--You may enter the following 5 items in any order-->
<is_supported xsi:type="xsd:boolean">?</is_supported>
<supplied_via_management_organization
xsi:type="xsd:boolean">?</supplied_via_management_organization>
<inn xsi:type="xsd:string">?</inn>
<alias xsi:type="xsd:string">?</alias>
<additional_info xsi:type="xsd:string">?</additional_info>
</cold_water_provider>
<drainage_provider xsi:type="api:Provider">
<!--You may enter the following 5 items in any order-->
<is_supported xsi:type="xsd:boolean">?</is_supported>
<supplied_via_management_organization
xsi:type="xsd:boolean">?</supplied_via_management_organization>
<inn xsi:type="xsd:string">?</inn>
<alias xsi:type="xsd:string">?</alias>
<additional_info xsi:type="xsd:string">?</additional_info>
97
</drainage_provider>
<finance xsi:type="api:Finance">
<!--You may enter the following 44 items in any order-->
<income_management
xsi:type="api:Decimal152">?</income_management>
<income_management_common_property
xsi:type="api:Decimal152">?</income_management_common_property>
<management_costs
xsi:type="api:Decimal152">?</management_costs>
<debt_owners_total
xsi:type="api:Decimal152">?</debt_owners_total>
<charged_owners_total
xsi:type="api:Decimal152">?</charged_owners_total>
<payment_claims_compensation
xsi:type="api:Decimal152">?</payment_claims_compensation>
<payment_claims_refusal
xsi:type="api:Decimal152">?</payment_claims_refusal>
<payment_claims_not_delivered
xsi:type="api:Decimal152">?</payment_claims_not_delivered>
<repair_work xsi:type="api:Decimal152">?</repair_work>
<beautification_work
xsi:type="api:Decimal152">?</beautification_work>
<raised_funds_subsidies
xsi:type="api:Decimal152">?</raised_funds_subsidies>
<raised_funds_credits
xsi:type="api:Decimal152">?</raised_funds_credits>
<raised_funds_leasing
xsi:type="api:Decimal152">?</raised_funds_leasing>
<raised_funds_energy_service
xsi:type="api:Decimal152">?</raised_funds_energy_service>
<raised_funds_contributions
xsi:type="api:Decimal152">?</raised_funds_contributions>
<raised_funds_others
xsi:type="api:Decimal152">?</raised_funds_others>
<income_supply_heating
xsi:type="api:Decimal152">?</income_supply_heating>
<income_supply_electricity
xsi:type="api:Decimal152">?</income_supply_electricity>
<income_supply_gaz
xsi:type="api:Decimal152">?</income_supply_gaz>
<income_supply_hot_water
xsi:type="api:Decimal152">?</income_supply_hot_water>
<income_supply_cold_water
xsi:type="api:Decimal152">?</income_supply_cold_water>
<income_supply_wastewater
xsi:type="api:Decimal152">?</income_supply_wastewater>
<debt_owners_heating
xsi:type="api:Decimal152">?</debt_owners_heating>
<debt_owners_electricity
xsi:type="api:Decimal152">?</debt_owners_electricity>
<debt_owners_gaz xsi:type="api:Decimal152">?</debt_owners_gaz>
<debt_owners_hot_water
xsi:type="api:Decimal152">?</debt_owners_hot_water>
<debt_owners_cold_water
xsi:type="api:Decimal152">?</debt_owners_cold_water>
<debt_owners_wastewater
xsi:type="api:Decimal152">?</debt_owners_wastewater>
<charged_services_heating
xsi:type="api:Decimal152">?</charged_services_heating>
<charged_services_electricity
xsi:type="api:Decimal152">?</charged_services_electricity>
<charged_services_gaz
xsi:type="api:Decimal152">?</charged_services_gaz>
98
<charged_services_hot_water
xsi:type="api:Decimal152">?</charged_services_hot_water>
<charged_services_cold_water
xsi:type="api:Decimal152">?</charged_services_cold_water>
<charged_services_wastewater
xsi:type="api:Decimal152">?</charged_services_wastewater>
<paid_services_heating
xsi:type="api:Decimal152">?</paid_services_heating>
<paid_services_electricity
xsi:type="api:Decimal152">?</paid_services_electricity>
<paid_services_gaz
xsi:type="api:Decimal152">?</paid_services_gaz>
<paid_services_hot_water
xsi:type="api:Decimal152">?</paid_services_hot_water>
<paid_services_cold_water
xsi:type="api:Decimal152">?</paid_services_cold_water>
<paid_resources_heating
xsi:type="api:Decimal152">?</paid_resources_heating>
<paid_resources_electricity
xsi:type="api:Decimal152">?</paid_resources_electricity>
<paid_resources_gaz
xsi:type="api:Decimal152">?</paid_resources_gaz>
<paid_resources_hot_water
xsi:type="api:Decimal152">?</paid_resources_hot_water>
<paid_resources_cold_water
xsi:type="api:Decimal152">?</paid_resources_cold_water>
</finance>
</data>
</api:SetHouseProfile>
</soapenv:Body>
</soapenv:Envelope>
SoapFault:
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="http://api.reformagkh.ru/api"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<SOAP-ENV:Body>
<SOAP-ENV:Fault>
<faultcode>SOAP-ENV:Client</faultcode>
<faultstring>Mandatory field is null</faultstring>
<detail xsi:type="ns1:ErrorDetails">
<code>1009</code>
<name>Mandatory field is null</name>
<description>Обязательное поле «sessionId» не
заполнено</description>
</detail>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Отсутствие SoapFault означает успешное выполнение запроса.
5) Ошибки
Таблица 97 – Результаты вызова метода SetHouseProfile
Code
(Код результата
запроса)
401
Name
(Наименование)
Description
(Описание)
Неавторизованный запрос
Unauthorized
99
403
Forbidden
Нет прав на выполнение запроса
500
Internal Server Error
Внутренняя ошибка сервера. Сервер
неспособен выполнить запрос.
Попробуйте обратиться позже
1004
House wasn’t found
Дом с указанным идентификатором не
найден
1014
Missing city
Населенный пункт с указанным
идентификатором не найден
1015
Missing street
Улица с указанным идентификатором
не найдена
1020
External system has no
request
Внешняя система не подписана на
раскрытие данных по управляющей
организации
1007
INN wasn’t found
Управляющая организация с
указанным ИНН не найдена
1011
House is not in company
Дом, находится в управлении другой
организации «ID УО, ИНН,
НАЗВАНИЕ», по которой нет
подписки
1007
Missing reporting period
Отчетный период с указанным
идентификатором не найден
1040
Missing house profile in this
reporting period
Анкета дома за указанный отчетный
период не найдена
1005
INN wasnt found
Управляющая организация с
указанным ИНН не найдена
1011
Mandatory field is null
Обязательное поле «НАЗВАНИЕ
ПОЛЯ» не заполнено
1012
Field "NAME" is not valid
Поле «НАЗВАНИЕ ПОЛЯ» заполнено
не верно
5.11 Метод SetNewHouse
1) Описание метода
Метод добавления нового дома с соответствующим адресом по ФИАС (GUID).
Внешняя система на вход подает GUID улицы, если дом без улицы, то на вход подается
GUID населенного пункта. Проверка существования дома с указанным адресом.
2) Входные данные
В таблице представлены входные параметры метода (Таблица 98).
100
Таблица 98 – Входные параметры метода SetNewHouse
Категор
Параметр
ия
SetNew
address
HouseIn
Тип
Max
символов
FiasAddress
Обязательн
ость
Да
Описание
Адрес дома
(GUID по
ФИАС)
(Описано в
Таблица 23)
3) Выходные параметры
В таблице представлены выходные параметры метода (Таблица 99).
Таблица 99– Выходные параметры метода SetNewHouse
Категория
SetNewHou
seOut
Параметр
house_id
Тип
Max
символов
Обязател
ьность
Описание
Идентификатор дома
integer
Таблица 100– Выходные параметры метода SetNewHouse в случае ошибочного
выполнения
Категория
SoapFault
Параметр
code
name
description
Тип
Max
символов
Обязател
ьность
Описание
Код результата запроса
Наименование
Описание
integer
text
text
4) Пример вызова метода
SOAP-запрос:
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:api="http://api.reformagkh.ru/api">
<soapenv:Header>
<authenticate>ev4sin4te6anc6949udv23n482</authenticate>
</soapenv:Header>
<soapenv:Body>
<api:SetNewHouse
soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<address xsi:type="api:FiasAddress">
<!--You may enter the following 7 items in any order-->
<city_id xsi:type="xsd:string">?</city_id>
<street_id xsi:type="xsd:string">?</street_id>
<house_number xsi:type="xsd:string">?</house_number>
<building xsi:type="xsd:string">?</building>
<block xsi:type="xsd:string">?</block>
<room_number xsi:type="xsd:string">?</room_number>
<letter xsi:type="xsd:string">?</letter>
</address>
</api:SetNewHouse>
</soapenv:Body>
</soapenv:Envelope>
101
SoapFault:
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="http://api.reformagkh.ru/api"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<SOAP-ENV:Body>
<SOAP-ENV:Fault>
<faultcode>SOAP-ENV:Client</faultcode>
<faultstring>Mandatory field is null</faultstring>
<detail xsi:type="ns1:ErrorDetails">
<code>1009</code>
<name>Mandatory field is null</name>
<description>Обязательное поле «sessionId» не
заполнено</description>
</detail>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Отсутствие SoapFault означает успешное выполнение запроса.
5) Ошибки
Таблица 101 – Результаты вызова метода SetNewHouse
Code
(Код результата
запроса)
Name
(Наименование)
Description
(Описание)
401
Unauthorized
Неавторизованный запрос
403
Forbidden
Нет прав на выполнение запроса
500
Internal Server Error
Внутренняя ошибка сервера. Сервер
неспособен выполнить запрос.
Попробуйте обратиться позже.
1014
Missing city
Населенный пункт с указанным
идентификатором не найден
1015
Missing street
Улица с указанным идентификатором
не найдена
1018
House is already exist
Дом с указанным адресом уже
существует
1009
Mandatory field is null
Обязательное поле «НАЗВАНИЕ
ПОЛЯ» не заполнено
1010
Field "NAME" is not valid
Поле «НАЗВАНИЕ ПОЛЯ» заполнено
не верно
5.12 Метод GetHouseInfo
1) Описание метода
102
Метод получения идентификатора дома с соответствующим адресом по ФИАС. По
одному адресу может быть несколько домов, например, снесенные. Возвращаем все дома.
В результате запроса получения информации по дому API - сервис может вернуть
несколько домов с одинаковым адресом. Необходимо выбрать дом, который находится в
управлении организации, по которой внешняя система раскрывает информацию. Если
таких домов несколько, то внешняя система вправе раскрывать информацию как по всем
своим домам-дублям также и по одному из домов.
2) Входные данные
В таблице представлены входные параметры метода (Таблица 102).
Таблица 102 – Входные параметры метода GetHouseInfo
Категор
Параметр
ия
GetHous fias_address
eInfo
Тип
Max
символов
Обязательн
ость
Описание
Адрес дома по
ФИАС
(Описано в
FiasAddress
Таблица 23)
3) Выходные параметры
В таблице представлены выходные параметры метода (Таблица 103).
Таблица 103– Выходные параметры метода GetHouseInfo
Категория
HouseInfo
Параметр
Тип
Max
символов
Обязател
ьность
Да
house_id
full_address
integer
FullAddress
inn
character
varying
state
HouseState
Enum
Да
stage
HouseStage
Enum
Да
is_drifting_fr
om
date
12
103
Описание
Идентификатор дома
Адрес дома (Описано в
Таблица 55)
ИНН текущей
организации, в
управлении которой
находится дом
Идентификатор
состояния (Описано в
Таблица 66)
Идентификатор стадия
жизненного цикла дома
(Описано в Таблица 67)
Дата сноса дома. Дата
возвращается, только
когда стадия дома
«снесен»
Таблица 104– Выходные параметры метода GetHouseInfo в случае ошибочного
выполнения
Категория
SoapFault
Параметр
code
name
description
Тип
Max
символов
Обязател
ьность
Описание
Код результата запроса
Наименование
Описание
integer
text
text
4) Пример вызова метода
SOAP-запрос:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:api="https://api.reformagkh.ru/api_document_literal">
<soapenv:Header>
<authenticate>ev4sin4te6anc6949udv23n482</authenticate>
</soapenv:Header>
<soapenv:Body>
<api:GetHouseInfo>
<address>
<!--You may enter the following 6 items in any order-->
<city_id>?</city_id>
<street_id>?</street_id>
<house_number>?</house_number>
<building>?</building>
<block>?</block>
<room_number>?</room_number>
<letter>?</letter>
</address>
</api:GetHouseInfo>
</soapenv:Body>
</soapenv:Envelope>
SoapFault:
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="http://api.reformagkh.ru/api_document_literal"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<SOAP-ENV:Body>
<SOAP-ENV:Fault>
<faultcode>SOAP-ENV:Client</faultcode>
<faultstring>Mandatory field is null</faultstring>
<detail xsi:type="ns1:ErrorDetails">
<code>1009</code>
<name>Mandatory field is null</name>
<description>Обязательное поле «sessionId» не
заполнено</description>
</detail>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Отсутствие SoapFault означает успешное выполнение запроса.
5) Ошибки
104
Таблица 105 – Результаты вызова метода GetHouseInfo
Code
(Код результата
запроса)
Name
(Наименование)
Description
(Описание)
401
Unauthorized
Неавторизованный запрос
403
Forbidden
Нет прав на выполнение запроса
500
Internal Server Error
Внутренняя ошибка сервера. Сервер
неспособен выполнить запрос.
Попробуйте обратиться позже
1014
Missing city
Населенный пункт с указанным
идентификатором не найден
1015
Missing street
Улица с указанным идентификатором
не найдена
1033
House wasn’t found
Дом с указанным адресом не найден
1009
Mandatory field is null
Обязательное поле «НАЗВАНИЕ
ПОЛЯ» не заполнено
1010
Field "NAME" is not valid
Поле «НАЗВАНИЕ ПОЛЯ» заполнено
не верно
5.13 Метод SetUploadFile
1) Описание метода
Метод загрузки файла в систему. В качестве выходного параметра возвращается
идентификатор файла, который необходимо будет использовать при добавлении файла в
анкету управляющей организации/дома. Файл создается с временным типом. Файлы с
временным типом удаляются через сутки. Таким образом, после загрузки файла
необходимо его прикрепить к анкете организации или дома. Идентификатор файла можно
использовать лишь один раз.
Допустимые расширения файлов: .odt, .ods, .odp, .doc, .docx, .xls, .xlsx, .ppt, .pptx,
.txt, .dat, .jpg, .jpeg, .png, .pdf, .gif, .tif, rtf. Максимальный размер файла: 15Мб.
2) Входные данные
В таблице представлены входные параметры метода (Таблица 106).
105
Таблица 106 – Входные параметры метода SetUploadFile
Категор
Параметр
ия
UploadFi name
leIn
data
Тип
Max
символов
255
character
varying
string
Обязательн
ость
Да
Да
Описание
Название
файла
Файл. Текст,
содержимое
зашифровано
B64
3) Выходные параметры
В таблице представлены выходные параметры метода (Таблица 107).
Таблица 107– Выходные параметры метода SetUploadFile
Категория
FileInfo
Параметр
file_id
name
extension
size
create_date
Тип
bigint
character
varying
character
varying
integer
date
Max
символов
Обязател
ьность
Да
255
Описание
Идентификатор файла
Название файла
Расширение файла
255
Размер файла
Дата загрузки файла
4) Пример вызова метода
SOAP-запрос:
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:api="http://api.reformagkh.ru/api">
<soapenv:Header>
<authenticate>ev4sin4te6anc6949udv23n482</authenticate>
</soapenv:Header>
<soapenv:Body>
<api:SetUploadFile
soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<file_object xsi:type="api:FileObject">
<!--You may enter the following 2 items in any order-->
<name xsi:type="xsd:string">?</name>
<data xsi:type="xsd:string">?</data>
</file_object>
</api:SetUploadFile>
</soapenv:Body>
</soapenv:Envelope>
SoapFault:
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="http://api.reformagkh.ru/api_document_literal"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
106
<SOAP-ENV:Body>
<SOAP-ENV:Fault>
<faultcode>SOAP-ENV:Client</faultcode>
<faultstring>Mandatory field is null</faultstring>
<detail xsi:type="ns1:ErrorDetails">
<code>1009</code>
<name>Mandatory field is null</name>
<description>Обязательное поле «sessionId» не
заполнено</description>
</detail>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Отсутствие SoapFault означает успешное выполнение запроса.
5) Ошибки
Таблица 108 – Результаты вызова метода SetUploadFile
Code
(Код результата
запроса)
Name
(Наименование)
Description
(Описание)
401
Unauthorized
Неавторизованный запрос
403
Forbidden
Нет прав на выполнение запроса
500
Internal Server Error
Внутренняя ошибка сервера. Сервер
неспособен выполнить запрос.
Попробуйте обратиться позже.
1022
Extension is not valid
Файл с таким расширение не допустим
к загрузке
1023
File Size Limit Exceeded
Размер загружаемого файла превышает
15MB
1009
Mandatory field is null
Обязательное поле «НАЗВАНИЕ
ПОЛЯ» не заполнено
1010
Field "NAME" is not valid
Поле «НАЗВАНИЕ ПОЛЯ» заполнено
не верно
5.14 Метод GetFileByID
1) Описание метода
Метод получения файла с соответствующим идентификатором. Внешняя система
может получать файлы с соответствующим идентификатором из текущей/архивной
анкеты организации, по которой внешней системе разрешена подписка на раскрытие.
Внешняя система может получать файлы, с соответствующим идентификатором из
107
текущей/архивной анкеты дома, который в управлении организации, по которой
разрешена подписка. Также внешняя система может получить файлы, которые были
загружены ею с помощью метода «SetUploadFile».
2) Входные данные
В таблице представлены входные параметры метода (Таблица 109).
Таблица 109 – Входные параметры метода GetFileByID
Категория
GetFileByI
DIn
Параметр
file_id
Тип
Max
символов
bigint
Обязател
ьность
Да
Описание
Идентификатор файла
3) Выходные параметры
В таблице представлены выходные параметры метода (Таблица 110).
Таблица 110– Выходные параметры метода GetFileByID
Категория
GetFileByI
DOut
Параметр
file
Тип
Max
символов
Обязател
ьность
Описание
Файл. (Описано в
Таблица 112)
FileObject
Таблица 111– Выходные параметры метода GetFileByID в случае ошибочного выполнения
Категория
SoapFault
Параметр
code
name
description
Тип
Max
символов
Обязател
ьность
Описание
Код результата запроса
Наименование
Описание
integer
text
text
Таблица 112 – Описание типа FileObject
Категор
Параметр
ия
FileObje name
ct
data
Тип
Max
символов
character
varying
string
Обязательн
ость
Да
Да
Описание
Название
файла
Файл. Текст,
содержимое
зашифровано
B64
4) Пример вызова метода
SOAP-запрос:
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
108
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:api="http://api.reformagkh.ru/api">
<soapenv:Header>
<authenticate
xsi:type="xsd:string">r3r3ct27sala7p283h4btkpe75</authenticate>
</soapenv:Header>
<soapenv:Body>
<api:GetFileByID
soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<file_id xsi:type="xsd:int">?</file_id>
</api:GetFileByID>
</soapenv:Body>
</soapenv:Envelope>
SoapFault:
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="http://api.reformagkh.ru/api_document_literal"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<SOAP-ENV:Body>
<SOAP-ENV:Fault>
<faultcode>SOAP-ENV:Client</faultcode>
<faultstring>Mandatory field is null</faultstring>
<detail xsi:type="ns1:ErrorDetails">
<code>1009</code>
<name>Mandatory field is null</name>
<description>Обязательное поле «sessionId» не
заполнено</description>
</detail>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Отсутствие SoapFault означает успешное выполнение запроса.
5) Ошибки
Таблица 113 – Результаты вызова метода GetFileByID
Code
(Код результата
запроса)
Name
(Наименование)
Description
(Описание)
Unauthorized
Неавторизованный запрос
500
Internal Server Error
Внутренняя ошибка сервера. Сервер
неспособен выполнить запрос.
Попробуйте обратиться позже.
1035
Missing file
Файл с указанным идентификатором не
найден
1009
Mandatory field is null
Обязательное поле «НАЗВАНИЕ
ПОЛЯ» не заполнено
1010
Field "NAME" is not valid
Поле «НАЗВАНИЕ ПОЛЯ» заполнено
не верно
401
109
5.15
Метод GetCompanyProfile
1) Описание метода
Метод получения данных анкеты (текущей и архивной) управляющей организации
с соответствующим ИНН за указанный отчетный период.
2) Входные данные
В таблице представлены входные параметры метода (Таблица 114).
Таблица 114 – Входные параметры метода GetCompanyProfile
Категория
Параметр
GetCompan inn
yProfileIn
reporting_per
iod_id
Тип
character
varying
bigint
Max
Обязател
символов
ьность
12
Да
Да
Описание
ИНН управляющей
организации
Идентификатор
отчетного периода
3) Выходные параметры
В таблице представлены выходные параметры метода (Таблица 115).
Таблица 115– Выходные параметры метода GetCompanyProfile
Категория
Параметр
GetCompan
yProfileOut
GetCompany
ProfileRespo
nse
Тип
Max
символов
Обязател
ьность
Да
Описание
Массив данных
(Описано в Таблица
116)
Таблица 116–Параметры GetCompanyProfileResponse
Категория
GetCompan
yProfileRes
ponse
Параметр
inn
name_full
name_short
company_pro
file_data
files_info
Тип
character
varying
character
varying
character
varying
CompanyPr
ofileData
FileInfo
Max
Обязател
символов
ьность
12
Да
Описание
ИНН
Да
Полное наименование
юридического лица
Да
Краткое наименование
юридического лица
Да
Массив данных
(Описано в Таблица 22)
Массив файлов анкеты
управляющей
организации (описано в
Таблица 107)
Таблица 117– Выходные параметры метода GetCompanyProfile в случае ошибочного
выполнения
Категория
Параметр
Тип
Max
110
Обязател
Описание
символов
SoapFault
code
name
description
ьность
Код результата запроса
Наименование
Описание
integer
text
text
4) Пример вызова метода
SOAP-запрос:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:api="http://api.reformagkh.ru/api_document_literal">
<soapenv:Header>
<authenticate>4be5tmhhmrla5nsuf4depd5o91</authenticate>
</soapenv:Header>
<soapenv:Body>
<api:GetCompanyProfile>
<inn>?</inn>
<reporting_period_id>?</reporting_period_id>
</api:GetCompanyProfile>
</soapenv:Body>
</soapenv:Envelope>
SoapFault:
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="http://api.reformagkh.ru/api_document_literal"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<SOAP-ENV:Body>
<SOAP-ENV:Fault>
<faultcode>SOAP-ENV:Client</faultcode>
<faultstring>Mandatory field is null</faultstring>
<detail xsi:type="ns1:ErrorDetails">
<code>1009</code>
<name>Mandatory field is null</name>
<description>Обязательное поле «sessionId» не
заполнено</description>
</detail>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Отсутствие SoapFault означает успешное выполнение запроса.
5) Ошибки
Таблица 118 – Результаты вызова метода GetCompanyProfile
Code
(Код результата
запроса)
Name
(Наименование)
Description
(Описание)
401
Unauthorized
Неавторизованный запрос
403
Forbidden
Нет прав на выполнение запроса
500
Internal Server Error
Внутренняя ошибка сервера. Сервер
неспособен выполнить запрос.
111
Code
(Код результата
запроса)
Name
(Наименование)
Description
(Описание)
Попробуйте обратиться позже.
1007
Missing reporting period
Отчетный период с указанным
идентификатором не найден
1005
INN wasnt found
Управляющая организация с
указанным ИНН не найдена
1027
Missing company profile in
this reporting period
Анкета управляющей организации за
указанный отчетный период не найдена
1009
Mandatory field is null
Обязательное поле «НАЗВАНИЕ
ПОЛЯ» не заполнено
1010
Field "NAME" is not valid
Поле «НАЗВАНИЕ ПОЛЯ» заполнено
не верно
5.16 Метод GetHouseProfile
1) Описание метода
Метод получения данных анкеты (текущей/архивной) дома с соответствующим
идентификатором дома.
2) Входные данные
В таблице представлены входные параметры метода (Таблица 119).
Таблица 119 – Входные параметры метода GetHouseProfile
Категория
Параметр
GetHouseP
rofileIn
house_id
reporting_per
iod_id
Тип
Max
символов
bigint
bigint
Обязател
ьность
Да
Да
Описание
Идентификатор дома
Идентификатор
отчетного периода
3) Выходные параметры
GetHouseProfileOut вызывает массив данных GetHouseProfileResponse (описано в
Таблица 120).
Таблица 120– Выходные параметры метода GetHouseProfile
Категор
Параметр
ия
GetHous house_id
eProfileR
Тип
Max
символов
integer
112
Обязательн
ость
Да
Описание
Идентификатор
дома
Категор
Параметр
ия
esponse
house_profile_dat
a
Тип
Max
символов
HouseProfile
Data
Обязательн
ость
Да
full_address
FullAddress
Да
stage
HouseStageEn
um
Да
state
HouseStateEn
um
Да
emergency_date
date
emergency_numb
er
character
varying
255
emergency_reaso
n
character
varying
255
emergency_after
character
varying
character
varying
255
inn
files
12
FileInfo
Описание
Массив данных
(Описано в
Таблица 65)
Адрес дома
(Описано в
Таблица 55)
Идентификатор
стадии
жизненного
цикла дома
(Описано в
Таблица 67)
Идентификатор
состояния дома
(Описано в
Таблица 73)
Дата документа
о признании
дома
аварийным
Номер
документа о
признании
дома
аварийным
Основание
признания
дома
аварийным
Дальнейшее
использование
ИНН текущей
организации, в
управлении
которой
находится дом
Массив файлов
анкеты
многоквартирн
ого дома
(описано в
Таблица 107)
Таблица 121– Выходные параметры метода GetHouseProfile в случае ошибочного
выполнения
Категория
Параметр
Тип
Max
113
Обязател
Описание
символов
SoapFault
code
name
description
ьность
Код результата запроса
Наименование
Описание
integer
text
text
4) Пример вызова метода
SOAP-запрос:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:api="http://api.reformagkh.ru/api_document_literal">
<soapenv:Header>
<authenticate>tmkoa8v8thbrnkuqlnope5b8c7</authenticate>
</soapenv:Header>
<soapenv:Body>
<api:GetHouseProfile>
<house_id>?</house_id>
<reporting_period_id xsi:type="xsd:int">?</reporting_period_id>
</api:GetHouseProfile>
</soapenv:Body>
</soapenv:Envelope>
SoapFault:
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="http://api.reformagkh.ru/api_document_literal"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<SOAP-ENV:Body>
<SOAP-ENV:Fault>
<faultcode>SOAP-ENV:Client</faultcode>
<faultstring>Mandatory field is null</faultstring>
<detail xsi:type="ns1:ErrorDetails">
<code>1009</code>
<name>Mandatory field is null</name>
<description>Обязательное поле «sessionId» не
заполнено</description>
</detail>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Отсутствие SoapFault означает успешное выполнение запроса.
5) Ошибки
Таблица 122 – Результаты вызова метода GetHouseProfile
Code
(Код результата
запроса)
Name
(Наименование)
Description
(Описание)
401
Unauthorized
Неавторизованный запрос
403
Forbidden
Нет прав на выполнение запроса
500
Internal Server Error
Внутренняя ошибка сервера. Сервер
неспособен выполнить запрос.
114
Попробуйте обратиться позже
House wasn’t found
1004
Дом с указанным идентификатором не
найден
1007
Missing reporting period
Отчетный период с указанным
идентификатором не найден
1040
Missing house profile in this
reporting period
Анкета дома за указанный отчетный
период не найдена
1009
Mandatory field is null
Обязательное поле «НАЗВАНИЕ
ПОЛЯ» не заполнено
1010
Field "NAME" is not valid
Поле «НАЗВАНИЕ ПОЛЯ» заполнено
не верно
5.17 Метод GetCompanyProfileSF
1) Описание метода
Метод получения данных анкеты (текущей и архивной) управляющей организации
по указанному субъекту федерации за указанный отчетный период. Чтение данных
постраничное, на одной странице передаются 100 анкет организаций.
2) Входные данные
В таблице представлены входные параметры метода (Таблица 123).
Таблица 123 – Входные параметры метода GetCompanyProfileSF
Категория
Параметр
GetCompan region_id
yProfileSFI
n
page_number
reporting_per
iod_id
Тип
character
varying
Max
Обязател
символов
ьность
Да
255
integer
integer
Описание
Уникальный
идентификатор региона
(GUID из ФИАС)
Номер страницы. По
умолчанию, будет
возвращаться первая
страница.
Идентификатор
отчетного периода
3) Выходные параметры
В таблице представлены выходные параметры метода (Таблица 124).
Таблица 124– Выходные параметры метода GetCompanyProfileSF
Категория
Параметр
Тип
Max
символов
115
Обязател
ьность
Описание
GetCompan data
yProfileSFR
esponse
page_number
page_count
ArrayOfGet
CompanyPr
ofileRespon
se
integer
integer
Да
Массив данных
Да
Да
Номер страницы
Количество страниц
Массив данных ArrayOfGetCompanyProfileResponse вызывает GetCompanyProfileResponse
(Описано в Таблица 116).
Таблица 125– Выходные параметры метода GetCompanyProfileSF в случае ошибочного
выполнения
Категория
SoapFault
Параметр
code
name
description
Тип
Max
символов
Обязател
ьность
Описание
Код результата запроса
Наименование
Описание
integer
text
text
4) Пример вызова метода
SOAP-запрос:
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:api="http://api.reformagkh.ru/api">
<soapenv:Header>
<authenticate>gpj0kj0ds4j71vlr6hcmkcgva7</authenticate>
</soapenv:Header>
<soapenv:Body>
<api:GetCompanyProfileSF
soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<region_id xsi:type="xsd:string">0c089b04-099e-4e0e-955a6bf1ce525f1a</region_id>
<page_number xsi:type="xsd:int"></page_number>
<reporting_period_id xsi:type="xsd:int">8</reporting_period_id>
</api:GetCompanyProfileSF>
</soapenv:Body>
</soapenv:Envelope>
SoapFault:
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="http://api.reformagkh.ru/api_document_literal"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<SOAP-ENV:Body>
<SOAP-ENV:Fault>
<faultcode>SOAP-ENV:Client</faultcode>
<faultstring>Mandatory field is null</faultstring>
<detail xsi:type="ns1:ErrorDetails">
<code>1009</code>
<name>Mandatory field is null</name>
<description>Обязательное поле «sessionId» не
заполнено</description>
</detail>
116
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Отсутствие SoapFault означает успешное выполнение запроса.
5) Ошибки
Таблица 126 – Результаты вызова метода GetCompanyProfileSF
Code
(Код результата
запроса)
Name
(Наименование)
Description
(Описание)
401
Unauthorized
Неавторизованный запрос
403
Forbidden
Нет прав на выполнение запроса
500
Internal Server Error
Внутренняя ошибка сервера. Сервер
неспособен выполнить запрос.
Попробуйте обратиться позже.
1037
Missing region
Субъект федерации с указанным
идентификатором не найден
1038
Page wasnt found
Страница с указанным номером не
найдена
1017
No permission to access
Нет доступа на чтение по указанному
Субъекту Федерации
1007
Missing reporting period
Отчетный период с указанным
идентификатором не найден
1009
Mandatory field is null
Обязательное поле «НАЗВАНИЕ
ПОЛЯ» не заполнено
1010
Field "NAME" is not valid
Поле «НАЗВАНИЕ ПОЛЯ» заполнено
не верно
117
5.18 Метод GetHouseProfileSF
1) Описание метода
Метод получения данных анкеты (текущей/архивной) дома по указанному субъекту
федерации. Чтение данных постраничное, на одной странице передаются 100 анкет домов.
2) Входные данные
В таблице представлены входные параметры метода (Таблица 127).
Таблица 127 – Входные параметры метода GetHouseProfileSF
Категория
GetHouseP
rofileSFIn
Параметр
Тип
region_id
character
varying
reporting_per
iod_id
page_number
bigint
Max
Обязател
символов
ьность
Да
255
Да
integer
Описание
Уникальный
идентификатор региона
(GUID из ФИАС)
Идентификатор
отчетного периода
Номер страницы. По
умолчанию, будет
возвращаться первая
страница.
3) Выходные параметры
GetHouseProfileSFOut вызывает GetHouseProfileSFResponse (описано в Таблица 128).
Таблица 128– Выходные параметры метода GetHouseProfileSF
Категория
Параметр
GetHousePr data
ofileSFResp
onse
page_number
page_count
Тип
Max
символов
ArrayOfGet
HouseProfil
eResponse
integer
integer
Обязател
ьность
Да
Да
Да
Описание
Массив данных
(Описано в Таблица
120).
Номер страницы
Количество страниц
Массив данных ArrayOfGetHouseProfileResponse вызывает GeHouseProfileResponse
(Описано в Таблица 129).
Таблица 129– Параметры GetHouseProfileResponse
Категор
Параметр
ия
GetHous house_profile_dat
eProfileR a
esponse
Тип
Max
символов
HouseProfile
Data
118
Обязательн
ость
Да
Описание
Массив данных
(Описано в
Таблица 65)
Категор
ия
Параметр
Тип
Max
символов
full_address
FullAddress
stage
HouseStageEn
um
inn
character
varying
house_id
bigint
Обязательн
ость
Да
Да
12
Да
Описание
Адрес дома
(Описано в
Таблица 55)
Идентификатор
стадии
жизненного
цикла дома
(Описано в
Таблица 67)
ИНН текущей
организации, в
управлении
которой
находится дом
Идентификатор
дома
Таблица 130– Выходные параметры метода GetHouseProfileSF в случае ошибочного
выполнения
Категория
SoapFault
Параметр
code
name
description
Тип
Max
символов
Обязател
ьность
Описание
Код результата запроса
Наименование
Описание
integer
text
text
4) Пример вызова метода
SOAP-запрос:
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:api="http://api.reformagkh.ru/api">
<soapenv:Header>
<authenticate>gpj0kj0ds4j71vlr6hcmkcgva7</authenticate>
</soapenv:Header>
<soapenv:Body>
<api:GetHouseProfileSF
soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<region_id xsi:type="xsd:string">0c089b04-099e-4e0e-955a6bf1ce525f1a</region_id>
<reporting_period_id xsi:type="xsd:int">?</reporting_period_id>
<page_number xsi:type="xsd:int"></page_number>
</api:GetHouseProfileSF>
</soapenv:Body>
</soapenv:Envelope>
SoapFault:
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="http://api.reformagkh.ru/api_document_literal"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<SOAP-ENV:Body>
119
<SOAP-ENV:Fault>
<faultcode>SOAP-ENV:Client</faultcode>
<faultstring>Mandatory field is null</faultstring>
<detail xsi:type="ns1:ErrorDetails">
<code>1009</code>
<name>Mandatory field is null</name>
<description>Обязательное поле «sessionId» не
заполнено</description>
</detail>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Отсутствие SoapFault означает успешное выполнение запроса.
5) Ошибки
Таблица 131 – Результаты вызова метода GetHouseProfileSF
Code
(Код результата
запроса)
Name
(Наименование)
Description
(Описание)
401
Unauthorized
Неавторизованный запрос
403
Forbidden
Нет прав на выполнение запроса
500
Internal Server Error
Внутренняя ошибка сервера. Сервер
неспособен выполнить запрос.
Попробуйте обратиться позже
1037
Missing region
Субъект федерации с указанным
идентификатором не найден
1007
Missing reporting period
Отчетный период с указанным
идентификатором не найден
1040
Missing house profile in this
reporting period
Анкета дома за указанный отчетный
период не найдена
1038
Page wasnt found
Страница с указанным номером не
найдена
1017
No permission to access
Нет доступа на чтение по указанному
Субъекту Федерации
1009
Mandatory field is null
Обязательное поле «НАЗВАНИЕ
ПОЛЯ» не заполнено
1010
Field "NAME" is not valid
Поле «НАЗВАНИЕ ПОЛЯ» заполнено
не верно
120
5.19 Метод GetCompanyProfileSF988
1) Описание метода
Метод получения данных анкеты (текущей и архивной) управляющей организации
по указанному субъекту федерации за указанный отчетный период. Чтение данных
постраничное, на одной странице передаются 100 анкет организаций.
2) Входные данные
В таблице представлены входные параметры метода (Таблица 132).
Таблица 132 – Входные параметры метода GetCompanyProfileSF988
Категория
Параметр
GetCompan region_id
yProfileSF9
88In
reporting_per
iod_id
page_number
Тип
character
varying
Max
Обязател
символов
ьность
Да
255
Да
integer
integer
Описание
Уникальный
идентификатор региона
(GUID из ФИАС)
Идентификатор
отчетного периода.
Идентификатор
отчетного периода
можно получить
методом
ReportingPeriodList
Номер страницы. По
умолчанию, будет
возвращаться первая
страница.
3) Выходные параметры
В таблице представлены выходные параметры метода (Таблица 133).
Таблица 133– Выходные параметры метода GetCompanyProfileSF988
Категория
GetCompan
yProfileSF9
88Response
Параметр
Тип
data
ArrayOfGet
CompanyPr
ofile988Res
ponse
page_number
page_count
integer
integer
Max
символов
Обязател
ьность
Да
Да
Да
121
Описание
Массив данных.
ArrayOfGetCompanyPro
file988Response
вызывает
GetCompanyProfile988R
esponse (Описано в
Таблица 134)
Номер страницы
Количество страниц
Таблица 134–Параметры GetCompanyProfile988Response
Категория
GetCompan
yProfile988
Response
Параметр
Тип
Max
символов
inn
name_full
name_short
last_update
under_manag
ement_house
s_count
under_manag
ement_house
s_square
company_pro
file_data
files_info
character
varying
character
varying
255
Да
255
Да
Да
timestamp(0
) without
time zone
integer
decimal
Обязател
ьность
Да
15.2
Да
CompanyPr
ofileData98
8
FileInfo
Описание
ИНН юридического
лица
Полное наименование
юридического лица
Краткое наименование
юридического лица.
Если ОКОПФ
«Индивидуальный
предприниматель», то
Краткое наименование
не обязательно на ввод.
Последнее изменение
анкеты
Количество домов,
находящихся в
управлении (ед.)
Площадь домов,
находящихся в
управлении (кв.м.)
Массив данных
(описано в Таблица
135)
Массив файлов анкеты
управляющей
организации (описано в
Таблица 107)
Таблица 135 – Описание типа CompanyProfileData988
Категория
CompanyPr
ofileData98
8
Параметр
Тип
okopf
Okopf
ogrn
character
varying
character
varying
character
varying
surname
firstname
Max
символов
Обязател
ьность
Да
Описание
255
Да
ОКОПФ. Передается
код всероссийского
справочника ОКОПФ в
формате «2 80 17»
(описано в Таблица 45)
ОГРН
255
Да
Фамилия
255
Да
Имя
122
Категория
Параметр
middlename
legal_address
actual_addres
s
post_address
phone
fax
Тип
character
varying
FiasAddress
Max
символов
255
Описание
Отчество
Да
Место государственной
регистрации
юридического лица
(идентификатор
юридического адреса)
(описано в
Таблица 23)
Адрес фактического
местонахождения
органов управления
(идентификатор
фактического адреса)
(описано в
FiasAddress
Таблица 23)
Почтовый адрес
(идентификатор
почтового адреса)
(описано в
FiasAddress
text
character
varying
character
varying
32
255
site
text
2500
work_time
text
2500
email
Обязател
ьность
Таблица 23)
Контактные телефоны
Факс
Адрес электронной
почты. Формат:
example@mail.ru
Официальный сайт в
сети Интернет
Режим работы, в т. ч.
часы личного приема
граждан
Адрес диспетчерской
службы (описано в
255
dispatcher_ad FiasAddress
dress
dispatcher_p
hone
dispatcher_w
ork_time
proportion_sf
text
2500
text
2500
decimal
5.2
proportion_m
o
decimal
5.2
Таблица 23)
Контактные телефоны
диспетчерской службы
Режим работы
диспетчерской службы
Доля участия в
уставном капитале
Субъекта РФ, %
Доля участия в
уставном капитале
123
Категория
Параметр
Тип
staff_regular
_total
staff_regular
_administrati
ve
staff_regular
_engineers
staff_regular
_labor
membership_
information
integer
chart_file_id
integer
Max
символов
integer
integer
2500
income_of_m decimal
ng
15.2
spending_of_
mng
15.2
decimal
Описание
муниципального
образования, %
Штатная численность
всего, чел.
Штатная численность,
чел (административный
персонал)
Штатная численность,
чел (инженеры)
Штатная численность,
чел (рабочий персонал)
Сведения о членстве
управляющей
организации,
товарищества или
кооператива в
саморегулируемой
организации
Устав товарищества
собственников жилья
или кооператива. Файл
добавляется только для
товариществ и
кооперативов. Если
идентификатор файла
не указан - это означает
удаление файла из
анкеты.
Сведения о доходах,
полученных за
оказание услуг по
управлению
многоквартирными
домами (по данным
раздельного учета
доходов и расходов),
руб.
Сведения о расходах,
понесенных в связи с
оказанием услуг по
управлению
многоквартирными
домами (по данным
integer
text
Обязател
ьность
124
Категория
Параметр
Тип
Max
символов
debt_for_ku
decimal
15.2
debt_for_ther
mal_energy
decimal
15.2
debt_for_ther
mal_energy_
by_heating
decimal
15.2
debt_for_ther
mal_energy_
by_hot_water
decimal
15.2
Обязател
ьность
Описание
раздельного учета
доходов и расходов),
руб.
Общая задолженность
управляющей
организации
(индивидуального
предпринимателя)
перед
ресурсоснабжающими
организациями за
коммунальные
ресурсы, руб.
Общая задолженность
управляющей
организации
(индивидуального
предпринимателя)
перед
ресурсоснабжающими
организациями за
коммунальные
ресурсы, руб. (по
тепловой энергии)
Общая задолженность
управляющей
организации
(индивидуального
предпринимателя)
перед
ресурсоснабжающими
организациями за
коммунальные
ресурсы, руб. (по
тепловой энергии для
нужд отопления)
Общая задолженность
управляющей
организации
(индивидуального
предпринимателя)
перед
ресурсоснабжающими
125
Категория
Параметр
Тип
Max
символов
debt_for_hot
_water
decimal
15.2
debt_for_col
d_water
decimal
15.2
debt_for_sew
erage
decimal
15.2
debt_for_gas
decimal
15.2
Обязател
ьность
Описание
организациями за
коммунальные
ресурсы, руб. (по
тепловой энергии для
нужд горячего
водоснабжения)
Общая задолженность
управляющей
организации
(индивидуального
предпринимателя)
перед
ресурсоснабжающими
организациями за
коммунальные
ресурсы, руб. (по
горячей воде)
Общая задолженность
управляющей
организации
(индивидуального
предпринимателя)
перед
ресурсоснабжающими
организациями за
коммунальные
ресурсы, руб. (по
холодной воде)
Общая задолженность
управляющей
организации
(индивидуального
предпринимателя)
перед
ресурсоснабжающими
организациями за
коммунальные
ресурсы, руб. (по
водоотведению)
Общая задолженность
управляющей
организации
(индивидуального
126
Категория
Параметр
Тип
Max
символов
debt_for_elec
trical_energy
decimal
12,2
debt_for_oth
er
decimal
15.2
annual_finan
cial_statemen
t_files
ArrayOfInt
Обязател
ьность
Описание
предпринимателя)
перед
ресурсоснабжающими
организациями за
коммунальные
ресурсы, руб. (по
поставке газа)
Общая задолженность
управляющей
организации
(индивидуального
предпринимателя)
перед
ресурсоснабжающими
организациями за
коммунальные
ресурсы, руб. (по
электрической энергии)
Общая задолженность
управляющей
организации
(индивидуального
предпринимателя)
перед
ресурсоснабжающими
организациями за
коммунальные
ресурсы, руб. (по
прочим ресурсам
(услугам))
Массив
идентификаторов
файлов годовой
бухгалтерской
отчетности
Массив
идентификаторов
файлов смет доходов и
расходов ТСЖ и ЖСК.
Файлы добавляются
только для товариществ
и кооперативов. Если
идентификатор файла
revenues_exp ArrayOfInt
enditures_esti
mates_files
127
Категория
Параметр
Тип
Max
символов
Обязател
ьность
не указан - это означает
удаление файла из
анкеты.
Массив
идентификаторов
файлов отчетов о
выполнении сметы
доходов и расходов.
Файлы добавляются
только для товариществ
и кооперативов. Если
идентификатор файла
не указан - это означает
удаление файла из
анкеты.
Нарушения.
ArrayOfDisturbance
вызывает Disturbance
(описано в таблице
Таблица 136)
Лицензии.
ArrayOfLicense
вызывает License
(Описано в Таблица
138). Редактирование
блока лицензий
недоступно, если
ОКОПФ с кодом «2 01
00» или «2 01 02» или
«2 01 03» или «2 01 04»
или «2 06 05» или «2 80
15» или «2 80 16».
performance_ ArrayOfInt
report_files
disturbances
ArrayOfDis
turbance
licenses
ArrayOfLic
ense
Описание
Таблица 136– Описание типа Disturbance
Тип
Disturbance
Параметр
id
Тип
Max
символов
Обязател
ьность
Описание
Идентификатор
нарушения. При записи
данных (метод
SetCompanyProfile988)
следующая логика
работы с нарушениями:
Если указать ID
integer
128
Тип
Параметр
Тип
Max
символов
Обязател
ьность
Описание
существующего
нарушения –
редактирование
нарушения.
Если указать ID
несуществующего
нарушения в анкете УО
– ошибка «Поле «data>disturbances>disturbance->id»
заполнено не верно».
Если не указать ID–
добавление нового
нарушения в анкету
УО. Если ничего не
прислать – удаление
нарушения.
Дата привлечения к
административной
ответственности
Тип лица,
привлеченного к
административной
ответственности
(возможные значения в
Таблица 137)
date_of_resp
onsibility
date
person_type
PersonType
person_fio
character
varying
255
person_positi
on
character
varying
255
subject_of_di
text
2500
ФИО лица,
привлеченного к
административной
ответственности. Поле
заполняется, если тип
лица = «Должностное
лицо», а иначе не
заполняется.
Должность лица,
привлеченного к
административной
ответственности. Поле
заполняется, если тип
лица = «Должностное
лицо», а иначе не
заполняется.
Предмет
129
Тип
Параметр
Тип
Max
символов
text
document_da
te
date
document_nu
mber
character
varying
document_fil
e_id
integer
measures_to_
eliminate
text
2500
integer
decimal
15.2
text
2500
Описание
административного
нарушения
Наименование
контролирующего
органа
Количество
выявленных нарушений
Размер штрафа
sturbance
supervisory_
authority_na
me
number_of_d
isturbance
amount_of_p
enalty
document_na
me
Обязател
ьность
Наименование
документа о
применении мер
административного
воздействия
Дата документа о
применении мер
административного
воздействия
Номер документа о
применении мер
административного
воздействия
Идентификатор
документа. Если
идентификатор файла
не указан - это означает
удаление файла из
анкеты.
Мероприятия,
проведенные для
устранения
выявленных нарушений
и результаты
административного
воздействия
255
2500
Таблица 137– Возможные значения PersonType
Тип
PersonType
Идентификатор
Значения
Юридическое лицо
Должностное лицо
1
2
130
Таблица 138– Описание типа License
Тип
License
Параметр
Тип
Max
символов
id
integer
license_numb
er
license_recei
pt_date
license_issui
ng_authority
license_docu
ment_file_id
character
varying
date
255
text
2500
Обязател
ьность
Описание
Идентификатор
лицензии. При записи
данных (метод
SetCompanyProfile988)
следующая логика
работы с нарушениями:
Если указать ID
существующей
лицензии –
редактирование
лицензии.
Если указать ID
несуществующей
лицензии в анкете УО –
ошибка «Поле «data>licenses->licence->id»
заполнено не верно».
Если не указать ID–
добавление новой
лицензии в анкету УО.
Если ничего не
прислать – удаление
лицензии.
Номер лицензии
Дата получения
лицензии
Орган, выдавший
лицензию
Идентификатор файла
лицензии. Если
идентификатор файла
не указан - это означает
удаление файла из
анкеты.
integer
Таблица 139– Выходные параметры метода GetCompanyProfileSF988 в случае
ошибочного выполнения
Категория
SoapFault
Параметр
code
name
Тип
Max
символов
Обязател
ьность
Описание
Код результата запроса
Наименование
integer
text
131
description
Описание
text
4) Пример вызова метода
SOAP-запрос:
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:api="http://reformagkh.ru/api">
<soapenv:Header>
<authenticate>i1c2lhe9a99q6g71q6ldeqfpd5</authenticate>
</soapenv:Header>
<soapenv:Body>
<api:GetCompanyProfileSF988
soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<region_id xsi:type="xsd:string">29251dcf-00a1-4e34-98d45c47484a36d4</region_id>
<page_number xsi:type="xsd:int">1</page_number>
<reporting_period_id xsi:type="xsd:int">22</reporting_period_id>
</api:GetCompanyProfileSF988>
</soapenv:Body>
</soapenv:Envelope>
SoapFault:
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="http://api.reformagkh.ru/api_document_literal"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<SOAP-ENV:Body>
<SOAP-ENV:Fault>
<faultcode>SOAP-ENV:Client</faultcode>
<faultstring>Mandatory field is null</faultstring>
<detail xsi:type="ns1:ErrorDetails">
<code>1009</code>
<name>Mandatory field is null</name>
<description>Обязательное поле «sessionId» не
заполнено</description>
</detail>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Отсутствие SoapFault означает успешное выполнение запроса.
5) Ошибки
Таблица 140 – Результаты вызова метода GetCompanyProfileSF988
Code
(Код результата
запроса)
Name
(Наименование)
Description
(Описание)
401
Unauthorized
Неавторизованный запрос
403
Forbidden
Нет прав на выполнение запроса
500
Internal Server Error
Внутренняя ошибка сервера. Сервер
132
Code
(Код результата
запроса)
Name
(Наименование)
Description
(Описание)
неспособен выполнить запрос.
Попробуйте обратиться позже.
1037
Missing region
Субъект федерации с указанным
идентификатором не найден
1038
Page wasnt found
Страница с указанным номером не
найдена
1017
No permission to access
Нет доступа на чтение по указанному
Субъекту Федерации
1007
Missing reporting period
Отчетный период с указанным
идентификатором не найден
1041
Reporting period is not
related to the Resolution 988
Данные по новым формам раскрытия
информации, согласно Постановлению
Правительства РФ № 988 от 27.09.2014
не относятся к запрашиваемому
отчетному периоду
1009
Mandatory field is null
Обязательное поле «НАЗВАНИЕ
ПОЛЯ» не заполнено
1010
Field "NAME" is not valid
Поле «НАЗВАНИЕ ПОЛЯ» заполнено
не верно
5.20 Метод GetCompanyProfile988
1) Описание метода
Метод получения данных анкеты (текущей и архивной) управляющей организации
с соответствующим ИНН за указанный отчетный период.
2) Входные данные
В таблице представлены входные параметры метода (Таблица 141).
Таблица 141 – Входные параметры метода GetCompanyProfile988
Категория
Параметр
GetCompan inn
yProfile988
In
reporting_per
iod_id
Тип
character
varying
bigint
Max
Обязател
символов
ьность
12
Да
Да
3) Выходные параметры
133
Описание
ИНН управляющей
организации
Идентификатор
отчетного периода
GetCompanyProfile988Out вызывает GetCompanyProfile988Response (Описано в
Таблица 134).
Таблица 142– Выходные параметры метода GetCompanyProfile988 в случае ошибочного
выполнения
Категория
SoapFault
Параметр
code
name
description
Тип
Max
символов
Обязател
ьность
Описание
Код результата запроса
Наименование
Описание
integer
text
text
4) Пример вызова метода
SOAP-запрос:
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:api="http://
reformagkh.ru/api">
<soapenv:Header>
<authenticate>ndk3a04qsobj5r1no40cjd0e42</authenticate>
</soapenv:Header>
<soapenv:Body>
<api:GetCompanyProfile988
soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<inn xsi:type="xsd:string">2462938589</inn>
<reporting_period_id xsi:type="xsd:int">22</reporting_period_id>
</api:GetCompanyProfile988>
</soapenv:Body>
</soapenv:Envelope>
SoapFault:
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="http://api.reformagkh.ru/api_document_literal"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<SOAP-ENV:Body>
<SOAP-ENV:Fault>
<faultcode>SOAP-ENV:Client</faultcode>
<faultstring>Mandatory field is null</faultstring>
<detail xsi:type="ns1:ErrorDetails">
<code>1009</code>
<name>Mandatory field is null</name>
<description>Обязательное поле «sessionId» не
заполнено</description>
</detail>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Отсутствие SoapFault означает успешное выполнение запроса.
5) Ошибки
134
Таблица 143 – Результаты вызова метода GetCompanyProfile988
Code
(Код результата
запроса)
Name
(Наименование)
Description
(Описание)
401
Unauthorized
Неавторизованный запрос
403
Forbidden
Нет прав на выполнение запроса
500
Internal Server Error
Внутренняя ошибка сервера. Сервер
неспособен выполнить запрос.
Попробуйте обратиться позже.
1007
Missing reporting period
Отчетный период с указанным
идентификатором не найден
1005
INN wasnt found
Управляющая организация с
указанным ИНН не найдена
1027
Missing company profile in
this reporting period
Анкета управляющей организации за
указанный отчетный период не найдена
1041
Reporting period is not
related to the Resolution 988
Данные по новым формам раскрытия
информации, согласно Постановлению
Правительства РФ № 988 от 27.09.2014
не относятся к запрашиваемому
отчетному периоду
1009
Mandatory field is null
Обязательное поле «НАЗВАНИЕ
ПОЛЯ» не заполнено
1010
Field "NAME" is not valid
Поле «НАЗВАНИЕ ПОЛЯ» заполнено
не верно
5.21 Метод GetHouseProfileSF988
1) Описание метода
Метод получения данных текущих/архивных анкет дома по указанному субъекту
федерации. Чтение данных постраничное, на одной странице передаются 100 анкет домов.
2) Входные данные
В таблице представлены входные параметры метода (Таблица 144).
Таблица 144 – Входные параметры метода GetHouseProfileSF988
Категория
Параметр
GetHouseP region_id
rofileSF988
Тип
character
varying
Max
Обязател
символов
ьность
Да
255
135
Описание
Уникальный
идентификатор региона
(GUID из ФИАС)
Категория
In
Параметр
Тип
page_number
integer
reporting_per
iod_id
bigint
Max
символов
Обязател
ьность
Да
Описание
Номер страницы. По
умолчанию, будет
возвращаться первая
страница.
Идентификатор
отчетного периода
3) Выходные параметры
В таблице представлены выходные параметры метода
GetHouseProfileSF988Out вызывает GetHouseProfileSF988Response.
(Таблица
145).
Таблица 145– Выходные параметры метода GetHouseProfileSF988Response
Категория
GetHousePr
ofileSF988
Response
Параметр
Тип
data
ArrayOfGet
HouseProfil
e988Respon
se
page_number
page_count
integer
integer
Max
символов
Обязател
ьность
Да
Да
Да
Описание
Массив
ArrayOfGetHouseProfile
988Response вызывает
GeHouseProfile988Resp
onse (описано в
Таблица 146)
Номер страницы
Количество страниц
Таблица 146– Выходные параметры метода GeHouseProfile988Response
Категория
Параметр
GetHousePr
ofile988Res
ponse
house_id
full_address
stage
inn
last_update
Тип
Max
символов
integer
FullAddress
HouseStage
Enum
character
varying
house_profile
_data
timestamp(0
) without
time zone
HouseProfil
eData988
files_info
FileInfo
Обязател
ьность
Да
Да
Да
Да
Да
Да
136
Описание
Идентификатор дома
Адрес дома
Идентификатор стадии
жизненного цикла дома
ИНН организации, в
управлении которой
находится дом
Последнее изменение
анкеты
Массив данных
(описано в таблице
Таблица 147)
Массив файлов анкеты
многоквартирного дома
(описано в Таблица
107)
Таблица 147– Описание типа HouseProfileData988
Категори
Параметр
я
HouseProf area_total
ileData988
area_residentia
l
Тип
decimal
Max
символов
15.2
decimal
15.2
area_non_resid decimal
ential
15.2
area_common_ decimal
property
15.2
is_alarm
boolean
method_of_for
ming_overhaul
_fund
integer
exploitation_st
art_year
integer
project_type
text
built_year
integer
house_type
HouseType
988Enum
integer
Да
FormingO
verhaulFu
ndEnum
2500
floor_count_m
ax
floor_count_m integer
in
entrance_count integer
elevators_coun
t
flats_count
Обязател
ьность
integer
Описание
Общая площадь дома,
кв.м
Общая площадь дома, в
т.ч. жилых помещений,
кв.м
Общая площадь дома, в
т.ч. нежилых
помещений, кв.м
Общая площадь дома, в
т.ч. помещений,
входящих в состав
общего имущества,
кв.м.
Признак аварийности.
Возможные значения:
true (да, дом
аварийный), false (нет,
дом не аварийный).
Значение по
умолчанию: «Нет».
Информация по
аварийности или при
отказе от аварийности
заполняется в теге
«alarm_info».
Способ формирования
фонда капитального
ремонта (описано в
Таблица 154).
Год ввода в
эксплуатацию (Формат:
‘2015’)
Серия, тип постройки
здания
Год постройки.
(Формат: ‘2015’)
Тип дома (описано в
Таблица 153)
Количество этажей,
наибольшее, ед.
Количество этажей,
наименьшее, ед.
Количество подъездов,
ед.
Количество лифтов, ед.
Количество
помещений, ед.
integer
137
Категори
я
Параметр
Тип
Max
символов
living_quarters
_count
integer
not_living_qua
rters_count
integer
area_land
decimal
15.2
parking_square decimal
15.2
HouseEnerg
yEfficiency
Class988En
um
additional_info text
2500
boolean
has_sportsgrou
nd
boolean
other_beautific
ation
text
foundation_typ HouseFoun
e
dationType
Enum
floor_type
HouseFloor
Type988En
um
wall_material
HouseWall
Material988
Enum
area_basement decimal
Описание
Количество
помещений, в том
числе, жилых, ед.
Количество
помещений, в том
числе, нежилых, ед.
Площадь земельного
участка, входящего в
состав общего
имущества в
многоквартирном доме,
кв.м
Площадь парковки в
границах земельного
участка, кв.м
Класс энергетической
эффективности
(описано в Таблица
152)
Дополнительная
информация
Элементы
благоустройства
(детская площадка).
Возможные значения
true (да, детская
площадка имеется),
false (нет, не имеется).
Элементы
благоустройства
(спортивная площадка).
Возможные значения
true (да, спортивная
площадка имеется) ,
false (нет, не имеется).
Элементы
благоустройства
(другое)
Идентификатор типа
фундамента (Описано в
Таблица 157)
Идентификатор типа
перекрытий (описано в
Таблица 158)
Материал несущих стен
(описано в Таблица
159)
Площадь подвала по
полу, кв.м
energy_efficie
ncy
has_playgroun
d
Обязател
ьность
2500
15.2
138
Категори
я
Параметр
Тип
chute_type
HouseChute
TypeEnum
chute_count
integer
electrical_type
HouseElectr
icalTypeEn
um
electrical_entri
es_count
heating_type
integer
hot_water_typ
e
HouseHotW
aterTypeEn
um
cold_water_ty
pe
HouseCold
WaterType
Enum
sewerage_type
HouseSewe
rageTypeEn
um
sewerage_cess
pools_volume
gas_type
decimal
ventilation_typ
e
HouseVenti
lationTypeE
num
firefighting_ty
pe
HouseFirefi
ghtingType
Enum
drainage_type
HouseDrain
ageTypeEn
Max
символов
Обязател
ьность
Описание
Идентификатор типа
мусоропровода
(описано в Таблица
160)
Количество
мусоропроводов, ед.
Идентификатор типа
системы
электроснабжения
(описано в Таблица
161)
Количество вводов в
МКД, ед.
Идентификатор типа
системы
теплоснабжения
(описано в Таблица
162)
Идентификатор типа
системы горячего
водоснабжения
(описано в Таблица
163)
Идентификатор типа
системы холодного
водоснабжения
(описано в Таблица
164)
Идентификатор типа
системы водоотведения
(описано в Таблица
165)
Объем выгребных ям,
куб.м
Идентификатор типа
системы газоснабжения
(описано в Таблица
166)
Идентификатор типа
системы вентиляции
(описано в Таблица
167)
Идентификатор типа
системы
пожаротушения
(описано в Таблица
168)
Идентификатор типа
системы водостоков
HouseHeati
ngTypeEnu
m
15.2
HouseGasT
ypeEnum
139
Категори
я
Параметр
Тип
Max
символов
ArrayOfHo
useCadastra
lNumber
facades
ArrayOfHo
useFacade
roofs
ArrayOfHo
useRoof
additional_
equipments
ArrayOfHo
useAddition
alEquipmen
t
metering_devi
ces
ArrayOfHo
useMetering
Device
lifts
ArrayOfHo
useLift
management_c
ontract
HouseMana
gementCont
ract
ArrayOfHo
useService
services
Описание
(описано в Таблица
169)
Кадастровый номер.
Массив
ArrayOfHouseCadastral
Number возвращает тип
данных
HouseCadastralNumber
(описано в Таблица
156).
Фасад. Массив данных
ArrayOfHouseFacade
возвращает тип данных
HouseFacade (описано в
Таблица 170).
Крыша. Массив данных
ArrayOfHouseRoof
возвращает тип
данныхHouseRoof
(описано в Таблица
172)
Иное
оборудование/конструк
тивный элемент.
Массив данных
ArrayOfHouseAdditional
Equipment возвращает
тип данных
HouseAdditionalEquipm
ent (описано в Таблица
175)
Общедомовые приборы
учета. Массив данных
ArrayOfHouseMetering
Device возвращает тип
данных
HouseMeteringDevice
(описано в Таблица
176)
Лифт. Массив данных
ArrayOfHouseLift
возвращает тип данных
HouseLift (описано в
Таблица 181)
Управление (описано в
Таблица 183)
um
cadastral_num
bers
Обязател
ьность
Работы (услуги) по
содержанию. Массив
140
Категори
я
Параметр
Тип
communal_ser
vices
ArrayOfHo
useCommu
nalService
common_prop
erties
ArrayOfHo
useCommo
nProperty
overhaul
HouseOver
haul
common_meet
ings
ArrayOfHo
useCommo
nMeeting
report
HouseRepor
t
alarm_info
HouseAlar
m
Max
символов
Обязател
ьность
Описание
данных
ArrayOfHouseService
возвращает тип данных
HouseService (описано
в Таблица 185)
Коммунальные услуги.
Массив данных
ArrayOfHouseCommuna
lService возвращает тип
данных
HouseCommunalService
(описано в Таблица
188)
Общее имущество.
Массив данных
ArrayOfHouseCommonP
roperty возвращает тип
данных
HouseCommonProperty
(описано в Таблица
193)
Сведения о КР
(описано в Таблица
195)
Общие собрания
собственников дома.
Массив данных
ArrayOfHouseCommon
Meeting тип данных
HouseCommonMeeting
(описано в Таблица
196)
Отчет по управлению
(описано в Таблица
197)
Информация при
признании дома
аварийным. При
признании дома
аварийным необходимо
заполнить информацию
из Таблица 148, для
отказа от аварийности
дополнительно
заполнить информацию
из Таблица 150. Пока
дом аварийный –
редактирование
информации по
аварийности доступно,
141
Категори
я
Параметр
Тип
Max
символов
Обязател
ьность
Описание
если есть отказ от
аварийности, то
редактирование
информации
недоступно. Для
повторного признания
дома аварийным
необходимо изменить
хотя бы одно поле из
Таблица 148, включая
изменение
идентификатора файла.
При условии, что
одновременно
заполнены данные двух
таблиц, произойдет
признание дома
аварийным и сразу же
отказ от аварийности.
Таблица 148– Описание типа HouseAlarm
Тип
HouseAlar
m
Параметр
Тип
document_da
te
date
document_nu
mber
character
varying
reason
AlarmReaso
nEnum
reason_other
text
failure
HouseAlar
mFailure
Max
символов
Обязател
ьность
Да
Да
255
Да
Да
2500
Описание
Дата документа
признания дома
аварийным
Номер документа
признания дома
аварийным
Причина признания
дома аварийным
(описано в Таблица
149)
Причина признания
дома аварийным (иная).
Заполняется если reason
= 6.
Информация при отказе
от аварийности дома
(Описано в
Таблица 150)
Таблица 149– Описание типа AlarmReasonEnum
Тип
AlarmReasonEnum
Идентификатор
Значения
Физический износ
Влияние окружающей среды
Природные катастрофы
1
2
3
142
Причины техногенного характера
Пожар
Иная
4
5
6
Таблица 150– Описание типа HouseAlarmFailure
Тип
HouseAlar
mFailure
Параметр
reason
Тип
Max
символов
AlarmFailur
eReasonEnu
m
Обязател
ьность
Да
Описание
Причина об отказе
признания аварийным
(описано в
Таблица 155)
document_na
me
character
varying
document_da
te
timestamp(0
) without
time zone
document_nu
mber
character
varying
files
ArrayOfInt
Наименование
документа об отказе
признания дома
аварийным. Поле
обязательное для
заполнения, если
reason != 1 (если тип
причины отказа не
равно «Ошибочный
признак состояния»)
Дата документа об
отказе признания
дома аварийным.
Поле обязательное
для заполнения, если
reason != 1 (если тип
причины отказа не
равно «Ошибочный
признак состояния»)
Номер документа об
отказе признания
дома аварийным.
Поле обязательное
для заполнения, если
reason != 1 (если тип
причины отказа не
равно «Ошибочный
признак состояния»)
Массив
идентификаторов
файлов документа об
отказе от признака
аварийности дома.
Указывается
255
255
143
Тип
Параметр
Тип
Max
символов
Обязател
ьность
Описание
идентификатор файла,
который был загружен
с помощью метода
SetUploadFile. При
повторном отказе от
аварийности
необходимо файлы
заново загрузить в
систему, а потом
прикрепить.
Таблица 151– Описание типа AlarmFailureFile
Категория
Параметр
file_id
Тип
Max
символов
Обязател
ьность
Описание
integer
Таблица 152– Возможные значения HouseEnergyEfficiencyClass988Enum
Тип
HouseEnergyEfficiency
Class988Enum
Идентификатор
Значения
Не присвоен
A
B++
B+
C
D
E
B
1
2
3
4
5
6
7
8
Таблица 153– Описание типа HouseType988Enum
Тип
HouseType988Enum
Идентификатор
Значения
Многоквартирный дом
Жилой дом блокированной застройки
Специализированный жилищный фонд
Жилой дом (индивидуальноопределенное здание)
(это значение не доступно для выбора,
по причине исключения из
справочника)
1
2
3
4
Таблица 154– Описание типа FormingOverhaulFundEnum
Тип
Идентификатор
Значения
144
FormingOverhaulFund
Enum
На специальном счете организации
На специальном счете у регионального
оператора
На счете регионального оператора
Не определен
1
2
3
4
Таблица 155– Описание типа AlarmFailureReasonEnum
Тип
AlarmFailureReasonEn
um
Идентификатор
Значения
Ошибочный признак состояния
Реконструкция
Признание пригодным для проживания
1
2
3
Таблица 156– Описание типа HouseCadastralNumber
Тип
Параметр
HouseCadas id
tralNumber
Cadastral_nu
mber
Тип
Max
символов
Описание
Идентификатор
кадастрового номера.
При записи данных
(метод
SetHouseProfile988)
следующая логика
работы с кадастровыми
номерами:
Если указать ID
существующего
кадастрового номера –
редактирование.
Если указать ID
несуществующего
кадастрового номера в
анкете дома – ошибка
«Поле «data->
cadastral_numbers >item->id» заполнено
не верно».
Если не указать ID–
добавление нового
кадастрового номера в
анкету дома. Если
ничего не прислать –
удаление кадастрового
номера.
Кадастровый номер
integer
character
varying
Обязател
ьность
250
145
Таблица 157– Возможные значения HouseFoundationTypeEnum
Тип
HouseFoundationType
Enum
Идентификатор
Значения
Ленточный
Бетонные столбы
Свайный
Иной
Столбчатый
Сплошной
Сборный
Отсутствует
1
2
3
4
5
6
7
8
Таблица 158– Возможные значения HouseFloorType988Enum
Тип
HouseFloorType988En
um
Идентификатор
Значения
Железобетонные
Деревянные
Смешанные
Иные
1
2
3
4
Таблица 159– Возможные значения HouseWallMaterial988Enum
Тип
HouseWallMaterial988
Enum
Идентификатор
Значения
Каменные, кирпичные
Панельные
Блочные
Смешанные
Деревянные
Монолитные
Иные
1
2
3
4
5
6
7
Таблица 160– Возможные значения HouseChuteTypeEnum
Тип
HouseChuteTypeEnum
Идентификатор
Значения
Отсутствует
Квартирные
На лестничной клетке
1
2
3
Таблица 161– Возможные значения HouseElectricalTypeEnum
Тип
HouseElectricalTypeEn
um
Идентификатор
Значения
Отсутствует
Центральное
Комбинированное
1
2
3
Таблица 162– Возможные значения HouseHeatingTypeEnum
Тип
Идентификатор
Значения
146
HouseHeatingTypeEnu
m
Отсутствует
Центральное
Автономная котельная (крышная,
встроенно-пристроенная)
Квартирное отопление (квартирный
котел)
Печное
Электроотопление
Индивидуальный тепловой пункт
(ИТП)
1
2
3
4
5
6
7
Таблица 163– Возможные значения HouseHotWaterTypeEnum
Тип
HouseHotWaterTypeE
num
Идентификатор
Значения
Отсутствует
Центральное (открытая система)
Центральное (закрытая система)
Автономная котельная (крышная,
встроенно-пристроенная)
Квартирное (квартирный котел)
Печное
Индивидуальный тепловой пункт
(ИТП)
1
2
3
4
5
6
7
Таблица 164– Возможные значения HouseColdWaterTypeEnum
Тип
HouseColdWaterTypeE
num
Идентификатор
Значения
Отсутствует
Центральное
Автономное
1
2
3
Таблица 165– Возможные значения HouseSewerageTypeEnum
Тип
HouseSewerageTypeEn
um
Идентификатор
Значения
Отсутствует
Центральное
Автономное
1
2
3
Таблица 166– Возможные значения HouseGasTypeEnum
Тип
HouseGasTypeEnum
Идентификатор
Значения
Отсутствует
Центральное
Автономное
1
2
3
147
Таблица 167– Возможные значения HouseVentilationTypeEnum
Тип
HouseVentilationType
Enum
Идентификатор
Значения
Отсутствует
Приточная вентиляция
Вытяжная вентиляция
Приточно-вытяжная вентиляция
1
2
3
4
Таблица 168– Возможные значения HouseFirefightingTypeEnum
Тип
HouseFirefightingType
Enum
Идентификатор
Значения
Отсутствует
Автоматическая
Пожарные гидранты
Пожарный кран
1
2
3
4
Таблица 169– Возможные значения HouseDrainageTypeEnum
Тип
HouseDrainageTypeEn
um
Идентификатор
Значения
Отсутствует
Наружные водостоки
Внутренние водостоки
Смешанные
1
2
3
4
Таблица 170– Описание типа HouseFacade
Тип
Параметр
HouseFacad id
e
Тип
Max
символов
Обязател
ьность
Описание
Идентификатор фасада.
При записи данных
(метод
SetHouseProfile988)
следующая логика
работы с фасадами:
Если указать ID
существующего фасада
– редактирование.
Если указать ID
несуществующего
фасада в анкете дома –
ошибка «Поле «data->
facades ->item->id»
заполнено не верно».
Если не указать ID–
добавление нового
фасада в анкету дома.
Если ничего не
integer
148
Тип
Параметр
Тип
Max
символов
Обязател
ьность
прислать – удаление
фасада.
Идентификатор типа
фасада (описано в
Таблица 171)
HouseFacad
eTypeEnum
Type
Описание
Таблица 171– Возможные значения HouseFacadeTypeEnum
Тип
HouseFacadeTypeEnu
m
Идентификатор
Значения
Соответствует материалу стен
Оштукатуренный
Окрашенный
Облицованный плиткой
Облицованный камнем
Сайдинг
Иной
1
2
3
4
5
6
7
Таблица 172– Описание типа HouseRoof
Тип
HouseRoof
Параметр
Тип
id
integer
Roof_type
HouseRoof
TypeEnum
Max
символов
Обязател
ьность
Описание
Идентификатор крыши.
При записи данных
(метод
SetHouseProfile988)
следующая логика
работы с крышами:
Если указать ID
существующей крыши
– редактирование.
Если указать ID
несуществующей
крыши в анкете дома –
ошибка «Поле «data->
roofs->item->id»
заполнено не верно».
Если не указать ID–
добавление новой
крыши в анкету дома.
Если ничего не
прислать – удаление
крыши.
Идентификатор типа
крыши (описано в
149
Тип
Параметр
roofing_type
Тип
Max
символов
Обязател
ьность
Описание
Таблица 173)
Идентификатор типа
кровли (описано в
Таблица 174)
HouseRoofi
ngTypeEnu
m
Таблица 173– Возможные значения HouseRoofTypeEnum
Тип
HouseRoofTypeEnum
Идентификатор
Значения
Плоская
Скатная
1
2
Таблица 174– Возможные значения HouseRoofingTypeEnum
Тип
HouseRoofingTypeEnu
m
Идентификатор
Значения
Из волнистых и полуволнистых
асбестоцементных листов (шиферная)
Из оцинкованной стали
Из металлочерепицы
Из профилированного настила
Из рулонных материалов
Мягкая (наплавляемая) крыша
Из иного материала
Безрулонная железобетонная крыша
1
2
3
4
5
6
7
8
Таблица 175– Описание типа HouseAdditionalEquipment
Тип
HouseAddit
ionalEquip
ment
Параметр
id
Тип
Max
символов
Обязател
ьность
Описание
Идентификатор
дополнительного
оборудования /
конструктивного
элемента. При записи
данных (метод
SetHouseProfile988)
следующая логика
работы с
оборудованием:
Если указать ID
существующего
оборудовния–
редактирование.
Если указать ID
несуществующего
integer
150
Тип
Параметр
Тип
Max
символов
Type
character
varying
255
description
text
2500
Обязател
ьность
Описание
оборудования в анкете
дома – ошибка «Поле
«data->
additional_equipments >item->id» заполнено
не верно».
Если не указать ID–
добавление нового
оборудования в анкету
дома. Если ничего не
прислать – удаление
оборудования.
Вид оборудования /
конструктивного
элемента
Описание
дополнительного
оборудования /
конструктивного
элемента
Таблица 176– Описание типа HouseMeteringDevice
Тип
Параметр
HouseMeter id
ingDevice
Тип
Max
символов
integer
151
Обязател
ьность
Да
Описание
Идентификатор
прибора учета. При
записи данных (метод
SetHouseProfile988)
следующая логика
работы с приборами
учета:
Если указать ID
существующего
прибора –
редактирование.
Если указать ID
несуществующего
прибора в анкете дома
– ошибка «Поле «data->
metering_devices ->item>id» заполнено не
верно».
Если не указать ID–
добавление нового
Тип
Параметр
Communal_r
esource_type
availability
Тип
Max
символов
HouseMeter
TypeEnum
Unit_of_mea
surement
UnitOfMeas
ureEnum
Commissioni
ng_date
date
Calibration_d
ate
date
Описание
прибора учета в анкету
дома. Если ничего не
прислать – удаление
прибора учета.
Идентификатор вида
коммунального ресурса
(описано в Таблица
177)
Идентификатор
наличия прибора учета
(описано в Таблица
178)
Идентификатор типа
прибора учета (описано
в Таблица 179).
Заполняется, если
значение в поле
«availability» равно
одному из
идентификаторов типа
MeteringDeviceAvailabil
ityEnum.
Идентификатор
единицы измерения
(описано в Таблица
180). Заполняется, если
значение в поле
«availability» равно
одному из
идентификаторов типа
MeteringDeviceAvailabil
ityEnum.
Дата ввода в
эксплуатацию.
Заполняется, если
значение в поле
«availability» равно
одному из
идентификаторов типа
MeteringDeviceAvailabil
ityEnum.
Дата поверки / замены
прибора учета.
Заполняется, если
значение в поле
«availability» равно
одному из
идентификаторов типа
MeteringDeviceAvailabil
ityEnum.
HouseCom
munalServi
ceTypeEnu
m
MeteringDe
viceAvailab
ilityEnum
meter_type
Обязател
ьность
152
Тип
Параметр
Is_default
Тип
Max
символов
Обязател
ьность
Описание
Признак определения
основной (is_default is
true) прибор учета или
пользовательский
(is_default is false).
Нельзя удалить
основные приборы
учета – их 6 штук.
Нельзя менять значение
в поле
«communal_resource_ty
pe (Вид коммунальной
услуги)» для основных
приборов учета, такая
возможность есть
только для
пользовательских
приборов. Пока не
заполнено поле
«availability (Наличие
приборы учета)» для
всех 6ти приборов,
нельзя добавить
пользовательский
прибор.
boolean
Таблица 177– Возможные значения HouseCommunalServiceTypeEnum
Тип
HouseCommunalServic
eTypeEnum
Идентификатор
Значения
Холодное водоснабжение
Горячее водоснабжение
Водоотведение
Электроснабжение
Отопление
Газоснабжение
Холодная вода для нужд ГВС
Тепловая энергия для подогрева
холодной воды для нужд ГВС
Газоснабжение для подогрева холодной
воды для нужд ГВС
Компонент на тепловую энергию для
ГВС
Обращение с твердыми
коммунальными отходами
1
2
3
4
5
6
7
8
9
10
11
153
Таблица 178– Возможные значения MeteringDeviceAvailabilityEnum
Тип
MeteringDeviceAvaila
bilityEnum
Идентификатор
Значения
Отсутствует, установка не требуется
Отсутствует, требуется установка
Установлен
1
2
3
Таблица 179– Возможные значения HouseMeterTypeEnum
Тип
HouseMeterTypeEnum
Идентификатор
Значения
Без интерфейса передачи данных
С интерфейсом передачи данных
1
2
Таблица 180– Возможные значения UnitOfMeasureEnum
Тип
UnitOfMeasureEnum
Идентификатор
Значения
кв.м
пог.м
шт.
куб.м
Гкал
Гкал/кв.м
Гкал/час
Гкал*час/кв.м
Гкал/год
чел.
ед.
руб.
%
°С*сут
км
куб.м/сут.
куб.м/квартира
куб.м/чел.в мес.
Вт/куб.м
кВт
кВА
Вт/(куб.м*°С)
час
дн.
тыс.руб.
м
кг
кг/куб.м
мВт
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
154
кВт/куб.м
кВт/ч
кВт*ч
руб/куб.м
куб.м/кв.м
кВт.ч/кв.м
руб./Гкал
руб./кВт.ч
Гкал/чел.
Гкал/куб.м
кВт/чел.
кВт*ч/чел.в мес.
руб./1000куб.м.
куб.м/кв.м общ. Имущества в мес.
кВт*ч/кв.м общ. Имущества в мес.
кВт/кв.м
Гкал/кв.м в мес.
Гкал/кв.м. в год
руб./чел. В мес.
руб./кв.м
руб./кг
1 пролёт
10 погонных метров
10 шт.
100 кв.м.
100 куб.м.
100 погонных метров
100 шт.
1000 кв.м.
1 м фальца
Квартира
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
Таблица 181– Описание типа HouseLift
Тип
HouseLift
Параметр
id
Тип
Max
символо
в
Обязатель
ность
Описание
Идентификатор лифта.
При записи данных
(метод
SetHouseProfile988)
следующая логика
работы с лифтами:
Если указать ID
integer
155
Тип
Параметр
porch_numbe
r
type
commissioni
ng_year
Тип
character
varying
HouseLiftT
ypeEnum
Max
символо
в
Обязатель
ность
Описание
существующего лифта
– редактирование.
Если указать ID
несуществующего
лифта в анкете дома –
ошибка «Поле «data->
lifts ->item->id»
заполнено не верно».
Если не указать ID–
добавление нового
лифта в анкету дома.
Если ничего не
прислать – удаление
лифта.
Номер подъезда
255
Идентификатор типа
лифта (описано в
Таблица 182)
Год ввода в
эксплуатацию (Формат:
‘2015’)
integer
Таблица 182– Возможные значения HouseLiftTypeEnum
Тип
HouseLiftTypeEnum
Идентификатор
Значения
Пассажирский
Грузовой
Грузо-пассажирский
1
2
3
Таблица 183– Описание типа HouseManagementContract
Категория
HouseMana
gementCont
ract
Параметр
Тип
Max
символов
date_start
date
management
_reason
confirm_met
hod_docume
nt_name
character
varying
255
text
2500
Обязател
ьность
Да
Да
Описание
Дата начала
обслуживания дома по
договору управления
Основание управления
Наименование
документа,
подтверждающего
выбранный способ
управления
156
confirm_met
hod_docume
nt_date
date
confirm_met
hod_docume
nt_number
character
varying
Дата документа,
подтверждающего
выбранный способ
управления
Номер документа,
подтверждающего
выбранный способ
управления
Дата договора
управления
255
management date
_contract_dat
e
management ArrayOfInt
_contract_file
s
Массив
идентификаторов
файлов договоров
управления. Если
идентификатор файла
не указан – это
означает удаление
файла из анкеты.
Таблица 184– Описание типа ManagementContractsFiles
Категория
Параметр
file_id
Тип
Max
символов
Обязател
ьность
Описание
Идентификатор файла
договора управления.
integer
Таблица 185– Описание типа HouseService
Категория
HouseServi
ce
Параметр
id
Тип
Max
символов
Обязател
ьность
Описание
Идентификатор работы
(услуги). При записи
данных (метод
SetHouseProfile988)
следующая логика
работы с
выполняемыми
работами (услугами):
Если указать ID
существующей работы
(услуги) –
редактирование.
Если указать ID
несуществующей
integer
157
Name
HouseServi
ceNameEnu
m
name_other
character
varying
Stop_reason_
type
ServiceStop
ReasonType
Enum
date_stop
date
Stop_reason
character
varying
Report
HouseServi
ceReport
costs
ArrayOfHo
255
255
Да
158
работы (услуги) в
анкете дома – ошибка
«Поле «data-> services>item->id» заполнено
не верно».
Если не указать ID–
добавление новой
работы (услуги) в
анкету дома.
Идентификатор
наименования
работы/услуги (описано
в Таблица 186)
Наименование работы
(прочая услуга).
Заполняется только при
HouseServiceNameEnu
m = 14.
Идентификатор типа
прекращения
предоставления работы
(услуги) (описано в
Таблица 203)
Дата истечения срока
предоставления услуги.
Заполняется, если
значение в поле
stop_reason_type = 1
(Срок действия
предоставления услуги
истек).
Основание
прекращения
предоставления услуг.
Заполняется, если
значение в поле
stop_reason_type = 1
(Срок действия
предоставления услуги
истек).
Отчет по выполненным
работам (услугам)
(описано в Таблица
202)
История стоимости
работы (услуги).
Массив данных
ArrayOfHouseServiceCo
st возвращает тип
данных
HouseServicesCost
(описано в Таблица
187). В истории
стоимости должна быть
хотя бы одна запись.
useServiceC
ost
Таблица 186– Возможные значения HouseServiceNameEnum
Тип
HouseServiceNameEnu
m
Идентификатор
Значения
Работы (услуги) по управлению
многоквартирным домом
Работы по содержанию помещений,
входящих в состав общего имущества в
многоквартирном доме
Работы по обеспечению вывоза
бытовых отходов
Работы по содержанию и ремонту
конструктивных элементов (несущих
конструкций и ненесущих конструкций)
многоквартирных домов
Работы по содержанию и ремонту
оборудования и систем инженернотехнического обеспечения, входящих в
состав имущества в многоквартирном
доме
Работы по содержанию и ремонту
мусоропроводов в многоквартирном
доме
Работы по содержанию и ремонту
лифта (лифтов) в многоквартирном
доме
Работы по обеспечению требований
пожарной безопасности
Работы по содержанию и ремонту
систем дымоудаления и вентиляции
Работы по содержанию и ремонту
систем внутридомового газового
оборудования
Обеспечение устранения аварий на
внутридомовых инженерных системах в
1
2
3
4
5
6
7
8
9
10
11
159
многоквартирном доме
Проведение дератизации и дезинсекции
помещений, входящих в состав общего
имущества в многоквартирном доме
Работы по содержанию земельного
участка с элементами озеленения и
благоустройства, иными объектами,
предназначенными для обслуживания и
эксплуатации многоквартирного дома
Прочая работа (услуга)
12
13
14
Таблица 187– Описание типа HouseServicesCost
Категория
HouseServi
cesCost
Параметр
Тип
year
integer
Plan_cost_pe
r_unit
decimal
Max
символов
Обязател
ьность
Да
15.2
Описание
Год предоставления
работы/услуги. Можно
указать только «2015»,
либо «2016», иначе
система выдаст
ошибку.
Годовая плановая
стоимость работ (услуг)
(руб.)
Таблица 188– Описание типа HouseCommunalService
Категория
HouseCom
munalServi
ce
Параметр
id
Тип
Max
символов
Обязател
ьность
Описание
Идентификатор
коммунальной услуги.
При записи данных
(метод
SetHouseProfile988)
следующая логика
работы с
коммунальными
услугами:
Если указать ID
существующей услуги
– редактирование.
Если указать ID
несуществующей
услуги в анкете дома –
ошибка «Поле «data->
communal_services-
integer
160
type
filling_fact
>item->id» заполнено
не верно».
Если не указать ID–
добавление новой
коммунальной услуги в
анкету дома
Вид коммунальной
услуги (описано в
Таблица 177)
HouseCom
munalServi
ceTypeEnu
m
СommunalS
erviceFillin
gFactEnum
Service_meth
od
CommunalS
erviceMeth
odEnum
tariff_descrip
tion
text
tariff_descrip
tion_file_id
integer
Supplied_via
_managemen
t_organizatio
n
boolean
2500
Да
161
Факт предоставления
услуги (описано в
Таблица 189).
Доступны все переходы
кроме перехода с факта
предоставления
«Прекращено» на
какой-либо другой факт
предоставления.
Основание
предоставления услуги
(описано в Таблица
190)
Описание
дифференциации
тарифов в случаях,
предусмотренных
законодательством
Российской Федерации
о государственном
регулировании цен
(тарифов)
Описание тарифа в
виде файла.
Идентификатор файла.
Если идентификатор
файла не указан – это
означает удаление
файла из анкеты.
Услуга предоставляется
через УО. Возможные
значения: true (да,
услуга предоставляется
через УО), false (нет,
услуга не
Provider_inn
character
varying
12
provider_na
me
character
varying
255
предоставляется через
УО).
ИНН лица,
осуществляющего
поставку
коммунального
ресурса. Заполняется,
если значение в поле
supplied_via_manageme
nt_organization is false
(услуга не
предоставляется через
УО)
Наименование лица,
осуществляющего
поставку
коммунального
ресурса. Заполняется,
если значение в поле
supplied_via_manageme
nt_organization is false
(услуга не
предоставляется через
УО)
Дополнительная
информация.
Заполняется, если
значение в поле
supplied_via_manageme
nt_organization is false
(услуга не
предоставляется через
УО)
Дата договора на
поставку
коммунального
ресурса. Заполняется,
если значение в поле
supplied_via_manageme
nt_organization is false
(услуга не
предоставляется через
УО)
Номер договора на
поставку
profider_addi
tional_info
supply_contr
act_date
date
supply_contr
act_number
character
varying
255
162
costs
ArrayOfHo
useCommu
nalServiceC
ost
Legal_act_of
_tariff_date
date
legal_act_of_ character
tariff_number varying
255
character
varying
255
legal_act_of_
tariff_org_na
me
коммунального
ресурса. Заполняется,
если значение в поле
supplied_via_manageme
nt_organization is false
(услуга не
предоставляется через
УО)
История стоимости
услуги. Массив данных
ArrayOfHouseCommuna
lServiceCost возвращает
тип данных
HouseCommunalService
Cost (описано в
Таблица 192). История
стоимости услуги
обязательно для
заполнения, если «Факт
предоставления» =
«Предоставляется» или
«Прекращено».
История стоимости
услуги не обязательно,
если «Факт
предоставления» =
«Предоставляется» или
«Прекращено» и
«Основание
предоставления» =
Предоставляется через
прямые договоры с
собственниками».
Дата нормативноправового акта,
устанавливающего
тариф
Номер нормативноправового акта,
устанавливающего
тариф
Наименование органа,
принявшего
нормативно-правовой
акт, устанавливающий
163
consumption
_norm
decimal
consumption
_norm_unit_
of_measurem
ent
UnitOfMeas
ureEnum
consumption
_norm_additi
onal_info
text
consumption decimal
_norm_on_co
mmon_needs
тариф
Норматив потребления
коммунальной услуги в
жилых помещениях
Идентификатор
единицы измерения
норматива потребления
коммунальной услуги в
жилых помещениях
(описано в Таблица
180)
Дополнительная
информация о
нормативе потребления
услуги в жилых
помещениях
Норматив потребления
коммунальной услуги
на общедомовые
нужды
Идентификатор
единицы измерения
норматива потребления
коммунальной услуги
на общедомовые
нужды (описано в
Таблица 180)
Дополнительная
информация о
нормативе потребления
услуги на общедомовые
нужды
Нормативно-правовой
акт, устанавливающий
норматив потребления
коммунальной услуги
(заполняется по
каждому нормативному
правовому акту).
Массив данных
ArrayOfHouseCommuna
lServiceNormativeAct
возвращает тип данных
HouseCommunalService
NormativeAct (описано
17.5
2500
17.5
consumption UnitOfMeas
_norm_on_co ureEnum
mmon_needs
_unit_of_mea
surement
consumption text
2500
_norm_on_co
mmon_needs
_additional_i
nfo
normative_ac ArrayOfHo
ts
useCommu
nalServiceN
ormativeAct
164
в Таблица 191)
Идентификатор типа
прекращения
предоставления услуги.
Для основной
коммунальной услуги
(is_default is true)
можно указать только
значение
ServiceStopReasonType
Enum = 1. (описано в
Таблица 203)
Дата истечения срока
предоставления услуги.
Заполняется, если
значение в поле
stop_reason_type = 1
(Срок действия
предоставления услуги
истек).
Основание
прекращения
предоставления услуг.
Заполняется, если
значение в поле
stop_reason_type = 1
(Срок действия
предоставления услуги
истек).
Отчет по управлению.
Объемы по
коммунальным услугам
(описано в Таблица
206). Объемы по
коммунальной услуге
не заполняются, если
«Описание
предоставления
услуги» =
«Предоставляется через
прямые договоры с
собственниками» или
«Факт предоставления
услуги» = «Не
предоставляется»
stop_reason_t ServiceStop
ReasonType
ype
Enum
date_stop
date
Stop_reason
character
varying
Volumes_rep
ort
HouseCom
munalServi
ceVolumes
Report
255
165
is_default
объемы по
коммунальной услуге
не заполняются
Признак определения
основная (is_default is
true) коммунальная
услуга или
пользовательская
(is_default is false).
Нельзя удалить
основные услуги – их 6
штук.
Нельзя менять значение
в поле «type (Вид
коммунальной услуги)»
для основных КУ, такая
возможность есть
только для
пользовательских КУ.
Пока не заполнено поле
«filling_fact (Факт
предоставления
услуги)» для всех 6ти
КУ, нельзя добавить
пользовательскую КУ.
boolean
Таблица 189– Возможные значения СommunalServiceFillingFactEnum
Тип
СommunalServiceFillin
gFactEnum
Идентификатор
Значения
Предоставляется
Не предоставляется
Прекращено
1
2
3
Таблица 190– Возможные значения CommunalServiceMethodEnum
Тип
СommunalServiceMeth
odEnum
Идентификатор
Значения
Предоставляется через договор
управления
Предоставляется через договор с ТСЖ и
ЖСК
Предоставляется через прямые
договоры с собственниками
1
2
3
Таблица 191– Описание типа HouseCommunalServiceNormativeAct
Категория
HouseCom
munalServi
Параметр
id
Тип
Max
символов
Обязател
ьность
Описание
Идентификатор
норматива
integer
166
ceNormativ
eAct
document_da
te
date
document_nu
mber
character
varying
255
document_or
ganization_n
ame
character
varying
255
Дата нормативного
правового акта,
устанавливающего
норматив потребления
коммунальной услуги
Номер нормативного
правового акта,
устанавливающего
норматив потребления
коммунальной услуги
Наименование
принявшего акт органа
Таблица 192– Описание типа HouseCommunalServiceCost
Категория
HouseCom
munalServi
ceCost
Параметр
Тип
id
integer
tariff_start_d
ate
unit_of_meas
urement
date
tariff
decimal
Max
символов
Обязател
ьность
Описание
Идентификатор
стоимости
Дата начала действия
тарифа
Идентификатор
единицы измерения
(описано в Таблица
180)
Тариф (цена) (руб.)
UnitOfMeas
ureEnum
15.3
Таблица 193– Описание типа HouseCommonProperty
Категория
HouseCom
monPropert
y
Параметр
id
Тип
Max
символов
Обязател
ьность
Описание
Идентификатор общего
имущества. При записи
данных (метод
SetHouseProfile988)
следующая логика
работы с общим
имуществом:
Если указать ID
существующего общего
имущества –
редактирование.
Если указать ID
несуществующего
общего имущества в
integer
167
Name
character
varying
255
function
text
2500
area
decimal
15.2
rent
HouseCom
monPropert
yRent
анкете дома – ошибка
«Поле «data->
common_properties >item->id» заполнено
не верно».
Если не указать ID–
добавление нового
общего имущества в
анкету дома. Если
ничего не прислать –
удаление общего
имущества.
Наименование объекта
общего имущества
Назначение объекта
общего имущества
Площадь объекта
общего имущества
(заполняется в
отношении помещений
и земельных участков),
кв.м
Общее имущество
сдается в аренду (в
пользование) (описано
в Таблица 194)
Таблица 194– Описание типа HouseCommonPropertyRent
Категория
Параметр
Тип
HouseCom
monPropert
yRent
provider_na
me
character
varying
provider_inn
character
varying
12
contract_num
ber
contract_date
contract_start
_date
cost_per_mo
nth
common_me
eting_protoco
character
varying
255
Max
символов
255
Описание
Наименование
владельца
(пользователя)
ИНН владельца
(пользователя)
Номер договора
Дата договора
Дата начала действия
договора
Стоимость по договору
в месяц, руб.
Дата протокола общего
собрания
date
date
decimal
Обязател
ьность
15.2
date
168
собственников
помещений
Номер протокола
общего собрания
собственников
помещений
l_date
common_me character
eting_protoco varying
l_number
255
Таблица 195– Описание типа HouseOverhaul
Категория
Параметр
Тип
HouseOver
haul
provider_inn
character
varying
provider_na
me
character
varying
Max
символов
12
255
common_me date
eting_protoco
l_date
common_me character
eting_protoco varying
l_number
255
payment_am
ount_for_1s
m
decimal
15.2
additional_in
fo
text
2500
169
Обязател
ьность
Описание
ИНН владельца
специального счета
Наименование
владельца
специального счета
Дата протокола общего
собрания
собственников
помещений, на котором
принято решение о
способе формирования
фонда капитального
ремонта
Номер протокола
общего собрания
собственников
помещений, на котором
принято решение о
способе формирования
фонда капитального
ремонта
Размер взноса на
капитальный ремонт на
1 кв. м в соответствии с
решением общего
собрания
собственников
помещений в
многоквартирном доме,
руб.
Дополнительная
информация
Таблица 196– Описание типа HouseCommonMeeting
Категория
HouseCom
monMeetin
g
Параметр
id
Тип
Max
символов
Protocol_date date
character
varying
protocol_file
_id
integer
Описание
Идентификатор общего
собрания. При записи
данных (метод
SetHouseProfile988)
следующая логика
работы с общим
собранием
собственников:
Если указать ID
существующего общего
собрания
собственников –
редактирование.
Если указать ID
несуществующего
общего собрания
собственников в анкете
дома – ошибка «Поле
«data->
common_meetings >item->id» заполнено
не верно».
Если не указать ID –
добавление нового
общего собрания
собственников в анкету
дома. Если ничего не
прислать – удаление
общего собрания
собственников.
Дата протокола общего
собрания
собственников
помещений
Номер протокола
общего собрания
собственников
помещений
Идентификатор файла.
Если идентификатор
файла не указан – это
означает удаление
integer
protocol_nu
mber
Обязател
ьность
255
170
файла из анкеты.
Таблица 197– Описание типа HouseReport
Категория
Параметр
HouseRepor common
t
Тип
Max
символов
Обязател
ьность
Отчеты по управлению.
Общая информация
(описано в Таблица
198)
Отчеты по управлению.
Коммунальные услуги
(описано в Таблица
199)
Отчеты по управлению.
Претензии по качеству
работ (описано в
Таблица 201)
Отчеты по управлению.
Претензионно-исковая
работа (описано в
Таблица 200)
HouseRepor
tCommon
communal_se HouseRepor
tCommunal
rvice
Service
claims_to_co
nsumers
HouseRepor
tClaimsToC
onsumers
house_report
_quality_of_
work_claims
HouseRepor
tQualityOf
WorkClaim
s
Описание
Таблица 198– Описание типа HouseReportCommon
Категория
Параметр
Тип
decimal
Max
символов
15.2
decimal
15.2
decimal
15.2
decimal
15.2
charged_for_ decimal
maintenance_
15.2
HouseRepor cash_balance
tCommon
_beginning_p
eriod_consu
mers_overpa
yment
cash_balance
_beginning_p
eriod
cash_balance
_beginning_p
eriod_consu
mers_arrears
charged_for_
services
Обязател
ьность
Описание
Авансовые платежи
потребителей (на
начало периода), руб.
Переходящие остатки
денежных средств (на
начало периода), руб.
Задолженность
потребителей (на
начало периода), руб.
Начислено за услуги
(работы) по
содержанию и
текущему ремонту, руб.
(всего)
Начислено за услуги
(работы) по
171
содержанию и
текущему ремонту, в
том числе, за
содержание дома, руб.
Начислено за услуги
(работы) по
содержанию и
текущему ремонту, в
том числе, за текущий
ремонт, руб.
Начислено за услуги
(работы) по
содержанию и
текущему ремонту, в
том числе, за услуги
управления, руб.
Получено денежных
средств, руб. (всего)
Получено денежных
средств, в т. Ч,
денежных средств от
собственников/нанимат
елей помещений, руб.
Получено денежных
средств, в т. Ч, целевых
взносов от
собственников/нанимат
елей помещений, руб.
Получено денежных
средств, в т. Ч,
субсидий, руб.
Получено денежных
средств, в т. Ч,
денежных средств от
использования общего
имущества, руб.
Получено денежных
средств, в т. Ч, прочие
поступления, руб.
of_house
charged_for_ decimal
maintenance_
work
15.2
charged_for_
management
_service
decimal
15.2
received_cas
h
received_cas
h_from_own
ers
decimal
15.2
decimal
15.2
received_targ
et_payment_f
rom_owners
decimal
15.2
received_sub
sidies
decimal
15.2
received_fro
m_use_of_co
mmon_prope
rty
decimal
15.2
received_fro
m_other
decimal
15.2
cash_total
decimal
15.2
cash_balance
_ending_peri
decimal
15.2
Всего денежных
средств с учетом
остатков, руб.
Авансовые платежи
потребителей на конец
172
od_consumer
s_overpayme
nt
cash_balance
_ending_peri
od
cash_balance
_ending_peri
od_consumer
s_arrears
периода, руб.
decimal
15.2
decimal
15.2
Переходящие остатки
денежных средств на
конец периода, руб.
Задолженность
потребителей на конец
периода, руб.
Таблица 199– Описание типа HouseReportCommunalService
Категория
Параметр
Тип
HouseRepor balance_begi
tCommunal nning_period
Service
_consumers_
overpayment
balance_begi
nning_period
decimal
Max
символов
15.2
decimal
15.2
balance_begi
nning_period
_consumers_
arrears
balance_endi
ng_period_co
nsumers_ove
rpayment
balance_endi
ng_period
decimal
15.2
decimal
15.2
Авансовые платежи
потребителей (на конец
периода), руб.
decimal
15.2
balance_endi decimal
ng_period_co
nsumers_arre
ars
claims_receiv integer
ed_count
15.2
Переходящие остатки
денежных средств (на
конец периода), руб.
Задолженность
потребителей (на конец
периода), руб.
claims_satisfi
ed_count
Обязател
ьность
Описание
Авансовые платежи
потребителей (на
начало периода), руб.
Переходящие остатки
денежных средств (на
начало периода), руб.
Задолженность
потребителей (на
начало периода), руб.
Количество
поступивших
претензий по качеству
предоставленных
коммунальных услуг,
ед.
Количество
удовлетворенных
integer
173
claims_denie
d_count
integer
produced_rec
alculation_a
mount
decimal
претензий по качеству
предоставленных
коммунальных услуг,
ед.
Количество претензий
по качеству
предоставленных
коммунальных услуг, в
удовлетворении
которых отказано
Сумма произведенного
перерасчета, руб.
15.2
Таблица 200– Описание типа HouseReportClaimsToConsumers
Категория
Параметр
Тип
HouseRepor sent_claims_
tClaimsToC count
onsumers
integer
filed_actions
_count
Received_cas
h_amount
integer
decimal
Max
символов
Обязател
ьность
Описание
Направлено претензий
потребителямдолжникам, ед.
Направлено исковых
заявлений, ед.
Получено денежных
средств по результатам
претензионно-исковой
работы, ед.
15.2
Таблица 201– Описание типа HouseReportQualityOfWorkClaims
Категория
Параметр
Тип
Max
символов
integer
claims_denie
d_count
integer
produced_rec
alculation_a
decimal
Описание
Количество
поступивших
претензий по качеству
работ, ед.
Количество
удовлетворенных
претензий по качеству
работ, ед.
Количество претензий
по качеству работ, в
удовлетворении
которых отказано, ед.
Сумма произведенного
перерасчета, руб.
HouseRepor claims_receiv integer
tQualityOf
ed_count
WorkClaim
s
claims_satisfi
ed_count
Обязател
ьность
15.2
174
mount
Таблица 202– Описание типа HouseServiceReport
Категория
Параметр
Тип
HouseServi
ceReport
fact_cost_per
_unit
decimal
volumes
ArrayOfHo
useServiceR
eportVolum
e
Max
символов
15.2
Обязател
ьность
Описание
Годовая фактическая
стоимость работ
(услуг), руб.
Детальный перечень
выполненных работ
(оказанных услуг) в
рамках выбранной
работы (услуги).
Массив данных
ArrayOfHouseServiceRe
portVolume возвращает
тип данных
HouseServiceReportVolu
me (описано в Таблица
204)
Таблица 203– Описание типа ServiceStopReasonTypeEnum
Тип
ServiceStopReasonTyp
eEnum
Идентификатор
Значения
Срок действия предоставления услуги
истек
Услуга была включена в список
предоставляемых услуг по ошибке
1
2
Таблица 204– Описание типа HouseServiceReportVolume
Категория
HouseServi
ceReportVo
lume
Параметр
id
Тип
Max
символов
Обязател
ьность
Описание
Идентификатор работы
(услуги), выполняемой
в рамках указанного
раздела работ (услуг).
При записи данных
(метод
SetCompanyProfile988)
следующая логика
работы с отчетом по
выполняемым работам
(услугам):
Если указать ID
сведений о
integer
175
Name
text
periodicity
HouseRepor
tServicesVo
lumesPeriod
icityEnum
unit_of_meas
urement
UnitOfMeas
ureEnum
cost_per_unit
decimal
выполняемых работах
(услугах) –
редактирование.
Если указать ID
несуществующих
сведений о
выполняемых работах в
анкете дома – ошибка
«Поле «data-> services > report -> volumes>id» заполнено не
верно».
Если не указать ID–
добавление новых
сведений о
выполняемых работах
(услугах) в анкету
дома. Если ничего не
прислать – удаление
сведений о
выполняемых работах.
Наименование работы
(услуги), выполняемой
в рамках указанного
раздела работ (услуг)
Периодичность
выполнения работ
(оказания услуг)
(описано в Таблица
205)
Идентификатор
единицы измерения
(описано в Таблица
180)
Стоимость на единицу
измерения, руб.
2500
15.3
Таблица 205– Описание типа HouseReportServicesVolumesPeriodicityEnum
Тип
HouseReportServicesV
olumesPeriodicityEnu
m
Идентификатор
Значения
Ежедневно
Еженедельно
Ежемесячно
Ежеквартально
Ежегодно
Один раз в сутки
1
2
3
4
5
6
176
Два и более раз в сутки
Один раз в неделю
Два и более раз в неделю
Один раз в месяц
Два и более раз в месяц
Один раз в квартал
Два и более раз в квартал
Один раз в год
Два и более раз в год
Один раз в сутки, при отрицательной
температуре
Два и более раз в сутки, при
отрицательной температуре
Один раз в неделю, при отрицательной
температуре
Два и более раз в неделю, при
отрицательной температуре
Один раз в сутки, при снегопаде
Два и более раз в сутки, при снегопаде
Один раз в неделю, при снегопаде
Два и более раз в неделю, при
снегопаде
При проведении капитального ремонта
При проведении текущего ремонта
При подготовке к зиме
По мере необходимости
По графику
По мере выявления
Ежедневно, кроме выходных и
праздничных дней
Ежедневно, кроме воскресных и
праздничных дней
Не реже одного раза в три дня
Постоянно при подготовке к
отопительному сезону
После отопительного сезона
Один раз в месяц (с ноября по апрель)
Иная
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
Таблица 206– Описание типа HouseCommunalServiceVolumesReport
Категория
Параметр
Тип
HouseCom
munalServi
ceVolumes
Report
unit_of_meas
urement
UnitOfMeas
ureEnum
total_volume
decimal
Max
символов
Обязател
ьность
Описание
Идентификатор
единицы измерения
(описано в Таблица
180)
Общий объем
потребления (нат.
15.2
177
accrued_cons
umer
Paid_by_con
sumers_amou
nt
Consumer_ar
rears
Cash_to_pro
vider_payme
nt
decimal
15.2
decimal
15.2
decimal
15.2
decimal
15.2
paid_to_supp
lier_amount
decimal
15.2
arrear_to_sup
plier_amount
decimal
15.2
total_penaltie
s
decimal
15.2
показ)
Начислено
потребителям, руб.
Оплачено
потребителями, руб.
Задолженность
потребителей, руб.
Начислено
поставщиком
(поставщиками)
коммунального
ресурса, руб.
Оплачено поставщику
(поставщикам)
коммунального
ресурса, руб.
Задолженность перед
поставщиком
(поставщиками)
коммунального
ресурса, руб.
Суммы пени и
штрафов, уплаченные
поставщику
(поставщикам)
коммунального
ресурса, руб.
Таблица 207– Выходные параметры метода GetHouseProfileSF988 в случае ошибочного
выполнения
Категория
SoapFault
Параметр
code
name
description
Тип
Max
символов
Обязател
ьность
Описание
Код результата запроса
Наименование
Описание
integer
text
text
4) Пример вызова метода
SOAP-запрос:
<soapenv:Envelope xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance”
xmlns:xsd=”http://www.w3.org/2001/XMLSchema”
xmlns:soapenv=”http://schemas.xmlsoap.org/soap/envelope/”
xmlns:api=”http://api.reformagkh.ru/api”>
<soapenv:Header>
<authenticate>m56iitk7o72g9beuqtqns83gg3</authenticate>
178
</soapenv:Header>
<soapenv:Body>
<api:GetHouseProfileSF988
soapenv:encodingStyle=”http://schemas.xmlsoap.org/soap/encoding/”>
<region_id xsi:type=”xsd:string”>0c5b2444-70a0-4932-980cb4dc0d3f02b5</region_id>
<page_number xsi:type=”xsd:int”>1</page_number>
<reporting_period_id xsi:type=”xsd:int”>22</reporting_period_id>
</api:GetHouseProfileSF988>
</soapenv:Body>
</soapenv:Envelope>
SoapFault:
<SOAP-ENV:Envelope xmlns:SOAP-ENV=”http://schemas.xmlsoap.org/soap/envelope/”
xmlns:ns1=”http://api.reformagkh.ru/api_document_literal”
xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance”>
<SOAP-ENV:Body>
<SOAP-ENV:Fault>
<faultcode>SOAP-ENV:Client</faultcode>
<faultstring>Mandatory field is null</faultstring>
<detail xsi:type=”ns1:ErrorDetails”>
<code>1009</code>
<name>Mandatory field is null</name>
<description>Обязательное поле «sessionId» не
заполнено</description>
</detail>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Отсутствие SoapFault означает успешное выполнение запроса.
5) Ошибки
Таблица 208 – Результаты вызова метода GetHouseProfileSF988
Code
(Код результата
запроса)
Name
(Наименование)
Description
(Описание)
401
Unauthorized
Неавторизованный запрос
403
Forbidden
Нет прав на выполнение запроса
500
Internal Server Error
Внутренняя ошибка сервера. Сервер
неспособен выполнить запрос.
Попробуйте обратиться позже
1037
Missing region
Субъект федерации с указанным
идентификатором не найден
1038
Page
Страница с указанным номером не
найдена
1017
No permission to access
ditin found
Нет доступа на чтение по указанному
Субъекту Федерации
179
1007
Missing reporting period
Отчетный период с указанным
идентификатором не найден
1040
Missing house profile in this
reporting period
Анкета дома за указанный отчетный
период не найдена
1041
Reporting period is not
related to the Resolution 988
Данные по новым формам раскрытия
информации согласно Постановлению
988 не относятся к запрашиваемому
отчетному периоду
1044
Availability of house
metering devices must be
filled
Необходимо заполнить информацию о
наличии прибора учета по всем видам
коммунальных ресурсов
1045
Communal service providing
must be filled
Необходимо заполнить информацию о
факте предоставления по всем видам
коммунальных ресурсов
1009
Mandatory field is null
Обязательное поле «НАЗВАНИЕ
ПОЛЯ» не заполнено
1010
Field “NAME” is not valid
Поле «НАЗВАНИЕ ПОЛЯ» заполнено
не верно
5.22 Метод GetHouseProfile988
1) Описание метода
Метод получения данных текущей/архивной анкеты дома с соответствующим
идентификатором дома.
2) Входные данные
В таблице представлены входные параметры метода (Таблица 209).
Таблица 209 – Входные параметры метода GetHouseProfile988
Категория
Параметр
GetHouseP
rofile988In
house_id
reporting_per
iod_id
Тип
Max
символов
bigint
bigint
Обязател
ьность
Да
Да
Описание
Идентификатор дома
Идентификатор
отчетного периода.
Идентификатор
отчетного периода
можно получить
методом
ReportingPeriodList
3) Выходные параметры
GetHouseProfileOut вызывает GetHouseProfile988Response (описано в Таблица 146)
180
Таблица 210– Выходные параметры метода GetHouseProfile988 в случае ошибочного
выполнения
Категория
SoapFault
Параметр
code
name
description
Тип
Max
символов
Обязател
ьность
Описание
Код результата запроса
Наименование
Описание
integer
text
text
4) Пример вызова метода
SOAP-запрос:
<soapenv:Envelope xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance”
xmlns:xsd=”http://www.w3.org/2001/XMLSchema”
xmlns:soapenv=”http://schemas.xmlsoap.org/soap/envelope/”
xmlns:api=”http://api.reformagkh.ru/api”>
<soapenv:Header>
<authenticate>9u14qpm7rk1vkuqg5sqnvvd3d6</authenticate>
</soapenv:Header>
<soapenv:Body>
<api:GetHouseProfile988
soapenv:encodingStyle=”http://schemas.xmlsoap.org/soap/encoding/”>
<house_id xsi:type=”xsd:int”>8961123</house_id>
<reporting_period_id xsi:type=”xsd:int”>22</reporting_period_id>
</api:GetHouseProfile988>
</soapenv:Body>
</soapenv:Envelope>
SoapFault:
<SOAP-ENV:Envelope xmlns:SOAP-ENV=”http://schemas.xmlsoap.org/soap/envelope/”
xmlns:ns1=”http://api.reformagkh.ru/api_document_literal”
xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance”>
<SOAP-ENV:Body>
<SOAP-ENV:Fault>
<faultcode>SOAP-ENV:Client</faultcode>
<faultstring>Mandatory field is null</faultstring>
<detail xsi:type=”ns1:ErrorDetails”>
<code>1009</code>
<name>Mandatory field is null</name>
<description>Обязательное поле «sessionId» не
заполнено</description>
</detail>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Отсутствие SoapFault означает успешное выполнение запроса.
5) Ошибки
Таблица 211 – Результаты вызова метода GetHouseProfile988
Code
(Код результата
запроса)
Name
(Наименование)
Description
(Описание)
181
401
Unauthorized
Неавторизованный запрос
403
Forbidden
Нет прав на выполнение запроса
500
Internal Server Error
Внутренняя ошибка сервера. Сервер
неспособен выполнить запрос.
Попробуйте обратиться позже
1004
House wasn’t found
Дом с указанным идентификатором не
найден
1007
Missing reporting period
Отчетный период с указанным
идентификатором не найден
1040
Missing house profile in this
reporting period
Анкета дома за указанный отчетный
период не найдена
1041
Reporting period is not
related to the Resolution 731
Данные по старым формам раскрытия
информации согласно Постановлению
731 не относятся к запрашиваемому
отчетному периоду
1009
Mandatory field is null
Обязательное поле «НАЗВАНИЕ
ПОЛЯ» не заполнено
1010
Field “NAME” is not valid
Поле «НАЗВАНИЕ ПОЛЯ» заполнено
не верно
5.23 Метод SetCompanyProfile988
1) Описание метода
Метод изменяет данные по текущей/архивной анкете управляющей организации с
соответствующим ИНН за указанный отчетный период. Внешняя система может
обновлять анкеты только тех организаций, по которым разрешена подписка.
2) Входные данные
В таблице представлены входные параметры метода (Таблица 21).
Таблица 212 – Входные параметры метода SetCompanyProfile988
Категор
Параметр
ия
SetComp inn
anyProfil
e988In
reporting_period_
id
Тип
character
varying
bigint
Max
символов
12
Обязательн
ость
Да
Да
182
Описание
ИНН
Идентификатор
отчетного
периода.
Идентификатор
отчетного
периода можно
Data
Да
CompanyProfi
leData988
получить с
помощью
метода
GetReportingPer
iodList.
Массив данных
(описано в
Таблица 135)
Таблица 213– Выходные параметры метода SetCompanyProfile988 в случае ошибочного
выполнения
Категория
SoapFault
Параметр
code
name
description
Тип
Max
символов
Обязател
ьность
Описание
Код результата запроса
Наименование
Описание
integer
text
text
3) Пример вызова метода
SOAP-запрос:
<soapenv:Envelope xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance”
xmlns:xsd=”http://www.w3.org/2001/XMLSchema”
xmlns:soapenv=”http://schemas.xmlsoap.org/soap/envelope/”
xmlns:api=”http://api.reformagkh.ru/api”
xmlns:soapenc=”http://schemas.xmlsoap.org/soap/encoding/”>
<soapenv:Header>
<api:Login
soapenv:encodingStyle=”http://schemas.xmlsoap.org/soap/encoding/”>
<login xsi:type=”xsd:string”>?</login>
<password xsi:type=”xsd:string”>?</password>
</api:Login>
</soapenv:Header>
<soapenv:Body>
<api:SetCompanyProfile988
soapenv:encodingStyle=”http://schemas.xmlsoap.org/soap/encoding/”>
<inn xsi:type=”xsd:string”>?</inn>
<reporting_period_id xsi:type=”xsd:int”>?</reporting_period_id>
<data xsi:type=”api:CompanyProfileData988”>
<!–You may enter the following 41 items in any order
<work_time xsi:type=”xsd:string”>?</work_time>
<dispatcher_address xsi:type=”api:FiasAddress”>
<!–You may enter the following 7 items in any order
<city_id xsi:type=”xsd:string”>?</city_id>
<street_id xsi:type=”xsd:string”>?</street_id>
<house_number xsi:type=”xsd:string”>?</house_number>
<building xsi:type=”xsd:string”>?</building>
<block xsi:type=”xsd:string”>?</block>
<room_number xsi:type=”xsd:string”>?</room_number>
<letter xsi:type=”xsd:string”>?</letter>
</dispatcher_address>
<dispatcher_phone xsi:type=”xsd:string”>?</dispatcher_phone>
<dispatcher_work_time
xsi:type=”xsd:string”>?</dispatcher_work_time>
<fax xsi:type=”xsd:string”>?</fax>
<staff_regular_total xsi:type=”xsd:int”>?</staff_regular_total>
183
<staff_regular_administrative
xsi:type=”xsd:int”>?</staff_regular_administrative>
<staff_regular_engineers
xsi:type=”xsd:int”>?</staff_regular_engineers>
<staff_regular_labor xsi:type=”xsd:int”>?</staff_regular_labor>
<membership_information
xsi:type=”xsd:string”>?</membership_information>
<chart_file_id xsi:type=”xsd:int”>?</chart_file_id>
<income_of_mng xsi:type=”api:Decimal152”>?</income_of_mng>
<spending_of_mng xsi:type=”api:Decimal152”>?</spending_of_mng>
<debt_for_ku xsi:type=”api:Decimal152”>?</debt_for_ku>
<debt_for_thermal_energy
xsi:type=”api:Decimal152”>?</debt_for_thermal_energy>
<debt_for_thermal_energy_by_heating
xsi:type=”api:Decimal152”>?</debt_for_thermal_energy_by_heating>
<debt_for_thermal_energy_by_hot_water
xsi:type=”api:Decimal152”>?</debt_for_thermal_energy_by_hot_water>
<debt_for_hot_water
xsi:type=”api:Decimal152”>?</debt_for_hot_water>
<debt_for_cold_water
xsi:type=”api:Decimal152”>?</debt_for_cold_water>
<debt_for_sewerage
xsi:type=”api:Decimal152”>?</debt_for_sewerage>
<debt_for_gas xsi:type=”api:Decimal152”>?</debt_for_gas>
<debt_for_electrical_energy
xsi:type=”api:Decimal152”>?</debt_for_electrical_energy>
<debt_for_other xsi:type=”api:Decimal152”>?</debt_for_other>
<annual_financial_statement_files xsi:type=”api:ArrayOfInt”
soapenc:arrayType=”xsd:int[]”/>
<revenues_expenditures_estimates_files xsi:type=”api:ArrayOfInt”
soapenc:arrayType=”xsd:int[]”/>
<performance_report_files xsi:type=”api:ArrayOfInt”
soapenc:arrayType=”xsd:int[]”/>
<disturbances xsi:type=”api:ArrayOfDisturbance”
soapenc:arrayType=”api:Disturbance[]”/>
<licenses xsi:type=”api:ArrayOfLicense”
soapenc:arrayType=”api:License[]”/>
<okopf xsi:type=”api:Okopf”>?</okopf>
<firstname xsi:type=”xsd:string”>?</firstname>
<surname xsi:type=”xsd:string”>?</surname>
<middlename xsi:type=”xsd:string”>?</middlename>
<ogrn xsi:type=”xsd:string”>?</ogrn>
<legal_address xsi:type=”api:FiasAddress”>
<!–You may enter the following 7 items in any order
<city_id xsi:type=”xsd:string”>?</city_id>
<street_id xsi:type=”xsd:string”>?</street_id>
<house_number xsi:type=”xsd:string”>?</house_number>
<building xsi:type=”xsd:string”>?</building>
<block xsi:type=”xsd:string”>?</block>
<room_number xsi:type=”xsd:string”>?</room_number>
<letter xsi:type=”xsd:string”>?</letter>
</legal_address>
<actual_address xsi:type=”api:FiasAddress”>
<!–You may enter the following 7 items in any order
<city_id xsi:type=”xsd:string”>?</city_id>
<street_id xsi:type=”xsd:string”>?</street_id>
<house_number xsi:type=”xsd:string”>?</house_number>
<building xsi:type=”xsd:string”>?</building>
<block xsi:type=”xsd:string”>?</block>
<room_number xsi:type=”xsd:string”>?</room_number>
<letter xsi:type=”xsd:string”>?</letter>
</actual_address>
<post_address xsi:type=”api:FiasAddress”>
184
<!–You may enter the following 7 items in any order
<city_id xsi:type=”xsd:string”>?</city_id>
<street_id xsi:type=”xsd:string”>?</street_id>
<house_number xsi:type=”xsd:string”>?</house_number>
<building xsi:type=”xsd:string”>?</building>
<block xsi:type=”xsd:string”>?</block>
<room_number xsi:type=”xsd:string”>?</room_number>
<letter xsi:type=”xsd:string”>?</letter>
</post_address>
<phone xsi:type=”xsd:string”>?</phone>
<email xsi:type=”xsd:string”>?</email>
<site xsi:type=”xsd:string”>?</site>
<proportion_sf xsi:type=”xsd:float”>?</proportion_sf>
<proportion_mo xsi:type=”xsd:float”>?</proportion_mo>
</data>
</api:SetCompanyProfile988>
</soapenv:Body>
</soapenv:Envelope>
SoapFault:
<SOAP-ENV:Envelope xmlns:SOAP-ENV=”http://schemas.xmlsoap.org/soap/envelope/”
xmlns:ns1=”http://api.reformagkh.ru/api”
xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance”>
<SOAP-ENV:Body>
<SOAP-ENV:Fault>
<faultcode>SOAP-ENV:Client</faultcode>
<faultstring>Mandatory field is null</faultstring>
<detail xsi:type=”ns1:ErrorDetails”>
<code>1009</code>
<name>Mandatory field is null</name>
<description>Обязательное поле «sessionId» не
заполнено</description>
</detail>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Отсутствие SoapFault означает успешное выполнение запроса.
4) Ошибки
Таблица 214 – Результаты вызова метода SetCompanyProfile988
Code
(Код результата
запроса)
Name
(Наименование)
Description
(Описание)
401
Unauthorized
Неавторизованный запрос
403
Forbidden
Нет прав на выполнение запроса
500
Internal Server Error
Внутренняя ошибка сервера. Сервер
неспособен выполнить запрос.
Попробуйте обратиться позже.
1007
Missing reporting period
Отчетный период с указанным
идентификатором не найден
1005
INN
didn’t found
Управляющая организация с
185
Code
(Код результата
запроса)
Name
(Наименование)
Description
(Описание)
указанным ИНН не найдена
1024
Missing OKOPF
ОКОПФ с указанным кодом не найдена
1027
Missing company profile in
this reporting period
Анкета управляющей организации за
указанный отчетный период не найдена
1020
External system has no
request
Внешняя система не подписана на
раскрытие данных по управляющей
организации
No permissions
У внешней системы нет разрешения на
раскрытие данных от управляющей
организации
1041
Reporting period is not
related to the Resolution 988
Данные по новым формам раскрытия
информации согласно Постановлению
988 не относятся к запрашиваемому
отчетному периоду
1043
It’s doesn’t fill up for official
Поле «НАЗВАНИЕ ПОЛЯ» не
заполняется для типа «Должностное
лицо»
1009
Mandatory field is null
Обязательное поле «НАЗВАНИЕ
ПОЛЯ» не заполнено
1010
Field “NAME” is not valid
Поле «НАЗВАНИЕ ПОЛЯ» заполнено
не верно
1021
186
5.24 Метод SetHouseProfile988
1) Описание метода
Метод изменяет данные текущей/архивной анкеты дома с соответствующим
идентификатором дома. Внешняя система может изменять данные анкет домов в
управлении организаций, по которым разрешена подписка. Проверка на принадлежность
дома управляющей организации, по которой есть разрешение на подписку раскрытия
данных.
2) Входные данные
В таблице представлены входные параметры метода (Таблица 64).
Таблица 215 – Входные параметры метода SetHouseProfile988
Категор
Параметр
ия
SetHouse house_id
Profile98
reporting_period_
8In
id
data
Тип
bigint
Обязательн
ость
Да
bigint
Да
HouseProfile
Data988
Да
Max
символов
Описание
Идентификатор
дома
Идентификатор
отчетного
периода.
Идентификатор
отчетного
периода можно
получить
методом
ReportingPeriod
List
Массив данных
(описано в
таблице
Таблица 147)
Таблица 216– Выходные параметры метода SetHouseProfile988 в случае ошибочного
выполнения
Категория
SoapFault
Параметр
code
name
description
Тип
Max
символов
Обязател
ьность
Описание
Код результата запроса
Наименование
Описание
integer
text
text
3) Пример вызова метода
SOAP-запрос:
<soapenv:Envelope xmlns:soapenv=”http://schemas.xmlsoap.org/soap/envelope/”
xmlns:api=”https://api-beta.reformagkh.ru/api_document_literal”>
<soapenv:Header/>
187
<soapenv:Body>
<api:SetHouseProfile988>
<house_id>?</house_id>
<reporting_period_id>?</reporting_period_id>
<data>
<!–You may enter the following 55 items in any order
<area_total>?</area_total>
<area_residential>?</area_residential>
<area_non_residential>?</area_non_residential>
<area_common_property>?</area_common_property>
<is_alarm>?</is_alarm>
<method_of_forming_overhaul_fund>?</method_of_forming_overhaul_fund>
<exploitation_start_year>?</exploitation_start_year>
<project_type>?</project_type>
<built_year>?</built_year>
<house_type>?</house_type>
<floor_count_min>?</floor_count_min>
<floor_count_max>?</floor_count_max>
<entrance_count>?</entrance_count>
<elevators_count>?</elevators_count>
<flats_count>?</flats_count>
<living_quarters_count>?</living_quarters_count>
<not_living_quarters_count>?</not_living_quarters_count>
<area_land>?</area_land>
<parking_square>?</parking_square>
<energy_efficiency>?</energy_efficiency>
<additional_info>?</additional_info>
<has_playground>?</has_playground>
<has_sportsground>?</has_sportsground>
<other_beautification>?</other_beautification>
<foundation_type>?</foundation_type>
<floor_type>?</floor_type>
<wall_material>?</wall_material>
<area_basement>?</area_basement>
<chute_type>?</chute_type>
<chute_count>?</chute_count>
<electrical_type>?</electrical_type>
<electrical_entries_count>?</electrical_entries_count>
<heating_type>?</heating_type>
<hot_water_type>?</hot_water_type>
<cold_water_type>?</cold_water_type>
<sewerage_type>?</sewerage_type>
<sewerage_cesspools_volume>?</sewerage_cesspools_volume>
<gas_type>?</gas_type>
<ventilation_type>?</ventilation_type>
<firefighting_type>?</firefighting_type>
<drainage_type>?</drainage_type>
<cadastral_numbers>
<!–Zero or more repetitions:
<item>
<!–You may enter the following 2 items in any order
<id>?</id>
<cadastral_number>?</cadastral_number>
</item>
</cadastral_numbers>
<facades>
<!–Zero or more repetitions:
<item>
<!–You may enter the following 2 items in any order
<id>?</id>
<type>?</type>
</item>
188
</facades>
<roofs>
<!–Zero or more repetitions:
<item>
<!–You may enter the following 3 items in any order
<id>?</id>
<roof_type>?</roof_type>
<roofing_type>?</roofing_type>
</item>
</roofs>
<additional_equipments>
<!–Zero or more repetitions:
<item>
<!–You may enter the following 3 items in any order
<id>?</id>
<type>?</type>
<description>?</description>
</item>
</additional_equipments>
<metering_devices>
<!–Zero or more repetitions:
<item>
<!–You may enter the following 8 items in any order
<id>?</id>
<communal_resource_type>?</communal_resource_type>
<availability>?</availability>
<meter_type>?</meter_type>
<unit_of_measurement>?</unit_of_measurement>
<commissioning_date>?</commissioning_date>
<calibration_date>?</calibration_date>
<is_default>?</is_default>
</item>
</metering_devices>
<lifts>
<!–Zero or more repetitions:
<item>
<!–You may enter the following 4 items in any order
<id>?</id>
<porch_number>?</porch_number>
<type>?</type>
<commissioning_year>?</commissioning_year>
</item>
</lifts>
<management_contract>
<!–You may enter the following 7 items in any order
<date_start>?</date_start>
<management_reason>?</management_reason>
<confirm_method_document_name>?</confirm_method_document_name>
<confirm_method_document_date>?</confirm_method_document_date>
<confirm_method_document_number>?</confirm_method_document_number>
<management_contract_date>?</management_contract_date>
<management_contract_files>
<!–Zero or more repetitions:
<item>?</item>
</management_contract_files>
</management_contract>
<services>
<!–Zero or more repetitions:
<item>
<!–You may enter the following 8 items in any order
<id>?</id>
<name>?</name>
189
<name_other>?</name_other>
<stop_reason_type>?</stop_reason_type>
<stop_reason>?</stop_reason>
<date_stop>?</date_stop>
<report>
<!–You may enter the following 2 items in any order
<fact_cost_per_unit>?</fact_cost_per_unit>
<volumes>
<!–Zero or more repetitions:
<item>
<!–You may enter the following 5 items in any
order
<id>?</id>
<name>?</name>
<periodicity>?</periodicity>
<unit_of_measurement>?</unit_of_measurement>
<cost_per_unit>?</cost_per_unit>
</item>
</volumes>
</report>
<costs SOAP-ENC:arrayType=”ns1:HouseServiceCost[2]”
xsi:type=”ns1:ArrayOfHouseServiceCost”>
<item xsi:type=”ns1:HouseServiceCost”>
<year xsi:type=”xsd:int”>?</year>
<plan_cost_per_unit>?<plan_cost_per_unit >
</item>
</costs>
</item>
</services>
<communal_services>
<!–Zero or more repetitions:
<item>
<!–You may enter the following 27 items in any order
<id>?</id>
<type>?</type>
<filling_fact>?</filling_fact>
<service_method>?</service_method>
<tariff_description>?</tariff_description>
<supplied_via_management_organization>?</supplied_via_management_organization
>
<provider_inn>?</provider_inn>
<provider_name>?</provider_name>
<provider_additional_info>?</provider_additional_info>
<supply_contract_date>?</supply_contract_date>
<supply_contract_number>?</supply_contract_number>
<costs>
<!–Zero or more repetitions:
<item>
<!–You may enter the following 4 items in any order
<id>?</id>
<tariff_start_date>?</tariff_start_date>
<unit_of_measurement>?</unit_of_measurement>
<tariff>?</tariff>
</item>
</costs>
<legal_act_of_tariff_date>?</legal_act_of_tariff_date>
<legal_act_of_tariff_number>?</legal_act_of_tariff_number>
<legal_act_of_tariff_org_name>?</legal_act_of_tariff_org_name>
<consumption_norm>?</consumption_norm>
190
<consumption_norm_unit_of_measurement>?</consumption_norm_unit_of_measurement
>
<consumption_norm_additional_info>?</consumption_norm_additional_info>
<consumption_norm_on_common_needs>?</consumption_norm_on_common_needs>
<consumption_norm_on_common_needs_unit_of_measurement>?</consumption_norm_on_
common_needs_unit_of_measurement>
<consumption_norm_on_common_needs_additional_info>?</consumption_norm_on_comm
on_needs_additional_info>
<normative_acts>
<!–Zero or more repetitions:
<item>
<!–You may enter the following 4 items in any order
<id>?</id>
<document_date>?</document_date>
<document_number>?</document_number>
<document_organization_name>?</document_organization_name>
</item>
</normative_acts>
<stop_reason_type>?</stop_reason_type>
<stop_reason>?</stop_reason>
<date_stop>?</date_stop>
<volumes_report>
<!–You may enter the following 9 items in any order
<unit_of_measurement>?</unit_of_measurement>
<total_volume>?</total_volume>
<accrued_consumer>?</accrued_consumer>
<paid_by_consumers_amount>?</paid_by_consumers_amount>
<consumer_arrears>?</consumer_arrears>
<cash_to_provider_payment>?</cash_to_provider_payment>
<paid_to_supplier_amount>?</paid_to_supplier_amount>
<arrear_to_supplier_amount>?</arrear_to_supplier_amount>
<total_penalties>?</total_penalties>
</volumes_report>
<is_default>?</is_default>
</item>
</communal_services>
<overhaul>
<!–You may enter the following 6 items in any order
<provider_inn>?</provider_inn>
<provider_name>?</provider_name>
<common_meeting_protocol_date>?</common_meeting_protocol_date>
<common_meeting_protocol_number>?</common_meeting_protocol_number>
<payment_amount_for_1sm>?</payment_amount_for_1sm>
<additional_info>?</additional_info>
</overhaul>
<common_meetings>
<!–Zero or more repetitions:
<item>
<!–You may enter the following 4 items in any order
<id>?</id>
<protocol_date>?</protocol_date>
<protocol_number>?</protocol_number>
<protocol_file_id>?</protocol_file_id>
</item>
</common_meetings>
<common_properties>
191
<!–Zero or more repetitions:
<item>
<!–You may enter the following 5 items in any order
<id>?</id>
<name>?</name>
<function>?</function>
<area>?</area>
<rent>
<!–You may enter the following 8 items in any order
<provider_name>?</provider_name>
<provider_inn>?</provider_inn>
<contract_number>?</contract_number>
<contract_date>?</contract_date>
<contract_start_date>?</contract_start_date>
<cost_per_month>?</cost_per_month>
<common_meeting_protocol_date>?</common_meeting_protocol_date>
<common_meeting_protocol_number>?</common_meeting_protocol_number>
</rent>
</item>
</common_properties>
<report>
<!–You may enter the following 4 items in any order
<common>
<!–You may enter the following 17 items in any order
<cash_balance_beginning_period>?</cash_balance_beginning_period>
<cash_balance_beginning_period_consumers_overpayment>?</cash_balance_beginnin
g_period_consumers_overpayment>
<cash_balance_beginning_period_consumers_arrears>?</cash_balance_beginning_pe
riod_consumers_arrears>
<charged_for_services>?</charged_for_services>
<charged_for_maintenance_of_house>?</charged_for_maintenance_of_house>
<charged_for_maintenance_work>?</charged_for_maintenance_work>
<charged_for_management_service>?</charged_for_management_service>
<received_cash>?</received_cash>
<received_cash_from_owners>?</received_cash_from_owners>
<received_target_payment_from_owners>?</received_target_payment_from_owners>
<received_subsidies>?</received_subsidies>
<received_from_use_of_common_property>?</received_from_use_of_common_property
>
<received_from_other>?</received_from_other>
<cash_total>?</cash_total>
<cash_balance_ending_period>?</cash_balance_ending_period>
<cash_balance_ending_period_consumers_overpayment>?</cash_balance_ending_peri
od_consumers_overpayment>
<cash_balance_ending_period_consumers_arrears>?</cash_balance_ending_period_c
onsumers_arrears>
</common>
<communal_service>
<!–You may enter the following 10 items in any order
<balance_beginning_period>?</balance_beginning_period>
192
<balance_beginning_period_consumers_overpayment>?</balance_beginning_period_c
onsumers_overpayment>
<balance_beginning_period_consumers_arrears>?</balance_beginning_period_consu
mers_arrears>
<balance_ending_period>?</balance_ending_period>
<balance_ending_period_consumers_overpayment>?</balance_ending_period_consume
rs_overpayment>
<balance_ending_period_consumers_arrears>?</balance_ending_period_consumers_a
rrears>
<claims_received_count>?</claims_received_count>
<claims_satisfied_count>?</claims_satisfied_count>
<claims_denied_count>?</claims_denied_count>
<produced_recalculation_amount>?</produced_recalculation_amount>
</communal_service>
<claims_to_consumers>
<!–You may enter the following 3 items in any order
<sent_claims_count>?</sent_claims_count>
<filed_actions_count>?</filed_actions_count>
<received_cash_amount>?</received_cash_amount>
</claims_to_consumers>
<house_report_quality_of_work_claims>
<!–You may enter the following 4 items in any order
<claims_received_count>?</claims_received_count>
<claims_satisfied_count>?</claims_satisfied_count>
<claims_denied_count>?</claims_denied_count>
<produced_recalculation_amount>?</produced_recalculation_amount>
</house_report_quality_of_work_claims>
</report>
<alarm_info>
<!–You may enter the following 5 items in any order
<document_date>?</document_date>
<document_number>?</document_number>
<reason>?</reason>
<reason_other>?</reason_other>
<failure>
<!–You may enter the following 5 items in any order
<reason>?</reason>
<document_name>?</document_name>
<document_date>?</document_date>
<document_number>?</document_number>
<files>
<!–Zero or more repetitions:
<item>?</item>
</files>
</failure>
</alarm_info>
</data>
</api:SetHouseProfile988>
</soapenv:Body>
</soapenv:Envelope>
SoapFault:
<SOAP-ENV:Envelope xmlns:SOAP-ENV=”http://schemas.xmlsoap.org/soap/envelope/”
xmlns:ns1=”http://api.reformagkh.ru/api”
xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance”>
<SOAP-ENV:Body>
193
<SOAP-ENV:Fault>
<faultcode>SOAP-ENV:Client</faultcode>
<faultstring>Mandatory field is null</faultstring>
<detail xsi:type=”ns1:ErrorDetails”>
<code>1009</code>
<name>Mandatory field is null</name>
<description>Обязательное поле «sessionId» не
заполнено</description>
</detail>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Отсутствие SoapFault означает успешное выполнение запроса.
4) Ошибки
Таблица 217 – Результаты вызова метода SetHouseProfile988
Code
(Код результата
запроса)
Name
(Наименование)
Description
(Описание)
401
Unauthorized
Неавторизованный запрос
403
Forbidden
Нет прав на выполнение запроса
500
Internal Server Error
Внутренняя ошибка сервера. Сервер
неспособен выполнить запрос.
Попробуйте обратиться позже
1004
House wasn’t found
Дом с указанным идентификатором не
найден
1014
Missing city
Населенный пункт с указанным
идентификатором не найден
1015
Missing street
Улица с указанным идентификатором
не найдена
1020
External system has no
request
Внешняя система не подписана на
раскрытие данных по управляющей
организации
1007
INN wasn’t found
Управляющая организация с
указанным ИНН не найдена
1011
House is not in company
Дом, находится в управлении другой
организации «ID УО, ИНН,
НАЗВАНИЕ», по которой нет
подписки
1040
Missing house profile in this
reporting period
Анкета дома за указанный отчетный
период не найдена
194
1044
Availability of house
metering devices must be
filled
Необходимо заполнить информацию о
наличии прибора учета по всем видам
коммунальных ресурсов
1045
Communal service providing
must be filled
Необходимо заполнить информацию о
факте предоставления по всем видам
коммунальных ресурсов
1011
Mandatory field is null
Обязательное поле «НАЗВАНИЕ
ПОЛЯ» не заполнено
1012
Field “NAME” is not valid
Поле «НАЗВАНИЕ ПОЛЯ» заполнено
не верно
195
СОСТАВ ПОКАЗАТЕЛЕЙ АНКЕТ, СОГЛАСНО
6
ПОСТАНОВЛЕНИЮ ПРАВИТЕЛЬСТВА РФ №731 от 23.09.2010,
КОТОРЫЕ НЕ МОГУТ ПРИНИМАТЬ ЗНАЧЕНИЕ «0»
В Таблица 218 представлены показатели анкеты управляющей организации,
которые не могут принимать значение «0».
Таблица 218 – Состав показателей анкеты управляющей организации
Наименование в wsdl
документе
Наименование поля
Группа показателей «Реквизиты»
Организационная форма
okopf
ИНН
inn
Юридический адрес (редактирование в
дополнительном модальном окне)
Населенный пункт
city_id
Улица
street_id
Фактический адрес (редактирование в
дополнительном модальном окне)
Населенный пункт
city_id
Улица
street_id
Почтовый адрес (редактирование в
дополнительном модальном окне)
Населенный пункт
city_id
Улица
street_id
Группа показателей «Сведения о
государственной регистрации»
ОГРН или ОГРНИП
ogrn
Дата присвоения ОГРН (ОГРНИП)
date_assignment_ogrn
Дополнительные сведения
Электронный адрес
email
Интернет-сайт
site
В Таблица 219 представлены показатели анкеты многоквартирного дома, которые
не могут принимать значение «0».
Таблица 219 – Состав показателей анкеты многоквартирного дома
Наименование в wsdl
документе
Наименование поля
Раздел «Общая характеристика»
196
Тип жилого дома
house_type
Состояние дома
state
Дата начала приватизации
privatization_start_date
Материал стен
wall_material
Тип перекрытий
floor_type
Этажность
storeys_count
Количество подъездов
Дата документа о признании дома
аварийным
entrance_count
emergency_date
Группа показателей «Удельная
тепловая характеристика здания»
Класс энергоэффективности здания
Дата проведения энергетического аудита
energy_efficiency
energy_audit_date
Группа показателей «Подвал»
Сведения о подвале
basement_stage
Группа показателей «Система
отопления»
Система отопления
Отпуск ресурсов производится
system_name
provisioning
Группа показателей «Система
горячего водоснабжения»
Система горячего водоснабжения
Отпуск ресурсов производится
system_name
provisioning
Группа показателей «Система
холодного водоснабжения»
Система холодного водоснабжения
Отпуск ресурсов производится
system_name
provisioning
Группа показателей «Система
канализации»
Система водоотведения (канализации)
system_name
197
Группа показателей «Система
электроснабжения»
Система электроснабжения
Отпуск ресурсов производится
system_name
provisioning
Группа показателей «Система
газоснабжения»
Вид системы газоснабжения
Отпуск ресурсов производится
system_name
provisioning
Раздел «Лифты»
Номер подъезда
porch_number
Количество остановок
stops_count
Грузоподъемность
capacity
Плановый срок замены (вывода из
эксплуатации)
plan_period
Раздел «Управление»
Тип договора
contract_type
Дата начала обслуживания дома по
договору управления
date_start
Плановая дата завершения обслуживания:
plan_date_stop
Раздел «Поставщики услуг»
ИНН
Inn
198
7
СПИСОК ОШИБОК ПЕРЕДАЧИ ИНФОРМАЦИИ
В случае возникновения ошибки обработка запроса прекращается, сервер
возвращает HTTP-статус ответа, отражающий суть произошедшей ошибки. Кроме статуса
в ответе передается краткое описание ошибки. Сообщение об ошибке возвращается
формате XML. Пример ошибки:
<SOAP-ENV:Envelope xmlns:SOAP-ENV=»http://schemas.xmlsoap.org/soap/envelope/»
xmlns:ns1=»http://api.reformagkh.ru/api»
xmlns:xsi=»http://www.w3.org/2001/XMLSchema-instance»>
<SOAP-ENV:Body>
<SOAP-ENV:Fault>
<faultcode>SOAP-ENV:Client</faultcode>
<faultstring>Unauthorized</faultstring>
<detail xsi:type=”ns1:ErrorDetails”>
<code>401</code>
<name>Unauthorized</name>
<description>Unauthorized</description>
</detail>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Таблица 220 – Список ошибок
Code
(Код результата
запроса)
Name
(Наименование)
Description
(Описание)
400
Bad request
Сервер обнаружил в запросе клиента
синтаксическую ошибку
401
Unauthorized
Неавторизованный запрос
403
Forbidden
Нет прав на выполнение запроса
404
Not Found
Указанный метод не найден
500
Internal Server Error
Внутренняя ошибка сервера. Сервер
неспособен выполнить запрос.
Попробуйте обратиться позже.
1002
Authentication failed
Логин не найден или логин не
соответствует паролю.
1003
User is blocked
Пользователь заблокирован
1004
House wasn’t found
Дом с указанным идентификатором не
найден
1005
INN wasnt found
Управляющая организация с
указанным ИНН не найдена
1006
User doesn’t conform to
Пользователь не соответствует
199
Code
(Код результата
запроса)
Name
(Наименование)
Description
(Описание)
external system
внешней системе
1007
Missing reporting period
Отчетный период с указанным
идентификатором не найден
1008
House is managed by any
organization
Дом не в управлении
1009
Mandatory field is null
Обязательное поле «НАЗВАНИЕ
ПОЛЯ» не заполнено
1010
Field is not valid
Поле «НАЗВАНИЕ ПОЛЯ» заполнено
не верно
1011
House is not in company
Дом, находится в управлении другой
организации «НАЗВАНИЕ УО», по
которой нет подписки
1012
House under the management
Дом уже под управлением
1013
Missing management date
Не заполнена дата начала управления
домом. Прежде чем прекратить
управление домом, Вам необходимо
заполнить дату начала управления с
помощью метода SetHouseProfile.
1014
Missing city
Населенный пункт с указанным
идентификатором не найден
1015
Missing street
Улица с указанным идентификатором
не найдена
1016
No interaction
Взаимодействие с системой «Реформа
ЖКХ» запрещено
1017
No permission to access
Нет доступа на чтение по указанному
Субъекту Федерации
1018
House is already exist
Дом с указанным адресом уже
существует
1019
Missing part of profile
Отсутствует раздел анкеты с
указанным идентификатором
1020
External system has no
request
Внешняя система не подписана на
раскрытие данных по управляющей
организации
1021
No permissions
У внешней системы нет разрешения на
раскрытие данных от управляющей
организации
1022
Extension is not valid
Файл с таким расширение не допустим
к загрузке
200
Code
(Код результата
запроса)
Name
(Наименование)
Description
(Описание)
1023
File Size Limit Exceeded
Размер загружаемого файла превышает
15MB
1024
Missing OKOPF
ОКОПФ с указанным кодом не найдена
1025
Technical works in the
system
Ведутся технические работы.
Попробуйте обратиться позже
1026
Part is not in house profile
Указан раздел «ИДЕНТИФИКАТОР
РАЗДЕЛА», который не относится к
анкете дома
1027
Missing company profile in
this reporting period
Анкета управляющей организации за
указанный отчетный период не найдена
1028
Part is not in company profile
Указан раздел «ИДЕНТИФИКАТОР
РАЗДЕЛА», который не относится к
анкете управляющей организации
1029
Request have been already
submitted
Запрос не создан. Запрос на подписку
уже был подан
1030
API – service is temporarily
unavailable
API-сервис доступен с 08:00 до 23:45
1032
The company with INN
already exist
Управляющая организация с
указанным ИНН уже зарегистрирована
в системе
1033
House wasn’t found
Дом с указанным адресом не найден
1035
Missing file
Файл с указанным идентификатором не
найден
1036
House unlinked already
Управление домом уже прекращено
1037
Missing region
Субъект федерации с указанным
идентификатором не найден
1038
Page
Страница с указанным номером не
найдена
ditin found
1039
House was added by error
Была указана причина прекращения
управления: «Дом был включен по
ошибке». Заполнение даты и основания
окончания управления не требуется.
1040
Missing house profile in this
reporting period
Анкета дома за указанный отчетный
период не найдена
1041
Reporting period is not
related to the Resolution 988
Данные по новым формам раскрытия
информации, согласно Постановлению
Правительства РФ № 988 от 27.09.2014
201
Code
(Код результата
запроса)
Name
(Наименование)
Description
(Описание)
не относятся к запрашиваемому
отчетному периоду
Reporting period is not
related to the Resolution 731
Данные по старым формам раскрытия
информации, согласно Постановлению
Правительства РФ № 731 от 23.09.2010
не относятся к запрашиваемому
отчетному периоду
1043
It fills up only for official
Поле «НАЗВАНИЕ ПОЛЯ»
заполняется только для типа
«Должностное лицо»
1044
Availability of house
metering devices must be
filled
Необходимо заполнить информацию о
наличии прибора учета по всем видам
коммунальных ресурсов
1045
Communal service providing
must be filled
Необходимо заполнить информацию о
факте предоставления по всем видам
коммунальных ресурсов
1046
If provider is MO field
“NAME” doesn’t fill up
Поле «НАЗВАНИЕ ПОЛЯ» не
заполняется, так как поставщиком
ресурсов является управляющая
организация.
1047
File is not from company
profile
Файл с указанным идентификатором не
относится к анкете УО
1048
File is not from house profile
Файл с указанным идентификатором не
относится к анкете МКД
1049
Can not delete default
communal service
Нельзя удалить коммунальную услугу
по умолчанию
1050
Can not delete default
metering device
Нельзя удалить прибор учета по
умолчанию
1051
Report of services is not
filled for services deleted by
mistake
По работе (услуге) удаленной по
ошибке отчет не заполняется
1052
Report of communal
services volumes is not filled
for communal services
deleted by mistake
По коммунальной услуге удаленной по
ошибке объемы не заполняется
1053
If “reason” = 1 (erroneous
state) parameters like
“document_name”,
“document_date”,
“document_number” are not
fiiled
Если причиной об отказе признания
дома аварийным является ошибочный
признак состояния, поля
«Наименование документа», «Дата
документа», «Номер документа» не
заполняются
1042
202
Code
(Код результата
запроса)
Name
(Наименование)
Description
(Описание)
1054
If “service_method” = 3 or
“filling_fact” = 2 report of
communal services volumes
is not filled
Если «Описание предоставления
услуги» = «Предоставляется через
прямые договоры с собственниками»
или «Факт предоставления услуги» =
«Не предоставляется» объемы по
коммунальной услуге не заполняются
1055
For default communal
services diting of
communal service type is
forbidded
Нельзя редактировать «Вид
коммунальной услуги» и флаг
«Коммунальная услуга по умолчанию»
для коммунальных услуг по
умолчанию
1056
Editing “type” and
“is_default” fields for default
metering device is forbidden
Нельзя редактировать «Вид
коммунальной услуги» для приборов
учета по умолчанию
1057
Missing id
Указанный идентификатор в «ПУТЬ К
НЕПРАВИЛЬНОМУ ID» не найден
1058
Doesn’t edit for removing or
not providing communal
service
Поле «НАЗВАНИЕ ПОЛЯ» не
доступно на редактирование для
удаленной или непредоставляемой
коммунальной услуги
1059
Doesn’t edit for removing
service
Поле «НАЗВАНИЕ ПОЛЯ» не
доступно на редактирование для
удаленной выполняемой работы
(услуги)
1060
Doesn’t edit for not
providing communal service
Поле «НАЗВАНИЕ ПОЛЯ» не
доступно на редактирование для
непредоставляемой коммунальной
услуги
9999
Custom error
Текст будет сформирован в
зависимости от ошибки
203
8
ТЕРМИНЫ И ОПРЕДЕЛЕНИЯ
API – (англ. Application programming interface) – интерфейс программирования
приложений (интерфейс прикладного программирования). Набор готовых классов,
процедур, функций, структур и констант, предоставляемых приложением (библиотекой,
сервисом) для использования во внешних программных продуктах.
XML – (англ. eXtensible Markup Language) – расширяемый язык разметки.
Спецификация XML описывает XML-документы и частично описывает поведение XMLпроцессоров (программ, читающих XML-документы и обеспечивающих доступ к их
содержимому).
SOAP – (от англ. Simple Object Access Protocol — простой протокол доступа к
объектам) — протокол обмена структурированными сообщениями в распределённой
вычислительной среде.
WSDL – (англ. Web Services Description Language) — язык описания веб-сервисов и
доступа к ним, основанный на языке XML.
GET и SET – методы доступа. Get выполняется, когда осуществляется чтение
данных, set выполняется, когда осуществляется запись данных.
ИНН
–
идентификационный
номер
налогоплательщик
Цифровой
код,
упорядочивающий учёт налогоплательщиков в Российской Федерации.
ФИАС – федеральная информационная адресная система. Классификатор содержит
адресные элементы и историю их изменения: регионы, районы, города, городские округа,
населенные пункты, улицы, дома.
Товарищества и кооперативы -
относятся следующие ОКОПФ «Товарищества
собственников жилья (2 80 16 ) », «Жилищные и жилищно-строительные кооперативы (2
01 02)», «Потребительские кооперативы (2 01 00)», «Жилищные накопительные
кооперативы (2 01 03)», «Кредитные потребительские кооперативы (2 01 04)»,
«Производственные кооперативы (артели) (1 40 00)», «Производственные кооперативы
(кроме сельскохозяйственных производственных кооперативов) (1 42 00)», «Союзы
(ассоциации) кооперативов (2 06 05)», «Сельскохозяйственные производственные
кооперативы (1 41 00)» и «Товарищество собственников недвижимости (2 80 15)».
ЖКХ – жилищно-коммунальное хозяйство. Комплекс отраслей экономики,
обеспечивающий функционирование инженерной инфраструктуры различных зданий в
населённых пунктах, создающий удобства и комфортабельность проживания и
нахождения в них людей путём предоставления им широкого спектра услуг.
204
ТСЖ – товарищество собственников жилья. Юридическое лицо, некоммерческая
организация,
созданная
на
основе
объединения
собственников
помещений
многоквартирного дома или собственников соседних участков с жилыми строениями
(домами) для совместного управления теми помещениями этого дома и землями, которые
находятся в совместном владении и пользовании, а также для ведения хозяйственной
деятельности в таком доме и на земле, находящейся в совместном владении, в форме
эксплуатации общего имущества, строительства дополнительных помещений и объектов
общего имущества, а также сдачи в аренду, внаём части общего имущества в
многоквартирном доме или общего земельного участка.
ЖСК – жилищно-строительный кооператив (жилищный кооператив). Объединение
людей или организаций, с целью строительства жилья, а также для управления жильем.
ТСН – товарищество собственников недвижимости.Добровольное объединение
собственников недвижимого имущества (помещений в здании, в том числе в
многоквартирном доме, или в нескольких зданиях, жилых домов, дачных домов,
садоводческих, огороднических или дачных земельных участков и т.п.), созданное ими
для совместного владения, пользования и в установленных законом пределах
распоряжения имуществом (вещами), в силу закона находящимся в их общей
собственности или в общем пользовании, а также, для достижения иных целей,
предусмотренных законом.
ОКОПФ – общероссийский классификатор организационно-правовых форм. В
классификаторе каждой организационно-правовой форме соответствует двухразрядный
цифровой код.
GUID
(Globally
Unique
Identifier)
статистически
уникальный
128-битный
идентификатор. Его главная особенность — уникальность, которая позволяет создавать
расширяемые сервисы и приложения без опасения конфликтов, вызванных совпадением
идентификаторов.
205
Лист регистрации изменений
№п/
п
Исполнитель
Версия
документ
а
Примечание
Дата
1.
ГК-Фонд
содействия
реформировани
ю ЖКХ
Добавлены методы чтения
GetCompanyProfileSF988,
GetCompanyProfile988.
2.
ГК-Фонд
содействия
реформировани
ю ЖКХ
Добавлены методы чтения
GetHouseProfileSF988, GetHouseProfile988.
Доработаны методы чтения по старым
формам GetHouseProfileSF,
GetHouseProfile. В старых методах стало
доступно чтение архивных анкет домов.
1.0.14
16.06.2015
3.
ГК-Фонд
содействия
реформировани
ю ЖКХ
Добавлены методы чтения GetHouseInfo,
GetHouseList.
1.0.15
19.06.2015
ГК-Фонд
содействия
реформировани
ю ЖКХ
Добавлены методы чтения/записи
GetRequestList, SetRequestForSubmit,
SetHouseProfile, SetHouseProfile988,
SetCompanyProfile, SetCompanyProfile988.
В «GetHouseProfileResponse» вынесены
следующие поля: state, emergency_date,
emergency_number, emergency_reason,
emergency_after в связи с невозможностью
редактирования. В методы записи данных
в анкеты УО/МКД добавлены возможности
прикрепления файла к требуемому
разделу. Добавление файлов таким путем
будет доступно в следующей версии.
1.0.16
03.07.2015
5.
ГК-Фонд
содействия
реформировани
ю ЖКХ
Добавлены методы: загрузки файла
«SetUploadFile», получения файла
«GetFileByID», взятие в управление
«SetHouseLinkToOrganization»,
прекращение управления домом
«SetUnlinkFromOrganization», создания
дома «SetNewHouse», создания заявки на
регистрацию новой УО «SetNewCompany».
Обновлены схемы взаимодействия.
1.0.17
13.07.2015
6.
ГК-Фонд
содействия
реформировани
ю ЖКХ
1.0.18
20.07.2015
7.
ГК-Фонд
содействия
реформировани
ю ЖКХ
1.0.19
21.07.2015
4.
1.0.13
Добавлены значения в следующие
справочники: HouseFirefightingTypeEnum,
HouseReportServicesVolumesPeriodicityEnu
m
Обновлены описания для параметров
chart_file_id,
revenues_expenditures_estimates_files,
performance_report_files
206
05.06.2015
Подпи
сь
№п/
п
Исполнитель
Примечание
Версия
документ
а
Дата
8.
ГК-Фонд
содействия
реформировани
ю ЖКХ
В метод SetHouseLinkToOrganizations
добавлено обязательное поле
management_reason (основание взятия в
управления домом)
1.0.20
23.07.2015
9.
ГК-Фонд
содействия
реформировани
ю ЖКХ
В метод GetHouseProfileSF988 добавлен
справочник возможных значений
HouseEnergyEfficiencyClass988Enum
1.0.21
29.07.2015
ГК-Фонд
содействия
реформировани
ю ЖКХ
В таблицу 180 добавлены новые единицы
измерения: кВт/кв.м, Гкал/кв.м в мес.,
Гкал/кв.м. в год
1.0.22
13.08.2015
1.0.23
02.10.2015
1.0.24
07.10.2015
1.0.25
15.10.2015
10.
11.
12.
13.
ГК-Фонд
содействия
реформировани
ю ЖКХ
ГК-Фонд
содействия
реформировани
ю ЖКХ
ГК-Фонд
содействия
реформировани
ю ЖКХ
1.
Смена типа поля porch_number номер подъезда (Таблица 221) на
стороковый тип «character
varying (255)».
2.
Таблица 138 переименован
параметр с license_file_id на
license_document_file_id.
3.
Условия записи данных по КУ и
текст ошибки №1054 изменены.
Добавлен пункт о строгом соблюдении
порядка следования параметров в тексте
запроса (стр. 16)
1.
Изменен тип поля
«date_of_responsibility» с
«timestamp(0) without time zone»
на «date».
2.
Исправлено описание: тип поля
«license_receipt_date» - date.
3.
Реализована возможность
добавления файла описания
тарифа в коммунальных услугах
14.
ГК-Фонд
содействия
реформировани
ю ЖКХ
Добавлены новые значения в справочники
«HouseFoundationTypeEnum»,
«UnitOfMeasureEnum»,
«HouseHeatingTypeEnum».
1.0.26
12.11.2015
15.
ГК-Фонд содействия
реформировани
ю ЖКХ
В таблицу №177 в тип
«HouseCommunalServiceTypeEnum»
добавлено новое значение «Обращение с
твердыми коммунальными отходами»
1.0.27
11.01.2016
16.
ГК-Фонд
содействия
реформировани
ю ЖКХ
В тип «HouseService» добавлен новый
параметр «costs» (Таблица 185). Параметр
«plan_cost_per_unit» вынесен в новый тип
«HouseServicesCost».
1.0.28
18.01.2016
207
Подпи
сь
№п/
п
Исполнитель
Примечание
Версия
документ
а
Дата
16.
ГК-Фонд
содействия
реформировани
ю ЖКХ
В таблицу 180 добавлены новые единицы
измерения: 1 пролёт, 10 погонных метров,
10 шт., 100 кв.м., 100 куб.м., 100 погонных
метров, 100 шт., 1000 кв.м., 1 м фальца.
1.0.29
28.01.2016
17
ГК-Фонд
содействия
реформировани
ю ЖКХ
В «HouseType988Enum» добавлен новый
тип «Жилой дом (индивидуальноопределенное здание)». Переименовано
значение «Общежитие» на
«Специализированный жилищный фонд».
1.0.30
10.02.2016
1.0.31
10.03.2016
1.0.32
15.03.2016
18
19
ГК-Фонд
содействия
реформировани
ю ЖКХ
ГК-Фонд
содействия
реформировани
ю ЖКХ
1.
В справочники
«HouseHeatingTypeEnum» и
«HouseHotWaterTypeEnum»
добавлено значение
"Индивидуальный тепловой пункт
(ИТП)".
2.
В справочник
«UnitOfMeasureEnum» добавлено
значение «Квартира».
3.
Добавлены условия заполнения
для параметра «licenses».
4.
Добавлена универсальная ошибка
с номером 9999 для читабельности
текста возникающих ошибок
1. В справочник
«HouseRoofingTypeEnum»
добавлено значение
«Безрулонная железобетонная
крыша»
2. Увеличен размер типа
cost_per_unit на decimal 15.3
(HouseServiceReportVolume)
208
Подпи
сь
Скачать