Выгрузка реестра получателей платежей за жилищно-коммунальные услуги и капитальный ремонт
| Атрибут | Значение |
|---|---|
| Название | zhkh-export-receivers |
| Тип | Адаптер для вида сведений |
| Наименование | Выгрузка реестра получателей платежей за жилищно-коммунальные услуги и капитальный ремонт |
| Версия ВС | 1.0.0 |
| Версия МР | 3.0 |
| Версия СМЭВ | СМЭВ3 |
Переменные окружения
| Название | Описание |
|---|---|
| CA_CERT | сертификат центра сертификации для подключения к rabbitmq |
| CLIENT_CERT | сертификат, используемый для подключения к rabbitmq |
| CLIENT_KEY | ключ, используемый для подключения к rabbitmq |
| MQ_HOST | хост rabbitmq |
| MQ_PORT | порт rabbitmq |
| SMEV_SERVICE | название смэв сервиса, на который будут отправляться запросы |
| FAIL_ON_EMPTY_ATTACHMENT | флаг для обработки пустого вложения. По умолчанию true, и в случае отсутствия данных о файле-вложении при передаче его по ftp, запрос будет считаться завершенным ошибкой. Используется для работы в тестовом контуре СМЭВ 3, где ответы не содержат файлов-вложений и флаг должен быть установлен в false |
Переменные для конфигурирования подключения к БД:
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 |
| by_date | Изменения от даты до текущего дня (включительно) | -1 | 2020-01-20 |
| full | Флаг получения последней полной выгрузки | -1 | true |
1 - обязательно должен присутствовать только один из элементов
Параметры ответа
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| exported_to_ftp | Результат работы был получен по FTP | -1 | true |
| file | Данные по полученному файлу | -2 | Составной элемент Attachment |
| payment_receivers_delta_package | Результат запроса дельты изменений получателей платежей | -1 | Составной элемент PaymentReceiversPackage |
| errors | Список ошибок | -1 | Последовательность элементов Error |
1 - должно присутствовать только одно из полей
2 - должен присутствовать при наличии exported-to-ftp
Структура элемента Attachment
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| uuid | Идентификатор вложения, по которому его можно запросить с файлового хранилища Агредатора | + | 359d7db3bb87a0f6e30fa801112be881e60c4859fd309d6b60e21964014d05c1 |
| checksum | SHA256 хэш сумма от файла вложения | + | 994873f550b38d23dff223482c998b107989b67575a64318b2146c659f47ceb8 |
Структура элемента Error
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| error_code | Код ошибки | + | INT021103 |
| description | Описание ошибки | + | Выгрузка дельты за данный интервал невозможна, воспользуйтесь полной выгрузкой |
| stacktrace | StackTrace в случае возникновения исключения | - |
Структура элемента PaymentReceiversPackage
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| create_date | Дата выгрузки | + | 2018-06-05T10:00:40Z |
| version | Версия формата выгрузки | + | 2 |
| package_type | Тип выгрузки (FULL - полная, DELTA - изменения) | + | DELTA |
| delta_from_date | Нижняя граница выгрузки изменений | - | 2018-06-04T00:00:00Z |
| delta_to_date | Верхняя граница выгрузки изменений | - | 2018-06-05T10:00:30Z |
| payment_receivers | Получатели платежей | - | Последовательность элементов PaymentReceiver |
Структура элемента PaymentReceiverType
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| ogrn | ОГРН/ОГРНИП | + | 1036603499635 |
| inn | ИНН | + | 6660061642 |
| kpp | КПП | - | 667001001 |
| name | Наименование | + | ПОТРЕБИТЕЛЬСКИЙ ЖИЛИЩНО-ЭКСПЛУАТАЦИОННЫЙ КООПЕРАТИВ № 208 |
| payment_informations | Сведения о платежных реквизитах организации | + | Последовательность элементов PaymentInformation |
Структура элемента PaymentInformation
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| recipient_inn | ИНН банка получателя платежа | + | 7707083893 |
| recipient_kpp | КПП банка получателя платежа | + | 773601001 |
| bank_name | Наименование банка получателя платежа | + | "ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО ""СБЕРБАНК РОССИИ""" |
| payment_recipient | Наименование получателя | + | ПОТРЕБИТЕЛЬСКИЙ ЖИЛИЩНО-ЭКСПЛУАТАЦИОННЫЙ КООПЕРАТИВ № 208 |
| bik | БИК банка получателя | + | 046577674 |
| operating_account_number | Номер расчетного счета | + | 40705810716540001608 |
| correspondent_account_number | Корр. счет банка получателя | - | |
| kbk | Код из Классификатора доходов в бюджет | - | |
| oktmo | Код из Общероссийского классификатора территорий муниципальных образований | - | |
| number_budgetary_account | Номер лицевого счета, открытого в органах Федерального казначейства (финансовых органах) | - | |
| ic_capital_repair | Платежные реквизиты для платежей капитального ремонта | - | |
| payment_information_guid | GUID платежных реквизитов | + | d6b1710c-da8e-47e0-86e1-4745a9a55a72 |
| update_date | Дата изменения платежных реквизитов | + | 2018-06-04T11:25:08Z |
Примеры
Запрос полной выгрузки реестра получателей платежей за жилищно-коммунальные услуги и капитальный ремонт:
{
"information_system_id": "1750f483-1684-4a06-b72e-485a559a2358",
"organization_id": "2a7a4f1c-0d83-4bb3-a317-fb5cb06cb967",
"full": true
}
Ответ (в тестовом контуре СМЭВ 3 и значении false FAIL_ON_EMPTY_ATTACHMENT значение file будет отсутствовать):
{
"exported_to_ftp": "true",
"file": {
"uuid": "359d7db3bb87a0f6e30fa801112be881e60c4859fd309d6b60e21964014d05c1",
"checksum": "994873f550b38d23dff223482c998b107989b67575a64318b2146c659f47ceb8"
}
}
Запрос выгрузки изменений в реестре получателей платежей за жилищно-коммунальные услуги и капитальный ремонт:
{
"information_system_id": "1750f483-1684-4a06-b72e-485a559a2358",
"organization_id": "2a7a4f1c-0d83-4bb3-a317-fb5cb06cb967",
"by_date": "2018-06-04"
}
Ответ:
{
"payment_receivers_delta_package": {
"create_date": "2018-06-05T10:00:40Z",
"version": "2.0",
"package_type": "DELTA",
"delta_from_date": "2018-06-04T00:00:00Z",
"delta_to_date": "2018-06-05T10:00:30Z",
"payment_receivers": [
{
"ogrn": "1036603499635",
"inn": "6660061642",
"kpp": "667001001",
"name": "ПОТРЕБИТЕЛЬСКИЙ ЖИЛИЩНО-ЭКСПЛУАТАЦИОННЫЙ КООПЕРАТИВ № 208",
"payment_informations": [
{
"recipient_inn": "7707083893",
"recipient_kpp": "773601001",
"bank_name": "\"ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО \"\"СБЕРБАНК РОССИИ\"\"\"",
"payment_recipient": "ПОТРЕБИТЕЛЬСКИЙ ЖИЛИЩНО-ЭКСПЛУАТАЦИОННЫЙ КООПЕРАТИВ № 208\n ",
"bik": "046577674",
"operating_account_number": "40705810716540001608",
"is_capital_repair": "true",
"payment_information_guid": "d6b1710c-da8e-47e0-86e1-4745a9a55a72",
"update_date": "2018-06-04T11:25:08Z"
}
]
}
]
}
}