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

Форматы файлов импорта

Требования к файлам CSV и XLSX для импорта заказов, отзывов и покупателей: состав колонок, обязательность и правила заполнения

Заказы, отзывы и покупателей платформа импортирует из файла CSV или XLSX в кодировке UTF-8. Общие правила одинаковы для всех трёх типов данных, состав колонок — разный.

Файлы загружаются в разделе Настройки → Импорт данных, на вкладке нужного типа данных. Тем же файлом записи не только создаются, но и обновляются.

Общие правила​

  • Первая строка файла содержит названия колонок. Порядок колонок значения не имеет.
  • Колонки, которых нет в таблицах ниже, сохраняются как дополнительные данные записи: у отзывов и покупателей — как пользовательские атрибуты, у заказов — как параметры заказа. Название такой колонки пишется латиницей без пробелов.
  • Дата и время передаются в формате ГГГГ-ММ-ДД чч:мм:сс, например 2021-01-01 00:11:22.
  • В CSV кавычки внутри значения удваиваются: ООО "Ромашка" записывается как ООО ""Ромашка"".
Неразобранные HTML-сущности попадут в контент как есть

Перед импортом проверьте, что в файле нет непреобразованных символов: &nbsp, &#41, &#40, <br>.

Состав колонок​

Номер заказа уникален в рамках компании: файл с существующим номером обновляет заказ, а не создаёт второй.

ПараметрОбязательныйОписание
numberДаНомер заказа
consumer_emailДа, одно из двухEmail покупателя
consumer_phoneДа, одно из двухТелефон покупателя
consumer_nameНетПолное имя покупателя
consumer_external_idНетИдентификатор покупателя в вашей системе
created_atНетДата создания заказа. Если колонки нет или значение пустое, подставляется момент импорта
product_idsНетИдентификаторы товаров из заказа
product_idНетИдентификатор одного товара, если каждая строка файла — одна позиция заказа
product_nameНетНазвание товара
product_urlНетURL карточки товара
product_picture_urlНетURL изображения товара

Контакт покупателя. Заказ импортируется, если заполнен consumer_email или consumer_phone — достаточно любого одного из двух.

Разделитель в product_ids. Платформа определяет его сама — запятая или вертикальная черта, в зависимости от того, какой символ чаще встречается в значении: 12232|32343|76348 и 12232,32343,76348 разбираются одинаково.

Одна строка — одна позиция заказа. Если у заказа несколько позиций, файл можно оформить построчно: строки с одинаковым number объединяются в один заказ. Из каждой строки берутся product_id, product_name, product_url и product_picture_url.

Создание товаров вместе с заказами. Если рядом с идентификатором товара заполнены product_name и product_url, отсутствующие в каталоге товары создаются во время импорта и попадают в служебную корневую категорию. В этом случае каталог товаров можно не импортировать: UGC-кампании будут работать и без него.

Дополнительные параметры. Любая колонка сверх перечисленных сохраняется в параметрах заказа и доступна в фильтрах и сегментах. Названия вроде payment_status или fulfilment_status — примеры таких произвольных колонок, а не отдельных полей платформы.

Образцы файлов: один заказ в строке, одна позиция заказа в строке.

Смотрите также: импорт данных в кабинете, импорт данных по API, каталог товаров (YML).