Модули

В данной статье рассматривается процесс перепродажи модулей ispmanager.

Общая схема перепродажи модулей

Для удобства клиентов процесс покупки коммерческих модулей ispmanager по умолчанию осуществляется через личный кабинет.

Однако существует альтернативная возможность - перепродажа модулей. Возможно самостоятельно принимать оплату от конечных пользователей за модули и обеспечивать оформление заказа непосредственно в личном кабинете компании ispmanager. Это позволяет более гибко управлять продажами и обслуживанием клиентов, а также адаптировать процесс под собственные потребности и стратегию бизнеса.

 

Процесс перепродажи модулей в ispmanager основан на простой и эффективной схеме.

  • Выбор и заказ модуля. Находясь в ispmanager, можно увидеть цены на модули, которые предоставлены партнером. При необходимости выберите нужный модуль и нажимает кнопку Купить;
  • Перенаправление на сайт/личный кабинет партнера. После нажатия на кнопку Купить автоматически произойдет перенаправление на веб-сайт или личный кабинет партнера. Здесь можно продолжить оформление заказа и выполнить оплату выбранного модуля;
  • Заказ модуля в ispmanager. Можно осуществить заказ модуля пользователя в ispmanager. Это можно сделать как автоматически через API, так и вручную в личном кабинете ispmanager;
  • Обновление данных о лицензии и модуле. После размещения заказа ispmanager обновляет данные о лицензии пользователя и получает информацию о купленном модуле. Это гарантирует корректную активацию и использование модуля со стороны клиента.

 

Для успешной реализации схемы перепродажи модулей ispmanager необходимо выполнить следующие шаги.

1. Уведомить сотрудников ispmanager о URL учетной системы.

Первым шагом необходимо связаться с сотрудниками ispmanager и предоставить им URL системы учета, в которой будут запрашиваться цены на модули и которая будет обрабатывать заказы. Это позволит установить необходимую связь и интеграцию между системами.

2. Реализация функции pricelist.export.

Необходимо реализовать функцию pricelist.export в своей системе. Эта функция будет ответственной за возврат актуальных цен на модули, которые предлагаются для перепродажи. Это позволит видеть актуальные цены в ispmanager.

3. Обеспечение заказов модулей.

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

 

Определение цен на модули

Ispmanager обеспечивает удобный механизм определения цен на модули через запросы к учетной системе. 

Запрос функции pricelist.export

Ispmanager инициирует запрос к учетной системе партнера с использованием функции pricelist.export. Запрос выглядит следующим образом.

https://api.ispmanager.ru/billmgr?func=pricelist.export&itemtype=addition&onlyavailable=on&out=xml
Пояснение

 

 Запрос ожидается в формате XML.

<doc>
  <pricelist>
    <id>23221</id>
<name>DDoS-GUARD</name>
   <intname>DDoSGUARD</intname>
    <additionintname>DDoSGUARD</additionintname>
    <price currency="RUB">
      <period cost="950.0000" type="month" length="1">monthly</period>
    </price>
  </pricelist>
</doc>

Для понимания информации о модулях в формате XML важно разобраться в следующих ключевых элементах.

  • id - идентификатор тарифа модуля, который соответствует определенному модулю (смотрите таблицу ниже для соответствий);
  • additionintname - служебное название модуля, предоставляющее информацию о типе или категории модуля;
  • price - стоимость модуля за указанный период времени. При покупке и загрузке цены всегда используется с параметрами type="month" и length="1". Это обозначает цену за месяц;
  • intname - еще одно служебное название модуля, предоставляющее информацию о типе или категории модуля;
  • name - название модуля.
Обратите внимание!
  • Отсутствие цен в XML и кнопки Купить. Если ispmanager не обнаружит цен на определенный модуль во возвращаемом XML-документе, то такие модули не будут отображаться на панели управления. Это означает, что не будет возможности видеть кнопку Купить для модулей, для которых цены не указаны;
  • Отсутствие не поддерживаемых модулей. Ispmanager также не будет отображать модули на своей странице, даже если они указаны в XML, если эти модули не поддерживаются данной панелью. Важно учитывать, что нельзя добавить произвольные модули, которые не совместимы с панелью управления ispmanager. 

 

 

Индикаторы тарифов модуля

Для клиентов РФ

ВерсияID модуля (pricelist)
Dr.Web 55379
DDoS-GUARD23221
URL личного кабинета https://my.ispmanager.ru/billmgr

 

Для клиентов других стран

ВерсияID модуля (pricelist)
Dr.Web55363
DDoS-GUARD 23221
URL личного кабинетаhttps://eu.ispmanager.com/billmgr

Заказ и обработка модулей

