> For the complete documentation index, see [llms.txt](https://help.zenky.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.zenky.io/exchange/customers.md).
# Импорт клиентской базы
Для переноса вашей клиентской базы из внешних систем в Zenky вы можете воспользоваться импортом покупателей через файлы CSV (Comma-separated values) или XLSX (Excel).
## Требования к файлу импорта
Перед тем, как загружать файл с покупателями, его нужно привести в определённый формат:
1. На первой строке файла должны идти заголовки полей: `phone,first_name,last_name,birth_date,gender,email,balance,bonuses_level_id` (именно в таком порядке);
2. На второй и последующих строках должны идти данные каждого покупателя (один покупатель — одна строка). Описание и порядок полей см. ниже;
3. Каждый файл может содержать **не более 1 000** покупателей. Если в файле перечислено больше покупателей, они будут проигнорированы. Для загрузки более 1 000 покупателей вам нужно разбить вашу базу на несколько файлов;
4. Файл должен иметь кодировку **UTF-8** без заголовка (BOM). При использовании иных кодировок могут возникнуть проблемы с отображением имён и фамилий;
5. У файла должно присутствовать расширение **.csv** или **.xlsx**. Если файл имеет другое расширение или не имеет его, он будет расценен как **.csv**-файл.
## Описание полей
Каждый покупатель может иметь следующий набор полей:
* `phone` — номер телефона (с 8 или +7). Обязательное поле **\[1]**;
* `first_name` — имя покупателя;
* `last_name` — фамилия покупателя;
* `birth_date` — дата рождения в формате **ГГГГ-ММ-ДД** (например: 1991-09-20);
* `gender` — пол покупателя. Возможные значения: `male` (мужской), `female` (женский) и `other` (не указан);
* `email` — адрес электронной почты покупателя;
* `balance` — баланс бонусов покупателя **\[2]**;
* `bonuses_level_id` — ID бонусного уровня, который нужно назначить покупателю. ID нужных уровней можно скопировать в разделе **"Лояльность" -> "Бонусные уровни"**, нажав на кнопку в столбце **"ID"**.
***\[1]** Если телефон не указан или указан неправильно, этот покупатель будет пропущен (лимит в 1000 покупателей при этом не увеличивается). Если один и тот же номер телефона присутствует в одном файле (или в нескольких), все данные будут перезаписаны последней позицией.*
***\[2]** Если баланс не указан (поле пропущено через запятую), то текущий баланс существущего покупателя не будет перезаписан. Однако, если в этом поле указано любое значение, баланс будет изменён. Обратите внимание, что **знак пробела будет преобразован в 0** и баланс покупателя **обнулится**.*
## Пример файла
Ваш файл импорта должен выглядеть примерно следующим образом:
```
phone,first_name,last_name,birth_date,gender,email,balance,bonuses_level_id
+79641234567,Иван,Иванов,1996-10-31,male,ivanov@example.org,500,94494c63-e7b3-4f1a-bea3-59fb8c482405
+79831234567,Полина,Петрова,1991-03-29,female,petrova@example.org,,
+79021234567,Анна,,,,,1024,
```
На первой строке файла расположены обязательные заголовки полей. На второй строке перечислены все поля для покупателя Иван Иванов. На третьей строке у покупателя Полина Петрова указаны все поля кроме баланса и ID бонусного уровня. На четвёртой строке у покупателя Анна указаны только номер телефона, имя и баланс бонусов.
## Импорт данных
После того, как вы подготовите файл, перейдите в раздел **"Продажи" -> "Покупатели"** в панели администратора Zenky и нажмите на кнопку **"Импорт"** справа над таблицей.
В интерфейсе импорта покупателей вы сможете отслеживать статус обработки загруженного файла. Имейте в виду, что вы не сможете загрузить новый файл, пока не завершится обработка предыдущего.
Нажмите на кнопку **"Выбрать файл"** и укажите расположение нужного вам файла. После выбора начнётся автоматическая загрузка.
Когда загрузка файла будет завершена, начнётся его обработка, а под кнопкой "Выбрать файл" появится информационное окно.
В информационном окне будет указан ID задачи импорта, её статус и количество импортированных покупателей. **Скопируйте и сохраните ID задачи на случай, если возникнут проблемы.** Этот ID нужно будет передать в техническую поддержку, без него нам будет сложно определить причину проблем.
Вы можете не ждать и закрыть браузер, импорт в этом случае не прервётся. После завершения импорта статус задачи в информационном окне изменится на "Выполнен".
Если вы закрыли окно во время импорта, а после открытия информационного окна нет, это означает, что импорт завершился. Если вы считаете, что во время импорта что-то пошло не так, напишите нам в чат или на , предоставив название магазина, ID задачи и описание проблемы.
**Обратите внимание, что данные существующих покупателей будут перезаписаны, в том числе их баланс (если указан) и бонусный уровень (если указан).**