МойСклад: интеграция с сайтом, CRM и маркетплейсами

 

 

 

 

Единая система управления товарами, ценами, остатками и заказами

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

Проблема заключается не в количестве программ. Проблема в том, что каждая из них участвует в одном общем бизнес-процессе, но располагает только частью информации.

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

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

Типичные ситуации

На сайте отображается товар, который уже зарезервирован менеджером.

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

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

Заказ уже создан в учётной системе, но из-за сетевого сбоя внешний сервис повторно отправляет запрос, и появляется второй документ.

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

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

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

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

 

1. Почему МойСклад не должен просто копировать данные во все системы

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

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

Такой подход выглядит логично, пока не начинаются реальные рабочие процессы.

Пример из практики

Например, контент-менеджер оптимизирует карточку товара на сайте. Добавляет подробное описание, меняет SEO-заголовок, загружает фотографии и оформляет характеристики в удобном для покупателя виде.

Затем запускается синхронизация с МойСклад, которая обновляет карточку целиком. Вместе с техническими данными она передаёт старое описание и заменяет подготовленный контент.

В результате сотрудники вынуждены повторно выполнять одну и ту же работу.

Проблема возникла не из-за ошибки программиста в конкретном запросе. Неправильно была спроектирована ответственность за данные.

Разделение систем по назначению

В большинстве проектов разумно использовать следующее распределение:

МойСклад
Номенклатура, складской учёт, резервы, учётные документы
Интернет-магазин
Каталог для покупателей, оформление заказов, SEO-контент
CRM
Клиенты, сделки, коммуникации, индивидуальные коммерческие условия
Маркетплейсы
Карточки и заказы в рамках правил конкретной площадки
Интеграционный слой
Обмен, сопоставление, контроль изменений и восстановление после сбоев

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

Здесь важно различать три понятия:

01

Где данные хранятся

Одно и то же значение может находиться в нескольких системах.

02

Кто имеет право их изменять

Это определяет владельца данных.

03

Кто отвечает за достоверность

Именно эта система является источником истины для конкретного атрибута.

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

А SEO-описание может храниться на сайте и одновременно передаваться на маркетплейсы, но управляться контент-менеджером в системе каталога.

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

 

2. Товарный каталог: с чего начинается правильная интеграция

До настройки остатков и заказов необходимо привести к единой модели товарный каталог.

Это принципиальный момент. Если система не может однозначно определить, какой именно товар поступил из внешнего канала, она не сможет правильно создать заказ и списать нужное количество.

Рассмотрим условный пример.

Условный пример

Компания продаёт беспроводные датчики температуры.

Один товарUUID в МойСкладМойСкладДатчиктемпературы T-100СайтУмный Wi-Fiдатчик температурыМаркетплейс AДатчик T100для домаМаркетплейс BТермодатчикбеспроводной T-100Для покупателя — один товар. Для интеграции — четыре представления.Сопоставление по названию рано или поздно даст ошибку.

Для покупателя это один товар. Для интеграции — четыре представления одной товарной позиции.

Если сопоставлять их по названию, рано или поздно появится ошибка.

2.1. Единый идентификатор вместо поиска по названию

Для каждого товара необходимо определить устойчивый внутренний идентификатор.

Например, можно использовать UUID объекта в МойСклад в качестве основного ключа товарной сущности.

При этом в отдельном реестре сохраняются соответствия:

МойСклад
UUID товара
Сайт
Product ID 5821
CRM
ID элемента каталога 740
Маркетплейс A
Offer ID T100-BLACK
Маркетплейс B
SKU 009481

Артикул, штрихкод, UUID и внешний SKU — не одно и то же.

Артикул предназначен прежде всего для идентификации товара в бизнес-процессах. Штрихкод используется для маркировки и операций с продукцией. UUID идентифицирует объект в конкретной системе. Внешний SKU позволяет сопоставить позицию с карточкой маркетплейса.

Эти значения нельзя бездумно подменять друг другом.

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

2.2. Модификации: почему одна карточка может означать несколько товаров

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

Для покупателя это одна модель. Для склада — 32 варианта исполнения.

У каждого размера и цвета собственное количество, артикул и иногда штрихкод.

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

Поэтому необходимо заранее определить структуру номенклатуры:

Основной товар.
Модификация.
Комплект.
Отдельная товарная позиция.
Единица измерения.
Артикул варианта.
Штрихкод.
Дополнительные характеристики.

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

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

2.3. Что делать с комплектами

Допустим, компания продаёт набор из двух товаров:

Основной датчик.
Дополнительный модуль.

В каталоге покупатель видит один комплект, но на складе его составляют две самостоятельные позиции.

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

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

Например, если для одного комплекта требуется один датчик и два дополнительных модуля, то при наличии 12 датчиков и 7 модулей максимальное количество комплектов ограничено тремя.

Датчики12Модули7→Доступно комплектов31 комплект = 1 датчик + 2 модуля12 датчиков хватило бы на 12 комплектов,но 7 модулей ограничивают выпуск тремя.

Это простой пример, но именно такие детали отличают полноценную интеграцию от обычной выгрузки товарного списка.

2.4. Не все товары нужно публиковать во всех каналах

В МойСклад могут находиться:

Внутренние позиции.
Расходные материалы.
Комплектующие.
Товары под заказ.
Продукция, доступная только оптовым клиентам.
Временно заблокированные позиции.

Автоматически выгружать всё это на сайт и маркетплейсы нельзя.

Для каждого канала следует определить признаки публикации и правила доступности.

Например, товар может продаваться через интернет-магазин, но не подходить для определённой площадки из-за требований к категории или характеристикам.

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

 

3. Характеристики, изображения и описания: как избежать потери контента

Товарная карточка — это не только артикул и цена.

Для интернет-магазина важны подробные описания, фотографии, инструкции, сертификаты, таблицы характеристик и SEO-данные.

Для маркетплейса могут потребоваться другие поля и обязательные атрибуты.

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

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

01

Первая — внешняя система может потерять собственный контент.

02

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

Правильный подход — сопоставление атрибутов

Для каждого поля определяется соответствие.

Например:

Наименование
Название товара
Название карточки
Артикул
SKU
Offer ID или артикул продавца
Цвет
Цвет
Цвет
Материал
Материал изделия
Материал
Вес
Вес товара
Вес
Комплектация
Состав комплекта
Комплектация

Но соответствие не всегда бывает один к одному.

Например, в одной системе цвет может храниться как «чёрный», а в другой требуется значение из фиксированного справочника.

