# Описание Клиентской документации

Мультибанк (Транзит 2.0) позволяет импортировать:

1. Рублевые платежные поручения в формате `1С`, `ISO20022`
2. Документы валютного контроля (в том числе валютные переводы) в формате `ISO20022`
3. Документы по зарплатному проекту в формате `XML`, `XLS`.

При импорте, Транзит преобразовывает файлы во внутренний универсальный формат (`УФ`). Для отправки в банк, документ преобразовывается в формат, определенный Банком.

Для получения пользователем документа, Транзит преобразовывает его в формат `XML`, `1С`, `ISO20022`, `PDF`, `XLS`.

При рассылке новых версий Мультибанка (Транзит 2.0), всем участникам платформы передается описание форматов в `ClientDoc` (далее – документация). В `ClientDoc` представлено: описание, примеры, схемы документов в формате `XML`. Описание форматов содержат в себе весь перечень атрибутов. `XML`-примеры могут использоваться в качестве шаблонов.

Документация содержит возможный набор атрибутов с указанием формата и условий их заполнения, а также обязательность атрибута, которая определяется требованиями, изложенными в спецификациях банков:

Представление данных в ClientDoc

В зависимости от бизнес-задачи пользователя предполагается два основных варианта (Рекомендации по использованию основаны на технологической особенности работы Мультибанка (Транзит 2.0)) использования документации при проведении доработок программного обеспечения, подготавливающего сообщения для загрузки в Транзит.

1. Основной вариант. Использование Мультибанка (Транзит 2.0) для взаимодействия с неограниченным перечнем банков (без привязки к определённому):
   - Пользователь на своей стороне проводит доработку для загрузки полного набора атрибутов, перечисленного в документации.
   - В этом случае Транзит сможет сформировать без ошибок документ в любой из банков, перечисленных в документации, сообщение будет соответствовать требованиям банка получателя.
2. Дополнительный вариант. Использование Мультибанка (Транзит 2.0) для взаимодействия с ограниченным перечнем банков (определенные обслуживающие пользователя банки):
   - Пользователь на своей стороне проводит доработку для загрузки всего набора атрибутов, для тех банков, с которыми предполагается взаимодействие, независимо от банка получателя (в этом случае необходимо учесть, что если атрибут в первом и втором банке опциональный (`O`), а в третьем банке обязательный (`R`), то этот атрибут считается обязательным) или
   - Пользователь на своей стороне проводит доработку для загрузки обязательного набора атрибутов для банка, с которыми предполагается взаимодействие (т.е. набор обязательных атрибутов изменяется в зависимости от банка, в которое направляется сообщение). Независимо от используемого варианта, требуется внимательно изучать документацию.

ВАЖНО! Необходимо обратить внимание, что ошибки с отправкой возможны в случае, если банк по каким-либо причинам не сообщил НРД об изменениях требований к получаемым документам.

ВАЖНО! В случае изменения форматов импорта, НРД может дополнительно направлять описание изменения форматов.

Изменения форматов производятся в следующих случаях:

- Изменение требований банка к принимаемым сообщениям
- Устранение ошибок
- Добавление нового функционала