Интеграции

На странице «Интеграции» администратор связывает Terake с другими системами: телеметрией (например, Navirec, SkyFMS, John Deere, Wialon, Metrotec, Mapon, FleetComplete), заправкой (Alexela, Piusi B.Smart), бухгалтерией (Directo) и TTKI Налогово-таможенного департамента Эстонии. Каждое подключение — это отдельная интеграция, для которой вы вводите данные для входа, полученные от партнёра, или даёте Terake разрешение в системе партнёра на чтение данных.

Структура страницы

• Кнопка «Добавить новую интеграцию» открывает форму новой интеграции.
• В таблице перечислены интеграции компании со столбцами «ID» и «Интеграционный партнер». С одним и тем же партнёром может быть несколько интеграций, например, два разных аккаунта.
• Над таблицей находятся поле поиска и кнопки для загрузки таблицы в виде файла Excel или PDF и для выбора столбцов.
• Чтобы открыть интеграцию, нажмите на её строку. Откроется окно «Изменить интеграцию».

Как добавить интеграцию

1. Нажмите «Добавить новую интеграцию».
2. Выберите «Интеграционный партнер». На форме появятся поля для этого партнёра.
3. Заполните поля партнёра или дайте разрешение в системе партнёра, как описано ниже для соответствующего партнёра.
4. Нажмите «Сохранить» или «Сохранить и закрыть».

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

Настройка партнёров

Navirec

1. Выберите Navirec в качестве партнёра. На форме есть поле «Apikey» и адрес для запроса ключа («URL получения Apikey»).
2. Введите ключ, полученный от Navirec, в поле «Apikey» либо введите имя пользователя и пароль Navirec в нижних полях формы и нажмите «Получить ключ от Navirec». Запрос автоматически копирует ключ в поле «Apikey». Terake не сохраняет имя пользователя и пароль.
3. Сохраните интеграцию.

SkyFMS

1. Выберите SkyFMS в качестве партнёра и нажмите кнопку www.skyfms.com. В новом окне откроется страница входа SkyFMS.
2. Войдите в свой аккаунт SkyFMS и разрешите Terake доступ к данным. Если разрешение дано успешно, вы увидите сообщение «All done! Please close this browser window». Закройте это окно.
3. Сохраните интеграцию в Terake.

John Deere

1. Выберите John Deere в качестве партнёра и нажмите расположенную ниже кнопку с текстом «Предоставить доступ в John Deere». В новом окне откроется страница входа John Deere.
2. Войдите в свой аккаунт John Deere и предоставьте Terake нужные права.
3. Сохраните интеграцию в Terake.

Wialon

1. Выберите Wialon в качестве партнёра и нажмите «Войдите в Wialon, чтобы получить новый Apikey».
2. В открывшемся окне войдите в свой аккаунт Wialon и подтвердите доступ.
3. После входа окно закроется, интеграция будет сохранена, а на форме появятся поля «Apikey» и «URL-адрес API» и список машин Wialon.

Metrotec и Alexela

Введите «Имя пользователя» и «Пароль», полученные от партнёра, и сохраните. При интеграции с Alexela заправки Alexela поступают в Terake.

Piusi B.Smart

1. Войдите в систему Piusi B.Smart, выберите «Settings» и «API», включите «Enable API for Export» и нажмите «Generate».
2. Скопируйте полученные там значения в поля «Client ID» и «Client Secret» формы Terake и сохраните.

При интеграции с Piusi в Terake поступают заправки, зарегистрированные в системе Piusi B.Smart. О загрузке заправок читайте на странице Заправки.

Directo

1. Выберите Directo в качестве партнёра, введите «Apikey», полученный от Directo, и адрес Directo в поле «URL-адрес API».
2. Сохраните интеграцию.

Из Directo Terake получает работников, проекты в виде рабочих объектов и клиентов, праздники и другие отсутствия в график работы, а также машины. Terake отправляет в Directo часы работников и часы машин по подтверждённым работам, по дням. Отправкой вы управляете в таблице «Взаимодействие с Directo» внизу формы сохранённой интеграции:

1. Выберите период и нажмите «Показать». Для каждого дня таблица показывает «Работ», «Утверждено», «Не утверждено», «Название отчета», «Время отправки» и «Результат».
2. Когда все работы дня подтверждены, нажмите «Отправить» в строке этого дня. Если в дне есть неподтверждённые работы, в строке написано «Wait workdones to be approved»: сначала подтвердите их на странице Утверждение.
3. Уже отправленный день можно отправить повторно кнопкой «Отправить повторно», а отправленный файл — скачать кнопкой «.xml». При успешной отправке в столбце «Результат» показано OK, в противном случае — сообщение об ошибке от Directo.

Maksuamet TTKI

Интеграция TTKI отправляет данные о въезде и рабочем времени на строительных объектах (рабочих участках) в реестр работников Налогово-таможенного департамента Эстонии. Запросы делаются от имени компании с личным кодом администратора, который первым успешно загрузил данные TTKI, поэтому в карточке вашего работника должен быть указан личный код. Выберите Maksuamet TTKI в качестве партнёра и сохраните. На форме три вкладки:

• «Сотрудники ТТКИ»: работники, зарегистрированные в TTKI. При открытии вкладки список загружается из TTKI, а недостающие работники добавляются в Terake. Если работник не был связан с нужным работником Terake, нажмите «Изменить» в его строке, выберите работника и нажмите «Сохранить». «Обновить» загружает список заново.
• «Рабочие участки ТТКИ»: рабочие участки компании в TTKI. Свяжите каждый рабочий участок с рабочим объектом Terake: нажмите «Изменить», выберите «Место работы» и нажмите «Сохранить». Работы, выполненные на связанном рабочем объекте, создают отчёты TTKI.
• «Отчеты ТТКИ»: выберите период и посмотрите «Количество записей», «Записи для экспорта», «Время отправки» и «Результат» по каждому дню и рабочему объекту. Кнопка «Количество записей» открывает отчёт о работах дня, кнопка «Записи для экспорта» — отправленные записи. Неотправленные данные прошедшего дня отправляйте кнопкой «Отправить», а уже отправленные данные — повторно кнопкой «Отправить повторно».

Другие партнёры

Для остальных партнёров (например, Mapon, FleetComplete) введите ключ, полученный от партнёра, в поле «Apikey» и сохраните.

Как проверить, связаны ли машины

Телеметрическая интеграция приносит местоположение, пробег и моточасы машин, и на их основе создаются работы машин. Данные связываются с машиной Terake по регистрационному номеру, VIN-коду или полю «Ключ интеграции (рег. номер без пробелов)».

1. Откройте сохранённую телеметрическую интеграцию.
2. Нажмите «Показать автомобили из указанного API».
3. В таблице «Список транспортных средств от провайдера API» перечислены машины партнёра со столбцами «Источник», «Рег. номер», «Имя», «Дополнительно», «VIN код» и «Внешний ID / ID 2». Если один и тот же регистрационный номер или VIN-код встречается несколько раз, он выделен красным и отмечен «Ошибка: дубликат».
4. Убедитесь, что у машин Terake на странице Машины и оборудование те же регистрационные номера или VIN-коды.

Если партнёр возвращает ошибку (например, неверный ключ), вместо списка показывается сообщение об ошибке. У интеграций заправки, Directo и TTKI кнопки списка машин нет.

Кто может это видеть и изменять

Страницу видит, а интеграции добавляет, изменяет и удаляет «Администратор». Данные Directo и TTKI также отправляет администратор.

Советы

• Храните ключи и пароли партнёров только в форме интеграции; не пересылайте их в письмах или файлах.
• Если телеметрические данные не доходят до машины, проверьте в списке машин, совпадает ли регистрационный номер у партнёра и в Terake. Телеметрические данные загружаются каждые несколько минут, см. Автоматические процессы.
• Заправки из интеграций вы видите на странице Заправки, а остатки топлива и настройки заправки — на странице Настройки заправки.