====== Інтеграція з UserSide ======

Починаючи з Ubilling 0.7.2 підтримується нове API для [[http://wiki.userside.eu/UBilling|взаємодії з UserSide]] за допомогою безкоштовного модулю UserSide [[http://wiki.userside.eu/index.php/Usm_billing|usm_billing]].  Для повноцінної роботи будуть потрібні наступні опції **alter.ini**

<code ini>
USERSIDE_API=1
REMOTEAPI_ENABLED=1
USERSIDE_CASHTYPE=1
</code>

Слід також пам'ятати, що як ключ авторизації API, використовується ваш серійний номер Ubilling. Про те, де його шукати, можете прочитати у [[faq|FAQ]].

====== Підтримувані методи ======

На даний момент підтримується API версії 1.5 від 06.10.2017 з наступними методами:

  * get_supported_method_list
  * get_api_information
  * get_tariff_list
  * get_city_list
  * get_street_list
  * get_house_list
  * get_user_additional_data_type_list
  * get_user_state_list
  * get_user_group_list
  * get_system_information
  * get_user_list
  * get_user_tags
  * get_services_list
  * get_user_history
  * get_user_messages
  * change_user_data
  * get_supported_change_user_data_list
  * get_supported_change_user_state
  * get_supported_change_user_tariff
  * get_device_type
  * get_device_model
  * get_device_list
  * get_connect_list

А також наступні методи зміни даних користувача (change_user_data):

  * balance_operation
  * name
  * comment
  * tariff
  * state

 Що роблять ці всі штуки, ви можете дізнатися на сторінці [[http://wiki.userside.eu/%D0%A3%D0%BD%D0%B8%D0%B2%D0%B5%D1%80%D1%81%D0%B0%D0%BB%D1%8C%D0%BD%D0%BE%D0%B5_API|документації UserSide]].

====== Налаштування цього ======

Для роботи з цим функціоналом потрібно виконати такі дії:

  * в файлі /userside3/main/config/config.php дописати блок

<code php>
 $billingSynergy[99] = array(
    'url' => 'http://mydomain.com/billing/?module=remoteapi&key=наш_серійник_Ubilling&action=userside',
    'is_allow_change' => 1
 );
</code>
 
 Де:
  * 99 - номер біллінгу (Настройка - Біллинги)
  * url - URL біллінгу
  * my_key - api-ключ біллінгу
  * is_allow_change - флаг - що дозволяє зміну даних з-під UserSide в біллінгу. Якщо не включений, то здійснюється лише читання даних.

при правильному заповненні, на сторінці "Налаштування - Біллінги - потрібний білінг" буде видно результати прямого опиту білінгу

{{:usersideint0.png?|}}