МойСклад: каталог, склады, остатки и фото
Эта статья про то, как после подключения реально получить на сайт каталог из МойСклад и сделать так, чтобы остатки и фото обновлялись без ручной работы.
См. также
Где находится
- Модули интеграций → Интеграции → открыть запись МойСклад
- Настройка поставщиков → Поставщики — если нужно проверить созданные склады вручную
Что нужно понять перед началом
В каталоге МойСклад есть несколько отдельных потоков:
| Поток | Что делает |
|---|---|
| Номенклатура (товары) | Создаёт или обновляет товары на сайте |
| Категории | Переносит категории |
| Остатки | Обновляет наличие товаров |
| Фото товаров | Загружает изображения |
Это не одна кнопка «сделать всё». Обычно первый запуск делается по шагам.
Правильный первый запуск
Шаг 1. Подключение уже сохранено
Сначала должна быть готова запись интеграции:
- логин и пароль;
- точка выдачи;
- организация;
- запись Активна.
Если это ещё не сделано — начните с подключения.
Шаг 2. Создать склады автоматически
В карточке интеграции нажмите «Создать склады автоматически».
Что делает эта кнопка
Система смотрит склады в вашем аккаунте МойСклад и для каждого склада создаёт на сайте поставщика со специальным адаптером «Склад для каталога товаров».
При этом:
- поставщик получает источник МойСклад;
- в него записывается ID склада МойСклад;
- он привязывается к выбранной в интеграции точке выдачи;
- уже созданные ранее совпадения пропускаются.
Пример. В МойСклад есть склады «Основной», «Резерв», «Шымкент». После нажатия кнопки на сайте появятся три поставщика/склада для работы каталога.
Если кнопку нажали повторно
Повторный запуск не должен создавать дубли там, где связь уже существует. Система покажет, сколько складов создано, а сколько пропущено.
Шаг 3. Проверить потоки каталога
В блоке «Потоки синхронизации» обычно должны быть включены:
- Номенклатура (товары)
- Категории
- Остатки
- Фото товаров — если хотите картинки из МойСклад
Для первого запуска удобнее оставить режим «Вручную», чтобы всё делать по шагам и видеть результат.
Шаг 4. Проверить маппинг номенклатуры
В блоке «Маппинг номенклатуры» решается, откуда брать данные товара.
Товары
| Поле | Что означает |
|---|---|
| Производитель: источник | Брать бренд из кода товара или из атрибута |
| Производитель: атрибут | Имя атрибута, если выбрали вариант «Из атрибута» |
| Номер детали: источник | Брать номер детали из поля article, code или атрибута |
| Номер детали: атрибут | Имя атрибута для номера детали |
| Аналоги: атрибут | Из какого атрибута брать аналоги |
Комплекты
Ниже есть такой же блок для комплектов.
Как выбрать без боли
Если не знаете, что ставить, начните с настроек по умолчанию:
| Поле | Что обычно оставляют |
|---|---|
| Производитель: источник | Из кода товара (Бренд + Артикул) |
| Номер детали: источник | Поле article |
Атрибуты заполняйте только если у вас в МойСклад реально так хранятся данные.
Шаг 5. Категории
У потока «Категории» есть дополнительные поля.
| Поле | Что означает |
|---|---|
| Из какой категории синхронизировать подкатегории | Если хотите брать не всё дерево, а только ветку от выбранной категории |
| Категория на сайте для импорта категорий из МойСклад | Куда на сайте складывать импортированные категории |
| Направление синхронизации категорий | Откуда куда передавать категории |
Что выбирать в обычном случае
Если вы просто хотите подтянуть категории из МойСклад на сайт, обычно ставят:
| Поле | Рекомендация |
|---|---|
| Направление синхронизации категорий | Из МойСклад в проект |
| Остальные два поля | Заполнять по необходимости |
Шаг 6. Остатки и цены
В блоке «Остатки и цены» есть два важных поля:
| Поле | Что означает |
|---|---|
| Из какого атрибута брать остаток товара | Как считать остаток |
| Синхронизировать остатки по закупочной цене | Брать закупочную цену вместо цены продажи |
Как понимать поле остатка
| Вариант | Что значит |
|---|---|
| Доступно (Остаток + Ожидания - Резервы) | Более «живой» остаток, с учётом ожиданий и резервов |
| Остаток (без ожиданий/резервов) | Просто чистый остаток |
Если не уверены, начинайте с Доступно.
Шаг 7. Запустить импорт вручную
В карточке интеграции сверху есть кнопка «Поставить поток в очередь». Внутри неё несколько действий.
Сначала: Товары и категории
Выберите действие «Товары и категории».
Если хотите просто проверить без реальной записи, можно выбрать:
- Тестовый запуск (dry-run) — только проверка;
- Реальный запуск — настоящий импорт.
Для первого живого запуска:
- Сделайте тестовый запуск, если база большая и хотите убедиться, что всё читается.
- Потом сделайте реальный запуск.
Потом: Остатки и фото
После товаров и категорий запустите:
- Остатки и фото
Если фото пока не нужны — ничего страшного, можете сначала запускать только товары и остатки.
Как это выглядит в жизни
Пример. Вы подключили МойСклад и нажали:
- Создать склады автоматически
- Товары и категории
- Остатки и фото
Что должно получиться:
- на сайте появились товары;
- у товаров появились категории;
- предложения стали показывать остатки;
- карточки товаров получили фото (если они были в МойСклад).
Почему это важно для заказов
Если товар приехал на сайт именно из МойСклад, система запоминает связь этого товара с учётной системой.
Проще говоря:
- сайт понимает, что это товар из МойСклад;
- потом такой товар можно корректно отправить обратно в МойСклад в заказ покупателя или в заказ поставщику.
Если товар создали вручную на сайте и не связали с МойСклад, такой товар может не попасть в заказ в МойСклад.
Когда лучше включать расписание
Когда первый запуск уже прошёл нормально.
Обычно схема такая:
- Первый импорт — вручную.
- Убедились, что всё загружается правильно.
- Потом переводите потоки в режим «По расписанию».
Что проверить
- Кнопка «Создать склады автоматически» отработала без ошибки
- В Настройка поставщиков → Поставщики появились склады/поставщики из МойСклад
- Потоки Товары, Категории, Остатки включены
- После запуска на сайте реально появились товары, категории и остатки
- Если включали фото — появились изображения
Дальше: Заказы в МойСклад.