подготовка файла

Подготовка файла для загрузки гостей

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

Требования к формату

Файл в формате CSV, кодировка UTF-8.
За один раз загружать не более 10 000 гостей в одном файле.
Символы " ` ' в файле могут вызвать некорректную работу загрузчика. Файл нужно тщательно проверять и редактировать.
Если в файле несколько страниц (листов), всё нужно перенести на одну страницу либо редактировать и сохранять каждую отдельно (при сохранении .csv Excel предупредит о потере остальных листов).
Не должно быть пустых строк.

Поля файла

Названия столбцов должны точно совпадать с именами полей ниже. Обязательное поле — phone.

Поле	Тип	Описание	Особые отметки
`phone`	string	Телефон	Обязательное. Форматы: `9xx-xxx-xx-xx`, `8xxx-xxx-xx-xx`, `+7xxx-xxx-xx-xx`, `7xxx-xxx-xx-xx`
`surname`	string	Фамилия
`name`	string	Имя
`patronymic`	string	Отчество
`fio`	string	ФИО полностью	не рекомендуется (лучше разбить на surname/name/patronymic)
`email`	string	Email
`birthday`	date	День рождения	Формат `дд.мм.гг`. Нет даты → `0000-00-00`. Пустая ячейка = ДР в день появления гостя в базе
`gender`	enum	Пол	`male` / `female`
`categories`	string	Категории	Через запятую, из существующих в CRM. Поиск с учётом регистра
`cards`	string	Номера карт	Через запятую. Для выпуска новых карт оставляем пустым
`наименование кошелька`	int	Сумма бонусов	Точное имя кошелька. Только целые числа; дробные — через точку
`tags`	string	Теги	Через запятую; регистронезависимые; должны быть созданы и активны в ЛК. Дубли удаляются
`total_sale_sum`	int	Сумма продаж в старой системе	Загружается одной продажей с датой `31.12.2000`
`sales_provider`	enum	Провайдер продаж	Нужен при заполнении `total_sale_sum`, иначе `provider` в продажах будет пустым
`loader_purchases_sum`	int	Сумма транзакций гостя	Только если планируются переходы по уровням ПЛ по суммам заказов. Дата создания — `31.12.2000`
`consent_status`	enum	Разрешение на обработку ПД	`given` / `revoked`
`reissue`	bool	Перевыпуск карты	не рекомендуется
`registration_date`	datetime	Дата регистрации	не рекомендуется
`staff`	bool	Является сотрудником	не рекомендуется

Загрузчик поддерживает и множество других технических полей (external_id, balance, discount, visits_count и т. п.), но они помечены «не рекомендуется» и в большинстве загрузок не используются.

Допустимые провайдеры для `sales_provider`

'', plaziuscab, rkeeper, iiko, iikodelivery, sbis, tillypad, poster,
beerfest1c, fastoperator, welcomegroupsales, loyalty1c, rkeeperdelivery,
iikocloud, frontol, superdostavka

Поля детей

Поле	Тип	Описание
`child_name_<n>`	string	Имя ребёнка, где `<n>` — порядковый номер ребёнка
`child_birthday_<n>`	date	День рождения ребёнка, где `<n>` — порядковый номер

Пошаговая подготовка

Получите базу гостей.
В Excel замените названия столбцов на имена полей из таблицы выше.
Если ФИО пришло слитно — разделите его (см. ниже).
Проверьте и замените данные в поле categories на корректные названия категорий из CRM (с учётом регистра).
Сохраните файл в формате CSV.
Откройте CSV в редакторе Notepad++.
Измените кодировку на UTF-8. Если номер телефона гостя длиннее 11 цифр — после перекодировки проверьте корректность номеров.
Проверьте отсутствие пустых строк и сохраните файл.

Разделение ФИО средствами Excel

Вставьте 1–2 пустых столбца правее столбца с ФИО.
Выделите ячейки, которые нужно разделить.
Вкладка «Данные» → «Текст по столбцам».
В диалоговом окне выберите «с разделителями» → «Далее».
В качестве разделителя выберите «пробел». В окне предварительного просмотра убедитесь, что разделение произошло → «Далее».
В следующем окне оставьте значения по умолчанию → «Готово».
Проверьте корректность разделения и вставки.

При выявлении странного поведения загрузчика незамедлительно предоставьте всю информацию (поинт, ссылку, загружаемый файл, скриншоты, краткое описание) ответственным в отделе Разработки и отделе ПЛ.

(см. скриншоты в исходной инструкции)