Как добавить конфигурацию к партнёру

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

Как добавить конфигурацию к партнёру:

В панели администратора перейдите в раздел «Партнёры»

2. Дважды кликните на выбранного партнера — откроется окно с настройками

3. Перейдите во вкладку «Конфигурация» и нажмите кнопку «Добавить»

Вернуться наверх

4. В раскрывающемся списке выберите нужную конфигурацию и укажите значение для неё

Выбор конфигурации

Вернуться наверх

5. Нажмите «Обновить» и сохраните изменения во вкладке «Конфигурация»

Воспользуйтесь иконками, чтобы изменить конфигурацию

или удалить

Используйте кнопку «Экспорт» для сохранения настроек текущего договора в файл формата JSON. Чтобы применить ранее сохранённые настройки к другому договору, используйте кнопку «Импорт» и выберите сохранённый JSON-файл.

Экспорт и импорт шаблона конфигураций

Вернуться наверх

Список конфигураций

Чтобы посмотреть список конфигураций, нажмите на кнопку «Список конфигураций».

Вернуться наверх

В списке отображаются все конфигурации, которые вы можете добавить в системе.

Конфигурации партнёра

В системе предусмотрен список доступных конфигураций, которые можно задать для партнёра.

Каждая конфигурация состоит из:

Название — имя настройки
Ключ (значение) — техническое имя параметра, которое используется системой

Если партнёру требуется особая логика работы (например, подключение SMS-провайдера, изменение отображения баланса, интеграция с Helpdesk, Twilio, Here Maps и т.д.), соответствующая конфигурация добавляется с нужным значением.

Пример:

Для отображения баланса в днях вместо денег используется ключ balance_in_days = 1
Для подключения Telegram-бота указывается адрес бота, например: @PilotGpsBot
Для подключения SMTP или SMS-провайдера указываются параметры авторизации в виде объекта (логин, пароль, ключ API и т.п.)

Список возможных конфигураций у партнёра

Название

Значение

Описание

Поддержка и Helpdesk

Support Url

support_url

Адрес для перехода в техническую поддержку из личного кабинета.

По клику на иконку «поддержка» пользователь попадает именно сюда.

Может быть:

обычной ссылкой на сайт поддержки
или mailto:support@domain.com, тогда сразу открывается письмо

support_link

Прямая ссылка на страницу поддержки/портал helpdesk, например:

https://example-support.com/login

okdesk

