Передача извещений о принятии к исполнению распоряжений

Атрибут	Значение
Название	zhkh-smev2-import-notification
Тип	Адаптер для сервиса СМЭВ 2
Наименование 1	Передача извещений о принятии к исполнению распоряжений
Наименование 2	Сведения о внесении платы кредитными организациями
Мнемоника	MNSV10KOSVED
Версия	1.10
Версия МР	2.5.x
Версия СМЭВ	СМЭВ2

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

Параметр	Название	Обязательное	Пример
organization_id	Идентификатор организации, через которую производится внесение платы, присвоенный данной организации в системе	+	c901756b-40c7-41dc-85c2-f95bbd15b5b6
notifications	Пакет извещений	+	Последовательность элементов Notification

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

Параметр	Название	Обязательное	Пример
supplier	Сведения о потребителе	-	Составной элемент Supplier
recipient	Сведения об исполнителе	-¹	Составной элемент Recipient
order	Общие сведения о распоряжении	+	Составной элемент Order
transport_id	Транспортный идентификатор	+	adb645bb-41cf-4c6f-8023-3dff40445195

1 - wsdl сервиса допускает отсутствие этого элемента, но в тестовой среде при отправке запроса без исполнителя возвращается ошибка "Отсутствуют сведения об исполнителе. Для размещения информации о внесении платы без указания сведений об исполнителе воспользуйтесь сервисом СМЭВ 3.". Поведение в продуктовой среде неизвестно, поэтому наличие элемента остается опциональным.

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

Параметр	Название	Обязательное	Пример
id	Уникальный идентификатор плательщика	-	001
name	Наименование плательщика	-	Тест

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

Параметр	Название	Обязательное	Пример
inn	ИНН исполнителя	+	1098765433
entpr	Исполнитель ИП	-¹	Составной элемент FIO
legal	Исполнитель ЮЛ	-¹	Составной элемент Legal
entpr_fio	Исполнитель-ИП (ФИО одной строкой)	-¹	Иванов Иван Иванович
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	Номер нежилого помещения	-¹
apartment	Номер жилого помещения	-¹
placement	Номер комнаты жилого помещения	-¹
ind	Физлицо, не являющееся индивидуальным предпринимателем	-²	Составной элемент FIO
inn	Индивидуальный предприниматель или юридическое лицо	-²	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	Ошибка	-¹	Составной элемент Error
UpdateDate	Дата модификации	-¹	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": "Извещение успешно размещено"
  }
]