Прием информации о возврате

Атрибут	Значение
Название	gis-gmp-import-refunds
Тип	Адаптер для вида сведений
Наименование	Предоставление информации о возврате
Идентификатор	VS01605v001-RKZN02
Область применения	Межведомственное взаимодействие
Версия	2.1.0
Версия МР	3.0

Переменные окружения

Название	Описание
CA_CERT	сертификат центра сертификации для подключения к rabbitmq.
CLIENT_CERT	сертификат используемый для подключения к rabbitmq.
CLIENT_KEY	ключ используемый для подключения к rabbitmq.
MQ_HOST	хост rabbitmq.
MQ_PORT	порт rabbitmq.
SMEV_SERVICE	название смэв сервиса, на который будут отправляться запросы.
SIGN_USER	флаг необходимости отправки запроса на подпись пользователя. Устанавливать значение true для отправки на подпись.
SIGNATURE_SERVICE	название сервиса, в котором будет производиться подпись, в случае отсутствия отправляется сервису, отправившему запрос.

Переменные для конфигурирования подключения к БД:

DATABASE_HOST, DATABASE_PORT, DATABASE_NAME, DATABASE_USER, DATABASE_PASS.

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

Параметр	Название	Обязательное	Пример
id	Идентификатор запроса	+	I_07d5a0d1-5183-4efc-86a8-93b4d341872c
timestamp	Дата и время формирования сообщения	+	2017-07-24T18:13:51.0
sender_id	УРН участника-отправителя сообщения	+	3eb551
sender_role	Полномочие участника-отправителя сообщения	+	3
refunds	Направляемые новые извещения о возврате	+¹	Массив элементов типа ImportedRefund
changes	Направляемые изменения в извещения о возврате	+¹	Массив элементов типа ImportedChange

1 - допускается наличие только одного поля refunds или changes

Допустимые значения ролей отправителей сообщения

Код	Описание
1	ГАН (главный администратор доходов бюджета, имеющий в своем ведении администраторов доходов бюджета и (или) осуществляющий функции и полномочия учредителя в отношении государственных (муниципальных) учреждений)
2	ГАН (орган государственной власти субъектов Российской Федерации (орган местного самоуправления), обеспечивающий информационное взаимодействие с ГИС ГМП государственных (муниципальных) учреждений и (или) администраторов доходов бюджета)
3	АН (администратор доходов бюджета)
4	АН (государственное (муниципальное) учреждение)
24	ГАН (уполномоченный орган, являющийся главным администратором доходов бюджета)
25	ГАН (оператор системы «Электронный бюджет»)
27	АН (уполномоченный орган, являющийся администратором доходов бюджета)
33	АН (уполномоченный орган)

Структура типа ImportedRefund

Параметр	Название	Обязательное	Пример
id	Идентификатор платежа в пакете	+	I_46488813-8080-49f4-b60f-7f87af897c6a
originator_id	УРН участника косвенного взаимодействия, сформировавшего запрос	-	123456
refund_id	Уникальный идентификатор извещения о возврате (УИВ)	+	0410964924072017000000001
refund_doc_date	Дата и время формирования извещения о возврате	+	2017-11-10T14:06:30.313+03:00
budget_level	Уровень бюджета	+	1 Допустимые значения: 1 - «федеральный» 2 - «бюджет субъекта РФ» 3 - «местный бюджет» 4 - «бюджет ГВФ РФ» 5 - «бюджет ТГВФ РФ» 6 - «средства ЮЛ»
kbk	КБК	-	32111301030016000130
oktmo	Код ОКТМО	-	45348000
payer	Сведения об организации, осуществляющей возврат денежных средств	+	составной тип Payer
application	Данные заявки на возврат	+	составной тип Application
basis	Реквизиты документа-основания для осуществления возврата	+	составной тип Basis
payee	Сведения о получателе денежных средств	+	Составной тип Payee
additional_data	Дополнительные поля возврата	-	Массив с максимальной длиной 10 элементов составного типа AdditionalData

Структура типа ImportedChange

Параметр	Название	Обязательное	Пример
originator_id	УРН участника косвенного взаимодействия	-	123456
id	Идентификатор изменяемого извещения о начислении в пакете	+	I_54a59db2-3845-4915-8770-dd95394aadb4
refund_id	Идентификатор возврата	+	0410964924072017000000001
changes	Изменяемые поля	-	Массив элементов составного типа Change
change_status	Сведения о статусе и основаниях его изменения	+	Составной тип ChangeStatus

Структура типа Payer (сведения об организации, осуществляющей возврат денежных средств)

Параметр	Название	Обязательное	Пример
name	Наименование организации	+	Тестовый участник
inn	ИНН организации	+	7706012716
kpp	КПП организации	+	770901011
ogrn	ОГРН организации	-	7723819340452
code_ubp	Код организации	+	28519

Структура тип Application(данные заявки на возврат)

Параметр	Название	Обязательное	Пример
number	Номер платежного документа	+	256894
date	Дата платежного документа	+	2017-07-24
payment_id	Уникальный идентификатор платежа (УИП), подлежащего возврату	+	10471020010005232407201700000012
cash_type	Вид средств для осуществления возврата	+	1 Допустимые значения: 1 - «средства бюджета» 3 - «средства дополнительного бюджетного финансирования» 4 - «средства для финансирования мероприятий по оперативно-розыскной деятельности» 5 - «средства поступающие во временное распоряжение казенных учреждений» 6 - «средства юридического лица»
amount	Сумма возврата (в копейках)	+	50000
purpose	Назначение платежа	+	Штраф за нарушение ПДД. Управление транспортным средством с нечитаемыми государственными регистрационными знаками

