Работа с вложенными файлами
URI
Работа с вложенными файлами может производиться для документов:
- Письма
- Сведения о валютных операциях (СВО)
- Справки о подтверждающих документах (СПД)
- Постановка на учет внешнеторгового контракта (УНК)
Для отправки файлов вложением необходимо в Headers передать параметры:
1. Media Type: multipart/form-data
2. В самом запросе для вложенных файлов необходимо указывать ContentID = attachment (маркер для определения файла - вложения)
Тип документа | Описание метода | Метод | Ссылка | Комментарий |
---|---|---|---|---|
Вложения к СВО |
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 - название подписываемого файла