Сведения об информации, необходимой для внесения платы за ЖКУ через кредитные организации

Атрибут	Значение
Название	zhkh-smev2-export-payment
Тип	Адаптер для сервиса СМЭВ2
Наименование	Сведения об информации, необходимой для внесения платы за ЖКУ через кредитные организации
Мнемоника	MNSV10gisGKHtest
Версия	1.10
Версия МР	2.5.x
Версия СМЭВ	СМЭВ2

Принимаемые параметры

Параметр	Название	Обязательное	Пример
document_id	Идентификатор платежного документа	-¹	10АА008025-01-6061
year	Год	-</sup>2</sup>	2016
month	Месяц	-²	06
unified_account_number	Единый лицевой счет	-¹	20АА031825
fias_house_guid	Глобальный уникальный идентификатор дома по ФИАС	-¹	e523bcf2-0f65-40b6-8ac6-2e0453d17005
payment_document_number	Номер платежного документа, по которому внесена плата, присвоенный такому документу исполнителем в целях осуществления расчетов по внесению платы	-³	156785
account_number	Номер лицевого счета/иной идентификатор плательщика	-³
mc_service_id	Идентификатор жилищно-коммунальной услуги	-³	20АА031825-01
amount_required	Сведения о потребителе, необходимые для получения информации о сумме начислений/задолженности	-	Составной элемент AmountRequired

1 - требуется наличие только одного из элементов

2 - year и month не обязательные аргументы, но при наличии document_id они не будут переданы в СМЭВ сервис

3 - обязательно должен присутствовать один из элементов при наличии fias_house_guid

Структура элемента AmountRequired

Параметр	Название	Обязательное	Пример
individual	Потребитель-физическое лицо, в том числе индивидуальный предприниматель	-¹	Составной элемент Individual
legal	Юридическое лицо	-¹	Составной элемент Legal

1 - должен быть обязательно указан один из элементов

Структура элемета Individual

Параметр	Название	Обязательное	Пример
surname	Фамилия	+	Иванов
name	Имя	+	Иван
patronymic	Отчество	-	Иванович

Структура элемента Legal

Параметр	Название	Обязательное	Пример
kpp	КПП	+	987654321
inn	ИНН	+	1098765433

Параметры ответа

Сервис возвращает последовательность элементов вида:

Параметр	Название	Обязательное	Пример
PaymentDocuments	Сведения о платежных документах	-¹	Последовательность элементов PaymentDocument
ErrorMessage	Сообщение об ошибке	-¹	Составной элемент ErrorMessage

1 - должен присутствовать один из элементов

Структура элемента PaymentDocument

Параметр	Название	Обязательное	Пример
PaymentDocumentID	Идентификатор платежного документа	+	10АА008025-01-6061
PaymentDocumentNumber	Номер платежного документа, по которому внесена плата, присвоенный такому документу исполнителем в целях осуществления расчетов по внесению платы	-	156785
UnifiedAccountNumber	Единый лицевой счет	-	20АА031825
AccountNumber	Номер лицевого счета/Иной идентификтатор плательщика	-	789456
MCServiceID	Идентификатор жилищно-коммунальной услуги	-	20АА031825-01
PaymentDocumentDetails	Платежный документ	-¹	Составной элемент PaymentDocumentDetails
ErrorMessage	Сообщение об ошибке	-¹	Составной элемент ErrorMessage
Year	Год	-	2016
Month	Месяц	-	6

1 - допускается наличие одного из элементов

Структура элемента PaymentDocumentDetails

Параметр	Название	Обязательное	Пример
ConsumerInformation	Сведения о потребителе	-	Составной элемент ConsumerInformation
ExecutorInformation	Сведения об исполнителе	+	Составной элемент ExecutorInformation
Reminder	Сумма к оплате (в копейках)	+	20000.00
ErrorMessage	Сообщение об ошибке	-¹	Cоставной элемент ErrorMessage
Debt	Задолженность (в копейках)	-¹
Purpose	Назначение платежа	-	Test
PDServiceName	Наименование услуги (работы), оказываемой (выполняемой) исполнителем, штрафной санкции	-

Структура элемента ConsumerInformation

Параметр	Название	Обязательное	Пример
Entpr	Потребитель-индивидуальный предприниматель	-¹	Составной элемент ConsumerEntpr
Legal	Потребитель-юридическое лицо	-¹	Составной элемент 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	Исполнитель-ИП	-¹	Составной элемент ExecutorEntpr
Legal	Исполнитель-ЮЛ	-¹	Составной элемент 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"
    }
  ]
}