При нажатии на кнопку «? (Помощь)» в PILOT пользователь перенаправляется на портал поддержки Okdesk (https://help.iglit.ru/)

okdesk_link

Прямая ссылка на страницу поддержки Okdesk

okdesk_key

Ключ интеграции с Okdesk

helpdeskeddy

Включает интеграцию с системой поддержки Helpdeskeddy

helpdeskeddy_link

Ссылка на портал Helpdeskeddy

helpdeskeddy_key

API-ключ Helpdeskeddy

Интерфейс

Main Tab

main_tab

Установить вкладку «Основные»

Address in Online Tree

adress_in_tree

Добавляет колонку «Адрес» в дереве объектов на вкладке «Онлайн». При большом количестве объектов может немного замедлять интерфейс

edit_car_model

Разрешает партнёру редактировать список марок и моделей автомобилей

Subpartner price

partner_price

Цена, по которой партнёр платит компании «Скай Электроникс» за услуги

Показывать марку и модель в отчётах

model_and_mark_in_reports

Добавляет марку и модель автомобиля в некоторые отчёты (для Кольцово)

Language Pilot edit

languages_pilot_edit

Открывает в меню пункт управления языками интерфейса PILOT.

В значении через запятую указываются языки, которые можно редактировать (например: ru,en)

Root column in accounts

root

Добавляет колонку Root в разделе договоров

Additional languages

languages

Список дополнительных языков интерфейса, разделённых запятыми

Font settings

font_settings

Настройка шрифта для партнёра.

Это объект, где ключ — язык, а значение — параметры шрифта. Пример:

{

"ru": {

"url": "https://fonts.gstatic.com/s/lobster/v22/neILzCirqoswsqX9zo-mM5Ez.woff2",

"font-family": "Lobster"

}

SMS и коммуникации

smsgetway24

Настройки интеграции с сервисом https://smsgateway24.com.

Пример:

{

"login": "...",

"password": "...",

"device_id": "..."

}

twilio

Интеграция с SMS-сервисом Twilio.

Пример:

{

"sid": "sid",

"token": "token"

}

TNF SMS Provider

tnf_sms_provider

Подключает провайдера TNF и меню «СМС-карты TNF SMS»

Sms provider

smsprovider

Выбор, через какого провайдера отправлять SMS для партнёра

Etisalat SMS Provider

etisalat_sms_provider

Настройки отправки SMS через Etisalat, например:

{

"username": "demo",

"api_key": "generated in api site",

"account_id": "copy from profile in api site"

}

Emnify SIM Provider

emmnify_sms_provider

Настройки SIM-карт Emnify (https://portal.emnify.com), пример:

{"application_token": "token"}

Endless sms

endless_sms

Настройка включает режим безлимитных SMS.

Если значение ключа равно 1, система переводит партнёра в режим неограниченной отправки SMS:

баланс SMS может уменьшаться до -1
после достижения -1 списание больше не производится

email_send_invoices_settings

Настройки отправки счетов клиентам по электронной почте

unsubscribe_url

Ссылка для отписки от email-уведомлений

sim_mts

Настройка кабинета МТС по SIM-картам

Opsos list

Пример:

[

{"name": "МТС"},

{"name": "Мегафон"},

{"name": "Beeline"},

{"name": "t2"}

]

Настраивает список SIM-операторов для выбора в поле «Оператор (SIM-провайдер)» в карточке транспортного средства.

Список формируется на уровне сервера и отображается в виде выпадающего меню.

Links Field (links_field_sms_provider)

Пример:

{

"access_key": "demo_access_key_1234567890abcdef",

"secret_key": "demo_secret_key_abcdef1234567890"

}

Интеграция с провайдером SIM-карт (SMS-провайдером) через Links Field.

В конфигурации указываются ключи доступа к API провайдера:

access_key — публичный ключ доступа к сервису

secret_key — секретный ключ для авторизации запросов

Для корректной работы интеграции у каждого транспортного средства должно быть заполнено поле ICCID — это уникальный идентификатор SIM-карты.

Telegram bot

Пример:

@PilotGpsBot

Настройка для добавления быстрого перехода в Telegram-бота из личного кабинета пользователя.

В параметре указывается адрес бота.

В меню «Дополнительные настройки» в личном кабинете пользователя появится кнопка быстрого перехода в Telegram-бот

Память и производительность

Low Memory

lmem

Включает режим оптимизации для работы с большим количеством ТС

queue_max_items

Ограничивает, сколько элементов за один раз обрабатывается из очереди — чтобы система работала стабильнее

Безопасность и авторизация

Auth Token

auth_token

Токен, используемый для сброса пароля

2FA_Email

2FA_email

Включение двухфакторной аутентификации по электронной почте

password_policy

Настройка политики сложности паролей.

true (1) — политика паролей включена. Пользователи должны создавать пароли, соответствующие установленным требованиям
false (0) — политика паролей отключена

TOTP Label

totp_label

Настройка задаёт название (подпись), которое будет отображаться в приложении двухфакторной аутентификации при добавлении учётной записи.

Эту строку пользователь увидит в своём приложении (например, в Google Authenticator или Microsoft Authenticator) рядом с кодами подтверждения

Single Driver

single_driver

Если включено — при подключении нового водителя к ТС предыдущая сессия водителя автоматически закрывается (один активный водитель на машину)

Block partner

timestamp_block_partner

Момент времени, начиная с которого партнёр считается заблокированным

is_block_vehicles_stock_account

Заблокировать объекты

Карты и геокодер

HERE API Key

here_api_key

Ключ для использования карт HERE

StadiaMaps

stadiamaps

Подключение карт stadiamaps.com

Geocoder

geocoder

Настройка сервиса геокодирования

Web Socket

Включение WebSocket-соединений

pilot_map_url

Если указан, ссылки на координаты из писем будут открываться на карте PILOT по этому адресу

windy_api_key

Пример значения:

4epwZKT8fdOIe6Boq2gbhdfs50ky

API-ключ для интеграции с Windy.com. Он используется для подключения погодного сервиса и отображения погодных данных в системе.

После добавления корректного API-ключа:

— в настройках слоёв карты появится чекбокс Weather

— станет доступен выбор погодных моделей (в зависимости от тарифа)

— можно будет включать погодные слои (ветер, температура, давление и др.)

Настройки Яндекс API Маршрутизатора

yandex_route_apikey

Ключ API

yandex_route_mode

Способ перемещения по маршруту

yandex_route_avoid_tolls

Не использовать платные дороги

yandex_route_avg_weight

Средняя масса ТС, т.

yandex_route_max_weight

Максимальная масса ТС, т.

Цены и доступность цен

hide_subpartner_price

Скрывает от партнёра колонки с субпартнёрскими прайсами, чтобы он не видел стоимость объекта у основного партнёра

Hide main partner prices

hide_main_partner_prices

Скрывает цены основного партнёра для субпартнёра

Only private prices

only_private_prices

Включает режим, когда используются частные цены

Спрятать / показать элементы

hide_device

Скрывает технические данные устройства в карточке объекта.

При включении из карточки объекта убираются поля, связанные с типом устройства и SIM-картами, например:

uniqid, additional_imei, iccid, msisdn, opsos1, msisdn2, opsos2, conf и другие технические параметры устройства.

Используется, если партнёру или пользователям не нужно видеть детали прибора (IMEI, SIM, тип устройства и т.п.).

Hide_fields

Скрыть любые выбранные поля в карточке объекта.

В значении конфигурации указывается список полей через запятую, которые необходимо скрыть. Например: vin,engine,year,color

Система поддерживает скрытие следующего перечня параметров:

name,uniqid,additional_imei,car_mark,car_model,car_mod,file,msisdn,iccid,opsos1,msisdn2,opsos2,color,type,ico,tags[],conf,parent,tempale,time_zone,initial_mileage,initial_motor_hours,time_shift,info,rfid,card_num,terminal_id,model,request_fines,gibdd_car_owner,gibdd_car_number,gibdd_region,auto_gibdd_id,lat,lon,un,garmin,id,agent_id,year,vin,engine,engine_cap,engine_horse,full_capacity,seating_capacity,choose_lic_type,license,lic_exp,ins_sert,ins_exp,driver_name,driver_phone,speed_parameter,speed_formula,speed_type,minspeed,mintime,minparking,maxflylength,cons_ignition,fix_speed,can_mileage,split,split_buslines,minsat,maxhdop,maxspeed,formula,speed_limit,lost_connection_time,minimum_idle,minimum_idle_cons_ignition,zones,zones_idle,zones_control,zones_sos,zones_speedlimit,zones_photo,recalc_zones,summer_fuel,winter_fuel,idle_fuel,mh_fuel,summer_start,winter_start,fuel_type,fuel_norm_type,fuel_price,fuel_tank_capacity,summer_gas,winter_gas,idle_gas,eco_zone_fine,eco_driver_fine,eco_speeding_fine,eco

hide_finances

Скрывать финансы

Работа с объектами

Add object idle send alert setting

add_vehicle_send_alert_idle

Добавить оповещение для простоя

Add object idle setting

add_vehicle_idle

Добавить учёт простоя

Add object speed limit setting

add_vehicle_speed_limit

Добавить ограничение скорости

Add object speed limit send alert setting

add_vehicle_send_alert_speed

Добавить оповещение для контроля скорости

Add object connection lost send alert setting

add_vehicle_send_alert_lost

Добавить оповещение для потери связи

Add object connection lost setting

add_vehicle_connection_lost

Добавить функцию «Потеря связи»

Event max speed

event_max_speed

Добавить максимальную скорость для фильтра событий

Add object consider ignition setting

add_vehicle_consider_ign_1

Добавить учёт зажигания

Add object idle consider ignition setting

add_vehicle_consider_ign_idle

Добавить оповещение для учёта зажигания

Add object fix speed setting

add_vehicle_fix_speed

Добавить коррекцию скорости при построении треков

Add object max points dist setting

add_vehicle_max_points

Добавить настройку максимального расстояния между точками трека

Add object mileage by can setting

add_vehicle_can_mileage

Добавить пробег по CAN-шине

Add object min parking time setting

add_vehicle_min_parking_time

Добавить минимальное время фиксации парковки

Add object min speed setting

add_vehicle_min_speed

Добавить минимальную скорость для регистрации поездки

Add object min tracks split time setting

add_vehicle_min_tracks_time

добавить минимальное время между поездками для их разделения

Minimum number of satellites

add_vehicle_minsat

Добавить минимальное количество спутников

Max HDOP

add_vehicle_maxhdop

Добавить максимальное значение HDOP

obj_types_for_task

Список идентификаторов типов объектов, для которых разрешено создавать задания в модулях ПТМ и «Логистика»

veh_types_for_task

Список идентификаторов типов ТС, которые можно назначать в заданиях ПТМ или «Логистике».

Идентификаторы указываются через ","

Настройка используется как дополнительный фильтр и работает совместно с конфигурацией obj_types_for_task

edit_car_models

Редактирование моделей транспорта

Создание договоров и пользователей

Contract API auto create new contract

contract_api_auto_create_new

Если значение равно 1, система работает следующим образом:

при создании нового контракта на транспортное средство, у которого уже есть активный контракт:

текущий активный контракт автоматически закрывается
новый контракт создаётся автоматически

new_user_settings

Новые пользовательские настройки

map_new_accounts

Настройка автоматической привязки новых договоров к выбранным пользователям.

В конфигурации партнёра можно создать ключ map_new_accounts.

В качестве значения указывается список ID пользователей через запятую, к которым должны автоматически привязываться все новые договоры этого партнёра.

При создании нового договора система проверяет, указан ли у партнёра ключ map_new_accounts. Если ключ есть — появляется подтверждение, нужно ли привязать договор к указанным пользователям. При подтверждении договор автоматически добавляется в таблицу маппинга и становится доступен этим пользователям

Прочие настройки

Time control module

Активация модуля контроля времени

Tires

tires

Конфигурация временных шин

Fota Tokens

fotaTokens

Список токенов для работы с Teltonika FOTA

fine_api

Ключи/параметры интеграции с сервисом по работе со штрафами

SFDA

Активирует дополнительную логику системы для складских (warehouse) компаний

в рамках модуля WASL

Wasl Price

wasl_price

Настройка стоимости для модуля WASL

Максимальное количество дней для перерасчета

max_day_recalc

Определяет максимальный период (в днях), за который разрешено выполнять перерасчёт данных

Confirm adding vehicles to notifications

confirm_adding_vehicles_to_notifs

Настройка отвечает за показ окна подтверждения при добавлении транспортных средств в уведомления из сопоставленных (связанных) учётных записей.

Если параметр включён:

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

Currencies

GHS

Валюта

Default language

eng

Язык по умолчанию

Partner Grace Period (days)

grace_period

Льготный период для партнеров (дней)

min_speed_limit_check

Проверка минимального порога скорости

Modules list

mod_list

Список идентификаторов модулей, подключённых к договору или партнёру

auto_notifications

Настройка автоматической отправки уведомлений

only_tags_model

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

Pilot7

pilot7

Включение интерфейса Pilot7

pulse

Параметры подключения к Pulse. В конфигурации указываются логин, пароль и хост

Как добавить конфигурацию к партнёру