Продажа модулей ispmanager через BILLmanager

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

Возможности перепродажи модулей 

Требования для перепродажи модулей

Для настройки интеграции необходимы актуальные версии панели ispmanager 6 и платформы BILLmanager.

Создание сервера лицензий для модулей

Для настройки интеграции начните с подключения обработчика услуг в BILLmanager:

1. Авторизуйтесь в BILLmanager под учетной записью администратора по адресу https://ВАШ_ДОМЕН/billmgr.
2. Перейдите в раздел Интеграция → Обработчики услуг.
3. На панели инструментов нажмите Создать.
4. На шаге Тип продукта выберите Модули ISPsystem.
5. На шаге Модуль обработки выберите BILLmanager.
6. На шаге Настройка интеграции укажите данные:
   1. URL ispmanager — адрес биллинг-системы ispmanager, которая будет предоставлять лицензии на модули: https://api.ispmanager.com/
   2. Имя пользователя — логин учетной записи, из-под которой будут совершаться покупки в личном кабинете ispmanager

   3. Пароль — пароль учетной записи, из-под которой будут совершаться покупки в личном кабинете ispmanager

      Если в личном кабинете ispmanager для учетной записи установлена 2FA, в BILLmanager появится ошибка при подключении обработчика. Отключите 2FA или используйте другую учетную запись для интеграции.

7. Нажмите Далее.
8. На шаге Параметры обработчика услуг укажите данные:

   • Дата-центр — комплекс серверов, которые подключаются со стороны BILLmanager

     Как создать дата-центр

     1. Перейдите в раздел Интеграция → Дата-центры.
     2. На панели инструментов нажмите Создать.
     3. В настройках введите данные для создания дата-центра:
        • Наименование — название дата-центра в интерфейсе с конкретной локализацией
        • Внешний идентификатор дата-центра — служебный код дата-центра из сторонней системы
        • Порядок сортировки — приоритет дата-центра среди других подключенных в BILLmanager. Для сортировки выбирается дата-центр с наименьшим приоритетом. Используются натуральные целые числа от 1 до N
     4. Нажмите Ok.
   • Наименование — название обработчика в интерфейсе с конкретной локализацией

   • Ответственный — ответственный отдел в BILLmanager, на который будут назначаться задачи от обработчика. Пример: «Технический отдел», «Отдел продаж» или «Служба обработки услуг». Задачи будут видны только выбранному отделу

     Как создать ответственный отдел

     1. Перейдите в раздел Провайдер → Отделы.
     2. На панели инструментов нажмите Создать.
     3. В настройках введите данные для создания отдела:
        • Основное:
          • Наименование — название отдела в интерфейсе с конкретной локализацией
          • График — рабочие часы отдела, в которые учитывается регламент ответа отдела. Для выбора графика создайте его в разделе Провайдер → Графики работы
          • Доступен в центре поддержки — установите галочку для отображения отдела при создании запроса клиентом в техническую поддержку. Позволяет заполнить Настройки отдела технической поддержки
          • Локализация задач — локализация, в которой будут формироваться уведомления в задачах, назначенных на отдел. Дополнительные языки доступны, если были добавлены в разделе Настройки → Локализации
        • Настройки отдела технической поддержки:
          • Показывать клиенту провайдеров — провайдеры, клиентам которых будет доступен выбор отдела при создании запроса
          • Глава отдела — главный сотрудник отдела технической поддержки. Для выбора сотрудника создайте его в разделе Провайдер → Сотрудники
          • Описание категории запроса — краткое описание отдела и задач, которые будут решаться. Отображается клиенту при выборе отдела во время создания запроса
          • Сортировка — приоритет отдела среди других подключенных в BILLmanager. Для сортировки выбирается отдел с наименьшим приоритетом. Используются натуральные целые числа от 1 до N
   • Сортировка — приоритет обработчика среди других подключенных в BILLmanager. Для обработки услуги выбирается обработчик с наименьшим приоритетом. Используются натуральные целые числа от 1 до N
   • Минимальный баланс обработчика — минимальный баланс обработчика для успешного продления услуги. Требуется аккаунт в ispmanager с пополненным балансом. Значения указываются в валюте лицевого счета личного кабинета ispmanager. То есть валюты должны быть одинаковыми для продающей и перепродающей платформ
9. Нажмите Завершить. 

После создания обработчика (сервера лицензий для модулей) импортируйте тарифы для BILLmanager. 

