1. Как работает интеграция

Для интеграции используется обработка для 1С:УНФ (версия 1С 8.3 и выше).


Наряды в Планадо создаются из данных заказ-наряда 1С.


Заказ-наряд 1С должен находиться в состоянии «К выгрузке» (состояние настраивается), чтобы обработка выбрала заказ-наряд и создала по нему наряд в Планадо.


В Планадо наряд создается по заранее настроенному шаблону. Шаблон наряда Планадо для заказ-наряда 1С настраивается в обработке.


В наряд Планадо переносятся прикрепленные файлы из 1С (договор, pdf-файл с описанием работы и т. п.)


После того, как выездной сотрудник начинает вносить любое изменение в наряд Планадо: начинает работу с нарядом, заполняет отчет, делает фотографии и т.п. при следующем запуске обработки данные в заказ-наряде 1С обновляются. Состояние заказ-наряда 1С изменяется на «Обновлён в Планадо» (состояние настраивается), а в дополнительные сведения по заказ-наряду 1С загружаются все данные из наряда Планадо (все данные по наряду).


После того, как выездной сотрудник завершает наряд, состояние заказ-наряда 1С меняется на «Завершен» (состояние настраивается). 


В случае, если в процессе работы в Планадо данные по наряду изменялись несколько раз, то эти же данные обновляются в заказ-наряде 1С.


Все фотографии и файлы переносятся из отчёта по наряду Планадо в присоединенные файлы заказ-наряда 1С.


Запасы, работы, материалы переносятся из заказ-наряда 1С в Планадо в текстовом виде.


2. Подключите интеграцию

Интеграция подключается с помощью API-ключа Планадо. Чтобы его получить, перейдите на вкладку «Настройки» → «Интеграции» → «API».






Если у вас ещё не сгенерирован API-ключ, нажмите на кнопку «Получить новый ключ». 



Скопируйте сгенерированный API-ключ.



Перейдите в 1С:УНФ.

Откройте обработку интеграции с Планадо.

В меню «Настройки обмена» в строку «API-ключ» вставьте скопированный из Планадо API-ключ. В строке «Домен» введите название своего домена.


Название домена — это первая часть адреса вашего домена Планадо. Например, если у вас адрес https://mikoteam2.planadoapp.com, то название домена будет mikoteam2.




3. Настройте состояния заказ-наряда


В 1С:УНФ для заказ-наряда добавьте новые состояния: «К выгрузке», «Выгружен» и «Обновлен в Планадо», либо придумайте свои названия.

Выберите в настройке обработки эти состояния, как показано на скриншоте:



Состояние заказ-наряда «К выгрузке» – в этом состоянии заказ-наряд будет перенесен в Планадо при следующем запуске обработки.

Состояние заказ-наряда «Выгружен» – наряд-заказ перейдет в это состояние после того, как обработка создаст наряд в Планадо.

Состояние заказ-наряда «Обновлен» – если наряд в Планадо изменен, например, был заполнен отчет, то данные из наряда будут перенесены в заказ-наряд, и заказ-наряд изменит свое состояние на это.

Состояние заказ-наряда «Закрыт» – если наряд в Планадо завершен, то заказ-наряд будет переведен в это состояние.


4. Настройте шаблон Планадо

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

Создание шаблонов в Планадо описано в инструкции.

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

В шаблон нужно добавить дополнительные поля для отчета, который будет заполнять ваш выездной сотрудник и которые нужно будет перенести обратно в заказ-наряд 1С.


Обработка выбирает по какому шаблону создавать наряды в Планадо по следующему алгоритму: берется значение поля «Вид» из заказ-наряда и по этому значению подбирается имя шаблона в таблице соответствий:

В этом примере по виду заказ-наряда «Экспресс-обследование» в Планадо будет создаваться наряд по шаблону «Обследование»


Если таблицу соответствий оставить пустой, то наряд будет создаваться по шаблону, название которого совпадает с названием вида заказ-наряда.

5. Настройте другие параметры 

Настройка «Число дней выгрузки заказ-нарядов» задает глубину просмотра нарядов в днях при выборке тех нарядов, которые будут перенесены в Планадо. 


Например, если установить значение 7, то в обработку попадут заказ-наряды за последнюю неделю.


Если установить значение «0», то отбор по дате отключается. Задавать значение «0» не рекомендуется, так как при большом количестве нарядов обработка будет работать медленно.



Настройте расписание работы обработки.

Чтобы запускать обработку по расписанию, её нужно добавить в справочник «Дополнительных отчетов и обработок». Для этого в списке справочника нажмите «Добавить из файла». После этого откроется окно: 

Выберите в нём «Интеграция с Планадо: Открыть для настройки и отладки» и нажмите «Выполнить».


После запуска обработки в интерактивном режиме можно задать расписание регламентного выполнения, то есть в фоне. Для этого нужно отметить галочкой поле в строке «Интеграция с Планадо: По расписанию» и в колонке с ?. После этого откроется форма расписания.




6. Как проверить работу интеграции

Переведите один из заказ-нарядов в состояние «К выгрузке». 

Запустите обработку.



Пример наряда, созданного после работы обработки:




Ваш заказ-наряд был передан в Планадо. 

Зайдите в Планадо.

Назначьте наряд на выездного сотрудника, если он не был выбран в заказ-наряде.

Откройте мобильное приложение, войдите туда под этим сотрудником.

Начните выполнять наряд.

Заполните поля отчета.

Запустите обработку интеграции в 1С. Данные из наряда будут перенесены в заказ-наряд. 


Данные, переданные в заказ-наряд 1С из Планадо:




 Файлы, подписи и фотографии загружаются в «Присоединенные файлы» заказ-наряда:


Файлы и фотографии из наряда Планадо



После завершения наряда в Планадо данные будут обновлены в заказ-наряде 1С, при следующем запуске обработки.