Переход Диадока с ShelfUpload и ShelfDownload на API v2
Переход Диадока с ShelfUpload и ShelfDownload на API v2 нужен интеграциям, которые используют полку документов как временное хранилище содержимого перед отправкой сообщения или при получении файла. Контур пометил старые методы устаревшими, добавил в их ответы заголовки Sunset и Link и назначил удаление после 30 сентября 2026 года.
Для целого документа применяется ShelfUpload v2. Для поэтапной передачи первый фрагмент отправляется через ShelfUploadPartInit, а следующие — через ShelfUploadPart. Скачивание переводится на ShelfDownload v2. Актуальные методы принимают документ или фрагмент размером до 3 МБ за запрос, поэтому размер части и число повторов требуют явной настройки.
Мы находим каждое место, где код получает shelf key, сохраняет его в очереди и передаёт дальше в отправку документа. Затем обновляем клиент, обработку ошибок и временных файлов. Для крупных документов сохраняем состояние частичной загрузки, чтобы сбой конкретного фрагмента имел понятный результат.
Приёмка проходит на малом и крупном файле: содержимое загружается, участвует в действующем сценарии Диадока, скачивается обратно и сравнивается по размеру и контрольной сумме. Команда получает актуальный обмен и журнал, по которому видно документ, способ передачи, число частей и завершение операции.
Когда стоит обратиться
Обычно к нам обращаются в таких ситуациях:
- Ответ Диадока на ShelfUpload либо ShelfDownload содержит заголовки Sunset и Link на актуальную документацию.
- Интеграция сначала кладёт XML, PDF, архив или вложение на полку, а затем использует shelf key при отправке.
- Крупный документ загружается собственным циклом частей, который связан с форматом старого метода или SDK.
- После обновления SDK проект теряет старый вызов, получает ошибку метода либо зависает на повторе фрагмента.
Что именно мы сделаем
Находим старые ShelfUpload и ShelfDownload, связанные shelf key, очереди, временные файлы и места отправки документа.
Разделяем сценарии целой и частичной загрузки по фактическим размерам и типам файлов в рабочем потоке.
Переводим клиент на ShelfUpload v2, ShelfUploadPartInit, ShelfUploadPart и ShelfDownload v2 с актуальными заголовками.
Добавляем журнал частей, контролируемый повтор, очистку временных данных и проверку целостности скачанного содержимого.
Проводим контрольную отправку документов разных размеров и передаём карту методов и инструкцию диагностики.
Что входит в стоимость
49 900 ₽ за всю работу
Находим старые вызовы ShelfUpload и ShelfDownload в API-клиенте, SDK, фоновых заданиях и очередях, затем выбираем целую или частичную загрузку для каждого типа документа. Обновляем методы, заголовки, обработку идентификатора полки, ограничение части, повторы, скачивание и очистку временных файлов. Проверяем документы разных размеров и форматов, отправку через действующий процесс ЭДО и целостность обратного скачивания.
Что будет готово
Передадим вам
- Обновлённый клиент полки Диадока с целой и частичной загрузкой и скачиванием через актуальные методы.
- Журнал документа, shelf key, номера части, размера, попытки и результата операции.
- Проверка размера и контрольной суммы для загруженных и скачанных контрольных файлов.
- Карта вызовов, настройки размера частей и инструкция разбора временных и постоянных ошибок.
Перед сдачей проверим
- Файл в пределах одной части загружается через ShelfUpload v2 и участвует в выбранном процессе Диадока.
- Крупный документ проходит ShelfUploadPartInit и последовательные ShelfUploadPart с полным журналом частей.
- ShelfDownload v2 возвращает содержимое с тем же размером и контрольной суммой, что у исходного файла.
- Временный сбой фиксируется в журнале, а повтор завершает выбранный сценарий и сохраняет корректный shelf key.
Как это выглядит на практике
Большой PDF проходит полку Диадока частями и сохраняет целостность
- 01
Фоновое задание определяет размер PDF и начинает передачу первого фрагмента через ShelfUploadPartInit.
- 02
Следующие части отправляются через ShelfUploadPart, а журнал сохраняет номер, размер и результат каждой операции.
- 03
Полученный shelf key передаётся в действующий сценарий документа Диадока и связывается с внутренней записью.
- 04
Контрольное скачивание через ShelfDownload v2 подтверждает размер, контрольную сумму и открытие PDF.
Что понадобится для работы
От вас
- Код интеграции либо используемый SDK Диадока, конфигурация API-клиента и журналы старых методов полки.
- Тестовый ящик Диадока и токен с правами, достаточными для выбранного сценария загрузки и отправки.
- Набор контрольных XML, PDF, архивов или вложений обычного и максимального рабочего размера.
- Описание очереди, временного хранилища, PostMessage, черновика или шаблона, куда передаётся shelf key.
Если у вас немного другая ситуация
Небольшие уточнения, которые помогают довести согласованный результат до рабочего состояния, уже учитываем в цене. Если по ходу работы появится отдельный крупный блок или понадобится платная лицензия, сначала обсудим варианты и стоимость. Расскажите о своей ситуации — подстроим план под неё.
- 3 000 ₽после подписания договора через Диадок
- 46 900 ₽после выполнения, демонстрации и приёмки результата
Предоплата входит в общую стоимость. Оставшуюся сумму оплачиваете после демонстрации и приёмки готовой работы.
Часто спрашивают
Об этой услуге
Когда удаляются старые ShelfUpload и ShelfDownload?
Контур перенёс срок удаления на период после 30 сентября 2026 года. Старые ответы уже содержат Sunset и Link с указанием актуальной замены.
Какой метод подходит для загрузки целого файла?
ShelfUpload v2 принимает содержимое целиком. Такой маршрут используем для файлов, которые укладываются в актуальный лимит запроса и рабочего транспорта.
Как передавать документ размером больше одной части?
Первый фрагмент отправляется через ShelfUploadPartInit, последующие — через ShelfUploadPart. Журнал сохраняет порядок и результат каждого фрагмента.
Какой размер файла или фрагмента поддерживает новый API?
В июне 2026 года Контур увеличил лимит ShelfUpload v2, ShelfUploadPartInit и ShelfUploadPart с 512 КБ до 3 МБ за запрос.
Изменится ли основной сценарий отправки документа?
Рабочий процесс сообщения, шаблона либо черновика сохраняется. Обновляется технический этап помещения содержимого на полку и его обратного получения.
Как проверяется целостность большого документа?
Скачиваем контрольное содержимое через ShelfDownload v2 и сравниваем байтовый размер и контрольную сумму с исходным файлом, затем проверяем открытие формата.
Потребуется ли обновление SDK Диадока?
Версия SDK зависит от языка и текущего клиента. Проверяем наличие актуальных методов и обновляем библиотеку либо прямые HTTP-вызовы вместе с совместимым кодом.
Как проходит приёмка перехода полки Диадока?
Проверяем целый и многочастный файл, временный сбой, повтор, участие shelf key в основном процессе и обратное скачивание с совпавшей контрольной суммой.
Цена и изменения по ходу работы
Цена на странице окончательная?
Да. Перед началом мы сверяем исходные данные и фиксируем результат в договоре. Указанная на странице сумма покрывает согласованную работу целиком, даже если её техническая реализация потребует больше времени, чем ожидалось при оценке.
Что означает резерв незапланированных работ?
Это уже включённый в цену запас времени на небольшие связанные уточнения заказчика, которые появляются после старта: например, добавить поле, изменить формат уведомления или учесть ещё одно условие обработки.
Резерв рассчитывается по формуле: стоимость услуги × 30% ÷ 1 500 ₽. Для услуги за 30 000 ₽ это 6 часов. Эти часы относятся только к дополнительным, заранее незапланированным уточнениям. Они не являются сроком проекта и не ограничивают время на основную работу: согласованный результат мы выполняем полностью.
Можно уточнять детали уже во время работы?
Да. Небольшие связанные изменения обычно помещаются во включённый резерв и не требуют доплаты. Если новая идея заметно меняет результат или превращается в самостоятельную задачу, сначала обсудим подход и стоимость. Любое решение согласуем до выполнения.
Начало работы и оплата
Как оформляются договор и оплата?
Подписываем договор через Диадок. Предоплата составляет 3 000 ₽ и входит в общую стоимость услуги. Остаток оплачивается после демонстрации и приёмки готового результата.
Когда начинается срок выполнения?
Срок отсчитывается после согласования задачи, получения необходимых доступов и материалов, подписания договора и поступления предоплаты. Конкретную дату старта и плановый день готовности подтверждаем перед началом.
Как учитываются платные лицензии и внешние сервисы?
До старта проверяем, нужны ли тарифы, лицензии, сертификаты или дополнительные ресурсы внешних систем. Если они потребуются, заранее покажем варианты и стоимость. По возможности аккаунты и лицензии оформляются сразу на заказчика.
Проверка результата и гарантия
Как принимается готовая работа?
Вместе проверяем согласованные сценарии на контрольных данных или тестовой копии, а затем демонстрируем результат. Для интеграций сверяем передачу данных и обработку ошибок, для сайта — работу нужных страниц и действий пользователя, для отчёта — расчёты и обновление данных.
Какая гарантия действует после сдачи?
На выполненные изменения действует гарантия 3 месяца. Если в изменённой нами части обнаружится ошибка нашей реализации, проверим и исправим её без дополнительной оплаты. Переданные материалы, настройки и код остаются у заказчика.
Связанные шаги
- 01Переход Диадока с COM на HTTP API
Обновить транспорт Диадока до HTTP API
- 02Переход Диадока с ShelfUpload и ShelfDownload на API v2
Перевести полку документов на актуальные методы
- 03Собственный архив документов Диадока или Saby
Сохранять собственный архив документов ЭДО