Управление тарифами

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

Импорт тарифа

1. Авторизуйтесь в BILLmanager под учетной записью администратора по адресу https://ВАШ_ДОМЕН/billmgr.
2. Перейдите в раздел Продукты → Тарифные планы.
3. Нажмите Импорт на панели инструментов.
4. В настройках выберите созданный ранее модуль обработки.
5. Нажмите Далее.
6. Импортируйте необходимые тарифные планы:
   • Тип продукта — выберите Модули ISPsystem.
   • Тарифный план — ID тарифа коммерческого модуля ispmanager

   • Провайдер — выберите провайдера для импорта тарифного плана. Это позволит брендировать услуги продажи, разделять продажи сертификатов, клиентов и вести расчеты в разной валюте

     Как создать провайдера

     1. Перейдите в раздел Провайдер → Провайдеры.
     2. На панели инструментов нажмите Создать.
     3. Введите данные для создания провайдера:
        • Основные настройки:
          • Наименование — название провайдера
          • Загрузить иконку 16х16 — изображение, которое будет использоваться в списке доступных провайдеров. Максимальный размер: 16х16 px
          • Email для отправки уведомлений — почта, с которой будут отправляться уведомления клиентам. Для успешной отправки уведомлений настройте внешний почтовый сервер и шлюз для исходящих писем
          • Email поддержки — почта, с которой будут отправляться уведомления: об активации пользователя, плательщика и о восстановлении пароля. Оставьте пустым, чтобы уведомления отправлялись с Email для отправки уведомлений
          • URL сайта — адрес вашего сайта
          • URL биллинга — публичный адрес с доступом к BILLmanager
          • URL справки — адрес страницы, которая будет открываться для клиента из раздела Справка → Вызов справки

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

            Если в системе есть активные платежи или расходы, смена валюты не произойдет.

          • Страна по умолчанию — страна и локализация интерфейса по умолчанию
        • Способы регистрации и авторизации:

          • По номеру телефона — включите авторизацию по номеру телефона. При регистрации или входе в BILLmanager будет запрошен код подтверждения через SMS-сообщение. Если номер телефона не указан или не подтвержден, то потребуется авторизация через логин и пароль

            • Количество попыток ввода кода — лимит на количество попыток неверно введенного кода. По достижении лимита потребуется новый код подтверждения.
            • Количество попыток получения кода — лимит на количество отправлений нового кода подтверждения на номер телефона. По достижении лимита потребуется время перед новой попыткой авторизации
            Подробнее о способах регистрации и авторизации сотрудников — в официальной документации ISPsystem.

7. Нажмите Завершить. 

После импорта в списке появится новый тариф. Для него автоматически установится цена на период «месяц». Это позволит сразу включить тариф и начать перепродажу модулей.

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

Настройка тарифа

1. Авторизуйтесь в BILLmanager под учетной записью администратора по адресу https://ВАШ_ДОМЕН/billmgr.
2. Перейдите в раздел Продукты → Тарифные планы.
3. Выберите и отредактируйте существующий тариф.

