Выгрузка из ГИС ЖКХ ответов поставщиков жилищно-коммунальных услуг на запросы о наличии задолженности по оплате
Атрибут | Значение |
---|---|
Название | zhkh-debt-responses |
Наименование | Выгрузка из ГИС ЖКХ ответов поставщиков жилищно-коммунальных услуг на запросы о наличии задолженности по оплате |
Тип | Адаптер для СМЭВ3 сервиса |
Версия СМЭВ | СМЭВ3 |
Версия ВС | 1.0.0 |
Версия МР | 3.0 |
Принимаемые параметры
Параметр | Описание | Обязательное | Пример |
---|---|---|---|
information_system_id | Идентификатор информационной системы | + | b6d9d2d2-33a6-4982-9ffd-6a0010be9bf9 |
organization_id | Идентификатор зарегистрированной организации | + | 59749f1b-8feb-41f7-96d7-2a287ce233d5 |
request_ids | Идентификаторы запросов о наличии задолженности за ЖКУ | -1 | ["27f2b925-45e6-4802-9006-d7822542a29c"] |
request_numbers | Номер запросов, присвоенный ГИС ЖКХ | -1 | ["1234567890"] |
criteria | Условия отбора по атрибутам запроса | -1 | Составной элемент Criteria |
1 - обязательно должен присутствовать только один из элементов
Структура элемента Criteria
Параметр | Описание | Обязательное | Пример |
---|---|---|---|
request_creation_period | Период создания запроса в ГИС ЖКХ. Указываемый период не должен превышать 6-ти месяцев | + | Составной элемент RequestPeriod |
period_of_sending_request | Период направления запроса поставщикам ЖКУ. Указываемый период не должен превышать 6-ти месяцев | - | Составной элемент RequestPeriod |
period_of_response_date | Период крайнего срока ответа на запрос | - | Составной элемент OpenPeriod |
applicant_info | Информация о заявителе | - | Составной элемент ApplicantInfo |
house_ids | Идентификатор домов в Реестре адресных объектов ГИС ЖКХ, по которому осуществляются запросы. (не более 100 штук) | - | ["3463557f-4ade-4852-9355-07d79533ceb4"] |
request_statuses | Статусы запросов в ГИС ЖКХ (не более 4) | - | ["DRAFT"] |
request_results | Результаты выполнения запросов о наличии задолженности за ЖКУ | - | [1,2,3] |
export_request_id | Идентификатор, используемый для экспорта 2-го и последующих блоков данных | - | 1e029a86-215b-4cd7-bbd3-d78a216b655c |
Структура элемента RequestPeriod
Параметр | Описание | Обязательное | Пример |
---|---|---|---|
start | Начало периода | + | 2021-02-04 |
end | Конец периода | + | 2021-02-04 |
Структура элемента OpenPeriod
Параметр | Описание | Обязательное | Пример |
---|---|---|---|
start | Начало периода | - | 2012-04-04 |
end | Конец периода | - | 2012-04-04 |
Структура элемента ApplicantInfo
Параметр | Описание | Обязательное | Пример |
---|---|---|---|
firstname | Имя | - | Петр |
lastname | Фамилия | - | Петров |
middlename | Отчество | - | Петрович |
snils | СНИЛС | - | 12345678901 |
document | Документ, удостоверяющий личность заявителя | - | Document |
Структура элемента Document
Параметр | Описание | Обязательное | Пример |
---|---|---|---|
type | Вид документа | + | 1 |
series | Серия | + | 1234 |
number | Номер | + | 123456 |
Параметры ответа
Параметр | Описание | Обязательное | Пример |
---|---|---|---|
request_data | В ГИС ЖКХ данные запроса о наличии задолженности за ЖКУ | - | Последовательность элементов RequestData |
found_not | Запросы о наличии задолженности за ЖКУ, данные о которых не найдены в ГИС ЖКХ | - | Составной элемент FoundNot |
paged_output | Параметры, необходимые для экспорта следующего блока данных | - | Составной элемент PagedOutput |
error | Ошибка контроля или бизнес-процесса | - | Составной элемент Error |
attachments | Информация о полученных вложениях, сохраненных в файловом хранилище Агредатора | - | Последовательность элементов AggredatorAttachment |
Структура элемента RequestData
Параметр | Описание | Обязательное | Пример |
---|---|---|---|
request_id | Идентификатор запроса, присвоенный в ГИС ЖКХ | + | d1fedc52-b86a-47a0-826b-f0482566ebdc |
request_number | Номер запроса, присвоенный в ГИС ЖКХ | + | 123456789 |
applicant_info | Информация о заявителе | + | Составной элемент ApplicantResponseInfo |
house_fund_object | Сведения об объекте жилищного фонда (ОЖФ), по которому осуществляется запрос | + | Составной элемент HouseFundObject |
period | Период, за который запрашивается задолженность | - | Составной элемент Period |
organization | Сформировавшая запрос организация | + | Составной элемент Organization |
executor_info | Информация о сотруднике, сформировавшем запрос | + | Составной элемент ExecutorInfo |
status | Статус запроса в ГИС ЖКХ о наличии задолженности за ЖКУ | + | PROCESSED |
result | Результат выполнения запроса | + | 4 |
creation_date | Дата создания запроса | + | 2021-02-04+03:00 |
sent_date | Дата направления запроса поставщикам ЖКУ | - | 2021-02-04+03:00 |
response_date | Крайний срок ответа на запрос | - | 2021-02-08+03:00 |
subrequests | Запросы, направленные организациям, предоставляющим ЖКУ | - | Последовательность элементов Subrequest |
Структура элемента FoundNot
Параметр | Описание | Обязательное | Пример |
---|---|---|---|
request_ids | Идентификаторы запроса о наличии задолженности за ЖКУ | - | ["b5fb85dd-023f-45b4-9676-19343f661edd"] |
request_numbers | Номера запросов, присвоенные в ГИС ЖКХ | - | ["1b18626d-c5d8-4aa5-b383-bdb19c268b44"] |
Структура элемента PagedOutput
Параметр | Описание | Обязательное | Пример |
---|---|---|---|
next_request_id | Идентификатор, который необходимо указать в элементе export_request_id для экспорта следующего блока данных | - | 2f353cfc-4cc8-41db-b469-752b35deda4c |
last_page | Признак того, что текущий экспортируемый блок является последним | - | true |
Структура элемента Error
Параметр | Описание | Обязательное | Пример |
---|---|---|---|
error_code | Код ошибки | + | INT002012 |
description | Описание ошибки | + | Нет объектов для экспорта |
stacktrace | StackTrace в случае возникновения исключения | - |
Структура элемента AggredatorAttachment
Параметр | Описание | Обязательное | Пример |
---|---|---|---|
uuid | Идентификатор файла в файловом хранилище Агредатора | + | 7ca24dd0450bf0cc509f384f6198ff9ac12dd52f0ef1fc10d3af8c14c49876aa |
checksum | Контрольная сумма | + | e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 |
created_at | Время загрузки файла | + | 2020-11-16T12:27:20.726+03:00 |
tags | Последовательность строк-тегов файла | + | ["test"] |
filename | Имя загруженного файла | + | test.txt |
smev_id | Идентификатор вложения, используемый в СМЭВ конверте | + | attachment.txt |
Структура элемента ApplicantResponseInfo
Параметр | Описание | Обязательное | Пример |
---|---|---|---|
firstname | Имя | + | Петр |
lastname | Фамилия | + | Петров |
middlename | Отчество | - | Петрович |
snils | СНИЛС | + | 12345678910 |
document | Документ, удостоверяющий личность заявителя | + | Document |
Структура элемента HouseFundObject
Параметр | Описание | Обязательное | Пример |
---|---|---|---|
house_id | Идентификатор дома в Реестре адресных объектов ГИС ЖКХ | + | ac86917f-cf3d-4768-93e8-aac35566018a |
address_details | Дополнительная информация об ОЖФ (номер квартиры / помещения, комнаты, блока жилого дома). Обязателен для ОЖФ, имеющих тип многоквартирный дом или жилой дом блокированной застройки. Не указывается для ОЖФ, имеющих тип жилой дом | - | кв. 27 |
fias_house_id | Идентификатор дома по ФИАС | + | a266b05d-4b0b-42bf-b4b6-6db5a368fa1c |
address | Адресная строка | + | 153045, Ивановская обл, г. Иваново, ул. 3 Июня, д. 14 |
Структура элемента Period
Параметр | Описание | Обязательное | Пример |
---|---|---|---|
start_date | Начало периода | + | 2018-02-01+03:00 |
end_date | Конец периода | + | 2021-01-31+03:00 |
Структура элемента Organization
Параметр | Описание | Обязательное | Пример |
---|---|---|---|
organization_root_id | Корневой идентификатор организации (в Реестре организаций ГИС ЖКХ) | + | f8bead93-37bc-4408-93f2-86a1594c6896 |
name | Наименование организации | + | Администрация г. Иваново |
tel | Телефон организации | - | +7(4932)32-80-83 |
Структура элемента ExecutorInfo
Параметр | Описание | Обязательное | Пример |
---|---|---|---|
id | Идентификатор исполнителя | + | c845aa8a-3398-4ac0-9bd4-7e5d611dd8a5 |
fio | ФИО исполнителя | + | Четвертак Иван Иванович |
Структура элемента Subrequest
Параметр | Описание | Обязательное | Пример |
---|---|---|---|
organization | Организация, представляющая ЖКУ | + | Составной элемент Organization |
response | Ответ организации | - | Составной элемент Response |
Структура элемента Document
Параметр | Описание | Обязательное | Пример |
---|---|---|---|
type | Вид документа | + | 1 |
series | Серия | + | 1234 |
number | Номер | + | 123456 |
Структура элемента Response
Параметр | Описание | Обязательное | Пример |
---|---|---|---|
type | Способ формирования ответа на подзапрос | - | PROVIDED |
has_debt | Признак наличия задолженности, подтвержденной судебным актом | - | false |
debt_info | Информация о непогашенной задолженности, подтвержденной судебным актом | - | DebtInfo |
additional_files | Дополнительный файл | - | Attachment |
description | Дополнительная информация | - | |
executor_info | Информация о сотруднике, сформировавшем ответ | - | ExecutorInfo |
Структура элемента DebtInfo
Параметр | Описание | Обязательное | Пример |
---|---|---|---|
person | Информация о лице, в отношении которого имеется задолженность | + | Составной элемент DebtPerson |
documents | Документ, подтверждающий задолженность | - | Последовательность элементов CourtDocument |
Структура элемента DebtPerson
Параметр | Описание | Обязательное | Пример |
---|---|---|---|
firstname | Имя | + | Петр |
lastname | Фамилия | + | Петров |
middlename | Отчество | - | Петрович |
snils | СНИЛС | - | 12345678910 |
document | Документ, удостоверяющий личность | - | Составной элемент Document |
Структура элемента CourtDocument
Параметр | Описание | Обязательное | Пример |
---|---|---|---|
type | Код типа документа судебного акта | + | 1 |
attachment | Прикрепленный файл | + | Составной элемент Attachment |
Структура элемент Attachment
Параметр | Описание | Обязательное | Пример |
---|---|---|---|
metadata | Информация о файле | + | Составной элемент FileInformation |
smev_attachment_ref_guid | Уникальный идентификатор вложения из блока RefAttachmentHeaderList сообщения СМЭВ | - | df8aa667-0875-4eb2-bc63-5f2b34f3b3a1 |
Структура элемента FileInformation
Параметр | Описание | Обязательное | Пример |
---|---|---|---|
guid | Уникальный идентификатор файла | + | dcced63b-d0b6-438a-b3fd-9343e5bbbf38 |
name | Наименование файла | + | |
description | Описание файла | - | |
hash | Хэш-сумма, рассчитанная по алгоритму ГОСТ-34 в binhex | - |
Примеры
Для проверки настройки сервиса можно отправить в консоли отправки панели администрирования отправить запрос соответствующий контрольному примеру и получить соответствующий ответ.
Пример 1
Запрос:
{
"information_system_id": "35a823b4-55da-4622-a561-6bae5c0a00ba",
"organization_id": "6eef689e-48bb-4eb0-9c11-18b6db9909b7",
"request_ids": [
"bac4c940-6ad3-11eb-9439-0242ac130002",
"00000000-0000-0000-0000-000000000000"
]
}
Ответ:
{
"request_data": [
{
"request_id": "bac4c940-6ad3-11eb-9439-0242ac130002",
"request_number": "022021173",
"applicant_info": {
"firstname": "Иван",
"lastname": "Иванов",
"middlename": "Иванович",
"snils": "11111111145",
"document": {
"type": "1",
"series": "1234",
"number": "123456"
}
},
"housing_fund_object": {
"house_id": "e786b770-28e6-4557-8dde-86e8e347587e",
"address_details": "кв. 27",
"fias_house_id": "497cdeef-0388-466b-a063-36f51d94800c",
"address": "153045, Ивановская обл, г. Иваново, ул. 3 Июня, д. 14"
},
"period": {
"start_date": "2018-02-01+03:00",
"end_date": "2021-01-31+03:00"
},
"organization": {
"organization_root_id": "6eef689e-48bb-4eb0-9c11-18b6db9909b7",
"name": "Администрация г. Иваново",
"tel": "+7(4932)32-80-83"
},
"executor_info": {
"id": "84b12e02-6ad8-11eb-9439-0242ac130002",
"fio": "Четвертак Иван Иванович"
},
"status": "PROCESSED",
"result": "4",
"creation_date": "2021-02-04+03:00",
"sent_date": "2021-02-04+03:00",
"response_date": "2021-02-08+03:00",
"subrequests": [
{
"organization": {
"organization_root_id": "ad50290c-6ad9-11eb-9439-0242ac130002",
"name": "УК ООО \"ГУЖФ\"",
"tel": "8-800-200-50-58"
},
"response": {
"type": "PROVIDED",
"has_debt": "false",
"executor_info": {
"id": "38a794b8-6ada-11eb-9439-0242ac130002",
"fio": "Герасимова Ольга Ивановна"
}
}
}
]
}
],
"not_found": {
"request_ids": [
"00000000-0000-0000-0000-000000000000"
]
}
}
Пример 2
Запрос:
{
"information_system_id": "35a823b4-55da-4622-a561-6bae5c0a00ba",
"organization_id": "6eef689e-48bb-4eb0-9c11-18b6db9909b7",
"request_numbers": [
"022021173",
"0220210"
]
}
Ответ:
{
"request_data": [
{
"request_id": "bac4c940-6ad3-11eb-9439-0242ac130002",
"request_number": "022021173",
"applicant_info": {
"firstname": "Иван",
"lastname": "Иванов",
"middlename": "Иванович",
"snils": "11111111145",
"document": {
"type": "1",
"series": "1234",
"number": "123456"
}
},
"housing_fund_object": {
"house_id": "e786b770-28e6-4557-8dde-86e8e347587e",
"address_details": "кв. 27",
"fias_house_id": "497cdeef-0388-466b-a063-36f51d94800c",
"address": "153045, Ивановская обл, г. Иваново, ул. 3 Июня, д. 14"
},
"period": {
"start_date": "2018-02-01+03:00",
"end_date": "2021-01-31+03:00"
},
"organization": {
"organization_root_id": "6eef689e-48bb-4eb0-9c11-18b6db9909b7",
"name": "Администрация г. Иваново",
"tel": "+7(4932)32-80-83"
},
"executor_info": {
"id": "84b12e02-6ad8-11eb-9439-0242ac130002",
"fio": "Четвертак Иван Иванович"
},
"status": "PROCESSED",
"result": "4",
"creation_date": "2021-02-04+03:00",
"sent_date": "2021-02-04+03:00",
"response_date": "2021-02-08+03:00",
"subrequests": [
{
"organization": {
"organization_root_id": "ad50290c-6ad9-11eb-9439-0242ac130002",
"name": "УК ООО \"ГУЖФ\"",
"tel": "8-800-200-50-58"
},
"response": {
"type": "PROVIDED",
"has_debt": "false",
"executor_info": {
"id": "38a794b8-6ada-11eb-9439-0242ac130002",
"fio": "Герасимова Ольга Ивановна"
}
}
}
]
}
],
"not_found": {
"request_numbers": [
"0220210"
]
}
}
Пример 3
Запрос:
{
"information_system_id": "35a823b4-55da-4622-a561-6bae5c0a00ba",
"organization_id": "6eef689e-48bb-4eb0-9c11-18b6db9909b7",
"criteria": {
"request_creation_period": {
"start": "2021-02-04",
"end": "2021-02-04"
},
"house_ids": [
"e786b770-28e6-4557-8dde-86e8e347587e"
]
}
}
Ответ:
{
"request_data": [
{
"request_id": "bac4c940-6ad3-11eb-9439-0242ac130002",
"request_number": "022021173",
"applicant_info": {
"firstname": "Иван",
"lastname": "Иванов",
"middlename": "Иванович",
"snils": "11111111145",
"document": {
"type": "1",
"series": "1234",
"number": "123456"
}
},
"housing_fund_object": {
"house_id": "e786b770-28e6-4557-8dde-86e8e347587e",
"address_details": "кв. 27",
"fias_house_id": "497cdeef-0388-466b-a063-36f51d94800c",
"address": "153045, Ивановская обл, г. Иваново, ул. 3 Июня, д. 14"
},
"period": {
"start_date": "2018-02-01+03:00",
"end_date": "2021-01-31+03:00"
},
"organization": {
"organization_root_id": "6eef689e-48bb-4eb0-9c11-18b6db9909b7",
"name": "Администрация г. Иваново",
"tel": "+7(4932)32-80-83"
},
"executor_info": {
"id": "84b12e02-6ad8-11eb-9439-0242ac130002",
"fio": "Четвертак Иван Иванович"
},
"status": "PROCESSED",
"result": "4",
"creation_date": "2021-02-04+03:00",
"sent_date": "2021-02-04+03:00",
"response_date": "2021-02-08+03:00",
"subrequests": [
{
"organization": {
"organization_root_id": "ad50290c-6ad9-11eb-9439-0242ac130002",
"name": "УК ООО \"ГУЖФ\"",
"tel": "8-800-200-50-58"
},
"response": {
"type": "PROVIDED",
"has_debt": "false",
"executor_info": {
"id": "38a794b8-6ada-11eb-9439-0242ac130002",
"fio": "Герасимова Ольга Ивановна"
}
}
}
]
}
],
"paged_output": {
"last_page": true
}
}
Пример 4
Запрос:
{
"information_system_id": "35a823b4-55da-4622-a561-6bae5c0a00ba",
"organization_id": "6eef689e-48bb-4eb0-9c11-18b6db9909b7",
"criteria": {
"request_creation_period": {
"start": "2021-02-04",
"end": "2021-02-04"
},
"house_ids": [
"00000000-0000-0000-0000-000000000000"
]
}
}
Ответ:
{
"error": {
"error_code": "INT002012",
"description": "Нет объектов для экспорта"
}
}