Сайт, который работает с МойСклад

Сайт, который работает с МойСклад, это магазин, где остатки на витрине совпадают со складом, заказы сами попадают в учёт с адресом и оплатой, а покупатель видит статус "собран" и "отправлен" без звонка менеджеру. Связать сайт с МойСклад можно готовым модулем, обменом по CommerceML или своей интеграцией через открытый API, и для магазина на своём сайте мы делаем третье: так работает Плавательный.рф, где товары и остатки приходят из МойСклад, а заказы уходят в него. Ниже без кода: что передаётся, как часто, что выбрать, сколько стоит и что ломается.

Что обычно не передают автоматически: описания товаров для сайта (их удобнее вести в админке сайта, в МойСклад они короткие), SEO-поля, подборки и акции. Это контент, и он живёт на стороне сайта.

Три способа связать сайт с МойСклад

Готовый модуль. У МойСклад есть интеграции с популярными платформами: Битрикс, Shop-Script, AdvantShop, Nethouse, ВКонтакте и другие. Ставится за день, стоит недорого или бесплатно. Минус: делает то, что задумал автор модуля. Если у вас несколько складов, свои правила округления остатков или модификации, которые надо схлопывать в одну карточку, модуль либо не умеет, либо умеет не так.

Обмен по CommerceML. Стандартный протокол обмена с 1С, который МойСклад тоже поддерживает бесплатно: товары и остатки на сайт, заказы обратно. Подходит платформам, которые умеют CommerceML. Обмен идёт файлами по расписанию, поэтому остатки отстают на интервал обмена, и тонко управлять тем, что передаётся, нельзя.

Своя интеграция через API. МойСклад отдаёт открытый API (JSON API 1.2): любые сущности, вебхуки об изменениях, фильтры. Мы пишем модуль, который живёт в бэкенде магазина и делает ровно то, что нужно вашему каталогу: например, собирает десять модификаций разных размеров в одну карточку с выбором размера, показывает остаток только с розничного склада, а заказ создаёт с нужным статусом и проектом. Это дороже модуля на старте, но это код в вашем репозитории, который не зависит от того, обновил ли автор модуль под новую версию платформы.

Для магазина на headless (сайт на Next.js со своей админкой) готовых модулей нет по определению, поэтому там всегда третий путь.

Что важно знать про API МойСклад

Без технических деталей, но с цифрами, которые влияют на то, как быстро сайт увидит изменения.

• МойСклад принимает не больше 45 запросов за 3 секунды и не больше 5 одновременных от одного сотрудника, 20 от аккаунта. При превышении МойСклад отвечает отказом, и интеграция должна уметь подождать и повторить. Каталог на 5 000 товаров поэтому синхронизируется не мгновенно, а за минуты, и это нормально.
• Уведомления об изменениях (вебхуки) позволяют не опрашивать МойСклад постоянно: он сам сообщает, что товар, остаток или заказ изменились. Мы используем их плюс регулярную полную сверку, потому что любое уведомление может потеряться.
• Доступ идёт от имени сотрудника МойСклад с ключом. Для интеграции заводят отдельного сотрудника с минимальными правами, чтобы смена пароля у менеджера не остановила магазин.
• Опция онлайн-торговли в МойСклад стоит 700 рублей в месяц, тарифы от 495 (Старт) до 7 840 (Корп) рублей в месяц при годовой оплате. Что именно из API доступно на вашем тарифе, проверяем на первом созвоне.

Что ломается и как об этом узнать

Главная особенность интеграций с учётом: снаружи поломка незаметна. Сайт открывается, корзина работает, а заказы не доходят до учёта, или остатки замерли неделю назад, и вы продаёте то, чего нет.

Типичные причины: ключ доступа перестал действовать или был отозван, сотрудника интеграции удалили или сменили ему пароль, МойСклад изменил структуру ответа, каталог переименовали и сопоставление товаров развалилось, превышены лимиты и запросы отваливаются.

Поэтому интеграция без слежения это половина интеграции. В наших магазинах логи сервера собираются автоматически, ошибки разбираются и уходят уведомлением в чат: "заказ 1234 не создан в МойСклад, причина такая-то". Владелец узнаёт о проблеме через минуты, а не от покупателя через неделю. Это входит в поддержку, подробно на странице поддержка headless-сайта.

Как это работает в живом магазине

Плавательный.рф: товары и остатки приходят из МойСклад, заказы с сайта и из приложений уходят в него с адресом, способом доставки и статусом оплаты через Т-Банк, Яндекс Сплит или Долями. Что заняло больше всего времени, это не сама интеграция, а порядок в каталоге: разные размерные сетки и ростовки у разных брендов, подарочные карты пластиковые и электронные, возвраты по рассрочке. Совет из этого опыта: перед стартом пройтись по каталогу в МойСклад и привести модификации к единому виду, это сокращает проект на недели.

Сколько стоит

Интеграция идёт отдельной строкой в смете магазина, и её цена зависит от трёх вещей: порядок в каталоге (единые модификации или разнобой), число складов и типов цен, нужны ли статусы обратно на сайт и передача оплат. Называем через день после доступа к вашему МойСклад в режиме просмотра. Ежемесячно: тариф МойСклад и поддержка сайта, отдельных платежей за интеграцию нет.

Если магазин у вас ещё не построен, интеграция считается вместе с ним, см. интернет-магазин на headless. Если сайт на Тильде и МойСклад к ней не привязать так, как нужно, начните с переезда с Тильды.

Дайте доступ к вашему МойСклад на просмотр и адрес сайта. За день скажем, что можно связать готовым модулем, что нужно писать, сколько это займёт и сколько будет стоить.