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

Interface LicenseService

public interface LicenseService

Method Summary

Modifier and Type	Method	Description
void	additionalAgreementCreate(int contractId, AdditionalAgreement additionalAgreement, int typeDocument)	Создает( точнее заносит ) новое доп. соглашение.
void	additionalAgreementDelete(int contractId, AdditionalAgreement additionalAgreement)	Удаление неподписанного допика.
List<AdditionalAgreement>	additionalAgreements(int contractId, int copyId)	Вернет список всех доп.сог. для соответсвующего договора и продукта.
void	additionalAgreementUpdate(int contractId, AdditionalAgreement additionalAgreement)
List<LicenseOrderConfirmed>	confirmedOrderList(int contractId, int copyId, int filter)	Список экземпляров компонентов для указанной копии продукта.
boolean	copyDelete(int copyId, int contractId)
LicenseCopy	copyGet(int id)
List<LicenseCopy>	copyList(int contractId)	Список продуктов для договора.
int	copyUpdate(LicenseCopy copy)
BigDecimal	costComponents(int copyId, List<SpecificationTitle> specificationList)	Вернет стоимость данных компонентов
int	createPackage(int contractId, int copyId, Set<String> confirmedOrderIds)
BigDecimal	discountGet(int contractId, int copyId)	Вернет скидку(ну или ту сумму которую они уже оплатили и которую необходимо учитовать).
void	discountSet(int contractId, int copyId, BigDecimal discount)	Установим скидку.
List<ContractData>	doContractData(int productId, int componentId)
List<LicenseStatData>	doStatData(int productId)
List<LicenseComponent>	getComponentItems(int copyId, boolean showHidden, boolean customer)
BigDecimal	getCostComponent(String componentName, int count, int copyId)	Вернет стоимость соответсвующего компонента
Integer	getCountOrderedComponents(String componentName, int copyId)	Вернет кол-во заказанных, подтвержденных.
List<LicenseOrderPermanentNew>	getNewPermanentOrders(int copyId)	Получим список постоянных заказов со статусом новый.
List<LicenseOrderTestNew>	getNewTestOrders(int copyId)	Получим список тестовых заказов со статусом новый.
List<LicenseOrder>	getOrders(int copyId, String testFilter, String permanentFilter, int componentFilter)	Если все 3 фильтра незначимые (filterPermanentStatus=null ,filterTestStatus=null ,filterComponentItemId=-1 ), то выведит все заказы.
List<LicenseOrder>	getOrdersList(int copyId, int type, int status, int componentId)
String	getProductItemLinks(int productItemId)
String	getProductLinks(int productId)
int	lastNumber(int contractId)	Вернет максимальный номер для соответсвующего контракта.Или -1 , если нет не одной записи.
List<LicenseOrderConfirmed>	licenseComponentList(int contractId, int licenseId)
LicenseComponentPrice	licenseComponentPriceGet(int productId, int componentId)
void	licenseComponentPriceUpdate(int productId, int componentId, String price)
int	licenseCreate(int contractId, int copyId, Set<String> confirmedOrderIds, boolean customer)
List<License>	licenseList(int contractId, int copyId)
boolean	licenseTariffGroupDelete(int id)
LicenseTariffGroup	licenseTariffGroupGet(int id)
List<IdTitle>	licenseTariffGroupTitles()
int	licenseTariffGroupUpdate(LicenseTariffGroup tariffGroup)
boolean	licenseTariffRangeDelete(int id)
LicenseTariffRange	licenseTariffRangeGet(int id)
List<IdTitle>	licenseTariffRangeTitles()
int	licenseTariffRangeUpdate(LicenseTariffRange tariffRange)
int	orderCreate(int contractId, LicenseOrder order, boolean customer)
void	orderDelete(int orderId)	Удалит заказ
LicenseOrder	orderGet(int orderId)	Вернет заказ
List<LicenseOrderBillData>	ordersBillDataList(int contractId, int copyId, Set<Integer> orderIds)	Получение списка данных (общее/добавленное кол-во, стоимость) по заказам.
void	ordersCopy(int contractId, int copyId, Set<Integer> orderIds, int term)	Копирование новых постоянных заказов в тестовые.
void	ordersDelete(int contractId, int copyId, Set<Integer> orderIds)	Удаление заказов.
void	orderUpdate(LicenseOrder order)	Создает или изменяет существующий заказ.
List<LicenseOrder>	permanentOrders(int copyId, boolean onlyPerformed)	Вернет список Постоянных заказов.
List<LicenseComponent>	productAllLicenseComponents()
LicenseComponent	productComponentByNameGet(String name)
LicenseComponent	productComponentGet(int id)
int	productComponentUpdate(LicenseComponent component)
List<LicenseCopy>	productCopyList(int contractId)
List<LicenseComponent>	productLicenseComponents(int productId)
List<LicenseProduct>	productList()
List<LicenseProduct>	productListWithComponent(int componentId)
List<IdTitle>	productTitles()
void	prolongTestOrders(int contractId, Date dateTo, List<Integer> ids)
BigDecimal	prospectiveDiscount(int copyId)	Вернет предполагаемую скидку.
String	sendLicenseTextByEmail(int contractId, int copyId, String email, String licenseText)
List<SpecificationTitle>	specificationTitles(int id)	Вернет список SpecificationTitle для соответсвующего дополнительного соглошениия.
void	statusSignedSet(int contractId, int copyId, AdditionalAgreement additionalAgreement)	Выставит статус подписанным, и попытается выставить статус "Выполнен" у заказов которые были добавлены.
AdditionalAgreement	toReplaceSpecification(AdditionalAgreement agreement, int oldCopyId)	При пролонгиции необходимо заменить старые модули(ipn,dialup) на новые(inet).

