Usm billing: различия между версиями

Материал из WiKi - UserSide
Нет описания правки
Строка 82: Строка 82:
== Параметры конфигурации ==
== Параметры конфигурации ==


  $znserver - адрес сервера биллинга
  $usersideUrl    - URL к ERP "UserSide"
$znbase - имя базы данных биллинга
  $usersideApiKey - API-ключ ERP "UserSide" ''(Указывается в файле "userside/main/config/config.php")''
$znuser - имя пользователя для доступа к базе биллинга
  $billingUrl    - URL к API биллинга
$znpass - пароль для доступа к базе биллинга
  $billingId      - Номер биллинга в ERP "UserSide" ''("Настройка - Биллинги")''
$zncp - кодировка базы биллинга
  $logPath        - Путь для записи логов
$zuserver - адрес сервера с UserSide
  $isSilence      - Флаг "Режим тишины" ''(скрыть вывод информационных сообщений от модуля в консоль)''
  $zubase - имя базы данных UserSide
$additionalDataMerge - Настройка импорта дополнительных данных/полей
$zuuser - имя пользователя для доступа к базе UserSide
$zupass - пароль для доступа к базе UserSide
$zucp - кодировка базы UserSide
$zusqlport - порт подключения к базе данных ''(по-умолчанию 3306)''
  $ps_logpath - путь к логам модуля
  $zbillcode - [[Настройка - Биллинги|номер биллинга]] по версии САП "UserSide"
  $zsilence - не выводить уведомления о работе модуля в консоль
 
  $zpass_give - сохранять пароль абонента в поле "доп.данные"
$zpass_onepass - использовать пароль биллинга как пароль входа абонента в UserSide ''(т.е. заменять пароль в UserSide паролем из биллинга)''

Версия от 15:45, 22 ноября 2015

Эта функция является одной из возможностью
обновления даты активности у объекта

usm_billing - модуль для организации импорта данных из биллинговых систем в ERP "UserSide" с использованием т.н. "универсального API"

Язык модуля: PHP

Текущая версия: см. на странице: Модули

Поддерживаемые стандартные биллинги: uBilling v.0.7.2+, MikBill v.2.8.16+

Статус модуля: Бесплатный

Перечень импортируемых данных *

* - может меняться в зависимости от того - какие именно данные отдаёт биллинг

Тарифные планы

  • название
  • размер абонентской платы
  • ежедневная или ежемесячная абонентская плата
  • входящая скорость
  • исходящая скорость
  • объем включённого трафика

Абоненты

  • учетная запись
  • ФИО
  • номер договора и дата
  • номер лицевого счета
  • текущий тарифный план
  • следующий тарифный план
  • дата последней активности в интернете
  • объем трафика потребленный абонентом за текущий месяц
  • адрес абонента (населенный пункт, улица, номер дома, корпус дома, квартира)
  • IP/MAC-адреса
  • статус работы в биллинге
  • заметки по абоненту
  • баланс
  • кредит
  • скидка по абоненту
  • 2 номера телефона
  • физическое/юридическое лицо
  • дата подключения к сети
  • адрес электронной почты
  • дополнительные поля/данные по абоненту (настраиваемо)

Информация по установке модуля

Архив usm_billing.zip содержит файлы

usm_billing.php
usm_billing.conf.php-example

1. Выделить отдельный (произвольный) каталог для модуля и поместить в него эти файлы

2. Выделить отдельный каталог для логов работы модуля. Дайте права на запись в этот каталог.

3. Пример файла конфигурации usm_billing.conf.php-example следует переименовать в usm_billing.conf.php и внести в нём требуемые изменения (перечень параметров указан ниже)

4. Запустите несколько раз (*) вручную модуль командой

php usm_billing.php

Он должен отработать без ошибок и вернуть данные:

usm_billing
====================================
 Start module at 2015-11-22 17:32:03
Finish module at 2015-11-22 17:32:14
====================================

* - При первом запуске - будут предварительно лишь созданы многие объекты. Чем больше объектов импортирует модуль - тем дольше это будет. При втором и последующих запусках сверяются изменённые данные и только они будут обновлены. Второй запуск также будет длиться долго, т.к. после первого запуска новосозданные объекты практические не содержат данных. А вот третий и последующие запуски будут работать гораздо быстрее.

5. Проверьте визуально полноту импортируемых данных в ERP "UserSide"

6. Когда станет понятно, что модуль работает стабильно - добавляем его в системный cron на периодическую работу (укажите нужные пути)

*/10 * * * * php usm_billing.php

Также ознакомьтесь с общей информацией для всех модулей

Параметры конфигурации

$usersideUrl    - URL к ERP "UserSide"
$usersideApiKey - API-ключ ERP "UserSide" (Указывается в файле "userside/main/config/config.php")
$billingUrl     - URL к API биллинга
$billingId      - Номер биллинга в ERP "UserSide" ("Настройка - Биллинги")
$logPath        - Путь для записи логов
$isSilence      - Флаг "Режим тишины" (скрыть вывод информационных сообщений от модуля в консоль)
$additionalDataMerge - Настройка импорта дополнительных данных/полей