При покупке модуля конечным пользователем, ispmanager автоматически отправляет запрос на URL учетной системы партнера с данными о заказе. 

https://<URL партнера>/billmgr?module=<служебное имя модуля>&license=<ID лицензии>&ip=<IP лицензии>&module_id=<ID модуля>

module - cлужебное имя модуля; 

license - идентификатор лицензии в ispmanager;

IP - IP-адрес лицензии в ispmanager (по желанию);

module_id - идентификатор заказываемого модуля.

 

Обратите внимание!
Этот запрос может быть обработан как вручную, так и автоматически.

 

Ручной заказ модуля 

Авторизуйтесь в личном кабинете ispmanager. Закажите модуль для лицензии вручную.

Автоматический заказ модуля 

В данном разделе представлена процедура автоматического заказа и управления модулями в системе ispmanager с использованием API. Для автоматического заказа и управления модулями используйте API ispmanager. Далее будет предоставлена инструкция о том, как это сделать.

 

Авторизация в личном кабинете ispmanager

Авторизация в личном кабинете ispmanager (по URL) осуществляется с помощью параметра authinfo, который принимает значение: authinfo=user:passwd.

  • user - электронная почта пользователя в биллинговой системе https://my.ispmanager.ru;
  • passwd - пароль пользователя.
Обратите внимание!
Параметр authinfo необходимо включать в каждом API запросе для подтверждения авторизации.  

 

Получение списка тарифных планов

Для получения списка доступных тарифных планов используется функция pricelist.export с указанными параметрами.

  • itemtype - тип продукта. Может принимать следующие значения:

    • certificate - сертификаты;
    • addition - модули;
    • soft - лицензии.

     

  • pricelist - код (идентификатор) тарифного плана, если нужно получить информацию о конкретном плане;
  • out - формат, в котором будет возвращена информация. Возможные варианты:

    • xml - возврат информации в формате XML;
    • json - возврат информации в формате JSON.

     


 

Примеры вызова функций.

1. Получение списка всех доступных модулей.

https://api.ispmanager.ru/billmgr?authinfo=<user:passwd>&func=pricelist.export&itemtype=addition&out=xml

 

2. Получить информацию по конкретному модулю (ID  00000).

https://api.ispmanager.ru/billmgr?authinfo=<user:password>&func=pricelist.export&itemtype=addition&pricelist=00000&out=xml 

 

Покупка модуля 

Для заказа используется функция addition.order.param с описанными ниже параметрами.

  • Item - номер лицензии ispmanager для которой покупается модуль;
  • period — период оплаты лицензии. Возможные значения:

    • period=1 — 1 месяц;
    • period=12 — 1 год.

     

  • pricelist - идентификатор модуля;
  • autoprolong  - параметр, отвечающий за автопродление лицензии. Возможные значения:

    • autoprolong=1 — при заказе лицензии будет выставлено автопродление на 1 месяц;
    • autoprolong=12 — автопродление на год;
    • autoprolong=null — без автопродления.

     

     

     

  • skipbasket - списать средства и активировать сразу, игнорируя корзину. Возможные значения:

    • on — активировать без перехода в корзину;
    • off — активировать с переходом в корзину. Значение по умолчанию допускается не указывать в запросе.

     

  • sok - имитирует нажатие кнопки "Ок" при заказе и оплате модуля с лицевого счета. Возможные значения:

    • ok — подтвердить списание средств с лицевого счета;

Пример вызова функции

https://api.ispmanager.ru/billmgr?authinfo=<user:password>&func=addition.order.param&item=<ID лицензии>&period=1&pricelist=55377&autoprolong=1&skipbasket=on&sok=ok

Для внесения изменений в номер лицензии, к которой привязан модуль, ispmanager предоставляет функцию addition.edit с определенными параметрами.

  • elid - идентификатор модуля который отображается в my.ispmanager.ru;
  • item - номер лицензии к которой нужно привязать модуль;
  • sok - имитирует нажатие кнопки "Ок". Возможные значения:

    • ok — подтвердить изменения.

     

     

Пример вызова функции

https://api.ispmanager.ru/billmgr?authinfo=<user:pass>&func=addition.edit&elid=<ID модуля>&item=<ID лицензии>&sok=ok

Обновление данных модуля в ispmanager

Автоматическое обновление данных о лицензии

Чтобы ispmanager получил информацию о купленном модуле, система автоматически выполняет обновление данных о лицензии раз в сутки. Это обеспечивает актуальность информации о модуле.

Ручное обновление данных о лицензии

Также можно незамедлительно обновить данные о лицензии. Это позволяет самостоятельно актуализировать информацию, не ожидая ежедневного автоматического обновления. Для этого перейдите в Основное меню → Управление лицензией → Обновить данные лицензии.