﻿# Входные и выходные атрибуты блоков решения «Интеграция СПАРК»

> [HTML Version](spark-blocks-input-output-parameters.html)

Чтобы [смоделировать пользовательский процесс](spark-process-blocks.md) с блоками решения **Интеграция СПАРК**, в контекст процесса добавляются определённые переменные. С ними сопоставляются поля из настроек блока, которые подразделяются на следующие типы:

- **входные атрибуты** — в них передаются переменные, содержащие данные о контрагенте, по которому создаётся запрос;

- **выходные атрибуты** — сопоставляются с переменными, в которые записывается результат выполнения запроса в блоке. 

Это позволяет идентифицировать компанию или физическое лицо при отправке запроса в СПАРК, а также передавать данные по контрагенту в ELMA365. 

Список всех графических элементов решения приведён в статье [«Типы запросов в сервис СПАРК»](spark-requests-types.md#applications-for-requests).

Перед настройкой блоков в контекст процесса нужно добавить переменные, которые соответствуют входным и выходным атрибутам по типу данных. Чтобы упростить настройку, для переменных рекомендуем использовать названия, совпадающие с атрибутами.

Рассмотрим подробнее входные и выходные атрибуты для настройки блоков.

## Входные атрибуты блоков решения «Интеграция СПАРК»

Входные атрибуты сопоставляются с переменными, в которых содержится информация о контрагенте, по которому направляется запрос. Добавьте эти переменные в контекст процесса.

| | |
|------|------|
| **Графические блоки** | **Входные атрибуты** |
| Большинство блоков.<br>Исключения: универсальный блок получения данных из СПАРК, блоки с запросами по санкционным спискам и рискам ПДЛ, а также остаткам платных запросов. | Атрибуты с типом **Строка**:<br>- **СПАРК ID** — идентификатор контрагента в СПАРК;<br>- **ИНН** — регистрационный код ИНН контрагента;<br>- **ОГРН **или **ОГРНИП** — регистрационный код ОГРН российской компании или  ОГРНИП физического лица.<br>Из этого набора переменных для выполнения запроса достаточно добавить одну. |
| Получение данных по остатку платных запросов | Не содержит входных параметров. |
| Получение данных из СПАРК** ** | **Метод**, **Тело запроса** — свойства с типом **Строка**. Пример заполнения этих параметров читайте в статье [«Отправка запросов в сервис из раздела „СПАРК”»](send-spark-requests.md#universal-request). |
| Получение списка событий мониторинга по компании / по компаниям | **Изменения** — свойство с типом **Выбор «да/нет»**, в вариантах указываются опции: **Все**, **Только неотправленные**.<br>Выбранный вариант определяет, какие изменения нужно получить из сервиса. Можно установить вариант по умолчанию или разместить пользовательскую задачу на схеме процесса перед блоками для выбора варианта. |
| - Получение данных по санкционным рискам ПДЛ;<br>- Получение информации о вхождении физического лица в санкционные списки и списки наблюдения | - **Идентификатор X-Compliance** — идентификатор физического лица в X-Compliance, тип **Строка**;<br>- **ФИО физического лица** — свойство с типом **Строка**;<br>- **Дата рождения физического лица** — свойство с типом **Дата**.<br>Из этого набора обязательно указывается переменная **Идентификатор X-Compliance **или **ФИО физического лица**. |
| Получение информации о вхождении компании в санкционные списки, а также список санкций по Правилу 50% | Атрибуты с типом **Строка**:<br>- **Идентификатор X-Compliance** — идентификатор компании в X-Compliance;<br>- **Идентификатор СПАРК** — идентификатор компании в СПАРК;<br>- **Регистрационный код** — регистрационный код ИНН или ОГРН российской компании;<br>- **Наименование компании**.<br>Хотя бы один параметр из этого набора должен быть задан.<br>Поиск иностранной компании осуществляется по значению идентификатора X-Compliance или наименованию. |


## Выходные атрибуты блоков решения «Интеграция СПАРК»

В выходные атрибуты передаются переменные, в которые записывается результат, полученный из сервиса. Схожие параметры имеют одинаковый тип данных. Для примера в таблице приведены выходные параметры некоторых блоков.

| | | |
|------|------|------|
| **Графические блоки** | **Выходные атрибуты в настройках блоков** | **Тип сопоставляемой переменной  ** |
| Все блоки | Атрибуты, которые присутствуют во всех блоках:<br>Результат выполнения, Текст ошибки, Код ошибки СПАРК, Код ответа | Строка |
| Большинство блоков.<br>Исключения: универсальный блок получения данных из СПАРК, блоки с запросами по санкционным спискам и рискам ПДЛ, а также остаткам платных запросов. | Атрибуты, которые присутствуют в большинстве блоков:<br>- СПАРК id (отсутствует также в блоке с запросом о факторах риска по физическому лицу);<br>- ИНН, ОГРН или ОГРНИП | Строка |
| Включение/Выключение мониторинга по компании | Включение/Выключение мониторинга по компании | Приложение > **Включение/Выключение мониторинга по компании** с опцией **Один** |
| Получение данных из СПАРК | Получение данных из СПАРК | Приложение > **Получение данных из СПАРК** с опцией **Один** |
| Получение данных из СПАРК: Отчет СПАРК-Риски по российской компании PDF | Свойства из настроек элемента **Получение информации об актуальных совладельцах российской компании**: ОКПО, ОКАТО, Признак действующей компании, Код статуса, Текст статуса, Идентификатор группы статусов, Наименование группы статусов, Дата актуальности статуса | Типы указаны в таблице ниже |
| | Отчет «СПАРК-Риски» | Файлы |
| Получение данных из СПАРК: Структура российской компании | Свойства для обозначения данных о совладельцах из настроек элемента **Получение информации об актуальных совладельцах российской компании** | Строка |
| | Краткое наименование компании, Признак включения в ЕГРПО (Росстат) | Строка |
| | Атрибуты с отметкой **Сериализованный ответ**: Дочерние компании по данным Росстата, Дочерние компании по данным компании, Дочерние компании по данным ЕГРЮЛ, Филиалы по данным компании, Филиалы по данным Росстата, Филиалы по данным ЕГРЮЛ, Участие в фондах, холдингах, некоммерческих партнерствах и объединениях, Список событий мониторинга | Строка |
| Получение информации о факторах риска по физическому лицу | ФИО, Место рождения | Строка |
| | Атрибуты с отметкой **Сериализованный ответ**: Пол, Гражданство, Другие ФИО, Индивидуальный предприниматель, Факторы риска, Связанные ИП по ИНН, Дисквалификации ФЛ, Совладелец, Руководитель, Бенефициар | Строка |
| | Дата рождения, Дата потери правоспособности | Дата |
| | Факторы риска физического лица | Приложение > **Факторы риска физического лица** с опцией **Один** |
| Получение информации об актуальных совладельцах российской компании | Краткое наименование, ОКПО, ОКАТО, Текст статуса, Наименование группы статусов, Основание для ограничения доступа к данным о совладельцах | Строка |
| | Атрибуты с отметкой **Сериализованный ответ**:  Совладельцы по данным Раскрытия, Совладельцы по данным ЕГРЮЛ, Совладельцы по данным Росстата | Строка |
| | Признак действующей компании, Признак ограничения доступа к данным о совладельцах | Выбор «да/нет» |
| | Код статуса, Идентификатор группы статусов | Число |
| | Дата актуальности статуса | Дата/время |
| | Информация об актуальных совладельцах российской компании | Приложение > **Информация об актуальных совладельцах российской компании** с опцией **Один** |
| Получение списка событий мониторинга по компании/компаниям | События, Название компании | Строка |
| | Получения списка событий мониторинга по компании/компаниям | Приложение > **Получения списка событий мониторинга по компании/компаниям** с опцией **Один** |