Method Details

copyList

List<LicenseCopy> copyList(int contractId)
                    throws Exception

Список продуктов для договора.

Parameters:

contractId -

Returns:

Throws:

ru.bitel.bgbilling.common.BGException

Exception

copyGet

LicenseCopy copyGet(int id)
             throws Exception

Throws:

Exception

copyUpdate

int copyUpdate(LicenseCopy copy)
        throws Exception

Throws:

Exception

copyDelete

boolean copyDelete(int copyId,
 int contractId)
            throws Exception

Throws:

Exception

confirmedOrderList

List<LicenseOrderConfirmed> confirmedOrderList(int contractId,
 int copyId,
 int filter)
                                        throws Exception

Список экземпляров компонентов для указанной копии продукта.

Parameters:

copyId - - id копии продукта

filter - - если 0, то в список попадают только компоненты с наибольшим количеством если 1 - только купленные компоненты если 2 - все компоненты

Returns:

- список экземпляров модулей

Throws:

ru.bitel.bgbilling.common.BGException

Exception

productList

List<LicenseProduct> productList()
                          throws Exception

Throws:

Exception

productTitles

List<IdTitle> productTitles()
                     throws Exception

Throws:

Exception

productListWithComponent

List<LicenseProduct> productListWithComponent(int componentId)
                                       throws Exception

Throws:

Exception

productCopyList

List<LicenseCopy> productCopyList(int contractId)
                           throws Exception

Throws:

Exception

licenseList

List<License> licenseList(int contractId,
 int copyId)
                   throws Exception

Throws:

Exception

licenseComponentList

List<LicenseOrderConfirmed> licenseComponentList(int contractId,
 int licenseId)
                                          throws Exception

Throws:

Exception

licenseCreate

int licenseCreate(int contractId,
 int copyId,
 Set<String> confirmedOrderIds,
 boolean customer)
           throws Exception

Throws:

Exception

createPackage

int createPackage(int contractId,
 int copyId,
 Set<String> confirmedOrderIds)
           throws Exception

Throws:

Exception

prolongTestOrders

void prolongTestOrders(int contractId,
 Date dateTo,
 List<Integer> ids)
                throws Exception

Throws:

Exception

orderGet

LicenseOrder orderGet(int orderId)
               throws Exception

Вернет заказ

Parameters:

orderId - ид заказа

Returns:

Order

Throws:

ru.bitel.bgbilling.common.BGException

Exception

orderUpdate

void orderUpdate(LicenseOrder order)
          throws Exception

Создает или изменяет существующий заказ.

Parameters:

order - - заказ, в случае когда order.id == 0 создает заказ

Throws:

ru.bitel.bgbilling.common.BGException

Exception

orderDelete

void orderDelete(int orderId)
          throws Exception

Удалит заказ

Parameters:

orderId - ид заказа

Throws:

ru.bitel.bgbilling.common.BGException

Exception

doStatData

List<LicenseStatData> doStatData(int productId)
                          throws Exception

Throws:

Exception

doContractData

List<ContractData> doContractData(int productId,
 int componentId)
                           throws Exception

Throws:

Exception

getProductLinks

String getProductLinks(int productId)
                throws Exception

Throws:

Exception

getProductItemLinks

String getProductItemLinks(int productItemId)
                    throws Exception

Throws:

Exception

productAllLicenseComponents

List<LicenseComponent> productAllLicenseComponents()
                                            throws Exception

Throws:

Exception

productLicenseComponents

List<LicenseComponent> productLicenseComponents(int productId)
                                         throws Exception

Throws:

Exception

sendLicenseTextByEmail

String sendLicenseTextByEmail(int contractId,
 int copyId,
 String email,
 String licenseText)
                       throws Exception

Throws:

Exception

getOrders

List<LicenseOrder> getOrders(int copyId,
 String testFilter,
 String permanentFilter,
 int componentFilter)
                      throws Exception

Если все 3 фильтра незначимые (filterPermanentStatus=null ,filterTestStatus=null ,filterComponentItemId=-1 ), то выведит все заказы.

Parameters:

copyId -

testFilter - - фильтр для "тестовых" заказов в виде 0,1,3 или 3,1 или 0 , где в скобках соответсвующий id (0-новый , 1-отказано, 3 -подтвержден). Если передать null или пустую строку, фильтр не будет выводить "тестовые" заказы.

permanentFilter - - фильтр для "постоянных" заказов в виде 0,1,2 или 2,1 или 0 , где в скобках соответсвующий id (0-новый , 1-отказано, 2 -выполнен). Если передать null или пустую строку, фильтр не будет выводить "постоянные" заказы.

componentFilter - - id компонента, фильтр по компоненту ну там id email или id ipn или id npay ну и т.д. или -1 если фильтр по нему не нужен.

Returns:

- отфильтрованный лист заказов

Throws:

Exception

getOrdersList

List<LicenseOrder> getOrdersList(int copyId,
 int type,
 int status,
 int componentId)
                          throws Exception

Parameters:

copyId - - код продукта

type - - тип, Тестовый - 0, Постоянный - 1. Все - invalid input: '<'1

status - - статус, Новый - 0, Отказано - 1, Подтвержденные(тестовые) и Постоянные( не тестовые) - 2. Все - invalid input: '<'1

componentId - - ид компонента. Все - invalid input: '<'1

Returns:

Throws:

Exception

getComponentItems

List<LicenseComponent> getComponentItems(int copyId,
 boolean showHidden,
 boolean customer)
                                  throws Exception

Throws:

Exception

getCostComponent

BigDecimal getCostComponent(String componentName,
 int count,
 int copyId)
                     throws Exception

Вернет стоимость соответсвующего компонента

Parameters:

componentName - - название компонента

count - - кол-во элементов

contractId - - номер договора

Returns:

Стоимость

Throws:

Exception

getCountOrderedComponents

Integer getCountOrderedComponents(String componentName,
 int copyId)
                           throws Exception

Вернет кол-во заказанных, подтвержденных. Если кол-во == 0 , то вернет -1, если кол-во == неогранченно вернет 0 ))))

Parameters:

componentName - - название компонента

copyId - - код копии продукта

Returns:

Throws:

Exception

getNewPermanentOrders

List<LicenseOrderPermanentNew> getNewPermanentOrders(int copyId)
                                              throws Exception

Получим список постоянных заказов со статусом новый.

Parameters:

copyId - код копии продукта

