Александр Немировнезависимый разработчик

Интеграция МойСклад с сайтом: как не превратить её в источник проблем

Связка интернет-магазина со складской системой выглядит простой задачей: передавать заказы туда, забирать остатки обратно. На практике именно эта связка ломается чаще всего, и ломается тихо.

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

Первый вопрос: что считать источником правды

До любой технической работы нужно ответить на вопрос, который кажется очевидным, пока не начнёшь отвечать. Где живёт правда о товаре?

Цена: на сайте или в складской системе? Остаток: складской или отдельный для интернет-продаж? Описание и фотографии: где редактируются? Категории: сайтовые или складские?

Пока это не зафиксировано письменно, любой обмен рано или поздно затрёт чью-то работу. Классическая история: контент-менеджер весь день правил описания на сайте, ночью прошла синхронизация и вернула старые тексты из складской системы, где их никто не обновлял.

Правильный ответ у каждого свой, но он должен быть один. В моём магазине правда о цене и остатке живёт на складе, правда о текстах, фотографиях и категориях — на сайте, и обмен настроен так, чтобы эти области не пересекались.

Дубли: главная болезнь типовых коннекторов

Второе, что происходит почти всегда: обмен начинает плодить дубли. Товары, контрагентов, заказы.

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

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

Отдельная ловушка — архив. Если при поиске существующего контрагента не учитывать архивные записи, система не найдёт архивного и создаст нового. Это тот случай, когда отсутствие одного параметра в запросе стоит нескольких тысяч лишних записей.

Чужие метки и поля, которые нельзя трогать

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

Правило простое: обмен должен обновлять только те поля, за которые отвечает, и не трогать остальные. Это значит частичное обновление вместо полной перезаписи записи.

Лимиты запросов: как обмен встаёт молча

У складских систем есть ограничение на число обращений в секунду и в сутки. Пока товаров триста, об этом можно не думать. Когда их становится несколько тысяч и обмен идёт каждые полчаса, лимит начинает выбираться.

Поведение при превышении хуже всего тем, что оно незаметно: часть запросов возвращает ошибку, обмен считает эти товары обработанными и идёт дальше. Остатки на сайте расходятся с реальными, и никто не знает, с какого момента.

Что нужно предусмотреть: ограничение частоты запросов на своей стороне, повторные попытки с нарастающей паузой, обработку ответа о превышении лимита как повода подождать, а не пропустить, и оповещение, когда за проход накопилось слишком много ошибок.

На своём проекте я в итоге сделал защиту, которая сама притормаживает обмен при приближении к лимиту, — до этого синхронизация вставала примерно раз в месяц.

Заказы: не всё так просто, как кажется

С заказами главный вопрос — момент передачи и что делать с изменениями.

Передавать сразу после оформления или после оплаты? Если сразу, склад заполняется неоплаченными заказами, часть из которых никогда не оплатится. Если после оплаты, то заказы с оплатой при получении не попадут на склад вообще.

Что делать с отменой и возвратом? Что делать, если менеджер изменил состав заказа на складе, а сайт об этом не знает? Что со статусами: кто кому их передаёт?

Эти вопросы не технические, а про ваш процесс. Разработчик не может ответить на них за вас, но обязан задать до начала работы. Ответы определяют половину архитектуры обмена.

Как понять, что обмен сломался

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

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

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