Интеграция МойСклад с сайтом: как не превратить её в источник проблем
Связка интернет-магазина со складской системой выглядит простой задачей: передавать заказы туда, забирать остатки обратно. На практике именно эта связка ломается чаще всего, и ломается тихо.
Я веду магазин издательства, где каждый день проходят заказы, а товары синхронизируются с МойСклад. Ниже то, на чём спотыкаются почти все.
Первый вопрос: что считать источником правды
До любой технической работы нужно ответить на вопрос, который кажется очевидным, пока не начнёшь отвечать. Где живёт правда о товаре?
Цена: на сайте или в складской системе? Остаток: складской или отдельный для интернет-продаж? Описание и фотографии: где редактируются? Категории: сайтовые или складские?
Пока это не зафиксировано письменно, любой обмен рано или поздно затрёт чью-то работу. Классическая история: контент-менеджер весь день правил описания на сайте, ночью прошла синхронизация и вернула старые тексты из складской системы, где их никто не обновлял.
Правильный ответ у каждого свой, но он должен быть один. В моём магазине правда о цене и остатке живёт на складе, правда о текстах, фотографиях и категориях — на сайте, и обмен настроен так, чтобы эти области не пересекались.
Дубли: главная болезнь типовых коннекторов
Второе, что происходит почти всегда: обмен начинает плодить дубли. Товары, контрагентов, заказы.
С товарами причина обычно в сопоставлении. Если товары связываются по названию, любая правка названия создаёт новую позицию. Связывать нужно по артикулу, и артикул должен быть обязательным полем с обеих сторон.
С контрагентами сложнее. Один и тот же человек заказывает с разной почтой, с разным написанием имени, с телефоном в разном формате. Типовой коннектор создаёт нового контрагента на каждый заказ, и через год в базе их вдесятеро больше, чем реальных клиентов. Решается нормализацией телефона и почты до сравнения и правилом, по какому полю искать совпадение.
Отдельная ловушка — архив. Если при поиске существующего контрагента не учитывать архивные записи, система не найдёт архивного и создаст нового. Это тот случай, когда отсутствие одного параметра в запросе стоит нескольких тысяч лишних записей.
Чужие метки и поля, которые нельзя трогать
В складской системе обычно работают люди, и они заводят свои признаки: метки для поставщиков, служебные поля, группы товаров. Обмен, написанный без учёта этого, при каждой синхронизации аккуратно стирает всё, чего не знает.
Правило простое: обмен должен обновлять только те поля, за которые отвечает, и не трогать остальные. Это значит частичное обновление вместо полной перезаписи записи.
Лимиты запросов: как обмен встаёт молча
У складских систем есть ограничение на число обращений в секунду и в сутки. Пока товаров триста, об этом можно не думать. Когда их становится несколько тысяч и обмен идёт каждые полчаса, лимит начинает выбираться.
Поведение при превышении хуже всего тем, что оно незаметно: часть запросов возвращает ошибку, обмен считает эти товары обработанными и идёт дальше. Остатки на сайте расходятся с реальными, и никто не знает, с какого момента.
Что нужно предусмотреть: ограничение частоты запросов на своей стороне, повторные попытки с нарастающей паузой, обработку ответа о превышении лимита как повода подождать, а не пропустить, и оповещение, когда за проход накопилось слишком много ошибок.
На своём проекте я в итоге сделал защиту, которая сама притормаживает обмен при приближении к лимиту, — до этого синхронизация вставала примерно раз в месяц.
Заказы: не всё так просто, как кажется
С заказами главный вопрос — момент передачи и что делать с изменениями.
Передавать сразу после оформления или после оплаты? Если сразу, склад заполняется неоплаченными заказами, часть из которых никогда не оплатится. Если после оплаты, то заказы с оплатой при получении не попадут на склад вообще.
Что делать с отменой и возвратом? Что делать, если менеджер изменил состав заказа на складе, а сайт об этом не знает? Что со статусами: кто кому их передаёт?
Эти вопросы не технические, а про ваш процесс. Разработчик не может ответить на них за вас, но обязан задать до начала работы. Ответы определяют половину архитектуры обмена.
Как понять, что обмен сломался
Обязательная часть, о которой обычно забывают. Синхронизация должна сообщать о себе: сколько записей обработано, сколько с ошибками, когда был последний успешный проход.
Минимально достаточный вариант: ежедневное сообщение в Telegram с цифрами и отдельное оповещение, если проход не состоялся или число ошибок выше обычного. Без этого вы узнаете о проблеме от клиента, который заказал то, чего нет на складе.
Готовое решение для связки магазина на WooCommerce с МойСклад я выложил в открытый доступ, оно работает на моём магазине. Если нужна связка под ваш процесс, об этом есть отдельная страница.