Как импортировать заказы по файлу

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

Чтобы массово загрузить заказы на проект, перейдите в раздел Данные → Импорт. Нажмите «Новый импорт», чтобы перейти к настройкам импорта:

Перед импортом убедитесь, что на проекте созданы:

• дополнительное поле типа «Внешний идентификатор» сущности «Заказ»;
• внешняя система для идентификации продуктов;
• точка интеграции и точка контакта, к которым будут отнесены заказы.

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

• Выберите тип импорта — «Заказы и действия → Заказы».
• Выберите действие — «Добавить и обновить заказы».

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

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

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

   Поле	Обязательно	Описание
   Идентификатор заказа {Внешняя система}	✅ Должен быть указан хотя бы один	Уникальный идентификатор заказа. Требуется заранее созданное дополнительное поле типа «Внешний идентификатор» сущности «Заказ»
   Дата и время создания/изменения заказа	✅	Дата и время последнего изменения заказа в формате UTC
   Идентификатор клиента	✅ Должен быть указан хотя бы один	Email, телефон, номер карты, MindboxID или внешний идентификатор клиента
   Id Product в {Внешняя система}	✅	Идентификатор товара во внешней системе
   Количество продукта	✅	Количество единиц товара в позиции заказа
   Базовая цена продукта Цена для покупателя за линию чека	✅ Должно быть указано одно из полей	Цена за единицу товара или итоговая цена позиции (без учета отмены и возврата линии)
   Статус позиции заказа	✅	Текущий статус позиции (например, оплачена, отменена, возвращена)
   Дополнительные поля заказа и позиции	❌	Любые дополнительные поля, настроенные в проекте для сущностей «Заказ» и «Позиция заказа»

   Полный список доступных полей можно посмотреть на странице импорта.

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

   • Формат файла — .csv или .txt.
   • Рекомендуемая кодировка — UTF-8.
   • Каждая строка соответствует одной позиции заказа. Заказ с несколькими позициями занимает несколько строк с одинаковым внешним идентификатором заказа.

   

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

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

   

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

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

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

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

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

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

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

На этом шаге можно задать дополнительные параметры действия импорта:

• Источник данных — точка интеграции, указывает, откуда пришли данные. Влияет на атрибуцию действий клиента. По умолчанию используется «Административная панель Mindbox».
• Точка контакта — определяет, к какому каналу или интеграции будет привязано действие. По умолчанию определяться автоматически по точке интеграции. Если нужно явно привязать клиентов к конкретному сайту или магазину, выберите нужную точку вручную.
• Комментарий — описание импорта, помогает быстрее найти импорт в общем списке.

Шаг 5. Проверьте и запустите импортШаг 5. Проверьте и запустите импорт

Перед запуском Mindbox показывает первые строки файла с уже примененными сопоставлением. Убедитесь, что данные выглядят ожидаемо: правильные значения попали в правильные поля.

Если все верно — нажмите «Запустить импорт».

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

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

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

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

Обновление статуса заказаОбновление статуса заказа

При повторном импорте заказа с тем же внешним идентификатором Mindbox обновит его статус и другие поля позиции.

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

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

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