Требования к файлу с заказами

Файлы загружаются в формате CSV, XLSX. Доступны два формата

Подготовьте CSV (кодировка UTF-8) или XLSX файл в одном из следующих форматов:

  • Формат 1 → каждая строка в файле — это один заказ

  • Формат 2 → каждая строка в файле — это одна позиция в заказе

Формат 1


В данном формате каждая строка это будет один заказ. Скачать пример

Переменная

Обязательно

Описание

Пример

number

Да

Номер заказа


consumer_email

Да

Е-mail клиента


consumer_name

Да

Полное имя клиента


consumer_external_id

Нет

Внешний ID клиента


consumer_phone

Нет

Телефон клиента


created_at

Да

Дата создания заказа

2014-01-01 00:11:22

paid_status

Рекомендуется

Статус оплаты


delivery_status

Рекомендуется

Статус доставки


product_ids

Да

ID товаров

12232|32343|76348

Комментарии:

  • Порядок колонок не важен, но первая строка в файле должна содержать названия колонок.

  • Если в заказе клиента более одной позиции, используйте символ - «|» в качестве разделителя (например: 12232|32343|76348).

  • Остальные колонки, кроме указанных как обязательны в примере выше, будут считаться доп. параметрами передаваемого заказа. Например, поля paid_status или delivery_status не обязательны, но мы рекомендуем их указывать.

  • Учитывайте, что при использовании CSV есть отдельные требования. Например, если в значениях встречаются кавычки → ООО "Ромашка" — то они представляются в виде двух кавычек подряд → ООО ""Ромашка"".

Формат 2


В данном формате каждая строка, это будет одна позиция (товар в корзине) из заказа. Если в заказе две позиции, то в файле будет две одинаковые строки, которые отличаются только значением колонок product_id. Скачать пример.

Переменная

Обязательно

Описание

Пример

number

Да

Номер заказа


consumer_email

Да

Е-mail клиента


consumer_name

Да

Полное имя клиента


consumer_external_id

Нет

Внешний ID клиента


consumer_phone

Нет

Телефон клиента


created_at

Да

Дата создания заказа

2014-01-01 00:11:22

paid_status

Рекомендуется

Статус оплаты


delivery_status

Рекомендуется

Статус доставки


product_id

Да

ID одного товара

12232

product_name

Рекомендуется

Название товара

Камера Sony a6400

product_url

Рекомендуется

URL карточки товара

https://shop.site/344

product_picture_url

Рекомендуется

URL картинки товара

https://shop.site/344/cover.jpg

Комментарии:

  • Порядок колонок не важен, но первая строка в файле должна содержать названия колонок.

  • Если в файле вместе с колонкой product_id заполнить product_name, product_url, product_picture_url, то вместе с импортом заказов будут созданы и товары в платформе. В этом случае для работы UGC кампаний, каталог товаров можно не импортировать.

  • Остальные колонки, кроме указанных как обязательны в примере выше, будут считаться доп. параметрами передаваемого заказа. Например, поля paid_status или delivery_status не обязательны, но мы рекомендуем их указывать.

  • Учитывайте, что при использовании CSV есть отдельные требования. Например, если в значениях встречаются кавычки → ООО "Ромашка" — то они представляются в виде двух кавычек подряд → ООО ""Ромашка"".


Еще:

👆 На этом пока всё