Загрузка нужна для массового добавления данных вручную из файла. Если нужно загружать данные автоматизированно, то лучше использовать 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 символов.

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

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

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

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