Интеграция должна избавлять команду от повторного ввода и поддерживать согласованные данные. Если заказ попал в CRM, но склад получил другой вариант товара или старый остаток вернулся на сайт, сам факт подключения ещё не означает работающую синхронизацию.
Начните с карты данных: кто создаёт каждую запись, кто может её менять и куда передаётся результат. Затем определите поведение при повторах, задержках и сбоях.
Не обязательно делать одну систему главной для всего. Например, склад может определять доступное количество, магазин — тексты и фотографии, а CRM — ответственного менеджера и историю общения.
Главное — исключить ситуацию, когда две системы независимо исправляют одно поле и перезаписывают друг друга. Для цен, остатков и статусов назначьте источник и направление обмена.
Условный пример: описания редактируют на сайте, а цену получают из учётной системы. Обновление цены не должно одновременно стирать отредактированный текст. Это нужно зафиксировать в правилах обмена.
Согласуйте устойчивые коды товара и вариантов. Название не подходит как единственный ключ: оно может измениться или совпадать у разных позиций.
Для обмена товарными данными определите:
Не отправляйте все поля во все системы без необходимости. Например, склад может не использовать SEO-описание, а CRM — все технические параметры товара.
Подготовка исходных кодов и характеристик разобрана в статье о загрузке товарного каталога.
Передавайте стабильный ID заказа, время создания, позиции с кодами вариантов, количество, цены на момент покупки, скидки, доставку, итоговую сумму и валюту.
Сохраняйте согласованную стоимость заказа. Последующее изменение цены в каталоге не должно незаметно менять уже оформленную покупку.
Разделяйте состояние заказа, оплаты и отправки. «Создан», «Оплачен» и «Передан перевозчику» обозначают разные события. Определите, какая система подтверждает каждое из них и какие переходы допустимы.
Данные клиента передавайте в объёме, необходимом для обработки: контакт, адрес, реквизиты при необходимости и связь с существующим клиентом. Отдельно согласуйте правила поиска совпадений. Один общий телефон компании не всегда означает одного покупателя.
Если передаются сведения о согласиях на коммуникацию, не подменяйте их самим фактом покупки. Храните предусмотренные вашим процессом источник и состояние такого согласия отдельно от заказа.
Различайте физическое количество на складе и доступное к продаже количество после резервов. Магазину может быть нужно второе, а не общий запас.
Зафиксируйте момент резервирования, снятия резерва, списания и возврата товара. Отмена неоплаченного заказа и возврат уже отправленного товара не должны обрабатываться как одно событие.
Если продажи идут через несколько каналов, проверьте конкуренцию за последний товар. Обновление по расписанию само по себе не гарантирует защиту от одновременного заказа. Нужен согласованный механизм подтверждения доступности или ограничения продажи.
Укажите допустимую задержку обмена и поведение при устаревших данных. Эти параметры зависят от ассортимента и скорости продаж, поэтому универсальной частоты обновления нет.
Одно уведомление может прийти повторно. Его повторная обработка не должна создавать второй заказ, ещё раз списывать остаток или повторно запускать возврат.
Например, Stripe предупреждает о повторных webhook-событиях и не гарантирует порядок их доставки. Документация рекомендует учитывать обработанные события и не строить процесс на обязательной последовательности получения. Для остальных подключений нужно проверить их собственные правила. Источник: Stripe.
Согласуйте с разработчиком журнал ошибок, повторные попытки и способ безопасно восстановить обмен. При недоступности CRM заказ должен сохраниться в предусмотренном источнике, а команда — увидеть проблему и возможность передать его позже.
Проводите сверку: все ли созданные заказы дошли, совпадают ли суммы и нет ли необъяснимых расхождений остатков. Получение технического ответа от сервера ещё не подтверждает правильную обработку данных внутри системы.
До запуска проверьте согласованные сценарии:
Для каждой проверки фиксируйте исходные условия, ожидаемый результат и запись в каждой участвующей системе. Назначьте человека, который будет контролировать обмен после запуска.
При разработке интернет-магазина карта данных помогает оценить интеграцию отдельно от дизайна и наполнения. Доработки существующего сайта можно обсудить в рамках поддержки сайтов и дизайна; состав работ зависит от платформы, доступных API и ограничений подключаемых систем.
Работающая синхронизация — это согласованные источники, корректные данные и понятный порядок восстановления, когда обмен нарушается.