Для партнеров

/
/
/
Перепродажа модулей ispmanager через HostBill

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

В HostBill реализован модуль ispmanager reselling, который автоматизирует перепродажу модулей ispmanager.

Возможности модуля

Возможность

Партнер

Клиент

Заказ

Продление

Остановка 

Смена тарифа

Просмотр названия, ключа и IP лицензии

Смена расчетного периода

Просмотр истории изменений для лицензии

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

Модуль ispmanager reselling доступен бесплатно.

Установка модуля

  1. Скачайте модуль по ссылке.
  2. Авторизуйтесь в HostBill под учетной записью администратора по адресу https://ВАШ_ДОМЕН/admin или по SSH.
  3. Загрузите архив в корневую директорию HostBill.
  4. Распакуйте архив.
  1. Авторизуйтесь на сервере с HostBill под учетной записью администратора по SSH.
  2. Скачайте модуль в корневую директорию HostBill:

    wget-P /КОРЕНЬ/HOSTBILL/ https://static.ispmanager.com/static/files/hostbill/ispmanager_reselling.zip
  3. Перейдите в корневую директорию HostBill:

    cd /КОРЕНЬ/HOSTBILL/
  4. Распакуйте архив:

    unzip ispmanager_reselling.zip

Активация модуля

  1. Авторизуйтесь в HostBill под учетной записью администратора по адресу https://ВАШ_ДОМЕН/admin.
  2. Перейдите в раздел Settings → Modules → Hosting Modules.
  3. На вкладке Inactive найдите модуль ispmanager_reselling и нажмите Activate.

Настройка подключения к ispmanager

  1. Авторизуйтесь в HostBill под учетной записью администратора по адресу https://ВАШ_ДОМЕН/admin.
  2. Перейдите в раздел SettingsApps ConnectionsAdd new Connection.

  3. В поле Application выберите ispmanager_reselling.

  4. Заполните параметры подключения. Обязательные поля отмечены звездочками.

    • Name* — произвольное название, под которым подключение сохранится в HostBill. Название будет доступно для просмотра только администратору HostBill.
    • Hostname* — доменное имя личного кабинета ispmanager — my.ispmanager.ru или eu.ispmanager.com.
    • Username* — имя пользователя в личном кабинете ispmanager.
    • Password* — пароль пользователя в личном кабинете ispmanager.

    Оставьте без изменений.

  5. Нажмите Test Configuration для проверки подключения. Если подключение успешно установлено, появится уведомление со статусом Success.
  6. Нажмите Add New Connection.

Создание услуг

Создание услуг доступно после создания хотя бы одной страницы заказа.

Страницы заказа

Страницы заказа позволяют сгруппировать услуги в клиентской зоне HostBill.

Для создания страницы заказа:

  1. Авторизуйтесь в HostBill под учетной записью администратора по адресу https://ВАШ_ДОМЕН/admin.
  2. Перейдите в Settings → Products & Services.
  3. Нажмите Add new order page.
  4. Заполните поля. Обязательные поля отмечены звездочками.
    • Name* — название страницы заказа, которое будет отображаться в клиентской зоне HostBill, например «Модули ispmanager».
    • Order page URL — нажмите Edit, чтобы отредактировать автоматически сгенерированный URL страницы заказа.
    • This category will contain* — выберите Products.
    • Order type* — выберите Other Services.
    • Cart Template — выберите шаблон корзины из стандартных или нажмите Here для покупки платного шаблона. Для предварительного просмотра нажмите Preview.

    • Description — описание услуг, которые будут размещены на странице заказа, для клиентской зоны.
    • Advanced : Order scenario — выберите сценарий заказа — последовательность шагов, которые должен выполнить клиент при заказе услуг на странице заказа. Подробнее о сценариях заказа — в официальной документации HostBill.
  5. Нажмите Add new order page.

