Как передать данные в файле CSV

Вы можете раз в сутки отправлять файл с данными в формате CSV на электронную почту.

Требования

  • Название файла должно быть в формате: сайт магазина_дата.csv. Например: example-shop.ru_20.05.2019.csv.

  • Частота передачи файла — раз в сутки.

    Внимание. Если в какой-то день не было ни одной продажи, файл все равно нужно отправлять. В нем должны быть заполнены только названия полей (заголовки столбцов). Строки с данными должны быть пустыми.
  • Формат — UTF-8.
  • Допустимы три типа строк:

    • Строка с данными по проданному товару.

    • Строка со скидкой на весь чек (идет после строк со всеми товарами по этому чеку).

    • Строка с возвратом.

  • Разделитель между полями — точка с запятой. Если в данных есть точка с запятой, экранируйте ее двойными кавычками.

  • Спецсимволы экранируйте двойными кавычками. Если в данных есть текст в кавычках, используйте перед ними слэш вида \.
    Пример

    Название товара с фразой в кавычках

    "Детские кубики \"Веселая Азбука\" алфавит с цифрами"

Названия и описание полей

Строка с данными о товаре

Ограничение. Данные по одному товару должны занимать только одну строку.
Поле Комментарий Обязательность
Номер чека Может содержать цифры, буквы латинского алфавита, кириллицу. Обязательно
ID пользователя Может содержать цифры и буквы латинского алфавита. Необязательно
Дата и время создания заказа Дата и время, когда пользователь оформил заказ, по местному времени (в часовом поясе, указанном в поле Часовой пояс (GMT) создания заказа). В формате DD.MM.YYYY hh:mm:ss, например: 25.02.2019 18:14:36. Обязательно
Дата и время покупки Дата и время, когда пользователь оплатил заказ, по местному времени (в часовом поясе, указанном в поле Часовой пояс (GMT) создания заказа). В формате DD.MM.YYYY hh:mm:ss, например: 25.02.2019 18:25:10. Обязательно
Часовой пояс (GMT) создания заказа Часовой пояс, в котором работает магазин. В формате ± hh:mm, например: + 03:00. Обязательно
Способ доставки

Возможные значения:

  • Курьер
  • Пункт выдачи
  • Служба доставки
  • Почта

Если покупка была в магазине, оставьте поле пустым.

Необязательно
Область Субъект федерации (область, край и т. д.), в котором была продажа или доставка. Только кириллица. Обязательно
Город Населенный пункт продажи или доставки. Только кириллица. Обязательно
Адрес Адрес, по которому была продажа (магазин, пункт выдачи), или адрес доставки (почтой, курьером). В формате субъект федерации, населенный пункт, улица, дом или город федерального значения, улица, дом, например: Приморский край, Уссурийск, ул. Ленина, д. 1. Только кириллица. Обязательно
URL сайта Укажите URL сайта, если продажа была через заказ в интернет-магазине. Необязательно
ID товара Может содержать только цифры. Обязательно
Полное название товара Максимально полное название товара. Экранируйте двойными кавычками. Обязательно
Штрихкод В формате EAN. Для книг укажите ISBN. Если штрихкод отсутствует, укажите нет. Обязательно
Бренд Производитель, бренд или торговая марка. Экранируйте двойными кавычками. Обязательно
Тип операции Значение для строки с данными о товаре — Продажа. Обязательно
Исходная цена товара без скидки

В рублях, с точностью до двух знаков после запятой или точки, например: 100,20 или 100.20. Обозначение валюты (руб.) указывать не нужно.

Обязательно
Количество товара Укажите, сколько единиц товара продано. Обязательно
Итоговая стоимость
  • Если была скидка, укажите стоимость товара после применения скидки.
  • Если куплено несколько единиц товара, укажите стоимость за проданное количество товара.

В рублях, с точностью до двух знаков после запятой или точки, например: 100,00 или 100.00. Обозначение валюты (руб.) указывать не нужно.

Обязательно
Размер скидки при ценовой акции

