Документооборот с контрагентами

Загрузка данных через файловое хранилище

Загрузка данных через файловое хранилище

Файлы вложений, которые вы загружаете, помещаются в файловое хранилище. Ссылка на файловое хранилище передается в методы API.

Размещение файла в файловом хранилище

Для того чтобы разместить файл в хранилище, выполните запрос по адресу в поле «href». Адрес ссылки возьмите из ответа на первое обращение к файловому хранилищу.

Пример запроса с заголовками

POST https://online.sbis.ru/disk/api/v1/temp?object=simple_file_sd
Заголовки
Content-Type: application/octet-stream
User-Agent: External API Client Name
Content-Disposition: attachment; filename*=UTF-8''NO_ENVD_7666_7666_1708003233170801001_20180416_32DB18D2-6551-4B41-A84B-0D8D3F3F49B9.xml
X-SBISSessionID: 0000ea78-0000ea79-00ba-d3b85272bc0c4842
Content-Length: 1160
Тело запроса
<?xml version="1.0" encoding="Windows-1251"?>
<Сведения>
<Описание>
<ИмяФормы>Налоговая декларация по единому налогу на вмененный доход для отдельных видов деятельности</ИмяФормы>
<КНДФормы>1152016</КНДФормы>
<ВидДокумента>первичный</ВидДокумента>
<Период ИдентификаторВложения="aec8aea7-6109-4089-bd7a-2e2325280d5f" Код="21" Год="2016"/>
<НОПоМестуУчета>9992</НОПоМестуУчета>
<НОПоМестуНахождения>9992</НОПоМестуНахождения>
<УполномоченнаяБухгалтерия>false</УполномоченнаяБухгалтерия>
<КолФайл>1</КолФайл>
</Описание>
<Пакет>
<ВерсПрог>СБИС 2.4.353</ВерсПрог>
<СКЗИ>Crypto-Pro GOST R 34.10-2001 Cryptographic Service Provider</СКЗИ>
<ПрограммаФормированияОтчета>СБИС 2.4.353</ПрограммаФормированияОтчета>
</Пакет>
</Сведения>

Назначение заголовков

ЗаголовокОписание
User-AgentНаименование системы интеграции
Content-TypeТип содержимого оригинального файла (MIME)
Content-DispositionДолжен иметь вид:
Content-Disposition:attachment;filename*=UTF-8’’name, где name=URLEncoded(имя файла в кодировке UTF-8)
Content-LengthРазмер файла
X-SBISSessionIDИдентификатор сессии, который приходит в результате аутентификации.

Пример ответа

HTTP/1.1 201 Created
Date: Mon, 16 Apr 2018 11:40:50 GMT
Content-Type: application/json; charset=utf-8
Content-Length: 562
Last-Modified: Mon, 16 Apr 2018 11:40:50 GMT
Strict-Transport-Security: max-age=31536000;
Cache-Control: must-revalidate, max-age=0
{
"status": 201,
"href": "https://online.sbis.ru/disk/api/v1/6f9b383e-4743-4928-9279-2a14a67405fa_88c5c5fe-42a1-46d7-a8b2-5d694521dbed",
"relativePath": "/disk/api/v1/6f9b383e-4743-4928-9279-2a14a67405fa_88c5c5fe-42a1-46d7-a8b2-5d694521dbed",
"fileid": "6f9b383e-4743-4928-9279-2a14a67405fa",
"versionid": "6f9b383e-4743-4928-9279-2a14a67405fa_88c5c5fe-42a1-46d7-a8b2-5d694521dbed",
"range-md5": "0-1159_f9c718bbbb4721625451dd22066fa366",
}

Значение, которое получено в поле «href» — ссылка на объект в файловом хранилище. Для отправки вложения ее нужно передать в поле «Документ.Вложение.Файл.Ссылка» для файла и «Документ.Вложение.Подпись.Файл.Ссылка» для электронной подписи.