====== Загрузка PON информации абонента из UserSide ======

  * [[https://wiki.userside.eu/UserSide_API_Key|Настройка API на стороне UserSide]]
  * [[https://wiki.userside.eu/API_device#get_pon_level_history|Используемое API UserSide]]

<alert type="warning">Требуется версии API UserSide не ниже 3.16</alert>

С версии 3.12.11 доступна функция получения информации о PON статусе абонента из UserSide.
{{:billing:photo_2022-06-06_15-30-58.jpg?600|}}

===== Настройка =====

=== Включение модуля ===
\\ Необходимо включить модуль UserSide PON в системных опциях, для этого перейдите в Настройки => Системные опции => Внешние интеграции, раздел UserSide PON.

{{:billing:userside_pon_settings_1.jpg?600|}}

\\ **Разрешить** - Включает модуль UserSide PON
\\ Отладка - в файл /var/log/mikbill/admin/debug.log (если он существует) будет записан запрос/ответ к UserSide
\\ **UserSide API Host** - домен где находится UserSide (включая http:// или https://)
\\ **UserSide API key** - ключ API UserSide
\\
\\

=== Устройства абонента ===
\\ Билинг отправляет запрос в UserSide только для устройств абонента у которых установлен тип "**ONU/ONT**" и  заполнено поле **MAC address** или **Serial Number**.
\\ Нужно зайти в типы устройств пользователя по пути Настройки => Система => Типы устройств пользователя и в свойствах выбрать нужный тип.

{{:billing:userside_pon_settings_2.jpg?500|}}

Теперь при открытии карты абонента, если у него будет добавлено устройство с типом ONU/ONT и заполненными полями, билинг отправит запрос в UserSide и добавит ответ к параметрам устройства абонента.