Returns:

List

Throws:

ru.bitel.bgbilling.common.BGException

Exception

getNewTestOrders

List<LicenseOrderTestNew> getNewTestOrders(int copyId)
                                    throws Exception

Получим список тестовых заказов со статусом новый.

Parameters:

copyId - код копии продукта

Returns:

List

Throws:

ru.bitel.bgbilling.common.BGException

Exception

orderCreate

int orderCreate(int contractId,
 LicenseOrder order,
 boolean customer)
         throws Exception

Throws:

Exception

ordersCopy

void ordersCopy(int contractId,
 int copyId,
 Set<Integer> orderIds,
 int term)
         throws Exception

Копирование новых постоянных заказов в тестовые.

Parameters:

contractId -

copyId -

orderIds -

term -

Throws:

ru.bitel.bgbilling.common.BGException

ru.bitel.bgbilling.common.BGMessageException

ru.bitel.bgbilling.common.BGIllegalArgumentException

Exception

ordersDelete

void ordersDelete(int contractId,
 int copyId,
 Set<Integer> orderIds)
           throws Exception

Удаление заказов.

Parameters:

contractId -

copyId -

orderIds -

term -

Throws:

ru.bitel.bgbilling.common.BGException

ru.bitel.bgbilling.common.BGMessageException

ru.bitel.bgbilling.common.BGIllegalArgumentException

Exception

ordersBillDataList

List<LicenseOrderBillData> ordersBillDataList(int contractId,
 int copyId,
 Set<Integer> orderIds)
                                       throws Exception

Получение списка данных (общее/добавленное кол-во, стоимость) по заказам.

Parameters:

contractId -

orderIds -

Returns:

Throws:

ru.bitel.bgbilling.common.BGException

ru.bitel.bgbilling.common.BGMessageException

ru.bitel.bgbilling.common.BGIllegalArgumentException

Exception

additionalAgreements

List<AdditionalAgreement> additionalAgreements(int contractId,
 int copyId)
                                        throws Exception

Вернет список всех доп.сог. для соответсвующего договора и продукта.

Parameters:

contractId - - номер договора

Throws:

Exception

additionalAgreementCreate

void additionalAgreementCreate(int contractId,
 AdditionalAgreement additionalAgreement,
 int typeDocument)
                        throws Exception

Создает( точнее заносит ) новое доп. соглашение.

Parameters:

contractId - - номер договора

additionalAgreement - - соглошение которое будет фактически просто добавлено в базу

typeDocument - - -1 - создание договора, 0 - создание допика.

Throws:

Exception

additionalAgreementUpdate

void additionalAgreementUpdate(int contractId,
 AdditionalAgreement additionalAgreement)
                        throws Exception

Throws:

Exception

additionalAgreementDelete

void additionalAgreementDelete(int contractId,
 AdditionalAgreement additionalAgreement)
                        throws Exception

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

Parameters:

contractId - - номер договора.

title - - соглошение которое будет удалено из базы.

Throws:

Exception

specificationTitles

List<SpecificationTitle> specificationTitles(int id)
                                      throws Exception

Вернет список SpecificationTitle для соответсвующего дополнительного соглошениия.

Parameters:

id - - айдишник доп. согл.

Throws:

Exception

permanentOrders

List<LicenseOrder> permanentOrders(int copyId,
 boolean onlyPerformed)
                            throws Exception

Вернет список Постоянных заказов.

Parameters:

copyId - - код копии продукта

onlyPerformed - - если равен false, вернет список Постоянных заказов со статусом Новый и Выполнен, иначе только со статусом Выполнен

Throws:

Exception

costComponents

BigDecimal costComponents(int copyId,
 List<SpecificationTitle> specificationList)
                   throws Exception

Вернет стоимость данных компонентов

Parameters:

specificationList - - список компонентов и их кол-во.

contractId - - номер договора

Throws:

Exception

lastNumber

int lastNumber(int contractId)
        throws Exception

Вернет максимальный номер для соответсвующего контракта.Или -1 , если нет не одной записи.

Parameters:

contractId - -номер договора

