Модули

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

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

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

Однако существует альтернативная возможность - перепродажа модулей. Возможно самостоятельно принимать оплату от конечных пользователей за модули и обеспечивать оформление заказа непосредственно в личном кабинете компании 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 - название модуля.
  

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

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

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

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

При покупке модуля конечным пользователем, 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 - пароль пользователя.

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

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

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

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