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


Для загрузки нужно подготовить файл в формате CSV или XLSX. 


Через загрузку можно добавлять наряды, клиентов и объекты. 

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



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


Примеры файлов для загрузки смотрите во вложении к этой инструкции (в самом конце).

Используйте эти файлы как образец для подготовки своих данных к загрузке. Далее будут описаны особенности подготовки файлов для каждого из случаев.


Так выглядит CSV-файл:

В первой строке файла обязательно должны быть названия столбцов:



Описание столбцов (колонок):


  1. Внешний идентификатор – идентификатор наряда. Если вы планируете загружать одну таблицу несколько раз, то нарядам нужно назначить уникальный идентификатор, чтобы они не создавались повторно.
  2. Шаблон – шаблон, по которому будет создан наряд.
  3. Тип – тип наряда.
  4. Запланирован – на какую дату и время запланирован наряд.
  5. Длительность – длительность наряда. 
  6. Описание – описание наряда.
  7. Адрес – адрес наряда.
  8. Описание адреса – если требуется дополнительное описание адреса, то вы можете добавить его в это поле.
  9. Подъезд – подъезд адреса для наряда.
  10. Этаж – этаж адреса из наряда.
  11. Квартира – квартира адреса из наряда
  12. Долгота — долгота адреса наряда.
  13. Широта — широта адреса наряда.
  14. Контакт 1 (имя) – имя контакта из наряда.
  15. Контакт 1 (телефон) – телефон контакта из наряда.
  16. Контакт 2 (имя) – имя второго контакта из наряда.
  17. Контакт 2 (телефон) – телефон второго контакта из наряда.
  18. Навыки – требуемые навыки для наряда.
  19. Участок – участок, к которому принадлежит наряд.
  20. Email исполнителя – email, указанный сотрудником при регистрации. Именно по этому полю назначается исполнитель наряда.
  21. Имя исполнителя – имя сотрудника-исполнителя наряда.
  22. Фамилия исполнителя – фамилия сотрудника-исполнителя наряда.
  23. Идентификатор клиента – идентификатор клиента в Планадо.
  24. Внешний идентификатор клиента – идентификатор клиента во внешней системе, используется в случаях, когда вы планируете добавлять несколько нарядов на одного клиента.
  25. Наименование юрлица – название юридического лица клиента, не используется, если клиент – физическое лицо.
  26. Имя физлица – имя клиента, не используется если клиент – юридическое лицо.
  27. Отчество физлица – отчество клиента, не используется если клиент – юридическое лицо.
  28. Фамилия физлица – фамилия клиента, не используется если клиент – юридическое лицо.
  29. Адрес клиента – если не был указан адрес наряда и объекта, то будет использовать он.
  30. Описание адреса клиента – если адресу требуется дополнительное описание, то вы можете указать его здесь.
  31. Подъезд клиента – подъезд адреса клиента.
  32. Этаж клиента – этаж адреса клиента.
  33. Офис/квартира клиента – офис или квартира адреса клиента.
  34. Адрес клиента (широта) — широта адреса клиента.
  35. Адрес клиента (долгота) — долгота адреса клиента.
  36. Контакт клиента 1 (имя) – имя контакта клиента.
  37. Контакт клиента 1 (телефон) – телефон клиента, будет использоваться для отправки СМС.
  38. Контакт клиента 2 (имя) – имя дополнительного контакта клиента.
  39. Контакт клиента 2 (телефон) – телефон дополнительного контакта клиента.
  40. Внешний идентификатор объекта – идентификатор объекта, должен быть уникальным.
  41. Название объекта – название объекта.
  42. Адрес объекта – если не был указан адрес наряда, то будет использоваться он.
  43. Описание адреса объекта – если требуется указать описание адреса, то вы можете сделать это в этом поле.
  44. Подъезд объекта – подъезд объекта.
  45. Этаж объекта – этаж объекта.
  46. Офис/квартира объекта – офис объекта.
  47. Адрес объекта (широта) — широта адреса объекта.
  48. Адрес объекта (долгота) — долгота адреса объекта.
  49. Контакт объекта 1 (имя) – имя контакта объекта, если указан, то будет использоваться как контакт для наряда.
  50. Контакт объекта 1 (телефон) – телефон контакта, если указан, то будет использоваться как контакт для наряда.
  51. Контакт объекта 2 (имя) – имя дополнительного контакта объекта.
  52. Контакт объекта 2 (телефон) – телефон дополнительного контакта объекта.
  53. Участок объекта – участок, к которому принадлежит объект.

Как загрузить

Для загрузки откройте страницу «Наряды» и нажмите «Загрузить».



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


Обратите внимание на результат загрузки.

В следующем примере загрузка прошла успешно и было создано четыре наряда, два клиента и один объект.



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


Если во время загрузки возникнут проблемы, то появится сообщение об ошибке. Например:


Исправьте ошибку и загрузите файл повторно. Если вы не понимаете, почему файл не загружается, то напишите в поддержку support@planado.app и пришлите пример файла.



⚠️ Если вы планируете в дальнейшем редактировать клиентов или объекты с помощью загрузки таблиц, или загружать для созданных клиентов и объектов наряды, то убедитесь, что у них указаны внешние идентификаторы. 



Возможные ошибки


Используется неправильный разделитель колонок

Используйте точку с запятой в качестве разделителя колонок в CSV-файле. Если использовать другой разделитель, например, запятую, то появится следующее сообщение об ошибке:


В таком случае необходимо поменять запятые на точки с запятой. 


