Зачем вообще связывать сайт и МойСклад
Пока заказов мало, товары, цены и остатки можно переносить руками. Но как только появляются сайт, маркетплейсы, менеджеры, склад и регулярные поставки, ручной режим начинает ломаться. Один сотрудник обновил цену в CMS, другой поменял остаток в учете, третий принял заказ по телефону, а на сайте все еще висит товар, которого нет.
Интеграция сайта с МойСклад нужна, чтобы сайт и учетная система работали как единый процесс. Сайт показывает покупателю актуальные товары, цены и наличие. МойСклад хранит учет, документы, заказы, склады и движение товара. Между ними должен быть понятный обмен, а не набор случайных выгрузок.
Что обычно синхронизируют
Состав интеграции зависит от бизнеса, но чаще всего связывают:
- товары и модификации;
- категории или группы товаров;
- цены и типы цен;
- остатки по складам;
- изображения и характеристики;
- заказы покупателей;
- статусы заказов;
- данные клиентов;
- доставки и оплаты;
- возвраты и отмены.
Не всегда нужно синхронизировать все. Иногда сайту достаточно получать остатки и цены, а заказы отправлять в МойСклад. В другом проекте важно вести весь каталог в МойСклад и автоматически обновлять карточки на сайте.
Где должна быть главная база товаров
Перед интеграцией нужно решить, где находится "истина" по данным. Если товары ведутся в МойСклад, сайт должен получать из него названия, артикулы, цены и остатки. Если сайт содержит богатые SEO-описания, фото, посадочные страницы и фильтры, часть данных лучше оставить в CMS, а из МойСклад брать только учетные поля.
Плохой вариант - когда одни и те же данные редактируются в двух местах без правил. Тогда интеграция не упрощает работу, а создает новые конфликты.
Остатки: остаток, резерв и доступное количество
Остатки нельзя воспринимать как простое число "лежит на складе". В учетной системе могут быть фактический остаток, резерв под заказы и ожидаемые поступления. Для сайта обычно важнее доступное количество: то, что можно обещать покупателю прямо сейчас.
Если показывать фактический остаток без учета резерва, сайт может продавать товар, который уже обещан другому клиенту. Если обновлять остатки слишком редко, покупатель будет видеть устаревшую информацию. Поэтому в интеграции нужно настроить не только поле, но и логику: какие склады учитывать, как работать с резервом, что делать при нулевом остатке.
Цены и акции
Цены тоже бывают разными: розничная, оптовая, дилерская, акционная, цена для конкретного сегмента клиентов. До интеграции нужно понять:
- какую цену показывать на сайте;
- есть ли разные типы клиентов;
- где создаются скидки;
- как обновляются акционные цены;
- что делать, если цена в МойСклад не заполнена;
- нужна ли округленная цена на сайте.
Если на сайте есть корзина, ошибка в цене сразу превращается в спор с покупателем. Если сайт работает по заявкам, цена может не выводиться, но менеджер все равно должен видеть в заказе правильную учетную информацию.
Заказы: что должно уходить в МойСклад
Обычно сайт передает в МойСклад:
- имя и контакты клиента;
- состав заказа;
- количество товаров;
- цену;
- способ доставки;
- способ оплаты;
- комментарий;
- источник заказа;
- статус.
Важно не просто создать заказ, а сделать его удобным для обработки. Менеджер должен понимать, откуда пришла заявка, какие товары заказаны, есть ли резерв, какой статус у оплаты и что нужно сделать дальше.
Частые ошибки интеграции
На практике проблемы повторяются:
- товары сопоставлены по названию, а не по стабильному артикулу или ID;
- остатки обновляются редко;
- не учитываются резервы;
- заказы дублируются при повторной отправке формы;
- статусы сайта и МойСклад не совпадают;
- удаленные товары остаются в каталоге;
- характеристики выгружаются в неправильные поля;
- нет журнала ошибок обмена;
- никто не понимает, где исправлять данные.
Хорошая интеграция должна быть наблюдаемой. Если обмен не прошел, это должно быть видно: какая запись не обновилась, почему и кто должен исправить ошибку.
Как подойти к настройке
Перед разработкой полезно составить карту обменов:
- какие сущности передаем;
- откуда и куда;
- как часто;
- по какому идентификатору сопоставляем;
- что делаем при ошибке;
- какие поля обязательны;
- кто отвечает за данные.
После этого можно выбирать способ: готовый модуль, API, обмен через файлы или индивидуальную интеграцию. МойСклад предоставляет JSON API, поэтому многие процессы можно автоматизировать без ручного переноса данных.
Вывод
Интеграция сайта с МойСклад - это не просто "подключить модуль". Это настройка правил между продажами, складом, каталогом и менеджерами. Чем точнее описаны товары, остатки, цены, заказы и статусы, тем меньше ручной работы и ошибок в ежедневных продажах.