Что синхронизируется

Сущность Направление Частота
Товары МС → Витрина Каждые 2 часа (cron) + webhook
Остатки МС → Витрина Каждые 15 минут (cron) + webhook
Цены МС → Витрина Каждые 2 часа
Фото МС → S3 → Витрина При полном синке
Заказы Витрина → МС Мгновенно (через demand)

Article-first upsert

Ключ для upsert товаров — артикул. Если у тебя уже есть товар с таким артикулом в Витрине — обновляем его поля из МС. Если нет — создаём новый.

Важно: не меняй артикулы в МС после первого синка — система создаст дубли.

Webhook

При регистрации webhook (делается нами при подключении):

  • product create/update — мгновенный пересинк одного товара
  • retaildemand create/update — мгновенное обновление остатка

URL webhook: https://vitrina-ai.ru/api/v1/sync/moysklad/webhook.

Multi-shop

Один МС-аккаунт = один магазин в Витрине. Если у тебя 2 магазина в одном МС — подключай каждый отдельно, указывая разные склады в настройках.