Перейти к основному содержимому

Разовый импорт

Доступность инструмента

Инструмент доступен в модуле Обмен товарами с версии 3.7.0

Кому и зачем нужен этот инструмент?​

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

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

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

Важно

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

Главный экран инструмента

Выбор типа импорта​

В верхнем блоке «Тип импорта» открывается список всех доступных операций, сгруппированных по назначению:

  • Сущности — разовый импорт товаров, модификаций, услуг и комплектов.
  • Цены — импорт цен для каждой из сущностей.
  • Остатки — общие остатки, актуальные остатки и остатки по комплектам.
  • Служебные — ассортимент, скидки, обновление внешних кодов, группы товаров.
  • Деактивация — массовая деактивация в Битриксе элементов и разделов, которых больше нет в МойСклад.
Недоступные типы

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

После выбора типа сразу подгружается превью запроса и применяются дефолтные параметры — отдельной кнопки «Подготовить» нажимать не нужно.

Превью запроса​

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

Пример превью и прогресса импорта

Запрос в МойСклад​

В этом разделе показано:

  • Метод и эндпоинт — например, GET /entity/product.
  • Параметры запроса — limit, offset, filter, expand и другие. Фильтр и набор раскрытий формируются по тем же правилам, что и при обычном агенте, — то есть превью показывает реальный запрос, а не упрощённую заглушку.

Если выбранный тип не использует REST-запрос (например, чисто служебные операции внутри Битрикса), вместо параметров появится пометка «Раннер не использует REST-запрос».

Настройки импорта​

Здесь собраны ключевые настройки, влияющие на текущий тип: ID инфоблока, флаг импорта архивных, фильтр по группам товаров МойСклад и так далее. Это позволяет до запуска убедиться, что обмен пойдёт именно по тому инфоблоку и с теми правилами, которые вы ожидаете.

Проверка условий запуска​

В правом верхнем углу превью отображается бейдж с результатом проверки:

  • ✅ Условия запуска выполнены — все настройки корректны, тип можно запускать.
  • ❌ Условия запуска не выполнены — ниже появится красный блок со списком конкретных причин. Кнопка «Запустить» в этом случае заблокирована.
  • ⚠️ Дополнительно могут быть предупреждения — запуск возможен, но к ним стоит присмотреться.

Управление запуском​

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

Лимит за шаг​

Количество элементов, которые обрабатываются за один шаг импорта. По умолчанию подставляется значение, оптимальное для выбранного типа (обычно 100 для сущностей). Можно уменьшить, если хочется проверить работу на маленькой порции, или увеличить для ускорения большой выгрузки.

Кнопки управления​

  • Запустить — старт пошагового импорта. Кнопка активна только при успешной проверке условий запуска.
  • Остановить — появляется во время выполнения и позволяет аккуратно прервать процесс на границе шага.
  • Сбросить — очищает прогресс и журнал, возвращает инструмент в состояние «готов к запуску». Полезно перед повторным запуском.
  • Обновить информацию — перезапрашивает превью. Используйте после изменения настроек модуля, чтобы убедиться, что они подтянулись.

Индикатор состояния​

Справа от кнопок отображается бейдж с текущим состоянием процесса: «Готов к запуску», «Импорт выполняется», «Импорт завершён», «Импорт остановлен» или «Ошибка импорта».

Прогресс и журнал сообщений​

После нажатия «Запустить» инструмент начинает выполнять шаги один за другим.

Общий прогресс​

Шкала прогресса показывает количество обработанных элементов и процент готовности. Для типов, которые идут несколькими стадиями (например, актуальные остатки выполняются в два этапа — Импорт и Финализация), рядом с прогрессом появляется бейдж с названием текущей стадии.

Журнал сообщений​

В журнал в реальном времени выводятся:

  • Параметры, с которыми сформирован запрос (фильтр, expand).
  • Итоги шага: сколько найдено, добавлено, обновлено и сколько ошибок.
  • Технические метрики — количество запросов к API МойСклад и время выполнения.

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

После завершения

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