В таком случае нужен слой преобразования значений.

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

Почему полезно разделять учётный каталог и товарный контент

Для компании с большим ассортиментом целесообразно использовать отдельную модель управления контентом.

МойСклад отвечает за учётные свойства товара, сайт или PIM-система — за маркетинговую информацию, а интеграционный слой формирует представление, подходящее для каждого канала.

Так можно обновить цену и остаток, не затрагивая описание.

Можно заменить фотографию, не изменяя учётную номенклатуру.

Можно адаптировать характеристики под маркетплейс, не разрушая исходные данные.

Это не просто удобство. Это защита от потери информации при массовых обновлениях.

 

4. Цены: как управлять стоимостью товара в разных каналах

Цена — одна из самых чувствительных частей интеграции.

Компания может продавать один и тот же товар по разной стоимости в зависимости от канала, клиента, объёма покупки и коммерческих условий.

Например:

Базовая розничная
12 900 ₽
Интернет-магазин
12 900 ₽
Оптовый клиент
11 700 ₽
Маркетплейс A
13 490 ₽
Маркетплейс B
13 790 ₽

Это условный пример. Разница между ценами может учитывать комиссии, логистику, скидки и другие расходы.

4.1. Базовая цена и цена канала — разные сущности

Распространённая ошибка — хранить одну цену и автоматически передавать её во все системы.

На практике лучше разделять:

Базовую учётную цену.
Розничную цену.
Оптовую цену.
Индивидуальную цену клиента.
Цену конкретного канала.
Акционную цену.
Минимально допустимую цену.

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

Например, менеджер в CRM согласовал постоянному клиенту скидку 10%.

Эта скидка относится к конкретному клиенту и его заказу. Она не должна изменять базовую цену товара в МойСклад или цену на маркетплейсе.

4.2. Как рассчитывать цену маркетплейса

Допустим, товар продаётся на маркетплейсе.

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

В расчёте могут участвовать:

Себестоимость.
Комиссия площадки.
Логистика.
Хранение.
Расходы на продвижение.
Скидки за счёт продавца.
Прочие переменные расходы.
Налоги и особенности учёта.
Плановая маржинальность.

Упрощённо можно представить модель так:

Цена продажи = (себестоимость + переменные расходы + целевая прибыль)/ (1 − процентные удержания)Условная формула

Формула условная. В реальной модели необходимо отдельно учитывать налоги, комиссии, логистику, правила округления, скидки и то, как именно площадка рассчитывает удержания.

Главная мысль: цена маркетплейса должна рассчитываться на основании экономики канала, а не просто копироваться из МойСклад.

4.3. Сложная ситуация: базовая цена изменилась во время акции

Представим:

У компании запущена рекламная кампания на маркетплейсе. Для товара установлена цена 13 490 рублей.

В это время менеджер меняет базовую цену в МойСклад с 12 900 до 13 200 рублей.

Интеграция получает обновление и передаёт его в маркетплейс.

Если система работает без правил владения ценами, она может перезаписать действующее акционное предложение.

Правильное решение:

1
Изменение базовой цены фиксируется в МойСклад.
2
Интеграция определяет, какие канальные цены зависят от базовой.
3
Проверяет наличие активной акции и специальных условий.
4
Пересчитывает только те значения, для которых разрешено автоматическое обновление.
5
Если изменение нарушает минимальную маржинальность или условия акции, операция блокируется либо отправляется на согласование.
6
Результат и причина решения сохраняются в журнале.

Здесь важно понимать: интеграция не должна принимать коммерческие решения за компанию. Она должна исполнять заранее утверждённые правила и останавливать опасные изменения.

4.4. Контроль маржинальности

Цена может быть технически корректной, но экономически убыточной.

Например, после изменения комиссии маркетплейса товар продолжает продаваться по старой стоимости.

Заказ успешно проходит через все системы, остатки обновляются, документы оформляются. Технически интеграция работает без ошибок.

Но компания теряет деньги на каждой продаже.

Поэтому зрелая система должна контролировать не только правильность передачи цены, но и коммерческие ограничения.

Для этого можно установить:

Минимальную цену продажи.
Минимальную маржинальность.
Допустимый уровень скидки.
Правила изменения цены.
Срок действия специальных условий.
Уведомление при выходе за допустимые значения.

Это пример того, как интеграция перестаёт быть исключительно техническим инструментом и начинает защищать экономику бизнеса.

 

5. Остатки: как избежать двойных продаж и неправильного резервирования

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

Именно здесь ошибки интеграции чаще всего становятся заметны покупателю.

Рассмотрим ситуацию

На складе находится 100 единиц товара.

При этом:

12 единиц зарезервированы под заказы сайта.
18 единиц зарезервированы под заказы отдела продаж.
5 единиц заблокированы из-за повреждений.
10 единиц зарезервированы под другие обязательства.

Физически товар есть. Но продавать все 100 единиц нельзя.

Физический остаток100−Резервы, блокировки и страховой запасСайт 12Отдел продаж 18Повреждения 5Прочее 10+ страховой запас 5=Доступно к продаже50Доступно = физический остаток − резервы − блокировки − страховой запасКонкретный расчёт зависит от правил учёта, складов и момента создания резерва.

Если страховой запас составляет пять единиц, доступное количество будет равно 50.

5.1. Почему физический остаток не равен доступному

В системе могут существовать разные показатели:

Физическое количество.
Зарезервированное количество.
Ожидаемое поступление.
Количество в пути.
Заблокированный товар.
Доступный остаток.

Их нельзя смешивать.

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

Поставка может задержаться, часть товара может не пройти приёмку, а фактическое количество может отличаться от ожидаемого.

Поэтому использование будущих поступлений в расчёте доступности должно быть отдельным бизнес-правилом.

5.2. Несколько складов и разные схемы исполнения

Предположим, у компании три места хранения:

Центральный склад80Региональный склад25Склад маркетплейса40Интернет-заказыосновной источникДоставка в регионыне везде участвуетТолько заказыэтой площадкиНельзя просто сложить всё количество и показать покупателю 145 единиц.Доступность необходимо рассчитывать с учётом маршрута исполнения.

Товар на складе маркетплейса может обслуживать только заказы этой площадки. Региональный склад может не участвовать в доставке в определённые регионы. Центральный склад может быть основным источником исполнения интернет-заказов.

5.3. FBO и FBS: почему их нельзя учитывать одинаково

FBO

При FBO товар передаётся на склад маркетплейса. Площадка участвует в хранении и исполнении заказов в соответствии со своей схемой.