Услуги

  1. Авторизуйтесь в HostBill под учетной записью администратора по адресу https://ВАШ_ДОМЕН/admin.
  2. Перейдите в Settings → Products & Services.
  3. Выберите созданную ранее страницу заказа.
  4. Нажмите:
    • Add new product — чтобы создать услугу вручную
    • Import products — чтобы импортировать существующую услугу, используя файл в формате JSON
  5. Заполните или отредактируйте поля на вкладках. Обязательные поля отмечены звездочками.

    General — основные настройки
    • Product Name* — название услуги.
    • Product Code — внутренний код услуги, который виден только администратору HostBill.
    • Product Description — нажмите Add description, чтобы добавить описание услуги, которое будет отображаться в карточке услуги в клиентской зоне HostBill.
    • Price* — тип оплаты:

      Услуга будет доступна бесплатно. 

      Услуга будет доступна по подписке.

      • Выберите платежный период*.

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

        • Monthly — ежемесячно
        • Quarterly — раз в 3 месчца
        • Semi-Annually — раз в полгода
        • Annually — раз в год
      • Setup Fee — единовременный платеж за открытие услуги
      • Upgrade Fee — единовременный платеж за повышение тарифа услуги
      • Billing Type* — выберите форму оплаты:
        • Pre-paid — предоплата
        • Post-paid — постоплата
        • Hybrid — гибрид: для покупки услуг действует предоплата, для повышения тарифа услуг — постоплата

      Для каждого платежного периода и стоимости создайте отдельную цену, нажав Add pricing option.

    • Tax — налог, который будет добавлен к стоимости услуги. Для включения налога активируйте опцию Yes и выберите налоговую группу из списка Tax Group.
    • Tags — теги для обозначения услуги, которые видны только администратору HostBill.
    Connect with App — настройки подключения к ispmanager
    1. App* — выберите из списка ispmanager_reselling.
    2. App Connection* — чтобы при заказе услуги модуль для клиента был заказан в ispmanager автоматически, выберите созданное ранее подключение.
    Automation — автоматические действия с заказами клиента
    • Auto-create — заказ модуля в ispmanager:
      • When the order is placed — при создании заказа в HostBill
      • When the first payment is received — после получения оплаты
      • After payment received, process by cron — с помощью периодического задания после получения оплаты
    • Automatic Upgrades — повышение/понижение тарифа:
      • When the order is placed — при создании заказа на повышение/понижение
      • After receiving payment — после получения оплаты
    • Automatic Renew — продление услуги
      • Renew account automatically after receiving payment — после получения оплаты
      • When renewal invoice is issued — после выставления счета на оплату
    • Automatic Suspension — приостановка лицензии:
      • Autosuspend account after X days past due date — приостанавливать лицензию через X дней после истечения срока оплаты
    • Automatic Unsuspension — возобновление лицензии:
      • Unsuspend account automatically after receiving due payment — действие лицензии будет возобновлено после получения оплаты
    • Automatic Termination — отключение лицензии:
      • Automatically terminate account after X days past due date — отключать лицензию через X дней после истечения срока оплаты
      • Automatically cancel related unpaid invoices — отменять неоплаченные счета по услуге
    • Auto-cancel unpaid orders — отменять неоплаченные заказы:
      • Cancel unpaid orders X days since creation — отменять неоплаченные заказы через X дней после создания
    • Generate invoices — выставление счетов на оплату:
      • X days before the due date for product/service — за X дней до истечения срока оплаты услуги
    • Advanced due date settings — расширенные настройки срока оплаты:
      • Invoice is expected to be paid X days before the due date for service/product — счет должен быть оплачен за X дней до истечения срока оплаты услуги
      • First invoice due date set to X days after order — первый срок оплаты наступает через X дней после создания заказа
      • Move due date X days into future for recurring invoices — перенести срок оплаты на X дней вперед для периодических счетов
    • Adjust Initial Period — скорректировать начало срока действия лицензии, если заказ был оплачен с задержкой, чтобы клиент получал услугу на полный срок
    Messages — уведомления для клиента и администратора HostBill

    Для настройки уведомления нажмите Change и выберите шаблон уведомления из списка.

    Создание шаблонов уведомлений доступно в разделе Settings → Message Templates.

    • Client email notifications — email-уведомления для клиентов:
      • Initial Order — о создании заказа
      • Account created email — о заказе лицензии в ispmanager
      • Account suspended email — о приостановке лицензии в ispmanager
      • Account unsuspended email — о возобновлении лицензии в ispmanager
      • Account terminated email — об отключении лицензии в ispmanager
      • Reminder of the service expiration — напоминание об истечении срока действия услуги
      • Client: Success upgrade — об успешном повышении/понижении тарифа
    • Admin email notifications — email-уведомления для администратора:
      • Staff: Success upgrade — об успешном повышении/понижении тарифа
      • Staff: Failed upgrade — о неудачной попытке повышения/понижения тарифа
    • Client mobile notifications — мобильные уведомления для клиентов:
      • Account created email — о заказе лицензии в ispmanager
    Components — дополнительные услуги, доступные при заказе лицензий

    Для модулей ispmanager поддерживаются только формы («Forms»).

    Формы позволяют получать и хранить информацию о клиентах и услугах в административной и клиентской зонах HostBill. 

    Для добавления собственной формы или поля нажмите одну из трех кнопок и выполните настройку:

    • Add new form field — добавить новое поле
    • Import — импортировать форму в виде файла в формате JSON или YML
    • Copy from product — скопировать форму из другого продукта или услуги

    Подробнее о настройке форм — в официальной документации HostBill.

    Client Functions — действия с заказанной услугой, доступные клиенту в личном кабинете HostBill

    Чтобы разрешить действие, нажмите Enable рядом с ним. Чтобы разрешить все действия, нажмите Enable all.

    Разрешенные действия будут доступны для активных заказов клиента в его личном кабинете HostBill в разделе Services:

    Возможные действия:

    • License details — просматривать информацию о лицензии.
    • Change Billing Cycle — менять платежный период, например с «раз в месяц» на «раз в полгода». Смена доступна, если для услуги лицензии настроено несколько платежных периодов.
    • Change Label — менять ярлык, который отображается рядом с заказанной услугой.
    • Change Ownership — передавать владение заказанной услуги лицензии другому пользователю HostBill.
    • Contracts — просматривать соглашения, принятые при заказе услуги лицензии. Просмотр доступен, если для услуги настроено принятие соглашения.
    • Edit Forms — просматривать и редактировать ответы в формах, добавленных на вкладке Component → Forms.
    • Logs — просматривать журнал действий с услугой, таких как активация, продление, остановка.
    • Manual Service Renew — продлевать услугу досрочно.
    • Related Emails — просматривать письма, связанные с услугой.
    • Related Invoices — просматривать счета по услуге.
    • Related Services — просматривать связанные услуги. Связанные услуги настраиваются на вкладке Component → Forms → Custom/Extra field types → Related Services.
    • Service Auto Renewal — просматривать дату автоматического продления услуги, настраивать продление и метод оплаты.
    • Service notes — просматривать заметки к услуге, оставленные для клиента администратором HostBill.
    • Status Updates — просматривать статус услуги.

    Остальные действия не поддерживаются для модулей.

    Other Settings — настройки отмен, повышения/понижения тарифа и др.
    • Limit Per Customer — максимальное количество заказов услуги, доступное одному клиенту. Для применения ограничения нажмите Yes и укажите количество услуг в поле One customer is allowed to order X products of this type.
    • Allow Cancellations — разрешить клиенту отменять заказ с услугой:
      • Yes, client can cancel service using this product — клиент сможет отменить заказ
      • Yes, client can cancel service after/for X days since account creation — клиент сможет отменить заказ в течение/через X дней после создания аккаунта
      • No, client cannot cancel service with this product — клиент не сможет отменить заказ
    • Allowed Cancellation Types — допустимые типы отмен:
      • Immediate — немедленная отмена
      • End of billing period — отмена в конце платежного периода
    • Pro-rate cancellations — отмена с перерасчетом стоимости услуги
      • No — запретить
      • Yes, for pre-paid services (for immediate cancelations) — разрешить для услуги с предоплатой (немедленная отмена)
      • Yes, for post-paid services — разрешить для услуги с постоплатой
    • Full Month Billing — биллинговая модель, при которой клиент оплачивает полную стоимость месяца независимо от даты активации услуги. Следующие платежи происходят в начала каждого месяца.
      • Enabled — включить
      • Disabled — выключить
    • Contract template — шаблон пользовательского соглашения. Выберите соглашение из списка или нажмите See all contract templates, чтобы настроить соглашения.
    • Clientarea Layout — расположение меню действий в клиентской зоне HostBill:
      • Left menu — слева
      • Right menu — справа
      • Top menu — сверху
    • Custom username — автоматическая генерация имени пользователя. Для настройки нажмите Enable и укажите шаблон имени в поле Username generation pattern.
    • Starting price calculation method — стоимость услуги, которая будет отображаться в клиентской зоне HostBill, если для услуги настроены дополнения на вкладке Components:
      • Calculate using lowest possible component prices — будет указана минимально возможная стоимость
      • Calculate using default components value — стоимость будет указана с учетом стоимости дополнений по умолчанию
    • Upgrades — повышения и понижения тарифов
      • Available Upgrades — выберите услуги, на которые клиент сможет перейти с текущей
      • Upgrade pro-rata — смена тарифа с перерасчетом стоимости услуги
        • Seconds — пересчитать с учетом количества секунд до даты следующего платежа
        • Hours — пересчитать с учетом количества часов до даты следующего платежа
        • Days — пересчитать с учетом количества дней до даты следующего платежа
      • Queue Pro-rata Charges — для услуг с предоплатой ставить пересчитанные платежи в очередь:
        • Disabled — выставлять счет за прошедший период сразу
        • Enabled — ставить счет за прошедший период в очередь
      • Credit on Downgrade — начислять разницу на счет клиента в HostBill при переходе на менее дорогой тариф
        • Default, use system billing settings — использовать настройки биллинга по умолчанию
        • No, do not credit customer pro-rated amount on package downgrade — не начислять разницу при понижении
        • Yes, credit customer pro-rated amount on package downgrade — начислять разницу при понижении
        • Yes, credit customer pro-rated amount on package downgrade, only after client doesn't have unpaid invoices (credit downgrade queue) — начислять разницу при понижении только после того, как клиент оплатит все счета (ставить начисление в очередь)
      • Credit note on Downgrade — создавать кредитную записку при понижении
        • Default, use system billing settings — использовать настройки биллинга по умолчанию
        • No, do not issue credit notes on downgrades — не создавать
        • Yes, issue credit notes on downgrades — создавать
      • Out-of-stock Upgrade — переход на текущую услугу, если ее нет в наличии
        • No, prevent upgrades to this product when it is out of stock — не разрешать
        • Yes, allow upgrades to this product even when it is out of stock — разрешать
  6. Нажмите Save Changes.
  7. Для каждого тарифа ispmanager создайте отдельную услугу.