Суммарная скидка на все единицы товара по акции, при покупке в комплекте с другими товарами, по программе лояльности и т. п. В рублях, с точностью до двух знаков после запятой или точки, например: 100,00 или 100.00. Обозначение валюты (руб.) указывать не нужно.

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

Необязательно
Размер скидки при оплате баллами, промокодами и купонами

Суммарная скидка на все единицы товара при оплате бонусными баллами, подарочным сертификатом, после применения промокода, купона и т. п. В рублях, с точностью до двух знаков после запятой или точки, например: 100,00 или 100.00. Обозначение валюты (руб.) указывать не нужно.

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

Необязательно
Категория Может содержать цифры, буквы латинского алфавита, кириллицу. Обязательно
Пол

Возможные значения: М, Ж.

Необязательно
Возраст

Укажите конкретную цифру, например 23, или диапазон в таком формате:

  • до 18 лет
  • 18-24
  • 25-34
  • 35-44
  • 45-54
  • 55 лет и старше
Необязательно
Источник перехода на сайт

Возможные значения:

  • Прямые заходы
  • Яндекс.Директ
  • Яндекс.Маркет
  • Яндекс.Дисплей
  • Google Shopping
  • Google Ads
  • Поиск Яндекса
  • Поиск Google
  • Переходы из социальных сетей
  • Переходы по медийной рекламе
  • Переходы из мессенджеров
  • Переходы из рекомендательных систем
  • Переходы с почтовых рассылок
Необязательно
Канал продаж

Возможные значения:

  • Десктопный сайт
  • Мобильный сайт
  • Мобильное приложение
  • Терминал в магазине или пункте выдачи заказов
  • Телефонный звонок
  • Продажа в магазине
  • Социальные сети
  • Мессенджеры
  • Продажа юрлицам
  • Маркетплейсы
Обязательно

Строка, если была скидка на весь чек

Примечание. Если в строках с данными о товарах указаны скидки на отдельные товары, учитывать их в строке со скидкой на весь чек не нужно.
Поле Комментарий Обязательность
Номер чека Может содержать только цифры. Обязательно
Тип операции Значение для строки со скидкой на весь чек — Продажа. Обязательно
Размер скидки при ценовой акции

Скидка на всю покупку по акции, при покупке в комплекте с другими товарами, по программе лояльности и т. п. В рублях, с точностью до двух знаков после запятой или точки, например: 100,00 или 100.00. Обозначение валюты (руб.) указывать не нужно.

Обязательно
Размер скидки при оплате баллами, промокодами и купонами

Скидка на всю покупку при оплате бонусными баллами, подарочным сертификатом, после применения промокода, купона и т. п. В рублях, с точностью до двух знаков после запятой или точки, например: 100,00 или 100.00. Обозначение валюты (руб.) указывать не нужно.

Обязательно

Строка с возвратом

Поле Комментарий Обязательность
Номер чека Должен быть таким же, как и у заказа, по которому производится возврат. Может содержать только цифры. Обязательно
ID пользователя Может содержать цифры и буквы латинского алфавита. Необязательно
Дата и время создания заказа Дата и время, когда пользователь оформил заказ, по которому производится возврат, по местному времени (в часовом поясе, указанном в поле Часовой пояс (GMT) создания заказа). В формате DD.MM.YYYY hh:mm:ss, например: 25.02.2019 18:14:36. Обязательно
Часовой пояс (GMT) создания заказа Часовой пояс, в котором работает магазин. В формате ± hh:mm, например: + 03:00. Обязательно
ID товара Может содержать только цифры. Обязательно
Тип операции Значение для строки с возвратом — Возврат. Обязательно
Количество товара Укажите, сколько единиц товара возвращено. Обязательно
Итоговая стоимость

Сумма возврата. В рублях, с точностью до двух знаков после запятой или точки, например: 100,00 или 100.00. Обозначение валюты (руб.) указывать не нужно.

Обязательно

Пример

