Редактирование: подготовка-файла

Путь: 06_Загрузка_гостей/подготовка-файла.md

Содержимое (Markdown)

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

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

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

- Файл в формате **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>` — порядковый номер |

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

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

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

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

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

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

Отмена