Действия с модулями

  1. Авторизуйтесь в HostBill под учетной записью администратора по адресу https://ВАШ_ДОМЕН/admin.
  2. Перейдите в раздел Orders and Accounts → Orders → Active Orders для активных заказов и Pending Orders — для ожидающих одобрения.
  3. Нажмите на нужный заказ в списке.
  4. В открывшейся форме в блоке Order items нажмите на услугу.

  5. Выполните нужное действие:
    • Create — заказать лицензию.
    • Terminate — отключить лицензию. При отключении лицензии раньше окончания срока ее действия средства не возвращаются автоматически.
    • Renewal — продлить лицензию.
    • Package сменить тариф на выбранный из списка.
    • Billing cycle — изменить платежный период.

      Подробнее о действиях с услугами — в документации HostBill.

  6. Нажмите Save Changes.

Подробнее о всех возможностях, которые могут быть разрешены клиенту — в разделе Создание услуг → Услуги на вкладке Client Functions.

  1. Авторизуйтесь в HostBill под учетной записью клиента по адресу https://ВАШ_ДОМЕН/index.php.
  2. В меню слева в разделе Services выберите страницу заказа услуг.
  3. В открывшемся списке выберите нужную услугу.

  4. Выполните нужное действие:
    • Upgrade/Downgrade — сменить тариф лицензии
    • License Details — просмотреть информацию о лицензии: название, IP-адрес, ключ и т. д.
    • Change Billing Cycle — изменить платежный период
    • Account Logs — просмотреть историю изменений для лицензии
    • Manual Service Renew — запросить продление лицензии
    • Service Auto Renewal — просмотреть информацию об автоматическом продлении и изменить его настройки
    • Request Cancellation — запросить отключение лицензии