В примере ниже переданы данные по трем чекам:

  • В первой строке указаны данные по заказу в интернет-магазине с доставкой курьером (чек 120002).

  • Во второй и третьей строках указаны данные по товарам, проданным в магазине (чек 134002). В четвертой строке указана скидка при оплате баллами и купонами на весь чек 134002.

  • В пятой строке указан возврат по чеку 101550.
Номер чека;ID пользователя;Дата и время создания заказа;Дата и время покупки;Часовой пояс (GMT) создания заказа;Способ доставки;Область;Город;Адрес;URL сайта;ID товара;Полное название товара;Штрихкод;Бренд;Тип операции;Исходная цена товара без скидки;Количество товара;Итоговая стоимость;Размер скидки при ценовой акции;Размер скидки при оплате баллами, промокодами и купонами;Категория;Пол;Возраст;Источник перехода на сайт;Канал продаж
120002;1111001;25.02.2019 18:14:36;25.02.2019 18:25:10;+ 03:00;Курьер;Тверская область;Тверь;Тверская область, Тверь, ул. Уральская, д. 4;www.example-shop.ru;20004501;"Смартфон Samsung Galaxy S8";4000120023;"Samsung";Продажа;10000.00;1;10000.00;;;Смартфоны;Ж;23;Прямые заходы;Десктопный сайт
134002;1450022;25.02.2019 18:34:56;25.02.2019 18:35:40;+ 03:00;;Москва;Москва;Москва, ул. Победы, 12;;10240055;"Набор сверл BRIGADIER 39321, 60 шт.";4200120099;"BRIGADIER";Продажа;1500.00;1;1300.00;200.00;;Сверла;М;34;;Мобильное приложение
134002;1450022;25.02.2019 18:34:56;25.02.2019 18:35:40;+ 03:00;;Москва;Москва;Москва, ул. Победы, 12;;10240056;"Набор сверл DeWALT DT5912-QZ, 13 шт.";4030120045;"DeWALT";Продажа;250.00;1;200.00;50.00;;Сверла;М;34;;Мобильное приложение
134002;;;;;;;;;;;;;;Продажа;;;;0.00;650.00;;;;;
101550;3002367;11.02.2019 10:55:59;;+ 03:00;;;;;;13500034;;;;Возврат;;1;200.00;;;;;;;
Номер чека ID пользо вателя Дата и время создания заказа Дата и время покупки Часовой пояс (GMT) создания заказа Способ доставки Область Город Адрес URL сайта ID товара Полное название товара Штрихкод Бренд Тип опера ции Исходная цена товара без скидки Коли чество товара Итоговая стоимость Размер скидки при ценовой акции Размер скидки при оплате баллами, промокодами и купонами Категория Пол Возраст Источник перехода на сайт Канал продаж
120002 1111001 25.02.2019 18:14:36 25.02.2019 18:25:10 + 03:00 Курьер Тверская область Тверь Тверская область, Тверь, ул. Уральская, д. 4 www.example- shop.ru 20004501 "Смартфон Samsung Galaxy S8" 4000120023 "Samsung" Продажа 10000.00 1 10000.00 Смартфоны Ж 23 Прямые заходы Десктопный сайт
134002 1450022 25.02.2019 18:34:56 25.02.2019 18:35:40 + 03:00 Москва Москва Москва, ул. Победы, 12 10240055 "Набор сверл BRIGADIER 39321, 60 шт." 4200120099 "BRIGADIER" Продажа 1500.00 1 1300.00 200.00 Сверла М 34 Мобильное приложение
134002 1450022 25.02.2019 18:34:56 25.02.2019 18:35:40 + 03:00 Москва Москва Москва, ул. Победы, 12 10240056 "Набор сверл DeWALT DT5912-QZ, 13 шт." 4030120045 "DeWALT" Продажа 250.00 1 200.00 50.00 Сверла М 34 Мобильное приложение
134002 Продажа 0.00 650.00
101550 3002367 11.02.2019 10:55:59 + 03:00 13500034 Возврат 1 200.00