Передача извещений о принятии к исполнению распоряжений
| Атрибут | Значение |
|---|---|
| Название | zhkh-smev2-import-notification |
| Тип | Адаптер для сервиса СМЭВ 2 |
| Наименование 1 | Передача извещений о принятии к исполнению распоряжений |
| Наименование 2 | Сведения о внесении платы кредитными организациями |
| Мнемоника | MNSV10KOSVED |
| Версия | 1.10 |
| Версия МР | 2.5.x |
| Версия СМЭВ | СМЭВ2 |
Переменные окружения
| Название | Описание |
|---|---|
| CA_CERT | сертификат центра сертификации для подключения к rabbitmq |
| CLIENT_CERT | сертификат, используемый для подключения к rabbitmq |
| CLIENT_KEY | ключ, используемый для подключения к rabbitmq |
| SMEV_KEY | Ключ СМЭВ 2 для режима экспорта ключа |
| SMEV_CERT | Сертификат СМЭВ 2 для режима экспорта ключа |
| CRYPTO_PROVIDER | Способ подписания (cryptopro/trojan/openssl) |
| CRYPTOPRO_KPS | Имя сертификата для поиска для режима КриптоПРО |
| CRYPTOPRO_PIN | Пин доступа к токену для режима КриптоПРО |
| SIGNER_URL | Адрес сервиса подписания для режима trojan |
| SIGNER_SRV_CERT | Сертификат сервиса подписания |
| SIGNER_CLIENT_CERT | Сертификат для подключения к сервису подписания |
| SIGNER_CLIENT_KEY | Ключ для подключения к сервису подписания |
Переменные для конфигурирования подключения к БД:
DATABASE_HOST, DATABASE_PORT, DATABASE_NAME, DATABASE_USER, DATABASE_PASS.
Принимаемые параметры
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| organization_id | Идентификатор организации, через которую производится внесение платы, присвоенный данной организации в системе | + | c901756b-40c7-41dc-85c2-f95bbd15b5b6 |
| notifications | Пакет извещений | + | Последовательность элементов Notification |
Структура элемента Notification
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| supplier | Сведения о потребителе | - | Составной элемент Supplier |
| recipient | Сведения об исполнителе | -1 | Составной элемент Recipient |
| order | Общие сведения о распоряжении | + | Составной элемент Order |
| transport_id | Транспортный идентификатор | + | adb645bb-41cf-4c6f-8023-3dff40445195 |
1 - wsdl сервиса допускает отсутствие этого элемента, но в тестовой среде при отправке запроса без исполнителя возвращается ошибка "Отсутствуют сведения об исполнителе. Для размещения информации о внесении платы без указания сведений об исполнителе воспользуйтесь сервисом СМЭВ 3.". Поведение в продуктовой среде неизвестно, поэтому наличие элемента остается опциональным.
Структура элемента Supplier
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| id | Уникальный идентификатор плательщика | - | 001 |
| name | Наименование плательщика | - | Тест |
Структура элемента Recipient
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| inn | ИНН исполнителя | + | 1098765433 |
| entpr | Исполнитель ИП | -1 | Составной элемент FIO |
| legal | Исполнитель ЮЛ | -1 | Составной элемент Legal |
| entpr_fio | Исполнитель-ИП (ФИО одной строкой) | -1 | Иванов Иван Иванович |
| payment | Сведения о платежных реквизитах | - | Составной элемент Payment |
1 - требуется наличие одного из элементов
Структура элемента FIO
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| name | Имя | + | Иван |
| surname | Фамилия | + | Иванов |
| patronymic | Отчество | - | Иванович |
Струкрута элемента Legal
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| kpp | КПП | + | 987654321 |
| name | Наименование | + | YO Elvis |
Структура элемента Payment
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| inn | ИНН получателя платежа | + | 1098765433 |
| kpp | КПП получателя платежа | + | 987456321 |
| bank | Наименование банка-получателя платежа | + | Банк |
| recipient | Наименование получателя | + | YO Elvis |
| bik | БИК банка получателя | + | 044206704 |
| operating_number | Номер расчетного счета | + | 30301810000006000001 |
| correspondent_bank_account | Корр. счет банка получателя | - | 30101810700000000704 |
Структура элемента Order
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| id | Уникальный номер платежа (идентификатор операции)(строка из 32 символов) | + | 10475017799000003006201614682552 |
| date | Дата | + | 2020-02-14 |
| num | Номер распоряжения (строка до 9 символов) | - | СМЭВ-08 |
| amount | Сумма оплаты (в копейках) | + | 42000 |
| purpose | Назначение платежа (до 1000 символов) | - | Тест |
| comment | Произвольный комментарий (до 210 символов) | - | Тест |
| document_id | Идентификатор платежного документа (строка 18 символов) | + | 10AA008025-01-6061 |
| document_number | Номер платежного документа, по которому внесена плата, присвоенный такому документу исполнителем в целях осуществления расчетов по внесению платы (строка до 30 символов - шаблон (.)([0-9а-яА-Яa-zA-Z]+)(.) ) | - | |
| unified_account_number | Единый лицевой счет | - | |
| address_and_consumer | Адрес помещения и реквизиты потребителя | - | Составной элемента AddressAndConsumer |
Структура элемента AddressAndConsumer
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| fias | Идентификатор дома по ФИАС | + | |
| non_living_apartment | Номер нежилого помещения | -1 | |
| apartment | Номер жилого помещения | -1 | |
| placement | Номер комнаты жилого помещения | -1 | |
| ind | Физлицо, не являющееся индивидуальным предпринимателем | -2 | Составной элемент FIO |
| inn | Индивидуальный предприниматель или юридическое лицо | -2 | 3298874164 |
| mc_service_id | Идентификатор жилищно-коммунальной услуги | - | |
| account_number | Номер лицевого счета/Иной идентификатор плательщика | - |
1 - элементы не обязательны, но наличие non_living_apartment не подразумевает наличие пары apartment и placement. И наоборот, наличие пары apartment и placement не подразумевает наличие non_living_apartment.
2 - должен присутствовать один из элементов
Параметры ответа
Сервис возвращает последовательность элементов следующего вида:
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| TransportID | Транспортный идентификатор | + | fe3e9fc1-7b64-47f1-a7d9-5755cd662086 |
| Description | Описание результата выполнения | - | При добавлении извещения произошла ошибка |
| ErrorMessage | Ошибка | -1 | Составной элемент Error |
| UpdateDate | Дата модификации | -1 | 2020-02-14T12:56:50.570+03:00 |
1 - должен присутствовать один из элементов
Структура элемента Error
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| ErrorCode | Код ошибки | + | SRV012001 |
| Description | Описание ошибки | + | Документ «Извещение о принятии к исполнению распоряжения» ранее размещен в системе: Уникальный номер платежа (идентификатор операции): 10475017799000003006201614682552; Дата внесения платы: 12.02.2020 |
| StackTrace | Отладочная информация в случае возникновения исключения | - |
Примеры
Для проверки настройки сервиса можно отправить в консоли отправки панели администрирования следующий запрос:
{
"organization_id": "c901756b-40c7-41dc-85c2-f95bbd15b5b6",
"notifications": [
{
"supplier": {
"id": "001",
"name": "Тест"
},
"recipient": {
"inn": "1098765433",
"legal": {
"kpp": "987654321",
"name": "УО Elvis"
},
"payment": {
"inn": "1098765433",
"kpp": "987456321",
"bank": "Банк",
"recipient": "УО Elvis",
"bik": "044206704",
"operating_number": "30301810000006000001",
"correspondent_bank_account": "30101810700000000704"
}
},
"order": {
"id": "10475017799000003006201614682555",
"date": "2020-02-12",
"num": "СМЭВ-08",
"amount": "10",
"purpose": "Тест",
"comment": "Тест",
"document_id": "10AA008025-01-6061"
},
"transport_id": "adb645bb-41cf-4c6f-8023-3dff40445195"
}
]
}
В случае корректной настройки должен прийти ответ вида:
[
{
"TransportID": "adb645bb-41cf-4c6f-8023-3dff40445195",
"UpdateDate": "2020-02-17T12:16:31.606+03:00",
"Description": "Извещение успешно размещено"
}
]
Для получения ответа с ошибкой повторно направляем запрос и получаем ответ с ошибкой вида:
[
{
"TransportID": "adb645bb-41cf-4c6f-8023-3dff40445195",
"ErrorMessage": {
"ErrorCode": "SRV012001",
"Description": "Документ «Извещение о принятии к исполнению распоряжения» ранее размещен в системе: Уникальный номер платежа (идентификатор операции): 10475017799000003006201614682555; Дата внесения платы: 12.02.2020."
},
"Description": "При добавлении извещения произошла ошибка"
}
]
Пример запроса с передачей нескольких извещений:
{
"organization_id": "c901756b-40c7-41dc-85c2-f95bbd15b5b6",
"notifications": [
{
"supplier": {
"id": "001",
"name": "Тест"
},
"recipient": {
"inn": "1098765433",
"legal": {
"kpp": "987654321",
"name": "УО Elvis"
},
"payment": {
"inn": "1098765433",
"kpp": "987456321",
"bank": "Банк",
"recipient": "УО Elvis",
"bik": "044206704",
"operating_number": "30301810000006000001",
"correspondent_bank_account": "30101810700000000704"
}
},
"order": {
"id": "10475017799000003006201614682598",
"date": "2020-02-12",
"num": "СМЭВ-08",
"amount": "10",
"purpose": "Тест",
"comment": "Тест",
"document_id": "10AA008025-01-6061"
},
"transport_id": "adb542bb-41cf-4c6f-8023-3dff40445195"
},
{
"recipient": {
"inn": "1098765433",
"legal": {
"kpp": "987654321",
"name": "УО Elvis"
},
"payment": {
"inn": "1098765433",
"kpp": "987456321",
"bank": "Банк",
"recipient": "УО Elvis",
"bik": "044206704",
"operating_number": "30301810000006000001",
"correspondent_bank_account": "30101810700000000704"
}
},
"order": {
"id": "10475017799000003006201614682572",
"date": "2020-02-12",
"num": "СМЭВ-08",
"amount": "10",
"purpose": "Тест",
"comment": "Тест",
"document_id": "10AA008025-01-6061"
},
"transport_id": "adb645bb-41cf-4c6f-8023-3dff40445142"
}
]
}
Ответ:
[
{
"TransportID": "adb645bb-41cf-4c6f-8023-3dff40445142",
"UpdateDate": "2020-02-17T12:30:12.216+03:00",
"Description": "Извещение успешно размещено"
},
{
"TransportID": "adb542bb-41cf-4c6f-8023-3dff40445195",
"UpdateDate": "2020-02-17T12:30:11.910+03:00",
"Description": "Извещение успешно размещено"
}
]