FBS

При FBS товар хранится у продавца, а продавец отвечает за подготовку и передачу заказов по правилам площадки.

Это принципиально разные процессы.

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

При FBS необходимо учитывать заказы площадки как обязательства перед покупателями и своевременно отражать их в складской доступности.

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

5.4. Страховой запас — не замена правильной архитектуре

Представим, что на складе осталось три единицы товара.

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

За несколько секунд могут поступить три заказа.

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

Один из способов снизить риск — страховой запас.

Например, система показывает на внешних площадках на одну единицу меньше, чем фактически доступно.

Но это не универсальное решение.

Для дорогих товаров страховой запас может быть значительным.

Для быстрооборачиваемого ассортимента он должен учитывать скорость продаж и задержку обновления.

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

Страховой запас снижает вероятность пересорта, но не заменяет централизованный контроль обязательств.

5.5. Как решить проблему одновременной продажи последней единицы

Это уже задача конкурентного доступа к ограниченному ресурсу.

Представим, что на складе находится одна единица.

12:00:00Сайт получилостаток = 112:00:01Маркетплейс получилтакой же остаток = 112:00:02Покупатель оформилзаказ на сайте12:00:03Второй покупательна маркетплейсеОба канала могут принять покупку, потому что ещё не получили обновлённое состояние.

Ускорение синхронизации уменьшает вероятность такого сценария, но не устраняет его полностью.

Здесь необходимо разделять два процесса:

Публикация доступности

Сколько товара можно показывать покупателям в каждом канале.

Подтверждение обязательства

Можно ли принять конкретный заказ с учётом уже существующих резервов.

В центральном интеграционном контуре можно реализовать атомарное распределение доступного количества между каналами.

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

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

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

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

 

6. Заказы: единый процесс приёма из нескольких каналов

После настройки каталога, цен и остатков необходимо организовать единый механизм обработки заказов.

Заказ может поступить:

Из интернет-магазина.
Из CRM.
Из маркетплейса.
Из другого подключённого канала продаж.

Каждый источник имеет собственный формат данных.

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

Интернет-магазинCRMМаркетплейсДругой каналИнтеграционныйслой→Учётная системаДокумент заказаПонятный документ с корректными позициями, количеством, ценами и связью с исходным заказом

6.1. Заказ с сайта

Покупатель оформляет покупку.

Сайт передаёт информацию в интеграционный слой:

ID заказа.
Состав корзины.
Товарные идентификаторы.
Количество.
Цены.
Скидки.
Данные покупателя.
Контактную информацию.
Способ доставки.
Адрес или пункт выдачи.
Комментарии.

Интеграция проверяет данные и создаёт соответствующий документ в МойСклад.

При этом необходимо различать оформление заказа и его подтверждение.

Покупатель может отправить заявку, но это ещё не означает, что товар гарантированно зарезервирован и заказ готов к исполнению.

Поэтому статусы должны отражать реальный процесс:

1Заказполучен2Данныепроверяются3Проверяетсядоступность4Заказподтверждён5Созданрезерв6Переданв сборку7Подготовленк отгрузке8Переданв доставку9ЗавершёнНабор состояний может отличаться, но каждое из них должно иметь чёткое значение.

6.2. Заказ из CRM

CRM чаще всего участвует в продаже через менеджера.

Клиент может получить индивидуальную скидку, заказать несколько товаров, согласовать особые сроки поставки или выбрать нестандартную комплектацию.

В таком заказе важно сохранить коммерческий контекст:

Ответственный менеджер.
Сделка.
Контрагент.
Договор.
Согласованная цена.
Скидка.
Условия оплаты.
Срок поставки.
Комментарии.

Интеграция должна передать именно те условия, которые были согласованы с покупателем.

Нельзя после создания заказа автоматически заменить индивидуальную цену стандартной розничной ценой из каталога.

Иначе технически успешная синхронизация приведёт к коммерчески неправильному документу.

6.3. Заказ с маркетплейса

Здесь необходимо учитывать особенности конкретной площадки.

Маркетплейс может передавать собственный идентификатор заказа, SKU, количество, цену, скидки, информацию о доставке и текущий статус.

Интеграция должна сохранять исходный идентификатор и канал продаж.

Это необходимо не только для создания документа, но и для дальнейшей обработки отмен, возвратов и финансовой сверки.

Отдельно учитываются схемы FBO и FBS.

FBO

При FBO часть складского и логистического процесса выполняет площадка.

FBS

При FBS продавец должен организовать исполнение на собственном складе и передать отправление по установленным правилам.

Поэтому один универсальный сценарий обработки заказов для всех каналов часто оказывается ошибочным.

6.4. Почему нельзя терять связь между заказом и исходным каналом

Представим, что в МойСклад создан заказ на 15 000 рублей.

Через неделю клиент оформил возврат.

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

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

Поэтому в интеграции нужно хранить устойчивые связи:

ID исходного заказа.
Канал продаж.
ID магазина или аккаунта.
ID заказа в МойСклад.
ID связанных документов.
ID внешних товарных позиций.
Историю изменений.
ЗаказМаркетплейс→ДокументМойСклад→Отгрузкаи доставка→Возврати закрытиеЭто позволяет проследить всю цепочку от первого оформления до отгрузки, возврата и окончательного закрытия операции.

 

7. Повторное создание заказов: почему одной проверки номера недостаточно

Одна из наиболее опасных ошибок интеграции — создание дублей.

Разберём ситуацию.

Разберём ситуацию

Маркетплейс отправляет уведомление о заказе №782641.

Интеграция получает данные и создаёт документ в МойСклад.

Но после создания документа происходит сетевой сбой. Ответ не возвращается на внешний сервис.

Маркетплейс не знает, была ли операция выполнена, и повторно отправляет запрос.

Интеграция получает тот же заказ ещё раз.

Заказ №782641отправлен→Документсоздан в МойСклад✕Сетевой сбойответ не вернулся↓Повторный запростот же заказ←Дубльвторой документЕсли система просто создаёт документ при каждом поступлении запроса, появится дубль.

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

В результате резервируется лишнее количество, склад получает неправильное задание, а менеджеры видят две продажи вместо одной.

7.1. Идемпотентность

Для защиты от таких ситуаций используется принцип идемпотентности.

Проще говоря, повторное выполнение одной и той же операции не должно приводить к повторному бизнес-результату.

Для каждого внешнего заказа формируется уникальный ключ.

Например:

Маркетплейсmarketplace-a:shop-15:order-782641Интернет-магазинsite-main:order-5821CRMcrm:deal-740:order-02Уникальный ключ для каждого внешнего заказа

При поступлении запроса система сначала проверяет реестр обработанных операций.

Если такой заказ уже существует, повторно создавать документ не нужно.

Интеграция должна найти ранее сохранённый результат и продолжить обработку с ним.

7.2. Почему проверка и создание должны быть атомарными

Есть ещё более сложная ситуация.

Два одинаковых запроса приходят практически одновременно.

Первый процесс проверяет реестр и не находит заказа.

Второй процесс тоже проверяет реестр и не находит заказа.

Оба переходят к созданию документов.

В результате появляются два заказа.

Процесс 1проверка реестра→ нет заказасоздание документаПроцесс 2проверка реестра→ нет заказасоздание документа→Два заказавместо одного

Чтобы этого избежать, проверка уникальности должна быть защищена на уровне хранилища данных.

Используются уникальные ограничения, транзакции и механизмы блокировки.

Недостаточно написать в программе обычное условие:

«Если заказа нет — создать».

Между проверкой и созданием может вмешаться другой процесс.

7.3. Важное различие: уникальность заказа и уникальность события

Один заказ может изменяться несколько раз.

Сначала он создан, затем изменилось количество, потом обновился адрес, после чего поступила отмена.

Если использовать только ID заказа как идентификатор всех событий, можно ошибочно принять законное изменение за дубликат.

Поэтому необходимо различать:

Идентификатор заказа.
Идентификатор события.
Версию или время изменения.
Тип операции.
ЗаказID 782641→созданизменено количествообновлён адресКаждое событиеобрабатывается отдельноПовторно пришедшее событие распознаётся как уже обработанное, а новое изменение — проходит отдельную обработку.

Повторно пришедшее событие должно распознаваться как уже обработанное, а новое изменение того же заказа — проходить отдельную обработку.

Это принципиально разные ситуации.

 

8. Самая сложная часть: что происходит, когда несколько систем одновременно изменяют одни данные

Теперь перейдём к проблеме, которая особенно часто проявляется в многоканальной торговле.

Представим, что один товар одновременно редактируют три сотрудника.

Менеджер меняет базовую цену в МойСклад.

Контент-менеджер обновляет описание на сайте.

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

Через несколько секунд запускается автоматическая синхронизация.

Если интеграция работает по принципу «получить весь объект и заменить им существующий», одно изменение может уничтожить другое.

МойСклад — ценаСайт — описаниеМаркетплейс — названиеСинхронизация«заменить объект»→Одно изменениеуничтожило другоеЭто называется конфликтом изменений.

Это называется конфликтом изменений.

8.1. Почему время последнего изменения не решает проблему

Допустим:

МойСклад изменён в 14:05:10.

Сайт изменён в 14:05:12.

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

Но что именно изменилось?

Возможно, только SEO-заголовок.

Если вместе с ним передать цену, система может случайно заменить утверждённую стоимость товара.

Время изменения не показывает, какое поле изменилось и кто имел право его менять.

Поэтому сравнение только по времени недостаточно.

8.2. Владение полями

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

Учётный идентификатор
МойСклад
Артикул
МойСклад
Базовая цена
МойСклад или система ценообразования
SEO-название
Сайт или PIM
Маркетинговое описание
Сайт или PIM
Физический остаток
Складской учёт
Доступность для каналов
Интеграционный контур
Индивидуальная скидка
CRM
Цена маркетплейса
Правила ценообразования канала
Статус доставки
Перевозчик или маркетплейс

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

8.3. Контроль версий и защита от устаревшей записи

В некоторых ситуациях необходимо контролировать не только владельца поля, но и версию данных.

Представим, что интеграция получила товар в состоянии версии 12.

Пока она обрабатывала данные, сотрудник изменил карточку до версии 13.

Интеграция пытается сохранить старую версию 12.

Если система просто выполнит обновление, более свежая информация может быть потеряна.

Для защиты используют контроль версий и оптимистическую блокировку.

Суть механизма:

Интеграция получилаверсию 12Сотрудник изменилдо версии 13→→Перед сохранениемпроверка версии12 ≠ 13→Не перезаписыватьперечитатьЕсли версия отличается, операция не перезаписывает новые данные автоматически.
1
Система получает объект и его текущую версию.
2
Подготавливает изменение.
3
Перед сохранением проверяет, не изменился ли объект после чтения.
4
Если версия отличается, операция не перезаписывает новые данные автоматически.
5
Система перечитывает актуальное состояние и решает, можно ли безопасно повторить изменение.

Для некоторых сценариев достаточно контроля на уровне отдельных групп полей. Для критичных операций нужен более строгий механизм.

8.4. Что делать, если два изменения оба правильные

Не каждый конфликт означает, что кто-то допустил ошибку.

Например, менеджер изменил базовую цену, а маркетплейс одновременно применил собственную скидку.

Оба изменения могут быть законными.

Проблема возникает только тогда, когда система пытается записать их в одно поле.

Менеджеризменил базовую ценуМаркетплейсприменил свою скидкуРазные полябазовая ценаканальная ценаскидка продавцаскидка площадки→Итоговаястоимость

Поэтому необходимо разделять базовую цену, канальную цену, скидку продавца и скидку площадки.

В таком случае изменения могут сосуществовать, а интеграция будет рассчитывать итоговую стоимость по установленным правилам.

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

 

9. Архитектура интеграции: почему между системами нужен отдельный управляющий слой

Когда компания подключает только сайт и МойСклад, иногда достаточно относительно простого коннектора.

Но при появлении CRM, нескольких маркетплейсов, разных складов и индивидуальных коммерческих условий количество связей начинает расти.

Каждый новый канал требует собственного набора правил.

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

Например, добавление нового маркетплейса затрагивает каталог, цены, остатки, заказы, отгрузки и возвраты.

Чтобы избежать такой зависимости, используют интеграционный слой.

Напрямую — хаос связейСайтCRMMP AМойСкладMP BСкладЧерез интеграционный слойИнтеграционныйслойСайтCRMMP AМойСкладMP BСклад

9.1. Как выглядит правильная схема

МойСклад ↔ интеграционный слой ↔ сайт
МойСклад ↔ интеграционный слой ↔ CRM
МойСклад ↔ интеграционный слой ↔ маркетплейсы

При этом интеграционный слой не просто передаёт данные.

Он отвечает за:

Преобразование форматов.
Сопоставление идентификаторов.
Проверку корректности данных.
Контроль владельцев полей.
Распределение остатков.
Создание и обновление документов.
Защиту от дублей.
Обработку ошибок.
Восстановление после сбоев.
Журналирование операций.

