Ваш обмен может перестать работать в день, когда вы к нему не прикасались. Поставщик — площадка, банк, оператор ЭДО, разработчик CRM — выпустил новую версию своего API и объявил дату отключения старой. С этого дня запросы вашей интеграции либо отклоняются, либо начинают возвращать данные в другом виде. Ни подрядчик, ни вы ничего не сломали: сломалась договорённость, срок действия которой закончился.
Это не редкость и не злой умысел. Практический пример: 1 сентября 2026 года Контур.Диадок прекратил поддержку модуля для 1С:Предприятие 7.7. Дату объявили заранее, о ней писали в рассылках оператора, и всё равно часть компаний узнала о ней в тот день, когда перестали уходить документы. Разница между теми и другими не в технике, а в том, был ли в компании человек, обязанный читать такие письма.
Дальше — как отличить изменение, которое вас не касается, от изменения, которое остановит обмен; как устроен реестр интеграций на одну страницу; сколько времени обычно дают на переход; и во что обходится один и тот же переход, сделанный заранее и сделанный после отключения.
Зафиксированный набор правил обмена: какие операции доступны, как называются поля, в каком виде передаются даты и числа. Внутри одной версии поставщик обещает не менять эти правила, чтобы чужие интеграции продолжали работать. Новая версия — это новый набор правил, который живёт параллельно со старой, пока старую не отключат.
Почему поставщик меняет API, даже когда обещал не менять
Причины почти всегда внешние по отношению к вам, и потому неотменяемые. Меняется закон: появляется новый обязательный реквизит документа, новая товарная группа маркировки, новое требование к согласиям. Меняется сам продукт: у площадки появляется новый тип отправления, у CRM — новая сущность. Меняется нагрузка: старая схема перестаёт держать поток, и поставщик режет её жёсткими ограничениями.
Отсюда практический вывод, который стоит принять до начала проекта: обмен — это не построенный объект, а поддерживаемый. Он требует внимания не потому, что его плохо сделали, а потому, что рядом с ним живут четыре чужие системы, каждая со своим планом релизов. Именно поэтому в смете на интеграцию есть строка поддержки, и именно поэтому её нельзя сокращать до нуля после успешной приёмки.
Ломающее изменение и безопасное: как отличить
Уведомление поставщика обычно написано для программистов и выглядит одинаково пугающе во всех случаях. На деле изменения делятся на три группы: те, что вас не касаются вовсе; те, что остановят обмен с явной ошибкой; и самые неприятные — те, что ничего не остановят, но начнут возить неверные данные. Отдельной строкой стоит ужесточение ограничений на число запросов: оно не меняет ни одного поля, но останавливает обмен не хуже переименования — механику разбирали в материале про лимиты API и превышение.
| Изменение у поставщика | Ломает ли обмен | Что делать |
|---|---|---|
| Добавлено новое необязательное поле в ответ | Нет, если обмен игнорирует незнакомые поля | Ничего. Один раз убедиться, что обмен не падает на неизвестных полях |
| Добавлен новый статус или тип в справочник | Да, если список статусов жёстко перечислен в коде | Заранее задать поведение по умолчанию для неизвестного значения |
| Поле переименовано или убрано | Да, с явной ошибкой | Перейти на новую версию в окне поддержки старой |
| Необязательное поле стало обязательным | Да, отправка начнёт отклоняться | Найти, где это поле пустое, до даты вступления требования |
| Изменён формат даты, числа или единицы измерения | Нет — и это худший вариант: данные проезжают, но неверные | Ловится только суточной сверкой итогов, а не ошибками |
| Ужесточён лимит запросов | Частично: обмен замедляется и упирается в стену | Пересчитать бюджет запросов и перевести обновления в пакеты |
| Выпущена новая версия, старая пока работает | Нет | Записать дату отключения старой в реестр интеграций |
| Старая версия отключена | Да, полностью и сразу | Это уже авария, стоимость посчитана ниже |
Обмен, который остановился с ошибкой, заметят за час. Обмен, который начал возить цену в копейках вместо рублей или дату в другом порядке, будут разбирать через три недели — по расхождению в отчётах, когда неверные данные уже разошлись по документам и отчётности. Единственная защита от такого — ежедневная сверка итогов между системами, а не проверка «сервис отвечает». Это тот же механизм, который ловит и другие тихие отказы: мы разбирали его в материале про мониторинг интеграций.
Сравнение в три колонки. Первая, светлая, «Не касается вас»: новое необязательное поле, новая версия при живой старой. Вторая, акцентная, «Остановит обмен»: поле переименовано или убрано, необязательное стало обязательным, старая версия отключена. Третья, самая тёмная, «Ничего не остановит, но испортит данные»: изменён формат даты, изменена единица измерения, добавлен неизвестный статус. Под третьей колонкой подпись: «Находят через три недели по сверке итогов, а не по ошибке». Чертёжный стиль, всё по-русски.
Реестр интеграций: одна страница, которая закрывает вопрос
Уведомления поставщиков приходят в разные места: в раздел для разработчиков на сайте площадки, в рассылку оператора ЭДО, в описание релиза конфигурации, иногда просто в личный кабинет. Никто в компании не читает их все — и не должен. Работает другое: список интеграций, у каждой из которых назначен ответственный сотрудник и указано, куда именно он подписан.
| Связка | Версия обмена | Где публикуются изменения | Ответственный | Известная дата отключения |
|---|---|---|---|---|
| Сайт → CRM | v3 | Раздел для разработчиков поставщика CRM | Руководитель отдела продаж | Не объявлена |
| CRM → 1С:УТ | Собственный модуль обмена | Описание релизов конфигурации, письма франчайзи | Главный бухгалтер | Привязана к смене релиза конфигурации |
| 1С → площадки | v2 и v3 работают параллельно | Раздел для разработчиков площадки | Руководитель отдела продаж | По v2 объявлена, записана в реестр |
| 1С → ЭДО | Модуль оператора | Рассылка оператора ЭДО | Главный бухгалтер | Модуль для 1С:Предприятие 7.7 — 1 сентября 2026 |
Реестр ведётся не подрядчиком, а компанией: подрядчик может смениться, а обмен останется. Обновляется он раз в месяц за час работы — этого достаточно, чтобы ни одна дата отключения не стала новостью. Тот же реестр отвечает на неудобный вопрос при смене подрядчика: сколько у нас вообще интеграций и что произойдёт, если одну из них выключить.
Карта связей пяти узлов: в центре «1С:УТ», вокруг — «Сайт», «CRM», «Площадки», «Оператор ЭДО». На каждой линии две подписи: что передаётся и версия со сроком. Сайт → CRM: «заявка, v3, срок не объявлен». CRM → 1С: «клиент и заказ, свой модуль, срок по релизу конфигурации». 1С ↔ Площадки: «остатки и заказы, v2 и v3 параллельно, по v2 дата объявлена». 1С ↔ ЭДО: «документы, модуль оператора, для 1С:Предприятие 7.7 — 1 сентября 2026». Линия к ЭДО отмечена как критическая. Сбоку рамка «ответственный по каждой связи назван поимённо». Чертёжный стиль, всё по-русски.
Сколько времени обычно дают на переход
Единого правила нет, но диапазоны устойчивы. Крупные поставщики с большим числом внешних интеграций обычно объявляют отключение старой версии за 6–12 месяцев и держат обе версии параллельно. Площадки и быстро меняющиеся сервисы дают меньше — от одного до шести месяцев. Изменения, вызванные новым требованием закона, могут прийти с окном в несколько недель, потому что сам поставщик узнал о сроке немногим раньше вас.
- 6–12 месяцев — типичное окно у операторов ЭДО и крупных платформ, где отключение затрагивает тысячи клиентов. Именно так была объявлена дата 1 сентября 2026 года по модулю Диадока для 1С:Предприятие 7.7.
- 1–6 месяцев — маркетплейсы и облачные сервисы. Здесь версии сменяются чаще, и параллельная работа старой и новой обычно короче.
- Несколько недель — изменения по требованию регулятора: новый обязательный реквизит, новая товарная группа маркировки, новое поле в документе. Спорить не с кем, окно не двигается.
- Без предупреждения — изменения, которые поставщик считает исправлением ошибки, а вы — сменой поведения. Формально версия та же, фактически обмен работает иначе. Ловится только сверкой итогов.
Отдельная история — обновления самой 1С. Там версия обмена привязана не к дате, а к релизу конфигурации, и переход происходит тогда, когда вы решите обновляться. Это удобнее, но создаёт другую ловушку: чем дольше откладывать обновление, тем дороже оно однажды обойдётся вместе со всеми доработками. Мы разбирали это в материале про обновление 1С после доработок.
Что делать, если срок уже вышел
Ситуация неприятная, но конечная. Порядок действий один и тот же независимо от того, чей API отключили.
- 1Включить ручной обход в тот же час. Пока обмен не восстановлен, операции выполняются людьми по регламенту, а номера обработанных вручную документов записываются для последующей сверки.
- 2Убедиться, что данные не теряются. Всё, что не уехало, должно лежать в очереди или карантине, а не исчезать. Если этого механизма нет, за время простоя накопится ровно ничего, и восстанавливать придётся из первичных документов.
- 3Оценить объём перехода честно. Переход на новую версию — это не «поменять адрес». Обычно меняются названия части полей, поведение при ошибках и правила выборки, поэтому требуется повторная приёмка. В модельном расчёте это 16 часов работы.
- 4Пройти регресс, а не только новый сценарий. После перехода проверяются не изменённые места, а весь маршрут целиком: как это устроено, разобрано в материале про тестовый набор и регресс при обновлении.
- 5Записать дату в реестр и назначить ответственного. Если этого не сделать, ровно та же история повторится со следующей версией через год-полтора.
Цифра простоя взята из разбора мониторинга интеграций: полтора рабочих дня молчания обмена на потоке около 1 100 заказов в месяц обходятся в 28 620 ₽ вместе с ручным восстановлением и разбором. Если у вас поток больше, эта часть растёт линейно, а стоимость планового перехода не меняется вовсе — она зависит от сложности обмена, а не от объёма.
Два столбца в рублях. Левый «Заранее — 51 300 ₽» из двух сегментов: «переход 48 000 ₽», «регресс 3 300 ₽». Правый «После отключения — 103 920 ₽» из трёх сегментов: «срочный переход 72 000 ₽», «регресс 3 300 ₽», «простой обмена 1,5 дня 28 620 ₽». Между столбцами выноска «разница 52 620 ₽». Под диаграммой строка «сама работа в обоих случаях одинакова». Ось подписана в рублях.
Сколько это стоит в год и что писать в договор поддержки
Модельная компания: четыре интеграции из реестра выше, обмен работает штатно, аварий нет. Считаем только то, что вызвано чужими обновлениями, — без развития функциональности и без исправления собственных ошибок.
| Статья | Как считается | ₽ в год |
|---|---|---|
| Чтение уведомлений и ведение реестра | 1 час в месяц × 12 × 1 100 ₽/час | 13 200 ₽ |
| Безопасные обновления: проверить и убедиться | 3 случая × 2 часа × 3 000 ₽/час | 18 000 ₽ |
| Одно ломающее изменение в год | 16 часов × 3 000 ₽/час | 48 000 ₽ |
| Регресс после каждого изменения | 4 раза × 3 часа × 1 100 ₽/час | 13 200 ₽ |
| Итого | сумма строк выше | 92 400 ₽ в год, около 7 700 ₽ в месяц |
Эти 7 700 ₽ в месяц — часть той суммы, которую подрядчик называет поддержкой, и по опыту именно эту часть заказчик считает необязательной. Поэтому в договоре её стоит назвать прямо, а не прятать в «консультации»: сколько часов в год включено на адаптацию к изменениям сторонних систем, что происходит при превышении лимита часов и кто отвечает за отслеживание уведомлений — вы или подрядчик. Полный разбор состава поддержки — в материале про то, что входит в поддержку системы.
«В стоимость ежемесячной поддержки включено 12 часов в год на адаптацию интеграций к изменениям API сторонних систем. Подрядчик отслеживает публикации об изменениях по перечню интеграций из приложения №1 и уведомляет заказчика не позднее 5 рабочих дней с момента публикации. Работы сверх включённого лимита выполняются по ставке, согласованной в договоре, с предварительной оценкой в часах».
Когда об этом можно не думать
Есть три случая, где отдельная работа с версиями действительно не нужна. Правда, в двух из трёх проблема не исчезает, а меняет владельца — и об этом честнее сказать сразу.
- Обе системы ваши, обновляете вы сами. Обмен между вашей CRM и вашим учётом на вашем сервере не отключат внезапно. Но версия здесь всё равно есть, просто владелец её — вы: обновление одной из систем ломает обмен ровно так же, поэтому регресс никуда не девается.
- Обмен идёт через готовый сервис-посредник. Он держит совместимость за вас, и это нормальный выбор для небольшого объёма. Оговорка одна: проверьте, что поддержка версий действительно входит в тариф, и помните, что сам посредник тоже может закрыться или сменить условия.
- Обмен файлами по расписанию. Выгрузка в файл и загрузка на другой стороне живёт дольше, чем любой API. Но и здесь формат меняется — вместе с релизами и требованиями закона, — просто медленнее и без объявлений.
И общий вывод, который стоит обсудить с подрядчиком до подписания: расходы на чужие обновления не зависят от того, хорошо или плохо написан ваш обмен. Хорошо написанный переживает изменения дешевле — если незнакомые поля игнорируются, у неизвестного статуса есть поведение по умолчанию, а сверка итогов ловит тихие отклонения. Но полностью убрать эту строку из бюджета нельзя, и смета, в которой её нет, просто отложила разговор на год.
