﻿# Входные и выходные атрибуты блоков для СБИС

> [HTML Version](sbis-blocks-parameters.html)

Перед началом настройки [блока из решения СБИС](sbis-process-blocks.md) добавьте в контекст процесса переменные, соответствующие входным и выходным атрибутам блока. В настройках каждого блока:

- **входные атрибуты** — сопоставьте с переменными, которые содержат данные из ELMA365 для их передачи в СБИС;

- **выходные атрибуты** — укажите переменные, в которые будет записан результат, полученный из СБИС.

Чтобы упростить настройку, рекомендуем для переменных использовать названия, совпадающие с названиями атрибутов.

## Входные атрибуты блоков решения «СБИС»

Перечень входных атрибутов в каждом блоке решения:

| | |
|------|------|
| **Название блока** | **Перечень входных атрибутов** |
| СБИС записать документ | Юр.  лицо,** **Элемент приложения,** **ИНН контрагента, КПП контрагента, Тип документа, Номер документа, Дата документа |
| СБИС записать вложение | Юр.  лицо,** **Элемент приложения,** **Подпись, ID вложения, Вложение, Идентификатор доверенности |
| СБИС отправить документ | Юр.  лицо,** **Элемент приложения,** **Отпечаток сертификата, ФИО, ИНН, Должность |
| СБИС записать и отправить документ | Юр.  лицо,** **Элемент приложения,** **Подпись, Вложение, ИНН контрагента, КПП контрагента, ID вложения, Тип документа, Этап (строка), Номер документа, Дата документа, Идентификатор доверенности |
| СБИС выполнить утверждение | Юр.  лицо,** **Элемент приложения,** **Отпечаток сертификата, Комментарий, ФИО, ИНН, Должность, Подпись |
| СБИС импорт доверенности | Юр.  лицо,** **Идентификатор доверенности, ИНН доверителя (не содержит атрибут Элемент приложения) |
| СБИС подготовить аннулирование,<br>СБИС подготовить отказ от аннулирования,<br>СБИС подготовить подтверждение аннулирования | Юр.  лицо,** **Элемент приложения,** **Отпечаток сертификата, Комментарий, ФИО, ИНН, Должность |
| СБИС выполнить аннулирование,<br>СБИС выполнить отказ от аннулирования,<br>СБИС выполнить подтверждение аннулирования | Юр.  лицо,** **Элемент приложения,** **Отпечаток сертификата, Комментарий, ФИО, ИНН, Должность, Подпись, ID вложения |


Список входных атрибутов, которые используются в блоках, с указанием типа сопоставляемой переменной:

| | |
|------|------|
| **Название входного атрибута** | **Тип сопоставляемой переменной. Комментарии** |
| Юр.  лицо | Приложение (один). Обязательный параметр.<br>Переменная ссылается на системный справочник **Мои юридические лица**. Записанное в неё юрлицо должно быть [подключено к сервису СБИС](sbis.md#sbis-connection) в настройках модуля. От этого юрлица будут выполняться действия в СБИС. |
| Элемент приложения | Приложение (один). Обязательный параметр.<br>Переменная ссылается на приложение типа **Документ**, для которого настроено [соответствие документов](sbis.md#compliance-of-documents) в настройках модуля. |
| ИНН контрагента | Строка. Обязательный параметр.<br>Содержит ИНН контрагента, которому будет направлен документ. |
| КПП контрагента | Строка. Обязательный параметр.<br>Содержит КПП контрагента, которому будет направлен документ. |
| Тип документа | Строка (текст). Обязателен для заполнения в блоке **СБИС записать документ**. Содержит тип документа в СБИС. Подробнее о типах смотрите в [официальной документации сервиса](https://sbis.ru/help/integration/catalog/guide#1). |
| Номер документа | Строка. Если переменная не указана, будет передано значение согласно настройкам [сопоставления атрибутов](sbis.md#setting-attributes) в модуле либо пустое значение. |
| Дата документа | Строка** **в формате **ДД.ММ.ГГГГ**. <br>Если переменная не указана, будет передано значение согласно настройкам [сопоставления атрибутов](sbis.md#setting-attributes) в модуле либо пустое значение. |
| Подпись | Файлы. Обязательный параметр |
| ID вложения | Строка. Содержит идентификатор вложения СБИС.<br>Необязательный атрибут. ID можно сгенерировать вручную в виде uid-номера и передать в СБИС. Если ID не указан, он сгенерируется автоматически при сохранении вложения в СБИС. |
| Вложение | Файлы. Обязательный параметр |
| Идентификатор доверенности | Строка. Обязателен для заполнения в блоке **СБИС импорт доверенности**.<br>Содержит идентификатор МЧД, который должен быть предварительно импортирован в личный кабинет СБИС и иметь статус **Действует** |
| ИНН доверителя | Строка. Обязательный параметр |
| Отпечаток сертификата | Строка. Содержит отпечаток добавленного в СБИС сертификата для подписания документа.<br>Условно-обязательный параметр: требует заполнения, если не сопоставлены **ФИО**, **ИНН** и **Должность**. |
| ФИО | Строка. Условно-обязательный параметр: требует заполнения, если не сопоставлен Отпечаток сертификата.<br>Содержит данные Ф. И. О. подписанта. |
| ИНН | Строка. Условно-обязательный параметр: требует заполнения, если не сопоставлен отпечаток сертификата.<br>Содержит ИНН подписанта |
| Должность | Строка. Условно-обязательный параметр: требует заполнения, если не сопоставлен отпечаток сертификата.<br>Содержит должность подписанта. |
| Этап (строка) | Строка. Необязательный параметр.<br>Позволяет настроить повторное выполнение блока **СБИС записать и отправить документ** с определённого этапа, на котором произошла ошибка и значение которого будет передано в блок. Если переменная не сопоставлена, выполнятся все три этапа: записать документ, записать вложение, отправить документ. |
| Комментарий | Строка (текст). Обязателен для заполнения в блоках:<br>- **СБИС подготовить аннулирование**;<br>- **СБИС выполнить аннулирование**;<br>- **СБИС подготовить отказ от аннулирования**;<br>- **СБИС выполнить отказ от аннулирования**;<br>- **СБИС выполнить подтверждение аннулирования**. |


## Выходные атрибуты блоков решения «СБИС»

Список выходных атрибутов может отличаться для каждого блока. Общими для всех блоков являются два выходных атрибута, **Успешно** и **Ошибка**.

Список блоков, которые содержат как общие, так и дополнительные выходные атрибуты:

| | |
|------|------|
| **Название блока** | **Выходные атрибуты** |
| СБИС записать вложение | Успешно, Ошибка, ID вложения |
| СБИС записать и отправить документ | Успешно, Ошибка, Этап (строка) |
| СБИС получение печатной формы | Успешно, Ошибка, Печатная форма, Ссылка на печатную форму |
| СБИС получить архив документооборота | Успешно, Ошибка, Архив документооборота |
| СБИС подготовить аннулирование,<br>СБИС подготовить подтверждение аннулирования | Успешно, Ошибка, Результат, Ответ, ID соглашения, Файл соглашения |
| СБИС подготовить отказ от аннулирования | Успешно, Ошибка, Результат, Ответ, ID вложения, Файл отказа |


Список входных атрибутов, которые используются в блоках, с указанием типа сопоставляемой переменной:

| | |
|------|------|
| **Название выходного атрибута** | **Тип сопоставляемой переменной. Комментарий** |
| Успешно | Выбор «да/нет». Успешный результат выполнения блока |
| Ошибка | Строка (текст). Текст ошибки при неуспешном выполнении операции |
| ID вложения | Строка. Внутренний идентификатор СБИС |
| Этап (строка) | Строка. Этап, на котором возникла ошибка в случае неуспешного выполнения. |
| Печатная форма | Файлы |
| Ссылка на печатную форму | Строка |
| Архив документооборота | Файлы |
| Результат | Строка. Текст результата |
| Ответ | Строка. Тело ответа запроса из JSON |
| ID соглашения | Строка. Внутренний идентификатор СБИС |
| Файл соглашения | Файлы |
| Файл отказа | Файлы. Файл служебного документа |