9.2. Основные компоненты

01

Модуль товарного каталога

Хранит связи между товарами, модификациями, комплектами и внешними карточками.

02

Модуль ценообразования

Рассчитывает стоимость для каналов, проверяет ограничения и обрабатывает специальные условия.

03

Модуль остатков

Учитывает склады, резервы, страховой запас и распределение доступного количества.

04

Модуль заказов

Принимает заказы, проверяет уникальность, создаёт документы и сохраняет связи между системами.

05

Модуль статусов

Преобразует состояния разных каналов в единую модель исполнения.

06

Очередь сообщений

Обеспечивает контролируемую обработку операций и повторные попытки.

07

Реестр соответствий

Хранит идентификаторы объектов во всех подключённых системах.

08

Мониторинг и журналирование

Показывает состояние обмена, задержки, ошибки и конфликты.

9.3. Почему не нужно сразу строить десятки микросервисов

Здесь есть ещё одна распространённая ошибка — избыточная архитектура.

Небольшому магазину не нужна сложная распределённая система с десятками отдельных сервисов, если её объём продаж и количество каналов этого не требуют.

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

По мере роста нагрузки отдельные компоненты можно выделять в самостоятельные сервисы.

Модульноеприложениестарт→Отдельныесервисырост нагрузки→Распределённаясистемаесли нужноАрхитектура должна соответствовать реальному масштабу бизнеса.

Главное — разделить бизнес-логику так, чтобы развитие одного направления не разрушало остальные.

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

 

10. Как обеспечить надёжный обмен через API, вебхуки и очереди

Техническая основа интеграции должна учитывать особенности каждой системы.

МойСклад предоставляет JSON API для работы с товарными и учётными сущностями. Через него можно получать и изменять данные, создавать документы и работать с другими объектами системы.

Но сам факт наличия API ещё не означает, что интеграция будет надёжной.

Необходимо правильно организовать обработку событий и нагрузку.

10.1. API — инструмент выполнения операций

Через API интеграция может:

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

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

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

Было в документеПозиция 1Позиция 2Позиция 3→Передаём новый списокПозиция 1(только одна)→Стало в документеПозиция 1Позиции 2 и 3удаленыЕсли программист не учитывает поведение API, частичное обновление документа может случайно удалить его товарные позиции.

Это особенно важно при разработке интеграции заказов.

Если программист не учитывает поведение API, частичное обновление документа может случайно удалить его товарные позиции.

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

10.2. Вебхуки — получение информации об изменениях

Вебхуки позволяют реагировать на события без постоянного опроса системы.

Например, товар изменился или был создан новый заказ.

Но вебхук не должен восприниматься как гарантированная доставка всей информации о состоянии объекта.

Правильнее рассматривать его как сигнал: «Объект изменился, проверьте актуальное состояние».

Источникизменение→Вебхуксигнал, а не данные→Запрос через APIактуальные данные→ОчередьОбработчик вебхуков должен быстро зарегистрировать событие и передать его в очередь.

Дальше интеграция получает необходимые данные через API и выполняет обработку.

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

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

10.3. Очереди сообщений

Представим, что маркетплейс после технического перерыва передал 500 заказов.

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

Очередь позволяет управлять интенсивностью обработки.

Например:

Высокий приоритетЗаказыобрабатываются первымиОперативныйКритичные обновления остатковоперативноОтдельный потокЦены

Например:

Заказы получают высокий приоритет.
Критичные обновления остатков обрабатываются оперативно.
Цены имеют отдельный поток обработки.
Массовая выгрузка описаний выполняется с более низким приоритетом.

Это позволяет не задерживать приём заказов из-за массовой синхронизации каталога.

10.4. Повторные попытки должны учитывать тип ошибки

Не любую ошибку можно исправить повторным запросом.

Если API временно недоступен, повторная попытка может помочь.

Если превышен лимит запросов, нужно учитывать интервал восстановления и ограничивать интенсивность обращений.

Если товар не сопоставлен с каталогом, повторный запрос не решит проблему. Необходимо исправить соответствие.

Поэтому ошибки разделяют на категории:

Тип ошибкиДействиеВременная недоступность→Повторная попыткаТайм-аут→Проверка результата и безопасный повторПревышение лимита→Ожидание и снижение нагрузкиОшибка авторизации→Восстановление доступаНе найден товар→Проверка сопоставленияНекорректные данные→Исправление и повторная обработкаКонфликт изменений→Перечитывание данных и разрешение конфликта

10.5. Почему нужен контрольный обмен

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

Представим, что уведомление о создании заказа не было обработано из-за технического сбоя.

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

Поэтому используется комбинированная схема:

01Событийный обменоперативная реакция02Очерединадёжная обработка03Периодическая сверкапоиск пропущенногоСобытийный обмен для оперативной реакции. Очереди для надёжной обработки. Периодическая сверка для обнаружения пропущенных изменений.
Событийный обмен для оперативной реакции.
Очереди для надёжной обработки.
Периодическая сверка для обнаружения пропущенных изменений.

Для большого каталога можно использовать контрольные выборки и обработку изменений по временным меткам или другим поддерживаемым механизмам API.

Важно не запускать полную выгрузку всего каталога при каждом небольшом изменении.

 

 

 

11. Что происходит при сбое посреди операции: разбор восстановления

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

Покупатель оформил заказ на сайте.

Интеграция получила его и начала обработку.

Далее произошло следующее:

1
Заказ прошёл проверку.
2
В МойСклад был создан документ.
3
Ответ API не дошёл до интеграционного сервиса.
4
Интеграция получила тайм-аут.
5
Внешняя система повторно отправила заказ.

Что делать?

Наивный вариант — повторить создание документа.

Но если первая операция всё-таки выполнилась, появится дубль.

Другой вариант — считать операцию неуспешной и удалить заказ на сайте.

Но документ уже может существовать в МойСклад, а резерв — быть создан.

Ни один из этих подходов не решает проблему.

Заказsite-main:5821→Документсоздан в МойСклад✕Ответ не дошёлтайм-аут↓Повторный запростот же заказ←Дубльвторой документНи один из подходов не решает проблему.

11.1. Правильная модель обработки

До обращения к API необходимо зарегистрировать операцию в собственном хранилище интеграции.

Например:

site-main:order-5821

Для неё фиксируется состояние:

1
Получен.
2
Проверен.
3
Передан в создание.
4
Ожидает подтверждения.
5
Создан.
6
Завершён.