Точка с запятой внутри поля

Если внутри поля используется точка с запятой, то само поле должно быть выделено одинарными кавычками ('). В противном случае появится подобное сообщение об ошибке:



В XLSX файле формат полей отличается от текстового


При загрузке XLSX-файла у всех его полей должен быть формат «Текст». Чаще всего программы для редактирования таблиц автоматически определяют формат некоторые полей как «Дата» или «Число». Чаще всего это происходит с полями «Запланирован на», «Длительность», «Квартира», «Этаж» и «Подъезд». 


Примеры загрузки

Файлы примеров смотрите во вложении к этой инструкции в самом конце.


1. Загрузка наряда без клиента

Рассмотрим вариант загрузки наряда с данными только по самому наряду.

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



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

Например, при первой загрузке создаётся наряд с идентификатором 32. При следующих загрузках этого файла наряд с таким идентификатором создаваться не будет. 


Пример наряда после загрузки:


2. Загрузка наряда с клиентом – юридическим лицом


Чтобы загрузить наряд вместе с клиентом, в таблицу нужно добавить поля для клиента.


Сначала рассмотрим клиента-юридическое лицо, поэтому поля для физических лиц добавлять не будем.

Добавим следующие поля в таблицу:


  • Идентификатор клиента
  • Внешний идентификатор клиента
  • Наименование юрлица
  • Описание адреса клиента
  • Этаж клиента
  • Офис/квартира клиента
  • Контакт клиента 1 (имя)
  • Контакт клиента 1 (телефон)
  • Контакт клиента 2 (имя)
  • Контакт клиента 2 (телефон)


У клиента, как и у наряда есть внешний идентификатор. Он должен быть уникальным и служит, чтобы в будущем ссылаться на наряды этого клиента. 

Обратите внимание, что если вы хотите использовать в качестве адреса для наряда адрес клиента, то поле адреса наряда нужно оставить пустым.

Если вы не планируете использовать какие-то из полей (например, второй контакт клиента), то можете их не добавлять. 


После загрузки будет создан наряд. Обратите внимание, что адрес, а также дополнительная информация по нему (описание адреса, офис, этаж, подъезд) уже занесены в наряд из информации по клиенту.

Кроме наряда на странице «Адреса» был создан клиент. В дальнейшем будем использовать этого клиента для создания других нарядов.



3. Загрузка клиента физического лица

Теперь добавим наряд на нового клиента-физическое лицо. Для этого добавим следующие поля:


  • Имя физлица
  • Отчество физлица
  • Фамилия физлица 


Поле с названием юрлица оставим пустым, потому что название юрлица и ФИО физлица не могут быть заполнены одновременно.


По результатам загрузки будет создан наряд:


А также новый клиент:




4. Загрузка объекта для существующего клиента


Теперь рассмотрим вариант, когда мы добавляем наряд на объект, который привязан к уже загруженному клиенту.

Для этого добавим следующие поля в таблицу:

  • Внешний идентификатор объекта
  • Название объекта
  • Адрес объекта
  • Описание адреса объекта
  • Подъезд объекта
  • Этаж объекта
  • Офис/квартира объекта
  • Контакт объекта 1 (имя) 
  • Контакт объекта 1 (телефон)
  • Контакт объекта 2 (имя) 
  • Контакт объекта 2 (телефон) 
  • Участок объекта 


В данном случае у нас уже создан клиент, поэтому не будем указывать адрес наряда и клиента, а укажем только внешний идентификатор клиента и его название. Адрес укажем у объекта. У объекта, как и у клиента, должен быть уникальный внешний идентификатор. Он будет использоваться в дальнейшем для создания нарядов по этому объекту.



После загрузки получим такой наряд:


Адресом наряда служит адрес объекта, а в контактах наряда указаны контакты объекта.

Вместе с нарядом был создан новый объект.


А у клиента, к которому мы привязывали этот объект, он появился на странице «Объекты».




5. Загрузка клиента с объектом

Попробуем добавить нового клиента с новым объектом. 



В этом примере укажем адрес клиента, но этого можно и не делать.

В результате загрузки у нас создался наряд, клиент и объект.


В данном случае в наряде используются адрес и контакты объекта.



К клиенту был привязан объект, его можно увидеть на странице «Объекты».


В объекте также указан клиент, к которому он привязан.



6. Загрузка второго объекта для клиента

Теперь рассмотрим случай, когда к уже существующему клиенту добавляется второй объект.

Не будем указывать адрес и контакты клиента, потому что он уже создан, в этом случае достаточно внешнего идентификатора и названия юр лица.


В результате загрузки будет создан наряд:


У созданного ранее клиента добавится новый объект:


А так выглядит объект, который создался:



6. Загрузка исполнителей


Кроме нарядов, клиентов и объектов можно загружать и исполнителей. Для этого нужна таблица с колонками:


  • Email исполнителя — адрес электронной почты исполнителя, должны быть уникальным;
  • Имя исполнителя;
  • Фамилия исполнителя;
  • Пароль исполнителя — пароль исполнителя для входа в приложение. Должен быть не короче 8 символов.


Таблица загрузки исполнителей


После загрузки таблицы будут созданы исполнители. У них будет доступ только в мобильное приложение. Каждому исполнителю будет выдана лицензия, поэтому перед загрузкой убедитесь, что у вас хватает свободных лицензий на новых исполнителей.


Загруженный исполнитель


Файлы с примерами загрузки исполнителей вы можете найти в приложении к этой инструкции.