Передача протокола с причинами возврата распоряжений о перечислении денежных средств
| Атрибут | Значение |
|---|---|
| Название | rkzn-export-result |
| Тип | Адаптер для вида сведений |
| Наименование | Передача протокола с причинами возврата распоряжений о перечислении денежных средств |
| Область применения | Межведомственное взаимодействие |
| Версия | 1.0.4 |
| Версия МР | 3.5.0.1 |
| Версия СМЭВ | ТСМЭВ3 |
| СМЭВ3 ns | http://www.roskazna.ru/eb/domain/Result/formular/1.0.4 |
| СМЭВ3 root | ExportResult / ReceiptResult |
Переменные окружения
| Название | Описание |
|---|---|
| CA_CERT | сертификат центра сертификации для подключения к rabbitmq |
| CLIENT_CERT | сертификат, используемый для подключения к rabbitmq |
| CLIENT_KEY | ключ, используемый для подключения к rabbitmq |
| MQ_HOST | хост rabbitmq |
| MQ_PORT | порт rabbitmq |
| SMEV_SERVICE | название смэв сервиса, на который будут отправляться запросы |
| DATABASE_URL | строка подключения к БД |
| EMULATE_CLIENT | флаг эмуляции ответа клиента в случае отсутствия АРМ. При получении запроса сервис сам себе отправит ответ с необходимыми данными для отправки ответа (возвращается статус обработки 1 - ЭД загружен) |
Переменные для конфигурирования отправки метрик в Elasticsearch:
ELASTIC_HOST, ELASTIC_PORT, ELASTIC_METRIC_PREFIX
Принимаемые параметры
В данном разделе приведены параметры, необходимые для формирования ответа на полученный запрос.
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| header | Заголовок ответа | + | Составной элемент ResponseHeader |
| receipt | Квитанция | + | Составной элемент Receipt |
Структура элемента ResponseHeader
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| document_guid | GUID передаваемого документа, сформированный в ИС-отправителе | + | d8bf66bf-1cf1-47f1-a48b-394d18461fe3 |
| params | Дополнительные параметры | + | Последовательность элементов типа RequestParam |
Структура элемента RequestParam
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| name | Наименование параметра | + | AccountNum |
| value | Значение параметра | + | 03744С95000 |
Обязательно должны быть указаны параметры: * AccountNum - номер лицевого счета * tofkCode – код ТОФК по КОФК * ParentDocGUID – GUID документа, инициирующего бизнес-процесс
Структура элемента Receipt
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| guid | Глобальный идентификатор Квитанции | + | 6fca5a89-329b-45d3-8cec-60951ebaa18c |
| datetime | Дата и время формирования квитанции | + | 2020-10-21T16:02:38+03:00 |
| parent_guid | GUID обработанного (квитуемого) документа | + | 2f2d3332-d210-41a9-8611-970375839b74 |
| result | Статус обработки документа. Возможные значения: • 1 – Загружен (ЭД загружен); • 2 – Не загружен (ЭД не загружен из-за ошибки формата); • 6 – Не прошел проверку (ЭД не прошел проверку). |
- | 1 |
| status_date | Дата присвоения статуса документу | - | 2020-10-21 |
Автогенерация ответа
В данном разделе рассмотрим алгоритм автогенерации ответа сервисом при включенном флаге EMULATE_CLIENT:
- Генерируется идентификатор квитанции, который используется в document_guid в header и guid в receipt
- Копируются параметры AccountNum и tofkCode из входящего запроса в параметры заголовка квитанции
- Добавляется параметр ParentDocGUID в заголовок квитанции с значением document_guid из заголовка запроса. Это же значение guid используется в качестве параметра parent_guid в receipt
- Устанавливается datetime, status_date на основе текущих даты и времени
- Устанавливаем поле result в receipt в 1.
Параметры ответа
Данный сервис получает запрос от СМЭВ 3 и ожидает получения ответа. В данном разделе указаны параметры, получаемые в результате обработки запроса.
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| header | Заголовок запроса | + | Составной элемент RequestHeader |
| protocol | Протокол | - | Составной элемент Protocol |
Структура элемента RequestHeader
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| sender_system_id | Идентификатор ИС-отправителя | + | ASFK1 |
| document_guid | GUID передаваемого документа, сформированный в ИС-отправителе | + | e8bf66bf-9cf1-47f1-a48b-394d18467fe3 |
| transaction_id | Идентификатор бизнес-процесса. Допустимые значения: Inf_OrderMir MSC_RcptPUR_EB | + | Inf_OrderMir |
| params | Блок дополнительных параметров | + | Последовательность элементов RequestParam |
1 - допустимые значения: * EXP - используется при передачи «Протокол» из ПУР ЭБ * ASFK - используется при передачи «Протокол» из ППО АСФК
Структура элемента RequestParam
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| name | Наименование параметра | + | AccountNum |
| value | Значение параметра | + | 03744С95000 |
Возможные значения name: * AccountNum - номер лицевого счета * tofkCode - код ТОФК по КОФК * ParentDocGUID - GUID документа, инициирующего бизнес-процесс
Структура элемента Protocol
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| protocol_guid | Глобальный идентификатор протокола | + | f861b623-f376-еe31-901f-0044b1562e11 |
| protocol_number | Номер протокола | + | 23 |
| protocol_date | Дата протокола | + | 2020-08-03 |
| doc_guid | Глобальный уникальный идентификатор документа, на который сформирован Протокол. В случае обмена с иными клиентами (организациями, которым не открыт лицевой счет в органах Федерального казначейства) указывается размерность (1-60). В иных случаях - (36) | + | bd444c06-ea43-430b-8fa9-5825505087da |
| doc_code | Код массива информации документа, по результатам обработки которого формируется данный Протокол. Возможные значения: • Order_Mir - Распоряжение о перечислении денежных средств на банковские карты «Мир» физических лиц; • MSC_ApplCashFlowShrt - Заявка на кассовый расход (сокращенная) (ф.0531851); • PaymOrder_PPP - Пакет платежных поручений; • MSC_CANCDOC_REQ - Запрос на аннулирование заявки (консолидированной заявки) (ф. 0531807). |
+ | MSC_ApplCashFlowShrt |
| doc_name | Полное наименование документа, по результатам обработки которого формируется данный Протокол. | + | Составной элемент DocName |
| doc_number | Номер документа, по результатам обработки которого формируется данный Протокол. В случае, если номер не предусмотрен формой документа, поле заполняется прочерком «-». | + | 21 |
| doc_date | Дата документа, по результатам обработки которого формируется данный Протокол. | + | 2020-08-01 |
| budget_name | Наименование бюджета. Для клиента, УБП федерального уровня, указывается «федеральный бюджет», для клиента, УБП субъекта РФ (МО), ТГВФ, ГВФ РФ указывается наименование соответствующего бюджета, в рамках кассового обслуживания исполнения которого, ТОФК осуществляется обработка и учет документов клиента. Поле не заполняется, если клиент является ФГУП, ГУП, МУП. | - | Бюджет Фонда социального страхования Российской Федерации |
| fo_name | Полное наименование ФО. Для УБП федерального уровня указывается наименование ФО «Министерство финансов Российской Федерации», для клиента, УБП субъекта РФ (МО), указывается наименование ФО соответствующего бюджета. Для клиента ТГВФ, ГВФ РФ может не заполнятся. Поле не заполняется, если клиент является ФГУП, ГУП, МУП. | - | Министерство финансов Российской Федерации |
| prot_type | Признак принятия к учету (аннулирования): • 0 - документ принимается; • 1 - документ не принимается (аннулируется). |
+ | 0 |
| process_date | Дата принятия для обработки или на учет (аннулирования) документа клиента. | + | 2020-08-03T09:30:47Z |
| note | Описание причин аннулирования документа или не принятия его для обработки или постановки на учет и другая необходимая информация. | - | |
| executor_name | ФИО исполнителя | + | Иванов И.И. |
| executor_post | Должность исполнителя | + | Исполнитель |
| executor_sign_date | Дата подписания ответственным исполнителем | + | 2020-08-03 |
| orfk_sender | ОрФК-отправитель | + | Составной элемент OrFK |
| orfk_recipient | ОрФК-получатель | - | Составной элемент OrFK |
| customer | Клиент | - | Составной элемент Customer |
| errors | Перечень сообщений ошибок | - | Последовательность элементов Error |
| personal_signature | Электронная подпись. Поле обязательно к заполнению при передаче документа в ЕГИССО | - | Последовательность строк, содержащих электронные подписи в формате XML-Dsig. |
Структура элемента DocName
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| code | Код документа-основания. Не используется. | - | |
| value | Наименование документа-основания. Возможные значения: • Распоряжение о перечислении денежных средств на банковские карты «Мир» физических лиц; • Заявка на кассовый расход (сокращенная) (ф.0531851); • Пакет платежных поручений; • Запрос на аннулирование заявки (консолидированной заявки) (ф. 0531807) |
Структура элемента OrFK
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| code | Код ТОФК | + | 7400 |
| value | Полное наименование ТОФК | + | Управление Федерального казначейства по г. Севастополю |
Структура элемента Customer
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| code | Код клиента. Указывается уникальный код организации по Сводному реестру, равный 8 символам. В случае отсутствия уникального кода организации по Сводному реестру, указывается код организации в соответствии с регистрационными данными, присвоенными органами ФК, равный 5 знакам. | - | 004С9500 |
| fullname | Полное наименование клиента | + | Государственное учреждение - Севастопольское региональное отделение Фонда социального страхования Российской Федерации |
| account_number | Номер лицевого счета клиента | - | 03744С95000 |
Структура элемента Error
| Параметр | Описание | Обязательное |
|---|---|---|
| rejection_code | Код причины отказа | - |
| detailed_rejection_code | Детализированный код причины отказа | + |
| reason | Причина отказа | - |
Примеры
Запроса:
{
"header": {
"sender_system_id": "EXP",
"document_guid": "f861b623-f376-еe31-901f-0044b1562e11",
"transaction_id": "MSC_Protocol",
"params": [
{
"name": "AccountNum",
"value": "03744С95000"
},
{
"name": "tofkCode",
"value": "7400"
},
{
"name": "ParentDocGUID",
"value": "f861b623-f376-еe31-901f-0044b1562e11"
}
]
},
"protocol": {
"protocol_guid": "f861b623-f376-еe31-901f-0044b1562e11",
"protocol_number": "23",
"protocol_date": "2020-08-03",
"doc_guid": "bd444c06-ea43-430b-8fa9-5825505087da",
"doc_code": "MSC_ApplCashFlowShrt",
"doc_name": {
"value": "Заявка на кассовый расход (сокращенная) (ф.0531851)"
},
"doc_number": "21",
"doc_date": "2020-08-01",
"budget_name": "Бюджет Фонда социального страхования Российской Федерации",
"fo_name": "Министерство финансов Российской Федерации",
"prot_type": "0",
"process_date": "2020-08-03T09:30:47Z",
"executor_name": "Иванов И.И.",
"executor_post": "Исполнитель",
"exucutor_sign_date": "2020-08-03",
"orfk_sender": {
"code": "7400",
"name": "Управление Федерального казначейства по г. Севастополю"
},
"customer": {
"code": "004С9500",
"fullname": "Государственное учреждение - Севастопольское региональное отделение Фонда социального страхования Российской Федерации",
"account_number": "03744С95000"
}
}
}
Также дополнительно сервисом возвращается xml полученного вида сведений:
<self:ExportResult xmlns:self="http://www.roskazna.ru/eb/domain/Result/formular/1.0.3" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.roskazna.ru/eb/domain/Result/formular/1.0.3 ExportResult.xsd">
<self:header>
<self:senderSystemId>EXP</self:senderSystemId>
<self:documentGuid>f861b623-f376-еe31-901f-0044b1562e11</self:documentGuid>
<self:transactionId>MSC_Protocol</self:transactionId>
<self:params>
<self:param name="AccountNum" value="03744С95000" />
<self:param name="tofkCode" value="7400" />
<self:param name="ParentDocGUID" value="f861b623-f376-еe31-901f-0044b1562e11" />
</self:params>
</self:header>
<self:MSC_Protocol>
<self:GUIDDec>f861b623-f376-еe31-901f-0044b1562e11</self:GUIDDec>
<self:ProtInfo_NumProt>23</self:ProtInfo_NumProt>
<self:ProtInfo_DateProt>2020-08-03</self:ProtInfo_DateProt>
<self:DocInfo_GUIDDoc>bd444c06-ea43-430b-8fa9-5825505087da</self:DocInfo_GUIDDoc>
<self:DocInfo_TypeDoc>MSC_ApplCashFlowShrt</self:DocInfo_TypeDoc>
<self:DocInfo_NameDoc value="Заявка на кассовый расход (сокращенная) (ф.0531851)" />
<self:DocInfo_NumDoc>21</self:DocInfo_NumDoc>
<self:DocInfo_DateDoc>2020-08-01</self:DocInfo_DateDoc>
<self:DocInfo_BudgName>Бюджет Фонда социального страхования Российской Федерации</self:DocInfo_BudgName>
<self:DocInfo_FOName>Министерство финансов Российской Федерации</self:DocInfo_FOName>
<self:DocInfo_ProtType>0</self:DocInfo_ProtType>
<self:DocInfo_ProcessDate>2020-08-03T09:30:47Z</self:DocInfo_ProcessDate>
<self:Executor_NmExec>Иванов И.И.</self:Executor_NmExec>
<self:Executor_PstExec>Исполнитель</self:Executor_PstExec>
<self:Executor_DtSgnngExec>2020-08-03</self:Executor_DtSgnngExec>
<self:ProtInfo_MSC_OrFK_Sender>
<self:Cd>7400</self:Cd>
<self:Nm>Управление Федерального казначейства по г. Севастополю</self:Nm>
</self:ProtInfo_MSC_OrFK_Sender>
<self:DocInfo_MSC_Cstmr>
<self:Cd>004С9500</self:Cd>
<self:FullNm>Государственное учреждение - Севастопольское региональное отделение Фонда социального страхования Российской Федерации</self:FullNm>
<self:AcntNmbr>03744С95000</self:AcntNmbr>
</self:DocInfo_MSC_Cstmr>
</self:MSC_Protocol>
</self:ExportResult>
Ответ:
{
"header":{
"document_guid":"c2e13f16-accc-481f-b235-cfbb7f3a0203",
"params":[
{
"name":"ParentDocGUID",
"value":"f861b623-f376-еe31-901f-0044b1562e11"
},
{
"name":"AccountNum",
"value":"03744С95000"
},
{
"name":"tofkCode",
"value":"7400"
}
]
},
"receipt":{
"guid":"c2e13f16-accc-481f-b235-cfbb7f3a0203",
"datetime":"2020-10-23T17:59:29+03:00",
"parent_guid":"f861b623-f376-еe31-901f-0044b1562e11",
"result":1,
"status_date":"2020-10-23"
}
}