4. Установите необходимые настройки в блоках:

   Основное

   • Наименование — название тарифа в интерфейсе с конкретной локализацией. Дополнительные языки доступны, если были добавлены в разделе Настройки → Локализации.
   • Внутреннее наименование — автоматически установленный служебный код модуля
   • Ежедневно снимать оплату — ежедневное списание средств за использование сертификата. Если опция включена, доступны параметры: 

   • Расчёт стоимости дня от периода заказа — сумма оплаты при ежедневном списании не будет зависеть от количества дней в месяце. Стоимость дня будет рассчитана из количества дней в периоде заказа. По умолчанию не установлено

     Пример

     В январе клиент заказывает услугу на «месяц». Сумма ежедневного списания — 10 рублей. Без включения опции сумма списания составит 310 рублей за 31 день в месяце. При включении опции стоимость будет рассчитана из количества дней в установленном периоде услуги — 30 дней. Так, клиент заплатит 300 рублей за 30 дней использования модуля. 

   • Разрешить клиенту запуск/остановку — клиент получит права на включение и отключение заказанного модуля. По умолчанию не установлено
     • Списывать средства при остановке — если опция включена, клиент оплачивает время простоя в работе модуля. Если опция выключена, клиенту будут возвращены средства за время простоя в работе модуля. По умолчанию не установлено
   • Календарное списание средств — срок действия услуги будет выровнен по календарному месяцу. Недоступно при использовании опции Ежедневно снимать оплату. По умолчанию не установлено
     • Переходный день — если клиент заказывает услугу в день месяца до переходного дня, то срок действия услуги будет рассчитан до конца текущего месяца. Если в переходный день или позже — до конца следующего месяца. Вместе с периодом действия модуля будет изменена стоимость заказа или продления. Значение по умолчанию: 15
   Дополнительные настройки

   • Тип модуля — автоматически установленный внутренний код импортированного модуля
   Цены за период

   Для создания тарифа необходимо задать цену хотя бы для одного периода оплаты.

   • За месяц — стоимость модуля или его продления на месяц
   • Выключить период заказа "месяц" — запрет на заказ модуля на месяц
   • Цена установки — снятие дополнительной суммы при покупке модуля
   • Продление по специальной цене — отдельная стоимость продления модуля на выбранный период. Если опция включена, то доступно:
     • Продление на месяц — стоимость продления модуля на месяц
   Политики

   • Разрешить группам клиентов — группы клиентов, которым доступны заказ и смена тарифа

     Как создать группу клиентов

     1. Перейдите в раздел Клиенты → Группы клиентов.
     2. На панели инструментов нажмите Создать.
     3. Установите необходимые настройки:
        • Наименование — название группы клиентов
        • Разрешить остановку/включение услуг — установите галочку, чтобы разрешить клиентам группы останавливать и возобновлять работу модулей
        • Разрешить удаление услуг — установите галочку, чтобы разрешить клиентам группы удалять модули
        • Игнорировать количество услуг на аккаунт — установите галочку, чтобы отменить политику Количество услуг доступных для заказа в настройках тарифа
     4. Нажмите Ok.
   • Запретить группам клиентов — группы клиентов, которым недоступны заказ и смена тарифа
   • Минимальный период заказа — минимальный срок использования модуля после заказа. Если опция используется, то доступна:
     • Длина минимального периода — количество дней или месяцев в минимальном периоде заказа
   • Количество услуг доступных для заказа — количество модулей, доступных для заказа 1 клиенту. Если клиент достиг лимита, заказ модуля по тарифу будет недоступен
   • Одновременный заказ услуг — клиенту доступно параллельное добавление нескольких услуг в корзину. Если опция используется, то доступно:
     • Максимальное количество услуг — количество параллельно добавленных услуг в корзину. Большое количество параллельно заказываемых услуг может повлиять на работу BILLmanager
   • Штраф за просрочку продления — взимание штрафа за позднее продление модуля. Штраф взимается во время продления модуля клиентом. Доступны значения:
     • Без штрафа — позднее продление модуля не облагается штрафом
     • Фиксированная сумма — к стоимости продления добавляется фиксированная сумма штрафа

     • Процент от стоимости периода просрочки — к стоимости продления добавляется процент от стоимости периода просрочки

       Пример

       За позднее продление модуля устанавливается штраф 50%. 

       Срок действия услуги истек 1 сентября, а продление произойдет 5 сентября. 
       Для вычисления суммы штрафа система рассчитает стоимость услуги за каждый день (даже если модуль продлевался на год). Допустим, в день начисляется штраф 10 рублей. После, будет подсчитана стоимость просрочки: 

       5 дней х 10 рублей = 50 рублей. 

       Итоговая сумма штрафа: 25 рублей, так как процент штрафа — 50%.

     • Продление с даты остановки — срок действия услуги будет рассчитан не с даты ее продления, а с даты остановки услуги. То есть штраф взимается не денежными средствами, а сроком действия услуги

       Пример

       Срок действия услуги истек 3 августа, а продление происходит только 15. После продления модуль активируется не до 15 сентября, а до 3. 

   • Период автоудаления — резерв дней, заданный для автоматического удаления непродленных модулей. Оставьте пустым, чтобы использовался период автоудаления из настроек типа услуги («Модули ISPsystem»). Если период автоудаления не указан и в типе услуги, то просроченные услуги не будут удаляться.
   • Выключение услуг по выходным — переопределение политики остановки работы модуля. Доступны значения:
     • Использовать настройки типа продукт — тариф будет использовать политики из настроек соответствующего типа продукта
     • Останавливать услуги — услуги тарифа будут останавливаться в выходные дни (субботу, воскресенье) при отсутствии у клиента средств на оплату продления
     • Не останавливать услуги — услуги данного тарифа не будут останавливаться в выходные дни (субботу, воскресенье) в случае отсутствия у клиентов средств на их продление. При наличии штрафа за продление остановленной услуги средства за дополнительные дни работы будут списаны со счета клиента при оплате продления услуги
   • Политика смены тарифа — политика расчетов используется при смене тарифа услуги. Доступны значения:
     • Изменение периода действия — при смене тарифа будет пересчитан срок действия услуги в сторону увеличения при переходе на более дешевый тариф, либо в сторону уменьшения при переходе на более дорогой тариф
     • Доплата/возврат средств — при переходе на более дорогой тариф потребуется доплата разницы в стоимости тарифов за оставшийся период действия услуги. При переходе на более дешевый тариф клиенту будет возвращена разница в стоимости за оставшийся срок действия услуги
     • Смена тарифа запрещена — переход на другой тариф будет невозможен
     • Только доплата, при понижении нет возврата — при переходе на более дорогой тариф потребуется доплата разницы в стоимости тарифов за оставшийся период действия услуги. При переходе на более дешевый — возврата средств не будет, но клиенту будет доступен предыдущий тариф без доплаты
     • Полная оплата нового тарифа — с клиента будет снята полная стоимость нового тарифа, срок действия услуги будет рассчитан по выбранному периоду заказа с даты смены тарифа.
       • Продление с — политика продления услуги на новый тарифный план. Доступны значения:
         • текущей даты — услуга продлевается с текущей даты
         • даты окончания срока действия услуги — услуга продлевается с даты окончания срока действия
   • Политика заказа доп.ресурсов — способ расчета стоимости дополнительных ресурсов при заказе модуля в период его действия. Для работы опции создайте и настройте дополнительные ресурсы, в разделе Продукты → Тарифные планы → выберите тарифный план → Конфиг. Доступны значения:

     • Стоимость до срока действия услуги — стоимость дополнений рассчитывается до даты окончания действия модуля

       Пример

       Услуга действует до 30 ноября. Заказ дополнительных ресурсов для модуля происходит 15 ноября. Стоимость дополнений будет рассчитана только за 15 дней.

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

       Примеры

       Пример 1:

       Для услуги 10 ноября заказываются дополнительные ресурсы. Ранее модуль приобретался на месяц до 20 ноября. Дополнения будут активны лишь 10 дней, но будут оплачены по их полной стоимости. 

       Пример 2:

       Клиент пользовался услугой три месяца и каждый раз продлевал эту услугу на месяц. Увидев, что срок действия услуги вновь подошел к концу, клиент продлил услугу на период «три месяца». После этого он пользовался услугой 2 месяца, после чего решил заказать дополнительные ресурсы. Если используется Полная стоимость за период, то стоимость дополнений будет оплачена на «три месяца». Даже если до конца действия услуги остался 1 месяц, это не повлияет на стоимость дополнений. 

   • Политика отказа от доп.ресурсов — отказ от дополнений к тарифному плану. Возможен возврат средств за оставшийся срок действия модуля или его удаление без компенсации
   • Заметки — текстовые заметки к тарифу. Видны только сотрудникам компании
   Настройка заказа услуги

   • Сортировка — сортировка тарифов из списка по приоритету. Для обработки выбирается тариф с наименьшим приоритетом. Используются натуральные целые числа от 1 до N. Если значения тарифов совпадают, то они сортируются в алфавитном порядке
   • Загрузить иконку — изображение для конкретного тарифа в интерфейсе BILLmanager
   • Отображать иконки ресурсов — правило отображения иконок дополнений к тарифному плану
   • Описание тарифа — описание тарифа в интерфейсе BILLmanager с привязкой к активной локализации. Доступна разметка Markdown
   • Метки — список значений, необходимых для фильтрации тарифов клиентами. Значения записываются с новой строки
