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


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


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

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



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


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

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


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

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



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


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

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

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

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

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

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

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


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

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


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


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

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

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


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

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

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

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


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

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

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


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

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


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

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


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


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

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


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


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

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

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


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

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


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

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


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


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

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

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


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


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

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

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


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


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

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

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

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



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

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


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

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


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

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

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


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

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

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


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

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

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