Package ru.bitel.bgbilling.modules.softkey.common.service

# Interface SoftkeyService

public interface SoftkeyService

- ## Method Summary

  Modifier and Type
  Method
  Description
  `void`
  `activate(int contractId, int count, int optionId)`
  Активация подписки
  `void`
  `continueSubscription(int contractId, int optionId)`
  Продление подписки после ее приостановки по инициативе пользвателя
  `List<SoftkeyProduct>`
  `getProductList()`
  Получение списка доступных подписок с сервера Softkey.
  `String`
  `getSubscribeStatus(int contractId)`
  Запрос актуального статуса подписки
  `SoftkeyTransaction`
  `getTransactionByCid(int contractId, int optionId)`
  Получение подписки для конкретного договора по его номеру
  `SoftkeyTransaction`
  `getTransactionById(int transactionId)`
  Получение подписки по ее номеру
  `List<SoftkeyTransaction>`
  `getTransactionList(String contractTitle, int status, Date fromDate, Date toDate)`
  Получение общего списка подписок
  `List<SoftkeyTransactionLog>`
  `getTransactionLog(int transactionId)`
  получение лога транзакции по ее номеру
  `void`
  `pause(int contractId, int optionId)`
  Приостановка подписки
  `void`
  `stop(int contractId, int optionId)`
  Прекращение действия подписки
  `void`
  `test()`
  Тестовый метод, для проверки работоспособности взаимодействия с сервисом

- ## Method Details

  - ### getTransactionList

    List<SoftkeyTransaction> getTransactionList(String contractTitle, int status, Date fromDate, Date toDate) throws ru.bitel.bgbilling.common.BGException, ru.bitel.bgbilling.common.BGMessageException
    Получение общего списка подписок
    Returns:
      список подписок, иначе - пустой список, если нет подписок
    Throws:
      `ru.bitel.bgbilling.common.BGException`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### getTransactionById

    SoftkeyTransaction getTransactionById(int transactionId) throws ru.bitel.bgbilling.common.BGException, ru.bitel.bgbilling.common.BGMessageException
    Получение подписки по ее номеру
    Parameters:
      `transactionId` - номер подписки
    Returns:
      null, если подписки нет в базе
    Throws:
      `ru.bitel.bgbilling.common.BGException`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### getTransactionByCid

    SoftkeyTransaction getTransactionByCid(int contractId, int optionId) throws ru.bitel.bgbilling.common.BGException, ru.bitel.bgbilling.common.BGMessageException
    Получение подписки для конкретного договора по его номеру
    Parameters:
      `cid` - номер договора
    Returns:
      null, если на договоре нет подписок
    Throws:
      `ru.bitel.bgbilling.common.BGException`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### getTransactionLog

    List<SoftkeyTransactionLog> getTransactionLog(int transactionId) throws ru.bitel.bgbilling.common.BGException, ru.bitel.bgbilling.common.BGMessageException
    получение лога транзакции по ее номеру
    Parameters:
      `transactionId` - номер транзакции
    Returns:
    Throws:
      `ru.bitel.bgbilling.common.BGException`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### getProductList

    List<SoftkeyProduct> getProductList() throws ru.bitel.bgbilling.common.BGException, ru.bitel.bgbilling.common.BGMessageException
    Получение списка доступных подписок с сервера Softkey. Список всегда будет актуальным. В базе не хранится
    Returns:
    Throws:
      `ru.bitel.bgbilling.common.BGException`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### activate

    void activate(int contractId, int count, int optionId) throws ru.bitel.bgbilling.common.BGException, ru.bitel.bgbilling.common.BGMessageException
    Активация подписки
    Parameters:
      `count` - количество активируемых копий подписок
      `optionId` - код подписки
    Throws:
      `ru.bitel.bgbilling.common.BGException`
      `SQLException`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### pause

    void pause(int contractId, int optionId) throws ru.bitel.bgbilling.common.BGException, ru.bitel.bgbilling.common.BGMessageException
    Приостановка подписки
    Throws:
      `ru.bitel.bgbilling.common.BGException`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### continueSubscription

    void continueSubscription(int contractId, int optionId) throws ru.bitel.bgbilling.common.BGException, ru.bitel.bgbilling.common.BGMessageException
    Продление подписки после ее приостановки по инициативе пользвателя
    Throws:
      `ru.bitel.bgbilling.common.BGException`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### stop

    void stop(int contractId, int optionId) throws ru.bitel.bgbilling.common.BGException, ru.bitel.bgbilling.common.BGMessageException
    Прекращение действия подписки
    Throws:
      `ru.bitel.bgbilling.common.BGException`
      `ru.bitel.bgbilling.common.BGMessageException`

  - ### getSubscribeStatus

    String getSubscribeStatus(int contractId) throws ru.bitel.bgbilling.common.BGException, ru.bitel.bgbilling.common.BGMessageException
    Запрос актуального статуса подписки
    Parameters:
      `contractId` - номер договора

  - ### test

    void test() throws ru.bitel.bgbilling.common.BGException, ru.bitel.bgbilling.common.BGMessageException
    Тестовый метод, для проверки работоспособности взаимодействия с сервисом
    Throws:
      `ru.bitel.bgbilling.common.BGException`
      `ru.bitel.bgbilling.common.BGMessageException`