Если запрос завершился тайм-аутом, операция не переводится автоматически в состояние «не создана».

Её состояние — «результат неизвестен».

Обычно«не создана»✕При тайм-ауте«результат неизвестен»Это принципиально важное различие.

Это принципиально важное различие.

11.2. Проверка результата

После тайм-аута система должна проверить, был ли создан документ.

Для этого используются сохранённые связи, внешние идентификаторы и согласованный механизм поиска операции.

Если документ существует, интеграция связывает его с исходным заказом и продолжает процесс.

Если документ не создан, выполняется безопасный повтор.

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

Тайм-аутДокумент создан?Да, создансвязать с заказомпродолжить процессНет, не созданбезопасный повторсоздание зановоНеизвестнодополнительнаяпроверкаЭто позволяет избежать повторного создания документов при неопределённом результате запроса.

11.3. Почему нельзя обещать абсолютную гарантию «один раз»

В распределённой системе несколько программ работают независимо.

Между ними могут происходить сетевые сбои, повторные запросы и задержки подтверждений.

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

На практике проектируют механизм, который обеспечивает практически однократный бизнес-результат за счёт:

Уникальных идентификаторов.
Реестра операций.
Идемпотентной обработки.
Защищённого создания документов.
Проверки результата после тайм-аута.
Контрольной сверки.

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

 

12. Экономика интеграции: сколько бизнес теряет из-за неправильных данных

Технические ошибки имеют вполне конкретную стоимость.

Причём она часто значительно выше, чем кажется на этапе разработки.

Рассмотрим условный пример.

Условный пример

Компания продаёт 4 000 товарных позиций через сайт, CRM и два маркетплейса.

За месяц поступает 3 000 заказов.

Допустим, из-за задержек синхронизации и неправильного резервирования 18 заказов оказываются проблемными.

Заказов за месяц3 000↓Проблемных18Отмены7нет товараСогласование5с покупателемПеремещение4между складамиИсправление2документовЭто не статистика реального проекта, а условная модель для оценки последствий.

Это не статистика реального проекта, а условная модель для оценки последствий.

Но она показывает, что даже небольшое количество ошибок создаёт постоянную нагрузку.

12.1. Прямые потери

К ним относятся:

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

12.2. Скрытые операционные расходы

Есть и менее очевидные последствия.

Менеджер тратит время на проверку остатков вместо работы с клиентами.

Сотрудник склада выясняет, какой заказ действительно нужно собирать.

Бухгалтерия исправляет документы.

Контент-менеджер повторно восстанавливает карточки товаров.

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

Каждая такая операция увеличивает стоимость обслуживания продаж.

ПРЯМЫЕ ПОТЕРИмаржа, логистика, компенсациивидны сразуСКРЫТЫЕ РАСХОДЫвремя, ручная работа, отчётынакапливаютсяОбе категории увеличивают стоимость обслуживания продаж.

12.3. Как оценить экономический эффект

Для расчёта можно использовать простую модель:

Общий эффект = предотвращённые потери от ошибок + сокращение ручного труда + дополнительная сохранённая маржа − стоимость интеграции и её сопровождения.

Общий эффект =предотвращённые потери + сокращение ручного труда + сохранённая маржа− стоимость интеграции и её сопровожденияУсловная модель

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

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

Это важно: оборот и прибыль — разные показатели.

Хорошая интеграция должна окупаться не количеством переданных запросов, а улучшением управляемости и экономических результатов компании.

 

13. Условный проект LOG-AI: объединение 4 000 товаров, сайта, CRM и двух маркетплейсов

Рассмотрим более подробный пример того, как может строиться такой проект.

Компания продаёт бытовую технику и аксессуары.

Исходная инфраструктура:

МойСклад — товарный и складской учёт.
Интернет-магазин — основной розничный канал.
CRM — работа менеджеров и оптовые продажи.
Маркетплейс A — продажи по FBO и FBS.
Маркетплейс B — дополнительный канал продаж.
Три склада — центральный, региональный и склад маркетплейса.

В каталоге около 4 000 товарных позиций, часть из которых имеет модификации и комплектации.

До внедрения интеграции сотрудники сталкивались с несколькими проблемами.

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

Главная проблема заключалась в том, что компания не имела единого механизма контроля изменений.

МойСкладтоварный и складской учётИнтернет-магазинCRMМаркетплейс AМаркетплейс BТри склада: центральный, региональный и склад маркетплейса
ЭТАП 1

Обследование и выявление конфликтов

Первым делом необходимо изучить не только системы, но и реальные процессы.

Было бы ошибкой сразу начинать разработку по принципу: «Нужно передавать товары, остатки и заказы».

Сначала требуется понять:

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

По результатам обследования составляется карта обмена.

Для каждого поля фиксируются владелец, направление передачи, условия обновления и допустимые значения.

ЭТАП 2

Очистка и сопоставление каталога

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

Создаётся единый реестр соответствий.

Автоматическое сопоставление применяется только там, где уверенность достаточна.

Неоднозначные позиции отправляются на ручную проверку.

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

ЭТАП 3

Разделение цен

Базовые цены остаются в учётном контуре.

Для маркетплейсов создаются отдельные правила расчёта, учитывающие комиссии и логистику.

Индивидуальные цены оптовых клиентов передаются из CRM в конкретные заказы.

Дополнительно устанавливаются минимально допустимые цены и условия согласования изменений.

ЭТАП 4

Управление остатками

Остатки разделяются по складам и каналам исполнения.

Товар на складе маркетплейса не смешивается со свободным остатком центрального склада.

Для сайта и маркетплейсов рассчитывается доступное количество.

Устанавливается страховой запас для наиболее чувствительных товарных позиций.

Заказы из всех каналов начинают учитываться в общем контуре обязательств.

ЭТАП 5

Централизованная обработка заказов

Все внешние заказы поступают через интеграционный слой.

Для каждого заказа сохраняются:

Внешний ID.
Канал продаж.
Состав заказа.
Идентификаторы товаров.
Цена и скидка.
Статус.
Связанный документ МойСклад.

Перед созданием документа проверяется уникальность операции.

При повторном получении запроса используется ранее созданный результат.

ЭТАП 6

Обработка отгрузок и возвратов

После подтверждения заказа запускается предусмотренный процесс исполнения.

МойСклад используется для учётных операций.

Информация о фактическом движении отправления поступает из соответствующего логистического канала.

При отмене или возврате система учитывает текущую стадию заказа.

