Сведения об информации, необходимой для внесения платы за ЖКУ через кредитные организации
| Атрибут | Значение |
|---|---|
| Название | zhkh-smev2-export-payment |
| Тип | Адаптер для сервиса СМЭВ2 |
| Наименование | Сведения об информации, необходимой для внесения платы за ЖКУ через кредитные организации |
| Мнемоника | MNSV10gisGKHtest |
| Версия | 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.
Принимаемые параметры
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| document_id | Идентификатор платежного документа | -1 | 10АА008025-01-6061 |
| year | Год | -</sup>2</sup> | 2016 |
| month | Месяц | -2 | 06 |
| unified_account_number | Единый лицевой счет | -1 | 20АА031825 |
| fias_house_guid | Глобальный уникальный идентификатор дома по ФИАС | -1 | e523bcf2-0f65-40b6-8ac6-2e0453d17005 |
| payment_document_number | Номер платежного документа, по которому внесена плата, присвоенный такому документу исполнителем в целях осуществления расчетов по внесению платы | -3 | 156785 |
| account_number | Номер лицевого счета/иной идентификатор плательщика | -3 | |
| mc_service_id | Идентификатор жилищно-коммунальной услуги | -3 | 20АА031825-01 |
| amount_required | Сведения о потребителе, необходимые для получения информации о сумме начислений/задолженности | - | Составной элемент AmountRequired |
1 - требуется наличие только одного из элементов
2 - year и month не обязательные аргументы, но при наличии document_id они не будут переданы в СМЭВ сервис
3 - обязательно должен присутствовать один из элементов при наличии fias_house_guid
Структура элемента AmountRequired
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| individual | Потребитель-физическое лицо, в том числе индивидуальный предприниматель | -1 | Составной элемент Individual |
| legal | Юридическое лицо | -1 | Составной элемент Legal |
1 - должен быть обязательно указан один из элементов
Структура элемета Individual
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| surname | Фамилия | + | Иванов |
| name | Имя | + | Иван |
| patronymic | Отчество | - | Иванович |
Структура элемента Legal
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| kpp | КПП | + | 987654321 |
| inn | ИНН | + | 1098765433 |
Параметры ответа
Сервис возвращает последовательность элементов вида:
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| PaymentDocuments | Сведения о платежных документах | -1 | Последовательность элементов PaymentDocument |
| ErrorMessage | Сообщение об ошибке | -1 | Составной элемент ErrorMessage |
1 - должен присутствовать один из элементов
Структура элемента PaymentDocument
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| PaymentDocumentID | Идентификатор платежного документа | + | 10АА008025-01-6061 |
| PaymentDocumentNumber | Номер платежного документа, по которому внесена плата, присвоенный такому документу исполнителем в целях осуществления расчетов по внесению платы | - | 156785 |
| UnifiedAccountNumber | Единый лицевой счет | - | 20АА031825 |
| AccountNumber | Номер лицевого счета/Иной идентификтатор плательщика | - | 789456 |
| MCServiceID | Идентификатор жилищно-коммунальной услуги | - | 20АА031825-01 |
| PaymentDocumentDetails | Платежный документ | -1 | Составной элемент PaymentDocumentDetails |
| ErrorMessage | Сообщение об ошибке | -1 | Составной элемент ErrorMessage |
| Year | Год | - | 2016 |
| Month | Месяц | - | 6 |
1 - допускается наличие одного из элементов
Структура элемента PaymentDocumentDetails
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| ConsumerInformation | Сведения о потребителе | - | Составной элемент ConsumerInformation |
| ExecutorInformation | Сведения об исполнителе | + | Составной элемент ExecutorInformation |
| Reminder | Сумма к оплате (в копейках) | + | 20000.00 |
| ErrorMessage | Сообщение об ошибке | -1 | Cоставной элемент ErrorMessage |
| Debt | Задолженность (в копейках) | -1 | |
| Purpose | Назначение платежа | - | Test |
| PDServiceName | Наименование услуги (работы), оказываемой (выполняемой) исполнителем, штрафной санкции | - |
Структура элемента ConsumerInformation
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| Entpr | Потребитель-индивидуальный предприниматель | -1 | Составной элемент ConsumerEntpr |
| Legal | Потребитель-юридическое лицо | -1 | Составной элемент ConsumerLegal |
| address | Адреса помещений | + | Последовательность элементов Address |
1 - допускается наличие одного из элементов
Структура элемента ConsumerEntpr
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| INN | ИНН | + | 857000728685 |
Структура элемента ConsumerLegal
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| Name | Наименование | + | Тест |
| KPP | КПП | + | 987654321 |
| INN | ИНН | + | 1098765433 |
Структура элемента Address
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| region | Код субъекта РФ по ФИАС | + | c685f6ca-d7e1-4938-8b21-7c20035652d2 |
| area | Район | - | |
| city | Код города по ФИАС | - | 5e40e6d2-8348-4e9f-973f-b228ae144285 |
| place | Населенный пункт по ФИАС | - | |
| street | Улица | - | |
| housenum | Номер дома | + | 2 |
| FIASHouseGuid | Глобальный уникальный идентификатор дома по ФИАС | + | e523bcf2-0f65-40b6-8ac6-2e0453d17005 |
| buildnum | Номер корпуса | - | |
| strucnum | Номер строения | - | |
| apartment | Номер жилого помещения | - | |
| placement | Номер комнаты жилого помещения | - | |
| address_string | Неформализованное описание адреса | + | Пермский край, г. Пермь, ул. Ленина, д. 2 |
Структура элемента ExecutorInformation
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| INN | ИНН | + | 1098765433 |
| Entpr | Исполнитель-ИП | -1 | Составной элемент ExecutorEntpr |
| Legal | Исполнитель-ЮЛ | -1 | Составной элемент ExecutorLegal |
| PaymentInformation | Сведения о платежных реквизитах организации | + | Составной элемент PaymentInformation |
| MailingAddress | Почтовый адрес | + | test@test.ru |
1 - должен присутствовать только один из элементов
Структура элемента ExecutorEntpr
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| surname | Фамилия | + | Иванов |
| name | Имя | + | Иван |
| patronymic | Отчество | - | Иванович |
Структура элемента ExecutorLegal
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| KPP | КПП | + | 987654321 |
| Name | Наименование | + | УО Тест |
Структура элемента PaymentInformation
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| RecipientINN | ИНН получателя платежа | + | 1098765433 |
| RecipientKPP | КПП получателя платежа | - | 987654321 |
| BankName | Наименование банка получателя платежа | + | УРАЛЬСКИЙ БАНК ПАО СБЕРБАНК г. ЕКАТЕРИНБУРГ |
| PaymentRecipient | Наименование получателя | + | УО Тест |
| BankBIK | БИК банка получателя | + | 046577674 |
| operatingAccountNumber | Номер расчетного счета | + | 40702810116000059094 |
| CorrespondentBankAccount | Корр. счет банка получателя | - | 30101810500000000674 |
Структура элемента ErrorMessage
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| ErrorCode | Код ошибки | + | SRV012001 |
| Description | Описание ошибки | + | Документ «Извещение о принятии к исполнению распоряжения» ранее размещен в системе: Уникальный номер платежа (идентификатор операции): 10475017799000003006201614682552; Дата внесения платы: 12.02.2020. |
| StackTrace | Отладочная информация в случае возникновения исключения | - |
Примеры
Для проверки настройки сервиса можно отправить в консоли отправки панели администрирования следующий запрос:
{
"year": "2016",
"month": "02",
"fias_house_guid": "89cd9247-7914-4140-a570-c0e2c576ef7a",
"account_number": "789456",
"amount_required": {
"individual": {
"surname": "Иванов",
"name": "Иван",
"patronymic": "Иванович"
}
}
}
С большой долей вероятности вы получите сообщение об ошибке (т.к. по данным ничего не найдено):
{
"ErrorMessage": {
"ErrorCode": "INT002012",
"Description": "Нет объектов для экспорта"
}
}
В случае получения ответа от сервиса, аналогичному указанному в качестве тестового ответа в документации:
{
"PaymentDocuments": [
{
"PaymentDocumentID": "10АА008025-01-6061",
"PaymentDocumentNumber": "156785",
"UnifiedAccountNumber": "20АА031825",
"AccountNumber": "789456",
"MCServiceID": "20АА031825-01",
"PaymentDocumentDetails": {
"ConsumerInformation": {
"address": [
{
"region": "c685f6ca-d7e1-4938-8b21-7c20035652d2",
"city": "5e40e6d2-8348-4e9f-973f-b228ae144285",
"housenum": "2",
"FIASHouseGuid": "e523bcf2-0f65-40b6-8ac6-2e0453d17005",
"address_string": "край. Пермский, г. Пермь, ул. Ленина, д. 2"
}
]
},
"ExecutorInformation": {
"INN": "1098765433",
"Legal": {
"KPP": "987654321",
"Name": "УО Тест"
},
"PaymentInformation": {
"RecipientINN": "1098765433",
"RecipientKPP": "987654321",
"BankName": "УРАЛЬСКИЙ БАНК ПАО СБЕРБАНК г. ЕКАТЕРИНБУРГ",
"PaymentRecipient": "УО Тест",
"BankBIK": "046577674",
"operatingAccountNumber": "40702810116000059094",
"CorrespondentBankAccount": "30101810500000000674"
},
"MailingAddress": "test@test.ru"
},
"Reminder": "20000.00",
"Purpose": "Test"
},
"Year": "2016",
"Month": "6"
},
{
"PaymentDocumentID": "00АА031506-01-6061",
"UnifiedAccountNumber": "20АА031825",
"AccountNumber": "789456",
"MCServiceID": "20АА031825-01",
"PaymentDocumentDetails": {
"ConsumerInformation": {
"address": [
{
"region": "c685f6ca-d7e1-4938-8b21-7c20035652d2",
"city": "5e40e6d2-8348-4e9f-973f-b228ae144285",
"housenum": "2",
"FIASHouseGuid": "e523bcf2-0f65-40b6-8ac6-2e0453d17005",
"address_string": "край. Пермский, г. Пермь, ул. Ленина, д. 2"
}
]
},
"ExecutorInformation": {
"INN": "1098765433",
"Legal": {
"KPP": "987654321",
"Name": "УО Тест"
},
"PaymentInformation": {
"RecipientINN": "1098765433",
"RecipientKPP": "987654321",
"BankName": "УРАЛЬСКИЙ БАНК ПАО СБЕРБАНК г. ЕКАТЕРИНБУРГ",
"PaymentRecipient": "УО Тест",
"BankBIK": "046577674",
"operatingAccountNumber": "40702810116000059094",
"CorrespondentBankAccount": "30101810500000000674"
},
"MailingAddress": "test@test.ru"
},
"Reminder": "2000.00",
"Purpose": "Test"
},
"Year": "2016",
"Month": "6"
}
]
}