Throws:

Exception

prospectiveDiscount

BigDecimal prospectiveDiscount(int copyId)
                        throws Exception

Вернет предполагаемую скидку. Она равна сумме стоимостей всех заказов со статусом Выполнен. Она будет предлагаться при первом создание доп. согл.

Parameters:

copyId - - код копии продукта

Throws:

Exception

discountGet

BigDecimal discountGet(int contractId,
 int copyId)
                throws Exception

Вернет скидку(ну или ту сумму которую они уже оплатили и которую необходимо учитовать). Она необхадима для вывода суммы при создание первого доп.согл. и для информирования в дальнейшем.

Parameters:

contractId - - номер договора

copyId - - код копии продукта

Throws:

Exception

discountSet

void discountSet(int contractId,
 int copyId,
 BigDecimal discount)
          throws Exception

Установим скидку.

Parameters:

contractId - - номер договора

copyId - - код копии продукта

discount - - скидка(ну или иначе, ту сумму которую они уже оплатили и мы не хотим ее учитовать)

Throws:

Exception

statusSignedSet

void statusSignedSet(int contractId,
 int copyId,
 AdditionalAgreement additionalAgreement)
              throws Exception

Выставит статус подписанным, и попытается выставить статус "Выполнен" у заказов которые были добавлены.

Parameters:

contractId - - номер договора.

copyId - - код копии продукта.

additionalAgreement - - то доп. согл. котрое подписывается.

Throws:

ru.bitel.bgbilling.common.BGMessageException - - если выставить статус "Выполнен" не удалось у заказов данного допика.

Exception

toReplaceSpecification

AdditionalAgreement toReplaceSpecification(AdditionalAgreement agreement,
 int oldCopyId)
                                    throws Exception

При пролонгиции необходимо заменить старые модули(ipn,dialup) на новые(inet). Если в старом договоре присутствую старые компоненты и отсутствуют новые, то на сумму старых компонентов будут добавлены новые( старые компоненты остаются ). В документ/допик при этом старые компоненты не попадут.

Parameters:

agreement - - документ/допик.

oldCopyId - - ид копии от старого договора, необходима для оценки стоимости и места вставки inet.

Returns:

тот же agreement, только с измененной specification и установленной ценной.

Throws:

ru.bitel.bgbilling.common.BGException

Exception

licenseComponentPriceGet

LicenseComponentPrice licenseComponentPriceGet(int productId,
 int componentId)
                                        throws Exception

Throws:

Exception

licenseComponentPriceUpdate

void licenseComponentPriceUpdate(int productId,
 int componentId,
 String price)
                          throws Exception

Throws:

Exception

licenseTariffGroupTitles

List<IdTitle> licenseTariffGroupTitles()
                                throws Exception

Throws:

Exception

licenseTariffGroupGet

LicenseTariffGroup licenseTariffGroupGet(int id)
                                  throws Exception

Throws:

Exception

licenseTariffGroupUpdate

int licenseTariffGroupUpdate(LicenseTariffGroup tariffGroup)
                      throws Exception

Throws:

Exception

licenseTariffGroupDelete

boolean licenseTariffGroupDelete(int id)
                          throws Exception

Throws:

Exception

licenseTariffRangeTitles

List<IdTitle> licenseTariffRangeTitles()
                                throws Exception

Throws:

Exception

licenseTariffRangeGet

LicenseTariffRange licenseTariffRangeGet(int id)
                                  throws Exception

Throws:

Exception

licenseTariffRangeUpdate

int licenseTariffRangeUpdate(LicenseTariffRange tariffRange)
                      throws Exception

Throws:

Exception

licenseTariffRangeDelete

boolean licenseTariffRangeDelete(int id)
                          throws Exception

Throws:

Exception

productComponentGet

LicenseComponent productComponentGet(int id)
                              throws Exception

Throws:

Exception

productComponentByNameGet

LicenseComponent productComponentByNameGet(String name)
                                    throws Exception

Throws:

Exception

productComponentUpdate

int productComponentUpdate(LicenseComponent component)
                    throws Exception

Throws:

Exception