Передача сведений о внесении платы за жилое помещение и жилищно-коммунальные услуги кредитными организациями
| Атрибут | Значение |
|---|---|
| Название | zhkh-import-notifications |
| Тип | Адаптер для вида сведений |
| Наименование | Передача сведений о внесении платы за жилое помещение и жилищно-коммунальные услуги кредитными организациями |
| Область применения | Межведомственное взаимодействие |
| Версия ВС | 1.0.0 |
| Версия МР | 3.0 |
| Версия СМЭВ | СМЭВ3 |
Переменные окружения
| Название | Описание |
|---|---|
| CA_CERT | сертификат центра сертификации для подключения к rabbitmq |
| CLIENT_CERT | сертификат, используемый для подключения к rabbitmq |
| CLIENT_KEY | ключ, используемый для подключения к rabbitmq |
| MQ_HOST | хост rabbitmq |
| MQ_PORT | порт rabbitmq |
| SMEV_SERVICE | название смэв сервиса, на который будут отправляться запросы |
Переменные для конфигурирования подключения к БД:
DATABASE_HOST, DATABASE_PORT, DATABASE_NAME, DATABASE_USER, DATABASE_PASS.
Переменные для конфигурирования отправки метрик в Elasticsearch:
ELASTIC_HOST, ELASTIC_PORT, ELASTIC_METRIC_PREFIX.
Принимаемые параметры
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| system_id | Идентификатор информационной системы. Предоставляется в личном кабинете ГИС ЖКХ руководителя организации | + | 3f8678e0-c69c-4bc0-998a-3be17a0ac8ad |
| organization_id | Идентификатор зарегистрированной организации. Для проверки прав доступа в соответствии с п.123 Приказа | + | f82e8882-72c1-4ba1-96be-516637c1adb7 |
| executions | Извещения о принятии к исполнению распоряжений в соответствии с п.138 589/944/пр | -1 | Последовательность элементов Execution |
| executions_139 | Извещения о принятии к исполнению распоряжений в соответствии с п.139 589/944/пр | -1 | Последовательность элементов Execution139 |
| cancellations | Извещения об аннулировании извещения о принятии распоряжения к исполнению | -1 | Последовательность элементов Cancellation |
1 - обязательно должен присутствовать только один из элементов
Cтруктура элемента Execution
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| transport_id | Транспортный идентификатор | + | ec032684-c825-49c6-866e-c2ac337a314b |
| recipient | Сведения об исполнителе жилищно-коммунальной услуги | + | Составной элемента Recipient |
| order | Общие сведения о распоряжении | + | Составной элемент Order |
Структура элемента Recipient
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| inn | ИНН | + | 1098765433 |
| individual_entrepreneur | Исполнитель-ИП | -1 | Составной элемент FIO |
| individual_entrepreneur | Исполнитель-ИП (ФИО одной строкой) | -1 | Иванов Иван Иванович |
| legal | Исполнитель-ЮЛ | -1 | Составной элемент Legal |
| payment_information | Сведения о платежных реквизитах | + | Составной элемент PaymentInformation |
1 - обязательно должен присутствовать только один из элементов
Структура элемента Order
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| id | Уникальный номер платежа (идентификатор операции) | + | 00000000000000000000000000007778 |
| date | Дата внесения платы | + | 2018-05-17 |
| amount | Сумма оплаты (в копейках) | + | 10 |
| payment_purpose | Назначение платежа | - | Тест |
| comment | Произвольный комментарий | - | Тест |
| payment_document_id | Идентификатор платежного документа | - | 10АА008025-01-6061 |
| payment_document_number | Номер платежного документа, по которому внесена плата, присвоенный такому документу исполнителем в целях осуществления расчетов по внесению платы | - | |
| month | Месяц | -1 | 6 |
| year | Год | -1 | 2015 |
| unified_account_number | Единый лицевой счет | - | |
| address_and_consumer | Адрес помещения и реквизиты потребителя | - | Составной элемент AddressAndConsumer |
| service_id | Идентификатор жилищно-коммунальной услуги | - | |
| account_number | Номер лицевого счета/Иной идентификатор плательщика | - |
1 - должны быть указаны одновременно либо отсутствовать
Структура элемента FIO
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| name | Имя | + | Иван |
| surname | Фамилия | + | Иванов |
| patronymic | Отчество | - | Иванович |
Структура элемента Legal
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| kpp | КПП | + | 987654321 |
| name | Наименование | + | УО Elvis |
Структура элемента PaymentInformation
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| recipient_inn | ИНН получателя платежа | + | 1098765433 |
| recipient_kpp | КПП получателя платежа | - | 987654321 |
| bank_name | Наименование банка получателя платежа | + | Банк |
| payment_recipient | Наименование получателя | + | УО Elvis |
| bik | БИК банка получателя | + | 044206704 |
| operating_account_number | Номер расчетного счета | + | 30301810000006000001 |
| correspondent_account_number | Корр. счет банка получателя | - | 30101810700000000704 |
| kbk | Код из Классификатора доходов в бюджет | - | |
| oktmo | Код из Общероссийского классификатора территорий муниципальных образований | - | 04701000001 |
| number_budgetary_account | Номер лицевого счета, открытый в органах Федерального казначейства (финансовых органах) | - |
Структура элемента AddressAndConsumer
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| fias_house_guid | Глобальный уникальный идентификатор дома по ФИАС | + | 965dd7df-1cec-4b69-9775-54f8902236b0 |
| residential_premise | Номер жилого помещения | -1 | |
| residential_premise_room | Номер комнаты жилого помещения | -2 | |
| residential_block | Номер жилого блока | -1 | |
| residential_block_room | Номер комнаты жилого блока | -3 | |
| non_residential_apartment | Номер нежилого помещения | -1 | |
| non_residential_block | Номер нежилого блока | -1 | |
| fio | Физлицо, не являющееся индивидуальным предпринимателем | -4 | Составной элемент FIO |
| inn | ИНН индивидуального предпринимателя или юридического лица | -4 | 9142929838 |
1 - возможно (не обязательно) присутствие только одного из элементов
2 - используется в паре с элементом residential_premise, но может отсутствовать
3 - используется в паре с элементом residential_block, но может отсутствовать
4 - обязательно должен присутствовать только один из элементов
Структура элемента Execution139
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| transport_id | Транспортный идентификатор | + | 9eaa068b-5e34-4709-8858-44a59b81d21a |
| order_id | Уникальный номер платежа (идентификатор операции) | + | 00000000000000000000000000007779 |
| date | Дата внесения платы | + | 2018-05-17 |
| amount | Сумма оплаты (в копейках) | + | 42 |
| month | Месяц | -1 | 5 |
| year | Год | -1 | 2018 |
| payment_document_id | Идентификатор платежного документа | -2 | 10АА008025-01-6062 |
| payment_document_guid | GUID платежного документа | -3 | d3323621-a100-4461-9c3f-ad932344243f |
| service_id | Идентификатор жилищно-коммунальной услуги | -2 | |
| service_id_guid | GUID идентификатора жилищно-коммунальной услуги | -4 | 1862b031-5e9d-4a25-935e-875174df66da |
| payment_information_guid | GUID платежных реквизитов в платежном документе | - | 2b6f5198-f8c5-4397-8a04-67d21f2e3a75 |
1 - должны либо отсутствовать, либо оба указаны
2 - обязательно должен присутствовать один из элементов
3 - обязательно должен присутствовать при наличии элемента payment_document_id
4 - обязательно должен присутствовать при наличии элемента service_id
Структура элемента Cancellation
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| transport_id | Транспортный идентификатор | + | 90b5d371-82a8-4ffe-979a-c14d46369f32 |
| order_id | Уникальный номер платежа (идентификатор операции) | + | 00000000000000000000000000007778 |
| date | Дата аннулирования | + | 2018-05-18 |
| comment | Комментарий | - | Тест |
Параметры ответа
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| results | Список результатов импорта по каждой сущности | -1 | Последовательность элементов Result |
| error | Ошибка импорта | -1 | Составной элемент Error |
1 - должно присутствовать только одно из полей
Структура элемента Result
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| transport_id | Транспортный идентификатор | + | c64f1659-15d4-40d0-a43e-d13e9ba6b2d0 |
| success | Успешный результат | -1 | Составной элемент Success |
| errors | Список ошибок | -1 | Последовательность элементов Error |
1 - должен присутствовать один из элементов
Структура элемента Error
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| error_code | Код ошибки | + | INT021103 |
| description | Описание ошибки | + | Выгрузка дельты за данный интервал невозможна, воспользуйтесь полной выгрузкой |
| stacktrace | StackTrace в случае возникновения исключения | - |
Примеры
Передача данных о фактах оплаты в соответствии с п. 138 Приказа:
{
"system_id": "1750f483-1684-4a06-b72e-485a559a2358",
"organization_id": "c901756b-40c7-41dc-85c2-f95bbd15b5b6",
"executions": [
{
"transport_id": "eb10e5d9-69e8-48e3-a8b5-561888eb6408",
"recipient": {
"inn": "1098765433",
"legal": {
"kpp": "987654321",
"name": "УО Elvis"
},
"payment_information": {
"recipient_inn": "1098765433",
"recipient_kpp": "987654321",
"bank_name": "Банк",
"payment_recipient": "УО Elvis",
"bik": "044206704",
"operating_account_number": "30301810000006000001",
"correspondent_account_number": "30101810700000000704"
}
},
"order": {
"id": "00000000000000000000000000007778",
"date": "2018-05-17",
"amount": 10,
"payment_purpose": "Тест",
"comment": "Тест",
"payment_document_id": "10АА008025-01-6061"
}
}
]
}
Ответ:
{
"results": [
{
"transport_id": "eb10e5d9-69e8-48e3-a8b5-561888eb6408",
"success": {
"id": "1b89e346-2120-4142-b997-95d9b6911663",
"update_date": "2018-05-17T12:04:03.146+03:00"
}
}
]
}
Передача данных о фактах оплаты в соответствии с п. 139 Приказа:
{
"system_id": "cf0107fd-9fa1-4b08-a6eb-3781b3e577c5",
"organization_id": "7d1e7d15-86f0-482b-93c0-c4a6cc81e2fc",
"executions_139": [
{
"transport_id": "b2fdd365-a19b-4de1-8fa8-25894e4c18e9",
"order_id": "00000000000000000000000000007779",
"date": "2018-05-17",
"amount": 12,
"month": 5,
"year": 2018,
"payment_document_id": "10АА008025-01-6062",
"payment_document_guid": "eba3277a-2e67-48de-8f42-e1361e7c2384",
"payment_information_guid": "f1f54535-a00d-49fa-854d-a469742a8959"
}
]
}
Ответ:
{
"results": [
{
"transport_id": "b2fdd365-a19b-4de1-8fa8-25894e4c18e9",
"success": {
"id": "1a06c496-3576-4e7f-88a1-891b7dbd4fb2",
"update_date": "2018-05-18T10:27:51.007+03:00"
}
}
]
}
Передача данных об аннулировании извещения о принятии к исполнению распоряжения:
{
"system_id": "cf0107fd-9fa1-4b08-a6eb-3781b3e577c5",
"organization_id": "7d1e7d15-86f0-482b-93c0-c4a6cc81e2fc",
"cancellations": [
{
"transport_id": "b2fdd365-a19b-4de1-8fa8-25894e4c18e9",
"order_id": "00000000000000000000000000007778",
"date": "2018-05-18",
"comment": "Тест"
}
]
}
Ответ:
{
"results": [
{
"transport_id": "b2fdd365-a19b-4de1-8fa8-25894e4c18e9",
"success": {
"id": "1a06c496-3576-4e7f-88a1-891b7dbd4fb2",
"update_date": "2018-05-18T10:27:51.007+03:00"
}
}
]
}