5. Нажмите Ok.

После настройки включите тарифы.

Включение тарифа

1. Авторизуйтесь в BILLmanager под учетной записью администратора по адресу https://ВАШ_ДОМЕН/billmgr.
2. Перейдите в раздел Продукты → Тарифные планы.
3. В списке нажмите на импортированный тариф.
4. Нажмите Вкл. на панели инструментов.
5. Подтвердите включение тарифа.

При необходимости повторите действия для всех созданных тарифов.

Сопоставление периодов

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

Для настройки сопоставления периодов:

1. Авторизуйтесь в BILLmanager под учетной записью администратора по адресу https://ВАШ_ДОМЕН/billmgr.
2. Перейдите в раздел Интеграция → Обработчики услуг.
3. В списке выберите нужный обработчик.
4. На панели инструментов нажмите Параметры.
5. Создайте и настройте сопоставление периодов:
   • Параметр — выберите Сопоставление периодов

   • Исходный период — выберите период, который нужно заменить. По умолчанию исходный период модулей — Месяц

     Доступные периоды

     • Триальный период — бесплатный пробный период
     • День
     • Месяц
     • Три месяца
     • Полгода
     • Год
     • Два года
     • Три года
     • Четыре года
     • Пять лет
     • Десять лет
     • Вечный

   • Заменить на — выберите новый период для замены исходного периода при обработке заказа

     Доступные периоды

     • Триальный период — бесплатный пробный период
     • День
     • Месяц
     • Три месяца
     • Полгода
     • Год
     • Два года
     • Три года
     • Четыре года
     • Пять лет
     • Десять лет
     • Вечный
   • Сопоставить с тарифным планом — установите галочку, чтобы при заказе модуля по указанному тарифу работало сопоставление периодов
     • Тип продукта — выберите Модули ISPsystem

     • Тарифный план — выберите тариф, для которого будет работать сопоставление периодов

       В списке отображаются только включенные тарифы.

