Боль номер один: заявка с сайта сидит в почте, менеджер переносит в CRM, логистика узнаёт из чата, 1С обновляют вечером «когда освободятся». Ошибка на любом шаге - потерянный заказ, двойная отгрузка, злой клиент. Задача интеграции - сделать один поток событий с повторами и логами, а не «ещё одну табличку».
Сроки 30-45 дней реальны, если есть владелец данных, тестовый контур и не десять «исключений навсегда». Ниже - что обычно входит в работы и где чаще всего всплывают грабли.
Карта систем
Сайт, CRM, 1С, оплата, доставка, почта. Для каждой - что является правдой по номенклатуре, цене, статусу. Если правды две - интеграция будет стрелять себе в ногу до бесконечности.
События вместо файлов
Заказ создан, оплачен, отгружен, отменён - события в очередь, обработчик, ретраи, мёртвая очередь для ручного разбора. Не «скрипт по крону раз в час», если вам важна скорость.
- Идемпотентность - повтор вебхука не создаёт второй заказ.
- Часовые пояса - да, это всегда весело, пока не почините.
- Тестовые заказы - отдельный флаг, чтобы не портить отчёты.
1С без драмы
Обычно страшно не API, а качество номенклатуры и прав доступа. Без выровненных справочников вы автоматизируете хаос быстрее, чем раньше.
Приёмка
10-15 реальных сценариев, включая отмену, частичную оплату, возврат, «клиент передумал». Пока не прошли - не включайте рекламу на всю страну.
Документы и владельцы
Кто подписывает допуски к API, кто отвечает за справочники, кто в праздник может нажать «остановить синк». Если этих людей нет - интеграция встанет не на техническом шаге, а на организационном.
Мониторинг и алерты
Очередь зависла, вебхук отвалился, в 1С уехал ноль вместо суммы - всё это должно светиться красным там, где дежурит живой человек. Иначе вы узнаете о проблеме из звонка клиента, а это самый дорогой канал диагностики.
Обучение людей
Менеджеры должны понимать, что теперь автоматически, а что трогать руками опасно. Одна страница «как жить после интеграции» экономит десятки часов саппорта.
Совместное тестирование с заказчиком
Назначьте бизнес-тестировщиков с полномочиями ломать сценарии. Они найдут «реальные» отмены, которые инженеры не придумали.
Фиксируйте результаты приёмки письменно: какие сценарии ок, какие отложены, кто владелец риска.
Масштабирование на новые склады
Шаблон подключения новой точки: справочники, права, тестовый прогон. Иначе каждое открытие филиала = мини-проект с нуля.
Контракты сообщений и версии API
Зафиксируйте схему события: обязательные поля, типы, максимальный размер, коды ошибок. Версионируйте контракт так, чтобы старый сайт не ломался, пока вы катаете новую CRM.
Дубли и идемпотентность в бою
Повтор вебхука от платёжки — норма. Ключ идемпотентности должен жить в вашем слое, а не «надеяться, что провайдер не повторит». Иначе склад увидит второй заказ.
Границы ответственности 1С и CRM
Кто владелец номенклатуры, кто — цены для витрины, кто — статусы оплаты. Если граница размыта, интеграция превращается в вечный теннис между отделами.
Тестовые данные и «грязные» сценарии
Частичная отгрузка, перенос даты, скидка после оплаты, отмена одной позиции из трёх. Автотесты на JSON-уровне дешевле, чем ночные сверки Excel.
Наблюдаемость и бизнес-алерты
SLA на задержку очереди, отдельная очередь «ручной разбор», дашборд по причинам отказа интеграции. Бизнесу нужен язык денег, не stack trace.
Сопровождение после запуска
Регламент изменений: новое поле в CRM — сколько времени на обновление коннектора, кто подписывает риск. Без реглама интеграция «живёт» первые две недели и умирает тихо.
Собрать вводные и оценить объём - контакты GERS, ответим предметно по шагам и рискам.