Работа с документами
Документы делятся на две категории:
- документы заявки;
- документы предложения.
Помимо них, существуют два отдельных документа: претензия к макету банковской гарантии и скан банковской гарантии с подписью банка.
Документы заявки
Документы заявки бывают двух видов:
- общие документы заявки — относятся к юридическому лицу: выписки, приказы и другие типы документов;
- документы бенефициарных владельцев принципала — удостоверяют личность физического лица или подтверждают его право проживания на территории РФ.
Принадлежность документа к физическому лицу указывается через параметр
beneficiaryIdв методах API.
Актуальный список типов документов приведен в спецификации методов для работы с ними — например, в методе добавления документа в заявку.
Допустимые размеры файлов для каждого типа документов приведены в таблице ниже.
| Тип документа | Максимальный размер одного файла (МБ) | Максимальный суммарный размер файлов (МБ) |
|---|---|---|
| PassportImage | 8 | 10, для каждого бенефициара |
| ResidencyDocument | 8 | 10, для каждого бенефициара |
| EgrulExcerpt | 5 | может быть загружен только один файл |
| ExtractFromShareholderRegister | 8 | может быть загружен только один файл |
| ConfirmationOfLocation | 8 | 20 |
| ConfirmationOfBeneficialOwners | 8 | 20 |
| ListOfPersonalDataOfParticipants | 8 | 20 |
| OrderForPosition | 8 | 20 |
| BusinessModel | 8 | 20 |
Документы предложения
Документы предложения формируются банком на этапе формирования предложения. Получить их можно через метод получения информации о предложении. Актуальный список типов документов приведен в спецификации данного метода.
Претензия к макету банковской гарантии и скан банковской гарантии
Претензия к макету банковской гарантии и скан банковской гарантии с подписью банка — отдельные документы, не входящие в категории документов заявки или предложения.
Эти документы встречаются на определенных этапах жизненного цикла заявки:
- претензия — документ, который прикладывает агент при составлении правок к тексту банковской гарантии, возможно загрузить при формировании предложения и после отправки предложения клиенту;
- скан банковской гарантии с подписью банка доступен для скачивания после её выпуска.
Максимальный размер файла претензии к макету банковской гарантии — 8 МБ.
Загрузка и скачивание файлов
Для прикрепления документа к заявке необходимо сначала загрузить файл во внутреннее хранилище через метод отправки файла. В ответе вернется fileId, который затем передается в метод добавления документа к заявке.
При скачивании файла через метод получения файла необходимо передать тип файла, а не тип документа. Идентификатор файла fileId доступен в ответе методов API, возвращающих информацию о документах.
Типы файлов отличаются от типов документов — соответствие между ними приведено в таблице ниже.
| Тип файла | Категории документов |
|---|---|
| Клиентское досье | Документы заявки |
| Индивидуальное предложение | Документы предложения |
| Претензия | Претензия к макету банковской гарантии |
| Банковская гарантия | Скан банковской гарантии с подписью |