Как импортировать региональные данные по продуктам

Региональные данные — это значения полей продукта (цена, доступность, ссылка и др.), которые отличаются в разных зонах проекта. Например, один и тот же товар может стоить по-разному в Москве и Самаре — региональные данные позволяют хранить эти значения в одной карточке продукта и показывать жителю каждого города актуальную информацию.

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

Импорт выполняется в разделе Данные → Импорт. Нажмите «Новый импорт» для перехода к настройкам:

Шаг 1. Выберите действие с даннымиШаг 1. Выберите действие с данными

1. Выберите тип импорта — «Продукты → Региональные данные».
2. Выберите действие — «Добавить и обновить региональные данные».

Шаг 2. Подготовьте и загрузите файлШаг 2. Подготовьте и загрузите файл

1. Определите, какие поля нужно загрузить. В файле обязательно должны присутствовать:

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

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

   Список необязательных полей

   Поле	Описание
   Имя	Название продукта в зоне
   Описание	Текстовое описание продукта в зоне
   Цена	Текущая цена продукта в зоне
   Старая цена	Предыдущая цена продукта в зоне
   Себестоимость	Себестоимость продукта в зоне
   Минимальная цена	Минимальная цена, до которой можно снижать стоимость в зоне
   Дата и время поступления (UTC)	Дата и время появления продукта в каталоге зоны в формате UTC
   Ссылка	Ссылка на страницу продукта на сайте для этой зоны
   Ссылка на картинку	Ссылка на изображение продукта в зоне
   Артикул	Артикул продукта в зоне
   Доступность	Доступность продукта в зоне в формате true / false
   Срок годности	Срок годности в днях
   Название производителя	Производитель продукта
   Идентификатор группы продуктов	Идентификатор группы, объединяющей вариации одного продукта (например, разные цвета или размеры)
   Дополнительные поля сущности «Продукт»	Дополнительные поля продукта, настроенные на проекте

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

   • Формат — .csv или .txt.
   • Рекомендуемая кодировка — UTF-8.
   • Проверьте, что значения соответствуют допустимым форматам.

   Убедитесь, что зоны и продукты с указанными внешними идентификаторами уже загружены на проект.

   

   Рекомендации по подготовке и сохранению файла.

3. Загрузите файл для импорта и нажмите «Продолжить»:

   

Шаг 3. Сопоставьте поля файлаШаг 3. Сопоставьте поля файла

Система автоматически сопоставляет колонки файла с полями в Mindbox. При необходимости скорректируйте сопоставление:

1. В колонке «Импорт» отметьте галочками поля, которые нужно загрузить. Колонки без галочки будут пропущены.

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

   Если нужного дополнительного поля еще нет на проекте, его можно создать по кнопке «Создать дополнительное поле».

3. Нажмите «Продолжить»:

Шаг 4. Настройте импорт и запустите импортШаг 4. Настройте импорт и запустите импорт

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

2. Добавьте комментарий импорта при необходимости.

3. Убедитесь, что данные выглядят ожидаемо: правильные значения попали в правильные поля и привязаны к нужным зонам. Если все верно — нажмите «Запустить импорт».

   

Как отслеживать импортКак отслеживать импорт

После запуска импорт появится в списке на странице «Импорт». По каждой задаче отображаются:

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

Если в ходе импорта возникли ошибки — часть строк была пропущена. Откройте детали импорта, чтобы посмотреть, какие строки вызвали проблему и почему. Исправьте ошибки в файле и запустите импорт повторно.

Результат импортаРезультат импорта

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