FAQ по импорту

Подробная инструкция по разделу /gadmin/imports и этапам обработки.

Навигация по разделам

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

Практический формат

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

FAQ: Импорт прайсов

Этот материал описывает, как сейчас работает импорт в интерфейсе /gadmin/imports: от загрузки файла до скачивания очищенного результата.

Актуально на основе текущей логики контроллеров, сервисов и job-пайплайна.

Быстрый переход

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

1) Быстрый старт

Откройте раздел Импорт прайсов.
Загрузите файл CSV/XLSX/XLS через drag-and-drop или выбор файла.
Дождитесь завершения первичной обработки (очистка файла).
Откройте пакет и при необходимости запустите шаги 2–5 кнопкой «Запустить следующий шаг».
Скачайте обработанный XLSX и при необходимости выгрузите ошибки/логи.

Подробности по этапам: как работает обработка, 5 шагов на карточке пакета, что можно скачать.

2) Где находится раздел и кто имеет доступ

Режим	URL	Кому доступно	Особенности
Администратор	`/gadmin/imports`	Пользователи с правом `imports.manage`	Полный обзор пакетов, bulk-операции, очистка истории, rollback.
Поставщик	`/account/imports`	Роль `supplier`	Только собственные пакеты, без массовых операций и без rollback.

Подробнее о различиях режимов: раздел для поставщика.

3) Как работает обработка

После загрузки создаётся пакет импорта, а дальше запускается цепочка фоновых job: ProcessOfferImportBatch → ParseWorkbookJob → SanitizeAndDetectTableJob → FinalizeImportBatchJob.

Что делает первичный пайплайн автоматически

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

После этого можно идти глубже вручную: шаги 2–5. Если интересуют признаки зависания или ошибок, смотрите диагностику и логи.

4) 5 шагов обработки на карточке пакета

Шаг	Что происходит	Результат
1. Обработка файла (очистка)	Чтение книги, sanitizing, выделение таблицы, сохранение staging-структуры.	Базово очищенный массив строк/колонок.
2. Определение строк с товарами	Поиск товарных строк по словарю типов + эвристикам; нетоварные строки удаляются.	Остаются строки с признаком `«Строка содержит товар»`.
3. Проверка дополнительных данных	Оценка корреляций по структуре значений, фильтрация слабых/шумных строк.	Остаются строки `«Товар с данными»`.
4. Выявление неинформативных строк	Поиск строк-аномалий по паттернам колонок и якорным полям.	Удаляются неинформативные и аномальные записи.
5. ИИ-нормализация таблицы	Нормализация заголовков и безопасные структурные выравнивания через AI-план.	Финальный очищенный набор для выгрузки.

Примечание: шаги 2–5 запускаются последовательно кнопкой «Запустить следующий шаг» и не выполняются, пока активен текущий процесс.

5) Статусы и что они означают

Код статуса	Название	Смысл
`uploaded`	Загружен	Файл принят системой и поставлен в обработку.
`parsing`	Парсинг	Идёт чтение файла и проверка структуры.
`raw_extracting`	Raw-извлечение	Совместимый промежуточный этап пайплайна.
`sanitizing`	Очистка	Идёт очистка и подготовка staging-данных.
`profiling`	Профилирование	Профилирование колонок (служебный этап).
`suggesting_mapping`	Авто-маппинг	Подготовка авто-сопоставления (служебный этап).
`preview_ready`	Предпросмотр готов	Предпросмотр подготовлен.
`waiting_confirmation`	Ожидает подтверждения	Ожидалось подтверждение импорта.
`importing`	Импорт	Этап записи офферов в каталог.
`embedding`	Синхронизация	Промежуточный этап синхронизации обновлённых данных.
`matching`	Matching	Очередь matching и последующая актуализация.
`ready`	Готов	Пакет завершил доступные этапы обработки.
`failed`	Ошибка	Пакет завершился с ошибкой.
`cancelled`	Отменён	Пакет отменён пользователем/массовой операцией.

Для расследования проблем переходите к ошибкам и логам.

6) Требования к файлу и лимиты

Поддерживаются форматы: CSV, XLSX, XLS.
Максимальный размер файла задаётся системным параметром limit_import_file_mb.
При загрузке считаются хеш и метаданные исходного файла.
Для поставщика действуют почасовые и суточные лимиты на количество импортов.
Проверка дубликатов учитывает поставщика, хеш и статус пакета.

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

7) Экспорт: что можно скачать

Файл	Назначение
`errors.csv`	Список ошибок/предупреждений по строкам с фильтрацией по фазе, severity, коду.
`errors.xlsx`	Та же аналитика ошибок в Excel-формате.
`processed.xlsx`	Очищенный результат (лист `Processed`) + метаданные пакета (лист `Meta`).
`logs.txt`	Технический pipeline-лог по шагам, уровням и context-полям.

8) Ошибки, логи и диагностика

Диагностика делится на два уровня:

Ошибки пакета: фильтры по фазе, severity, коду, выгрузка в CSV/XLSX.
Технические логи: последовательность шагов и контекст обработки в logs.txt.

На что смотреть в первую очередь

status и current_step на карточке пакета;
последние записи в logs.txt;
коды ошибок в выгрузке errors.csv/errors.xlsx;
системные причины: пустой файл, неподходящий формат, лимиты, отсутствующие данные.

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

9) Текущие ограничения функционала

Важно

В текущей конфигурации интерфейса подтверждение полноценного импорта и сохранение маппинга временно отключены на уровне контроллеров/сервиса.

saveMapping() возвращает сообщение о временном отключении.
confirm() возвращает сообщение о временном отключении.
confirmAndImport() бросает confirm_disabled_processing_only.

Практически это означает, что пользовательский сценарий сейчас ориентирован на очистку файла + скачивание обработанного результата.

10) Отличия режима поставщика

Поставщик видит только свои пакеты.
На списке отключены bulk-операции и очистка всей истории.
На карточке пакета скрыт rollback.
Доступны загрузка, шаги обработки, отмена, скачивание результатов и логов.

Если в интерфейсе не хватает кнопок, сначала проверьте роль и маршрут (/account/imports vs /gadmin/imports).

11) Типовые сценарии и решения

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

Кнопка скрывается, когда пакет в активном статусе обработки или когда уже выполнен шаг 5. Также она не появится, если ещё нечего скачивать (не готовы staging-колонки).

Система нашла пакет с тем же хешем файла (в рамках поставщика и активных статусов). Используйте уже созданный пакет или загрузите новую версию файла с изменениями.

Проверьте: формат файла, корректность Excel, непустые данные, лимит размера и лимиты поставщика. Для точной причины смотрите коды ошибок в errors.xlsx и технический logs.txt.

12) Сноски и термины

Staging — промежуточное хранилище строк/колонок для очистки и анализа перед финальными действиями.
Пакет импорта — единица обработки одного загруженного файла с собственным id, статусом и логами.
Pipeline logs — журнал событий каждого этапа с контекстом (step, level, message, context).
Processed XLSX — выгрузка очищенных данных + служебных метаданных по обработке.
Статус ready в текущем режиме означает завершение доступной обработки в рамках текущей конфигурации.

Наверх: к быстрому старту · к оглавлению: к началу раздела.