04. Интеграция с Navixy
Для компаний, работающих в сфере интеграции и обслуживания систем мониторинга транспорта (GPS\ГЛОНАСС), мы разработали интеграцию с международной системой мониторинга Navixy.
Сценарий интеграции
В рамках интеграции реализована синхронизация базы транспортных средств клиентов в Navixy с базой объектов обслуживания клиентов в Okdesk.При синхронизации из Navixy копируется не только основная информация о транспортном средстве, но и текущие координаты. А значит, диспетчеру будет проще распределять заявки по транспортным средствам, видя их текущее положение на карте (и сопоставляя текущее местоположение транспортных средств с местоположением сервисных инженеров).
Предварительные настройки
Для того, чтобы интеграция была возможной, в вашем аккаунте Okdesk нужно провести ряд настроек:
- В карточку компании добавить атрибут типа "Строка" с кодом navixy_id и названием "Логин клиента в Navixy". Этот атрибут нужен для того, чтобы Okdesk "понимал", какая Компания в Okdesk соответствует какому клиенту в Navixy.
- В карточку объекта обслуживания добавить:
- Атрибут типа "Строка" с кодом navixy_vehicle_id и названием "ID ТС". В этом атрибуте будет храниться уникальный идентификатор транспортого средства (генерируется автоматически при создании карточки транспортного средства в Navixy). Значение этого атрибута будет "связью" между карточкой объекта обслуживания в Okdesk и карточкой транспортного средства в Navixy.
- Атрибут типа "Строка" с кодом navixy_tracker_id и названием "ID терминала". В этом атрибуте будет храниться ID терминала транспортного средства.
- Атрибут типа "Значение из списка" (не путать с "Набор значений из списка") с кодом navixy_tracker_model и названием "Модель терминала". В этом атрибуте будет справочно храниться название модели терминала, установленного на транспортном средстве.
- Атрибут типа "Строка" с кодом navixy_tracker_sn и названием "Серийный номер терминала". В этом атрибуте будет храниться серийный номер терминала транспортного средства.
- Атрибут типа "Строка" с кодом navixy_phone и названием "Телефонный номер терминала". В этом атрибуте будет храниться телефонный номер терминала транспортного средства (установленной в терминал SIM-карты).
- Атрибут типа "Строка" с кодом navixy_vehicle_vin и названием "VIN транспортного средства". В этом атрибуте будет храниться VIN транспортного средства.
Подключение интеграции
Для подключения интеграции необходимо совершить описанные выше предварительные настройки, после чего прислать в тех.поддержку Okdesk заявку на подключение. В заявке необходимо указать логин и пароль пользователя с правами администратора.
В случае, если передача в Okdesk реквизитов доступа пользователя с правами администратора неприемлема, вы можете попросить в технической поддержке Navixy создать для вашей компании специального пользователя с ролью техника, и прислать его логин и пароль.Логика синхронизации
Синхронизация транспортных средств осуществляется один раз в сутки. Логика синхронизации следующая:
- Для каждой компании, у которой заполнен строковый атрибут "Логин клиента в Navixy" (должен быть создан в соответствии с разделом "Предварительные настройки") осуществляется забор информации обо всех транспортных средствах клиента в соответствии с указанным в карточке компании логином. Для каждого транспортного средства:
- Проверяется наличие в карточке компании в Okdesk объекта обслуживания с аналогичным ID (хранится в Okdesk в созданном атрибуте "ID ТС"). Если такой объект обслуживания найден, то информация по нему обновляется (в том числе, обновляется координата);
- Если такой объект в карточке компании не найден, осуществляется поиск объекта с соответствующим "ID ТС" в карточках других компаний. Если он найден в карточке другой компании, осуществляется перенос объекта в новую компанию с последующим обновлением параметров (таким образом, если транспортное средство перешло из одной компании в другую, эта информация автоматически отразится в Okdesk);
- Если такой объект не найден ни в одной карточке компании в Okdesk, в текущей карточке компании будет создан новый объект, соответствующий новому транспортному средству.
- При создании и обновлении объекта обслуживания заполняются следующие поля:
- Название объекта обслуживания заполняется названием транспортного средства с добавлением гос. номера в Navixy;
- Добавленные атрибуты "ID ТС", "ID терминала", "Модель терминала", "Серийный номер терминала", "Телефонный номер терминала" и "VIN транспортного средства" заполняются соответствующими значениями из Navixy;
- В поле "Адрес" объекта обслуживания записываются текущие координаты транспортного средства.
Загрузка данных...