Передача протокола с причинами возврата распоряжений о перечислении денежных средств

smev3 link

smev manual

Атрибут Значение
Название 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:

  1. Генерируется идентификатор квитанции, который используется в document_guid в header и guid в receipt
  2. Копируются параметры AccountNum и tofkCode из входящего запроса в параметры заголовка квитанции
  3. Добавляется параметр ParentDocGUID в заголовок квитанции с значением document_guid из заголовка запроса. Это же значение guid используется в качестве параметра parent_guid в receipt
  4. Устанавливается datetime, status_date на основе текущих даты и времени
  5. Устанавливаем поле 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"
  }
}