6. Нажмите Ok.

Тестовый заказ модуля

Чтобы проверить, что тарифы на модули стали доступны для клиентов и заказы обрабатываются корректно, совершите тестовый заказ:

1. Авторизуйтесь в BILLmanager под учетной записью администратора по адресу https://ВАШ_ДОМЕН/billmgr.

2. Если у вас нет тестового аккаунта клиента в BILLmanager, создайте его.

   Как создать аккаунт клиента в BILLmanager

   1. Перейдите по URL биллинга, указанного в настройках провайдера.
   2. В форме авторизации нажмите Зарегистрируйтесь.
   3. В форме регистрации укажите:
      • Контактное лицо — ФИО клиента
      • Email адрес — логин для авторизации клиента в BILLmanager
      • Пароль — пароль для авторизации клиента в BILLmanager
      • Введите пароль еще раз — пароль клиента
      • Страна — страна регистрации клиента в BILLmanager
   4. Нажмите Зарегистрироваться. 

3. Перейдите в клиентскую зону. 

   Как перейти в клиентскую зону BILLmanager

   1. Перейдите в раздел Клиенты → Клиенты.
   2. В списке выберите ранее созданного клиента.

   3. На панели инструментов нажмите Войти.

      

   Произойдет автоматическое перенаправление в клиентскую зону.

4. В клиентской зоне закажите модуль.

   Как заказать модуль в BILLmanager

   1. Перейдите в раздел Лицензии → Модули.
   2. На панели инструментов нажмите Заказать.
   3. Выберите и закажите модуль.
   4. Укажите данные для регистрации модуля:
      • Лицензия — ID лицензии ispmanager, для которой приобретается модуль
   5. Подтвердите выбранный период оплаты.
   6. При необходимости включите Автопродление платной услуги. 

   7. Нажмите Активировать или Оплатить.

      Подробнее

      • Активировать — доступно при оформлении бесплатной услуги.
      • Оплатить — доступно при оформлении платной услуги.

   8. Выберите и установите необходимый метод оплаты. Может потребоваться проверка дополнительных данных плательщика (как юридического лица).

      Проверка данных плательщика

      • Получатель — компания-получатель платежа.
      • Название банка — банк-получатель платежа.
      • БИК — номер БИК.
      • Р/С — номер расчетного счета.
      • К/С — номер корреспондентского счета.

      Плательщик создается отдельно или во время заказа модуля в разделе Клиент → Плательщики.

   9. Проверьте состав заказа и оплатите его.
5. В случае успеха появится уведомление «Услуга готова к использованию». Для просмотра и управления модулем перейдите в раздел Лицензии → Модули (доступно клиентам и администраторам).
6. Автоматически установится состояние модуля Обрабатывается (открытие). Для перехода в состояние Активен дождитесь подтверждения запроса со стороны BILLmanager.

7. При необходимости удалите тестовый заказ. 

   Как удалить тестовый заказ в BILLmanager

   1. В административной зоне BILLmanager перейдите в раздел Лицензии → Модули.
   2. Выберите ранее заказанный модуль.

   3. На панели инструментов нажмите Удалить.

      

   4. Подтвердите удаление модуля.