Модули

В данной статье рассматривается процесс перепродажи модулей 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 — название модуля.

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

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

URL личного кабинета: https://my.ispmanager.ru/billmgr

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

URL личного кабинета: https://eu.ispmanager.com/billmgr

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

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

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

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

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

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

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

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

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

• user — электронная почта пользователя в биллинговой системе https://my.ispmanager.ru
• passwd — пароль пользователя

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

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

• itemtype — тип продукта. Может принимать следующие значения:
  • certificate — сертификаты
  • addition — модули
  • soft — лицензии
• pricelist — код (идентификатор) тарифного плана, если нужно получить информацию о конкретном плане
• out — формат, в котором будет возвращена информация. Возможные варианты:
  • xml — возврат информации в формате XML
  • json — возврат информации в формате JSON

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

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

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

• Получить информацию по конкретному модулю (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 получил информацию о купленном модуле, система автоматически выполняет обновление данных о лицензии раз в сутки. Это обеспечивает актуальность информации о модуле.

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

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