Товар не возвращается в доступный остаток автоматически только потому, что покупатель нажал кнопку отмены.

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

ЭТАП 7

Проверка сложных сценариев

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

Например:

Сценарий 1Последняя единица одновременно заказана на сайте и маркетплейсе.распределение остатковСценарий 2Один заказ дважды поступил из маркетплейса.защита от дублейСценарий 3МойСклад создал документ, но интеграция получила тайм-аут.восстановление результатаСценарий 4Цена изменилась во время рекламной акции.защита спецусловийСценарий 5Заказ отменён после начала сборки.снятие резерваСценарий 6Изменилось описание товара на сайте.сохранение контентаСценарий 7API временно недоступен.повтор и сверка
Сценарий 1. Последняя единица одновременно заказана на сайте и маркетплейсе. Проверяется распределение остатков и порядок разрешения конфликта.
Сценарий 2. Один заказ дважды поступил из маркетплейса. Проверяется защита от повторного создания документа.
Сценарий 3. МойСклад создал документ, но интеграция получила тайм-аут. Проверяется восстановление результата без создания дубля.
Сценарий 4. Цена изменилась во время рекламной акции. Проверяется защита специальных условий.
Сценарий 5. Заказ отменён после начала сборки. Проверяется корректное снятие резерва и учётная обработка.
Сценарий 6. Изменилось описание товара на сайте. Проверяется, что обновление из МойСклад не уничтожает маркетинговый контент.
Сценарий 7. API временно недоступен. Проверяется сохранение операций, повторная обработка и последующая сверка.
ЭТАП 8

Постоянный контроль

После запуска система контролирует не только ошибки API, но и расхождения бизнес-данных.

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

Если остаток на сайте отличается от расчётного доступного количества, система должна показать причину расхождения.

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

Так интеграция становится контролируемым бизнес-инструментом, а не механизмом, который просто работает в фоновом режиме.

 

14. Как контролировать качество интеграции после запуска

Одна из ошибок внедрения — считать проект завершённым сразу после успешной передачи первых заказов.

На самом деле интеграция должна сопровождаться постоянно.

Меняются товары, сотрудники, цены, склады, правила маркетплейсов и процессы компании.

Поэтому необходимо контролировать несколько групп показателей.

01Техническиесобытия, ошибки,очереди, задержки02Бизнес-показателидубли, остатки,цены, резервы03Контрольная сверкабизнес-правила,а не числаТри группы показателей, которые нужно контролировать постоянно.
01 // ТЕХНИЧЕСКИЕ

Технические показатели

Количество полученных событий.
Количество успешно обработанных операций.
Количество ошибок.
Время обработки заказа.
Задержка обновления остатков.
Количество повторных попыток.
Длина очередей.
Число конфликтов изменений.
Количество операций, требующих ручного вмешательства.
02 // БИЗНЕС

Бизнес-показатели

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

Время существования ошибки

Особенно важно контролировать не только количество ошибок, но и время их существования.

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

Поэтому для разных операций устанавливаются разные приоритеты и допустимое время восстановления.

Ошибка описаниянекритичноможно исправить позжеОшибка остатковкритичнолишние заказы через минутыДля разных операций — разные приоритеты и допустимое время восстановления.

Контрольная сверка

Даже при использовании событийного обмена необходимо периодически сравнивать данные между системами.

Например, проверять:

Существуют ли все внешние заказы в учётной системе.
Совпадают ли идентификаторы товаров.
Не остались ли зависшие резервы.
Соответствуют ли цены утверждённым правилам.
Правильно ли распределены остатки.
Закрыты ли отменённые и возвращённые операции.

При этом нельзя требовать буквального равенства всех показателей.

Если сайт показывает 95 единиц, а в МойСклад физически находится 100, это может быть правильным результатом страхового запаса.

Сайт показывает95≠В МойСклад физически100✓Это нормастраховой запасСверка должна проверять бизнес-правила, а не только сравнивать числа.

Сверка должна проверять бизнес-правила, а не только сравнивать числа.

 

15. Как внедрять интеграцию без риска остановить продажи

Я не рекомендовал бы подключать все направления обмена одновременно.

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

Восемь этапов — от обследования до пилотного запуска.

01Обслед.02Проект.03Каталог04Цены/ост.05Заказы06Исполн.07Испыт.08ПилотПоследовательно, проверяя каждый уровень до перехода к следующему.
ЭТАП 01

Обследование

Изучаются каталоги, склады, цены, каналы, бизнес-процессы и существующие ограничения.

ЭТАП 02

Проектирование

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

ЭТАП 03

Товарный каталог

Настраиваются номенклатура, модификации, комплекты, характеристики и соответствия внешним SKU.

ЭТАП 04

Цены и остатки

Реализуются правила ценообразования, распределение количества и резервирование.

ЭТАП 05

Заказы

Подключаются каналы продаж, создаются документы и настраивается защита от дублей.

ЭТАП 06

Исполнение

Реализуется обмен статусами, отгрузками, отменами и возвратами.

ЭТАП 07

Испытания

Проверяются сбои, повторные события, конкурентные изменения, массовые операции и восстановление после недоступности API.

ЭТАП 08

Пилотный запуск

Сначала подключается ограниченная часть ассортимента или один канал продаж. После проверки корректности постепенно расширяется охват.

Возможность временно остановить отдельный поток обмена

Отдельно стоит предусмотреть возможность временно остановить отдельный поток обмена.

Например, если обнаружена ошибка в обновлении цен, не обязательно останавливать приём заказов и синхронизацию статусов.

Возможность изолировать проблемный компонент существенно повышает устойчивость всей системы.

Обновление цен⏸ остановленПриём заказов▶ работаетСинхронизация статусов▶ работает

 

16. Какие ошибки при интеграции обходятся бизнесу дороже всего

Есть несколько решений, которые на этапе разработки кажутся упрощением, но впоследствии создают серьёзные проблемы.

12 ошибок, которые обходятся дороже всего.

01Синхронизациявсего объекта02Артикул какединственный ID03Остаток безрезервов04Нет распределенияостатков05Заказ при каждомзапросе06Нет контроляпосле тайм-аута07Один наборстатусов08Игнорированиевозвратов09Нет журналаопераций10Нет регулярнойсверки11Увеличениечастоты обмена12ИзбыточнаяархитектураВсе 12 ошибок объединяет одно: они кажутся упрощением на этапе разработки.
01

Синхронизация всего объекта вместо изменённых полей.

Приводит к потере контента, перезаписи цен и конфликтам данных.

02

