Работа с вложенными файлами

URI

Работа с вложенными файлами может производиться для документов:
- Письма
- Сведения о валютных операциях (СВО)
- Справки о подтверждающих документах (СПД)
- Постановка на учет внешнеторгового контракта (УНК)

Для отправки файлов вложением необходимо в Headers передать параметры:
1. Media Type: multipart/form-data
2. В самом запросе для вложенных файлов необходимо указывать ContentID = attachment (маркер для определения файла - вложения)

Table 1. URI
Тип документа Описание метода Метод Ссылка Комментарий

Вложения к СВО

Load attaches to Certificate

POST

/API/v1/ISO20022/COCertificates/Transactions/Files/<TxId>

Отправка вложенных файлов в СВО

Get attaches' list to Certificate

GET

/API/v1/ISO20022/COCertificates/Transactions/Files/<TxId>

Получение списка файлов, приложенных к СВО

Get attach to Certificate

GET

/API/v1/ISO20022/COCertificates/Transactions/Files/<TxId>/<FileId>

Получение контента файла, приложенного к СВО

Вложения к СПД

Load attaches to Certificate

POST

/API/v1/ISO20022/ConfCertificates/Transactions/Files/<SpprtgDocId>

Отправка вложенных файлов в СПД

Get attaches' list to Certificate

GET

/API/v1/ISO20022/ConfCertificates/Transactions/Files/<SpprtgDocId>

Получение списка файлов, приложенных к СПД

Get attach to Certificate

GET

/API/v1/ISO20022/ConfCertificates/Transactions/Files/<SpprtgDocId>/<FileId>

Получение контента файла, приложенного к СПД

Вложения к письму

Load attaches to letter

POST

/API/v1/ISO20022/Letters/OutLetters/Files/<ReqOrLttrId>

Отправка вложенных файлов

Get attach’s content to incoming letter

GET

/API/v1/ISO20022/Letters/InLetters/Files/<ReqOrLttrId>/<DocNb>

Получение контента файла, приложенного к входящему письму

Вложения к Контракту (УНК)

Load attaches to Contract

POST

/API/v1/ISO20022/Contracts/Files/<CtrctRegnOpngId>

Отправка вложенных файлов в Контракт (УНК)

Get attaches' list to Contract

GET

/API/v1/ISO20022/Contracts/Files/<CtrctRegnOpngId>/<FileId>

Получение списка файлов, приложенных к Контракту (УНК)

Get attach to Contract

GET

/API/v1/ISO20022/Contracts/Files/<CtrctRegnOpngId>

Получение контента файла, приложенного к Контракту (УНК)

Отправка вложенных файлов с подписью

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

Необходимо в Headers передать параметры:
1. check_sign_attach со значением true
2. company_tin (не обязательный параметр) со значением ИНН компании
3. В самом запросе для файлов-подписей (.pkcs7) необходимо указывать ContentId = sign (маркер для определения подписей)

Может быть 2 варианта установки подписи:
1. Все подписи в одном файле .pkcs7
2. Каждая подпись в отдельном файле .pkcs7

Наименование файлов подписи должны соответствовать формату:
sign_filename.pkcs7 или signX_filename.pkcs7 , где
X - это цифра от 1 до 3 в случае, если подписей на файле несколько и каждая из них в отдельном файле (.pkcs7),
filename - название подписываемого файла