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

Импорт заказов позволяет массово загрузить в 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 показывает первые строки файла с уже примененными сопоставлением. Убедитесь, что данные выглядят ожидаемо: правильные значения попали в правильные поля.

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

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

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

• дата запуска,
• тип импорта,
• кто запустил.

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

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

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

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