Передача сведений о внесении платы за жилое помещение и жилищно-коммунальные услуги кредитными организациями

smev3 link

smev manual

Атрибут Значение
Название 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 Отчество - Иванович
Параметр Описание Обязательное Пример
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"
      }
    }
  ]
}