Использование названия или артикула как единственного идентификатора.

Создаёт риск неправильного сопоставления товаров и модификаций.

03

Передача физического остатка без учёта резервов.

Провоцирует продажи товаров, которые уже обещаны другим покупателям.

04

Отсутствие распределения остатков между каналами.

Не позволяет корректно управлять последними единицами товара.

05

Создание заказа при каждом входящем запросе.

Приводит к дублированию документов и резервов.

06

Отсутствие контроля результата после тайм-аута.

Создаёт риск повторного выполнения уже завершённой операции.

07

Использование одного набора статусов для всех систем.

Приводит к неправильному отображению исполнения и доставки.

08

Игнорирование возвратов и отмен.

Оставляет некорректные резервы и складские остатки.

09

Отсутствие журнала операций.

Затрудняет поиск ошибок и восстановление после сбоев.

10

Отсутствие регулярной сверки.

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

11

Попытка решить все проблемы увеличением частоты обмена.

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

12

Избыточная архитектура.

Усложняет сопровождение и увеличивает стоимость проекта без реальной пользы для бизнеса.

Все 12 ошибок объединяет одно: они кажутся упрощением на этапе разработки.

Но каждое такое «упрощение» впоследствии создаёт системную проблему — потерю данных, дубли, неправильные остатки, конфликты и, как следствие, финансовые и операционные потери.

Больше запросовчаще синхронизациякажется решением≠Правильная модель данныхрезервы, владение полями,распределение остатковБолее частые запросы не исправляют неправильную модель данных.

Все 12 ошибок объединяет одно: они кажутся упрощением на этапе разработки, но впоследствии создают системную проблему.

 

17. Что отличает профессиональную интеграцию от обычного обмена данными

На этом этапе стоит сформулировать главное различие.

Обычная интеграция отвечает на вопрос:

«Как передать товар, цену, остаток или заказ из одной системы в другую?»

Профессиональная интеграция отвечает на другие вопросы:

ОБЫЧНАЯ ИНТЕГРАЦИЯ«Как передать данныеиз одной системыв другую?»один вопросПРОФЕССИОНАЛЬНАЯ• Как определить, что данные правильные?• Кто имеет право изменить значение?• Что если две системы изменят одновременно?• Как понять, что заказ уже создан?• Что если API выполнил, а ответ не вернулся?• Как не продать одну единицу дважды?• Как восстановить обмен после сбоя?и ещё несколько вопросовИменно ответы на эти вопросы определяют качество интеграционного решения.

Вопросы профессиональной интеграции

01
Как определить, что передаваемые данные правильные?
02
Кто имеет право изменить конкретное значение?
03
Что произойдёт, если две системы изменят его одновременно?
04
Как система поймёт, что заказ уже был создан?
05
Что делать, если API выполнил операцию, но ответ не вернулся?
06
Как не продать одну единицу товара дважды?
07
Как восстановить обмен после нескольких часов недоступности?
08
Как обнаружить расхождение до того, как его заметит покупатель?
09
Как добавить новый канал продаж без переписывания всей архитектуры?

Именно ответы на эти вопросы определяют качество интеграционного решения.

Разные требования к скорости обновления

При этом не нужно стремиться к абсолютной синхронности всех данных.

Для цен, остатков, описаний и статусов могут быть разные требования к скорости обновления.

Например, остатки популярного товара требуют оперативной передачи. SEO-описание не нуждается в обновлении каждую секунду.

Заказ должен быть зарегистрирован максимально быстро. Массовая выгрузка изображений может выполняться в фоновом режиме.

Заказмаксимально быстроОстаткиоперативноЦеныпо правилам каналаSEO-описаниене срочноМассовая выгрузка изображенийфоновый режимПравильная архитектура учитывает критичность каждой операции, а не пытается обрабатывать всё одинаково.

Правильная архитектура учитывает критичность каждой операции, а не пытается обрабатывать всё одинаково.

 

Заключение

Интеграция МойСклад с сайтом, CRM и маркетплейсами — это создание единой системы управления многоканальными продажами.

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

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

Ситуация 1два покупателяпоследняя единицаСитуация 2цена меняетсяво время акцииСитуация 3заказ поступаетповторноСитуация 4нет подтверждениявыполненной операцииИменно в таких ситуациях становится понятно, насколько качественно спроектировано решение.

Надёжная архитектура строится на принципах

Единая идентификация товаров и заказов.
Чёткое распределение ответственности за данные.
Разделение базовых и канальных цен.
Расчёт доступного остатка с учётом резервов.
Контролируемое распределение товара между каналами.
Идемпотентная обработка заказов.
Контроль версий и конфликтующих изменений.
Очереди, журналирование и восстановление после сбоев.
Регулярная сверка бизнес-данных.

Но есть ещё один принцип, который я считаю особенно важным.

Интеграция должна сохранять правильность бизнес-процесса даже тогда, когда отдельные системы временно перестают работать идеально.

Если маркетплейс задержал уведомление, заказ не должен потеряться.

Если API вернул тайм-аут, система не должна создавать второй документ.

Если сотрудник изменил описание товара, обновление из МойСклад не должно уничтожать его работу.

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

Именно в таких ситуациях становится понятно, насколько качественно спроектировано решение.

Результат для бизнеса

Для бизнеса результатом должна стать не просто автоматизация обмена, а управляемая торговая инфраструктура, в которой сайт, CRM, МойСклад и маркетплейсы работают по согласованным правилам.

Управляемаяторговая инфраструктураРуководительдостоверная картина продажМенеджерыменьше ручных проверокСкладпонятные обязательстваПокупателиточная информация
Руководитель получает более достоверную картину продаж.
Менеджеры перестают тратить время на постоянную проверку данных.
Склад работает с понятными обязательствами.
Покупатели получают более точную информацию о наличии и состоянии заказов.

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

 

НАВИГАЦИЯ // SUGGESTED_READING
 
[ Модуль // БЕЗОПАСНОСТЬ ]

Где хранить API-ключи, токены и сервисные учётные данные

 
[ Модуль // БЕЗОПАСНОСТЬ ]

Реестр российского ПО: что нужно проверить перед внедрением

 
[ Модуль // БЕЗОПАСНОСТЬ ]

152-ФЗ: как проверить корпоративную систему на соответствие требованиям

 
[ EXPERTISE JOURNAL ]

Все инженерные материалы и экспертные статьи

 
[ CORE GLOSSARY ]

Полный алфавитный справочник ИТ-терминов

AI Ассистент
×
ИИ может ошибаться