Структура тип Basis(реквизиты документа-основания для осуществления возврата)

Параметр	Название	Обязательное	Пример
doc_kind	Вид документа-основания для осуществления возврата	+	Заявление
doc_number	Номер документа-основания для осуществления возврата	+	235
doc_date	Дата документа-основания для осуществления возврата	+	2017-07-23

Структура типа Payee (сведения о получателе денежных средств)

Параметр	Название	Обязательное	Пример
identifier	Идентификатор плательщика, которому осуществляется возврат денежных средств	+	1220000000007712579832
name	Наименование получателя денежных средств	+	Костров Дмитрий Матвеевич
kbk	КБК	-	32111301030016000130
oktmo	Код ОКТМО	-	45348000
account	Номер лицевого счета получателя платежа	+	Составной тип account

Структура типа Account (номер лицевого счета получателя платежа)

Параметр	Название	Обязательное	Пример
number	Номер банковского счета получателя платежа	-	40101200500000010041
bank	Данные банка, в котором открыт счет	+	Составной тип Bank

Структура типа Bank (данные банка, в котором открыт счет)

Параметр	Название	Обязательное	Пример
name	Наименование структурного подразделения кредитной организации или подразделения Банка России, в котором открыт счет	-	ГРКЦ ГУ Банка России по г. Москва
bik	БИК структурного подразделения кредитной организации или подразделения Банка России, в котором открыт счет	+	047102001
correspondent_account	Номер корреспондентского счета кредитной организации, открытый в подразделении Банка России	-	13486438211277969918

Структура типа ChangeStatus

Параметр	Название	Обязательное	Пример
meaning	Статус, отражающий изменение данных	+	1 Возможные значения: 1 – новый; 2 – уточнение; 3 – уточнение об аннулировании; 4 – уточнение о деаннулировании (отмена аннулирования).
reason	Обоснование изменения	+	Что-то пошло не так
change_date	Дата и время уточнения информации.	+	2019-01-11T14:51:02.427

Структура типа Change

Параметр	Название	Обязательное	Пример
field_number	Номер изменяемого поля	+	42
change_values	Новое значение поля	+	Непустой массив максимальной длины 10 с элементами типа ChangeValue

Структура типа ChangeValue

Параметр	Название	Обязательное	Пример
name	Наименование поля	-	test
value	Значение поля	+	value

Структура типа AdditionalData

Параметр	Название	Обязательное	Пример
name	Наименование поля	+	test
value	Значение поля	+	value

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

Параметр	Название	Обязательное	Пример
id	Идентификатор ответа	+	I_c6609858-a388-4a14-9f73-d83377b571eb
rq_id	Идентификатор запроса	+	I_07d5a0d1-5183-4efc-86a8-93b4d341872c
recipient_identifier	УРН участника – получателя ответа на запрос	+	3eb551
timestamp	Дата и время формирования сообщения	+	2019-01-11T17:21:38.98+03:00
import-protocols	Результаты обработки сущности в пакете		Массив элементов максимальной длины 100 типа ImportProtocol

Структура типа ImportProtocol

Параметр	Название	Обязательное	Пример
entity_id	Идентификатор ответа	+	Идентификатор ответа
code	Код результата обработки информации	+	0
description	Описание результата обработки	+	Описание результата обработки

Примеры

Для проверки настройки сервиса можно отправить в консоли отправки панели администрирования следующий запрос:

{
  "id": "I_07d5a0d1-5183-4efc-86a8-93b4d341872c",
  "timestamp": "2017-07-24T18:13:51.0",
  "sender_id": "3eb551",
  "sender_role": "3",
  "refunds": [
    {
      "id": "I_46488813-8080-49f4-b60f-7f87af897c6a",
      "refund_id": "0410964924072017000000001",
      "refund_doc_date": "2017-11-10T14:06:30.313+03:00",
      "budget_level": "1",
      "kbk": "18811630020016000140",
      "oktmo": "45381000",
      "payer": {
        "code_ubp": "28519",
        "name": "Тестовый участник",
        "inn": "7706012716",
        "kpp": "770901011"
      },
      "application": {
        "number": "256894",
        "date": "2017-07-24",
        "payment_id": "10471020010005232407201700000012",
        "cash_type": "1",
        "amount": "50000",
        "purpose": "Штраф за нарушение ПДД. Управление транспортным средством с нечитаемыми государственными регистрационными знаками"
      },
      "basis": {
        "doc_kind": "Заявление",
        "doc_number": "235",
        "doc_date": "2017-07-23"
      },
      "payee": {
        "identifier": "1220000000007712579832",
        "name": "Костров Дмитрий Матвеевич",
        "account": {
          "bank": {
            "bik": "044552272",
            "correspondent_account": "30101810800000010022"
          }
        }
      }
    }
  ]
}

В случае корректной настройки должен прийти следующий ответ:

{
  "id": "I_c6609858-a388-4a14-9f73-d83377b571eb",
  "rq_id": "I_07d5a0d1-5183-4efc-86a8-93b4d341872c",
  "recipient_identifier": "3eb551",
  "timestamp": "2019-01-16T14:40:30.011+03:00",
  "import_protocols": [
    {
      "entity_id": "I_46488813-8080-49f4-b60f-7f87af897c6a",
      "code": "0",
      "description": "Успешно (ТЕСТОВЫЕ ДАННЫЕ!)"
    }
  ]
}