Помимо создания клиентов и объектов вручную, вы можете загрузить их с помощью файла в формате csv. Это помогает в случаях, когда у вас уже есть собственная база с большим количеством клиентов. С помощью загрузки вы сэкономите время на создании и обновлении уже существующих клиентов.


CSV (Comma-Separated Values — значения, разделённые запятыми) — текстовый формат, предназначенный для представления табличных данных. Его можно выгрузить из современных программ по работе с таблицами.


Откройте вкладку Адреса.

Для загрузки файла нажмите кнопку загрузки рядом с кнопками добавления клиентов и объектов. 

Здесь вы увидите описание всех доступных колонок.

Скачайте пример файла и отформатируйте по нему csv файл с собственными клиентами.


Если вы используете первую строку таблицы, как «шапку», поставьте галочку в Пропустить первую строку. Вы также можете выбрать кодировку csv файла. Чаще всего используется UTF-8 и CP-1251. Если у вас другая кодировка, поменяйте её на один из доступных.


После выбора файла, нажмите на кнопку Загрузить. В зависимости от количества значений, системе может потребоваться несколько минут для загрузки.



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

Загруженные клиенты будут отображаться на вкладке Адреса → Клиенты, а объекты на Адреса → Объекты.


Если в файле имеет неправильный формат и ошибки, вы можете увидеть данное сообщение, вместо результатов загрузки.



Сравните свой файл с примером, проверьте кодировку, и попробуйте загрузить таблицу еще раз.


Подготовка csv файла

Для создания файла, воспользуйтесь любой программой для работы с таблицами. В этом примере мы воспользуемся Google таблицами.

Скачайте пример файла. Откройте его и скопируйте «шапку» в свою таблицу.



external_id;client_id;organization;first_name;last_name;middle_name;organization_name;contact_name;cell_phone;work_phone;email;site_address;site_address_country;site_address_apartment;site_address_floor;site_address_entrance_no;site_address_description;template_name;job_external_id


Вы также можете напрямую импортировать/открыть пример файла, если ваша программа позволяет это.

Таблица будет выглядеть подобным образом. 



Каждое поле имеет свое значение:

  1. external_id — идентификатор клиента во внешней системе.
  2. client_id — идентификатор клиента в Планадо.
  3. organization — признак юридического лица (t или f). Данное поле является обязательным.
  4. first_name — имя (для физлиц).
  5. last_name — фамилия (для физлиц).
  6. middle_name — отчество (для физлиц).
  7. organization_name — название (для юрлиц).
  8. contact_name — контактное лицо (для юрлиц).
  9. cell_phone — мобильный телефон (используйте формат E.164 для корректной работы SMS).
  10. work_phone — рабочий телефон.
  11. email — электронная почта.
  12. site_address — адрес.
  13. site_address_country — страна (двухбуквенный код, Россия — ru).
  14. site_address_apartment — номер квартиры.
  15. site_address_floor — этаж.
  16. site_address_entrance_no — номер подъезда.
  17. site_address_description — описание адреса.
  18. template_name — наименование шаблона наряда (при указании после загрузки клиента по нему будет создан наряд).
  19. job_external_id — внешний идентификатор наряда (при указании наименования шаблона).

Заполните колонки данными о своих клиентах. Если клиент является физлицом, введите в колонку organization значение f. Клиентам физлицам не нужно вносить значения в колонку organization_name.

Если клиент является юрлицом, нужно будет ввести в колонку organization значение t. Для юрлиц, колонки first_name, last_name, middle_name остаются пустыми.



https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/13006640077/original/1454336260_58.png?1465374706Если вы собираетесь в будущем обновлять данные о клиентах тоже с помощью загрузки csv файла, вам потребуется заполнить колонку внешний идентификатор external_id. Например, при первой загрузке будет создан клиент с идентификатором 1. При последующих загрузках файла с данным идентификатором - вместо создания нового клиента будет обновление полей у уже существующего с идентификатором 1.


После заполнения таблицы, экспортируйте/скачайте её как файл формата csv.



Сравните получившийся файл с примером. Если формат сходится, вы можете загружать файл в Планадо.


https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/13006640077/original/1454336260_58.png?1465374706Обратите внимание, что разделителем между полями должны быть именно точка с запятой (;). При сохранении из некоторых программ, вместо точки с запятой может использоваться только запятая - такой файл не получится загрузить.


Возможные проблемы.

1. У полей есть максимум символов. При загрузке файла, где символов больше, будет появляться ошибка.


Если вам нужна помощь, оставьте заявку или напишите нам на почту support@planado.ru.