Обновление интеграции Диадок перед отключением устаревших методов API
Диадок публикует график удаления устаревших методов и помечает такие ответы заголовками Sunset и Link. В ближайшем графике есть три важные даты: после 10 ноября 2026 года удаляется группа старых методов, включая прежние версии операций с контрагентами; после 30 ноября 2026 года завершается работа следующей группы, куда входит GetTemplate; после 3 апреля 2027 года отключаются старые версии методов сообщений, событий и документооборота.
Сам факт использования HTTP API ещё требует проверки актуальности интеграции. Код может обращаться к GetMessage V4 или V5, читать ленту через GetNewEvents V7, получать шаблон отдельным GetTemplate либо использовать прежнюю структуру ответа из SDK. Актуальные версии отличаются параметрами, моделями данных и способом продолжения выборки, поэтому простая замена номера в URL редко даёт проверенный результат.
Мы сначала фиксируем реальные вызовы из кода и журналов, распределяем их по официальным срокам и связываем с бизнес-действиями: поиск контрагента, получение входящего документа, чтение событий, работа с шаблоном, статус и служебное действие. Затем переносим только используемые маршруты на рекомендуемые версии из документации.
Контрольная выборка подтверждает сохранность MessageId, EntityId, внутренних номеров и связей с ERP или CRM. Параллельное сравнение показывает разницу старого и нового ответа до рабочего переключения. В результате компания получает обновлённую интеграцию, реестр оставшихся вызовов и понятный способ замечать будущие Sunset-заголовки заранее.
Когда стоит обратиться
Обычно к нам обращаются в таких ситуациях:
- Интеграция Диадока использует давно закреплённую версию SDK или прямые URL методов, выбранные несколько лет назад.
- В HTTP-ответах появились заголовки Sunset и Link, а владельцам системы требуется определить затронутый бизнес-процесс.
- Обмен получает документы и события стабильно, однако в коде встречаются GetMessage V4/V5, GetNewEvents V7 или GetTemplate.
- Компании нужен плановый переход до 10 или 30 ноября 2026 года либо до 3 апреля 2027 года с проверкой связей и статусов.
Что именно мы сделаем
Собираем HTTP-журналы, версии SDK и карту рабочих операций, которые обращаются к Диадоку.
Находим устаревшие методы, заголовки Sunset и Link и распределяем вызовы по официальным датам отключения.
Подбираем актуальные версии по документации и обновляем параметры, структуры данных, курсоры и обработку ошибок.
Сравниваем старый и новый маршрут на контрольных документах, событиях, контрагентах и шаблонах.
Переключаем рабочий обмен, наблюдаем журнал и передаём реестр методов, тесты и план следующих обновлений.
Что входит в стоимость
69 900 ₽ за всю работу
Инвентаризируем прямые HTTP-вызовы и используемые методы SDK, проверяем заголовки Sunset и Link и сопоставляем найденные вызовы с официальным графиком. Для рабочих сценариев подбираем актуальные версии, переносим параметры и структуры ответа, обновляем курсоры событий и тесты. Переключение проводим после сравнения результата старого и нового маршрута на контрольных документах.
Что будет готово
Передадим вам
- Обновлённая интеграция Диадока с актуальными версиями найденных методов API и проверенными структурами данных.
- Реестр вызовов с бизнес-сценарием, текущей версией, официальной датой отключения и выбранной заменой.
- Протокол сравнения документов, событий, контрагентов и шаблонов со сохранёнными идентификаторами и статусами.
- Журнал запросов, контроль Sunset-заголовков, инструкция переключения и план следующих обновлений.
Перед сдачей проверим
- Каждый выбранный устаревший вызов заменён актуальной версией и проходит контрольный запрос в доступном контуре Диадока.
- Документы и события сохраняют MessageId, EntityId, внутренние связи, порядок обработки и ожидаемые статусы.
- Контрольные операции с контрагентом и шаблоном дают ожидаемый бизнес-результат через обновлённый маршрут.
- Реестр содержит найденные методы, даты 10.11.2026, 30.11.2026 и 03.04.2027, результат перехода и ответственного за дальнейшее наблюдение.
Как это выглядит на практике
Лента входящих документов продолжает работать после смены версии API
- 01
Инвентаризация показывает, что фоновое задание читает события через GetNewEvents V7 и затем вызывает GetMessage V5.
- 02
Разработчик переносит маршрут на актуальные версии, сохраняет новый ключ продолжения и прежние внутренние идентификаторы.
- 03
Контрольный документ появляется в ERP один раз, получает правильный статус и связывается с существующим контрагентом.
- 04
После переключения журнал подтверждает новый маршрут, а мониторинг Sunset продолжает следить за будущими изменениями.
Что понадобится для работы
От вас
- Исходный код или конфигурация интеграции, сведения о версии SDK и список фоновых заданий обмена с Диадоком.
- HTTP-журналы с названиями методов, кодами ответа и заголовками либо возможность включить безопасное техническое логирование.
- Доступ к тестовому ящику или участие администратора, который проведёт контрольные операции в доступном контуре.
- Примеры входящих и исходящих документов, событий, контрагентов и шаблонов из фактического рабочего процесса.
Если у вас немного другая ситуация
Небольшие уточнения, которые помогают довести согласованный результат до рабочего состояния, уже учитываем в цене. Если по ходу работы появится отдельный крупный блок или понадобится платная лицензия, сначала обсудим варианты и стоимость. Расскажите о своей ситуации — подстроим план под неё.
- 3 000 ₽после подписания договора через Диадок
- 66 900 ₽после выполнения, демонстрации и приёмки результата
Предоплата входит в общую стоимость. Оставшуюся сумму оплачиваете после демонстрации и приёмки готовой работы.
Часто спрашивают
Об этой услуге
Какие ближайшие даты отключения указал Диадок?
В опубликованном графике ближайшие группы удаляются после 10 ноября 2026 года, после 30 ноября 2026 года и после 3 апреля 2027 года. Конкретный приоритет определяется методами, которые найдены в вашей интеграции.
Как понять, что интеграция вызывает устаревший метод?
Проверяем код, URL запросов, версию SDK и HTTP-журналы. Устаревшие ответы могут содержать заголовки Sunset и Link с датой и ссылкой на информацию о переходе.
Какие методы затрагивает дата 10 ноября 2026 года?
В эту группу входят прежние версии операций с контрагентами, включая AcquireCounteragent, GetCounteragent и GetCounteragents. Полный перечень сверяем с официальной историей изменений и фактическими вызовами клиента.
Что важно проверить перед 30 ноября 2026 года?
Среди методов этой группы находится GetTemplate, а также прежние методы генерации ряда документов и служебных действий. В работу включаем только те вызовы, которые реально участвуют в вашем процессе.
Что меняется к 3 апреля 2027 года?
Диадок планирует удалить старые версии методов сообщений, событий и документооборота, включая GetMessage V4/V5 и GetNewEvents V7. Для них проверяем актуальные версии, структуры ответа и продолжение ленты.
Эта работа дублирует переход Диадока с COM на HTTP API?
Задачи различаются. Переход с COM меняет технологию интеграции целиком, а здесь обновляется уже существующая HTTP- или SDK-интеграция, в которой сохранились устаревшие версии отдельных методов.
Сохранятся связи документов с ERP или CRM?
Да. При переносе контролируем MessageId, EntityId, идентификаторы ящиков, номера и внутренние ключи. Параллельное сравнение подтверждает связи до рабочего переключения.
Как принимается обновлённая интеграция?
Запускаем выбранные сценарии для документов, событий, контрагентов и шаблонов, сравниваем идентификаторы и статусы и проверяем журнал. Итоговый протокол показывает старый вызов, актуальную замену и результат теста.
Цена и изменения по ходу работы
Цена на странице окончательная?
Да. Перед началом мы сверяем исходные данные и фиксируем результат в договоре. Указанная на странице сумма покрывает согласованную работу целиком, даже если её техническая реализация потребует больше времени, чем ожидалось при оценке.
Что означает резерв незапланированных работ?
Это уже включённый в цену запас времени на небольшие связанные уточнения заказчика, которые появляются после старта: например, добавить поле, изменить формат уведомления или учесть ещё одно условие обработки.
Резерв рассчитывается по формуле: стоимость услуги × 30% ÷ 1 500 ₽. Для услуги за 30 000 ₽ это 6 часов. Эти часы относятся только к дополнительным, заранее незапланированным уточнениям. Они не являются сроком проекта и не ограничивают время на основную работу: согласованный результат мы выполняем полностью.
Можно уточнять детали уже во время работы?
Да. Небольшие связанные изменения обычно помещаются во включённый резерв и не требуют доплаты. Если новая идея заметно меняет результат или превращается в самостоятельную задачу, сначала обсудим подход и стоимость. Любое решение согласуем до выполнения.
Начало работы и оплата
Как оформляются договор и оплата?
Подписываем договор через Диадок. Предоплата составляет 3 000 ₽ и входит в общую стоимость услуги. Остаток оплачивается после демонстрации и приёмки готового результата.
Когда начинается срок выполнения?
Срок отсчитывается после согласования задачи, получения необходимых доступов и материалов, подписания договора и поступления предоплаты. Конкретную дату старта и плановый день готовности подтверждаем перед началом.
Как учитываются платные лицензии и внешние сервисы?
До старта проверяем, нужны ли тарифы, лицензии, сертификаты или дополнительные ресурсы внешних систем. Если они потребуются, заранее покажем варианты и стоимость. По возможности аккаунты и лицензии оформляются сразу на заказчика.
Проверка результата и гарантия
Как принимается готовая работа?
Вместе проверяем согласованные сценарии на контрольных данных или тестовой копии, а затем демонстрируем результат. Для интеграций сверяем передачу данных и обработку ошибок, для сайта — работу нужных страниц и действий пользователя, для отчёта — расчёты и обновление данных.
Какая гарантия действует после сдачи?
На выполненные изменения действует гарантия 3 месяца. Если в изменённой нами части обнаружится ошибка нашей реализации, проверим и исправим её без дополнительной оплаты. Переданные материалы, настройки и код остаются у заказчика.
Связанные шаги
- 01Переход Диадока с COM на HTTP API
Перевести интеграцию Диадока с COM на HTTP API
- 02Обновление интеграции Диадок перед отключением устаревших методов API
Обновить устаревшие методы Диадок до даты отключения
- 03Собственный архив документов Диадока или Saby
Собрать независимый архив документов и статусов ЭДО