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

Interface CardService

@MTOM(enabled=true,
      threshold=10000)
public interface CardService

Method Summary

Modifier and Type	Method	Description
List<CardAction>	cardActionTable(int dealerId, int type, Date dateFrom, Date dateTo)	Список проводок (выдача/возврат карт) по дилеру, типу и периоду.
void	cardActionUndo(int id)	Отмена проводки (возврат карт на склад, удаление проводки).
ru.bitel.bgbilling.common.dto.FileDto	cardActionView(int id)	Просмотр проводки (FO-XML документ).
void	cardActivateForPayment(int contractId, String number, String pin)	Активация карты для пополнения баланса.
List<CardData>	cardContractInfo(int contractId, int serviceId)	История карты (таблица card_data_) по указанной услуге договора.
List<CardContract>	cardContractList()	Список договоров на карты (card_contract).
void	cardDealerAdd(int dealerId, String cardIds, String seriesCount)	Передача карт дилеру (по серийным номерам или по сериям/количеству).
void	cardDealerDelete(int dealerId, String cardIds)	Возврат карт от дилера.
Result<DealerCard>	cardDealerInfo(int dealerId, Page page)	Карты дилера (с пагинацией).
CardLoadResult	cardLoad(float summa, Date dateFrom, Date dateTo, String cards, int patternId, int servicePayId, int serviceActivateId, int paymentType, String series)	Загрузка карт из файла.
CardReport	cardReport(int report, String dealers, Date date1, Date date2, float summaFrom, float summaTo)	Отчёт по картам дилеров (выданные/возвращённые/истёкшие).
List<IdTitle>	cardReportDealers(int type)	Дилеры отчёта карты (по битам типа: 1 — выдача, 2 — возврат).
List<IdTitle>	cardReportTemplates()	Шаблоны отчёта карты (moduleSetup XSLT_K1...).
void	cardSeriesDelete(int id)
CardSeries	cardSeriesGet(int id)
List<CardSeries>	cardSeriesNotEmpty()	Список серий карт, содержащих карты (передача дилеру).
void	cardSeriesUpdate(CardSeries cardSeries)
List<IdTitle>	cardServiceList(int contractId)	Список услуг (типов карт) на договоре в модуле.
CardCheckResult	checkCardInfo(int serviceId, long cardCode, long cardPinCode)	Проверка карты (номер/pin/период/статус) по услуге.
ContractFound	dealerContractFind(int contractId, String title)	Поиск договора дилера по номеру/названию (проверка по шаблонам CONTRACT_PATTERN).
List<String>	dealerContractPatterns()	Шаблоны поиска договора дилера (moduleSetup CONTRACT_PATTERN).
void	dealerDelete(int id)
Dealer	dealerInfo(int id)	Просмотр дилера.
List<Dealer>	dealerList(int type)
List<Dealer>	dealerList(String title, Period period, int type)	Список дилеров (по названию, периоду, типу).
DealerParams	dealerParamsList()	Настройки дилера: списки параметров, режимов поиска и допустимых договоров.
int	dealerPaymentAdd(int contractId, String title, BigDecimal summa, String comment, int dealerId)	Платёж дилера (по договору или названию договора).
Result<DealerPayment>	dealerPaymentList(int dealerId, Date dateFrom, Date dateTo, Page page)	Платежи дилера (по его типам платежей) с пагинацией.
List<IdTitle>	dealerPaymentTypes(String excludeIds)	Типы платежей, доступные дилеру (кроме заданных).
RevisePayments	dealerRevise(int dealerId, Date from, Date until, String file)	Сверка платежей дилера по файлу.
void	dealerUpdate(Dealer dealer)
DPaymentList	dPaymentList(int dealerId, Date from, Date until, int type, Page page)	Платежи дилера (DPaymentManager).
Result<DealerPayment>	paymentList(Set<Integer> dealerIds, Date dateFrom, Date dateTo, int type, String trans, String contract, List<Integer> contractLabels, List<FilterEntityAttr> contractFilter, Page page)
ru.bitel.bgbilling.common.dto.FileDto	paymentListExport(Set<Integer> dealerIds, Date dateFrom, Date dateTo, int type, String trans, String contract, List<Integer> contractLabelIds, List<FilterEntityAttr> contractFilter, Page page)

Method Details

paymentList

Result<DealerPayment> paymentList(Set<Integer> dealerIds,
 Date dateFrom,
 Date dateTo,
 int type,
 String trans,
 String contract,
 List<Integer> contractLabels,
 List<FilterEntityAttr> contractFilter,
 Page page)
                           throws ru.bitel.bgbilling.common.BGException

Throws:

ru.bitel.bgbilling.common.BGException

paymentListExport

ru.bitel.bgbilling.common.dto.FileDto paymentListExport(Set<Integer> dealerIds,
 Date dateFrom,
 Date dateTo,
 int type,
 String trans,
 String contract,
 List<Integer> contractLabelIds,
 List<FilterEntityAttr> contractFilter,
 Page page)
                                                 throws ru.bitel.bgbilling.common.BGException

Throws:

ru.bitel.bgbilling.common.BGException

cardActivateForPayment

void cardActivateForPayment(int contractId,
 String number,
 String pin)
                     throws ru.bitel.bgbilling.common.BGException

Активация карты для пополнения баланса.

Parameters:

contractId - ID договора, для которого активируется карта.

number - номер карты.

pin - пароль (PIN-код) карты.

Throws:

ru.bitel.bgbilling.common.BGException

cardDealerAdd

void cardDealerAdd(int dealerId,
 String cardIds,
 String seriesCount)
            throws ru.bitel.bgbilling.common.BGException

Передача карт дилеру (по серийным номерам или по сериям/количеству).

Parameters:

dealerId - ID дилера.

cardIds - список ID карт, запятыми (пусто, если заданы серии).

seriesCount - пары "серия:кол-во", разделитель ";" (пусто, если заданы ID).

Throws:

ru.bitel.bgbilling.common.BGException

cardDealerDelete

void cardDealerDelete(int dealerId,
 String cardIds)
               throws ru.bitel.bgbilling.common.BGException

Возврат карт от дилера.

Parameters:

dealerId - ID дилера.

cardIds - список ID карт, запятыми.

Throws:

ru.bitel.bgbilling.common.BGException

cardActionUndo

void cardActionUndo(int id)
             throws ru.bitel.bgbilling.common.BGException

Отмена проводки (возврат карт на склад, удаление проводки).

Parameters:

id - ID проводки.

Throws:

ru.bitel.bgbilling.common.BGException

cardActionView

ru.bitel.bgbilling.common.dto.FileDto cardActionView(int id)
                                              throws ru.bitel.bgbilling.common.BGException

Просмотр проводки (FO-XML документ).

Parameters:

id - ID проводки.

Returns:

документ (FO-XML в Base64).

Throws:

ru.bitel.bgbilling.common.BGException

cardActionTable

List<CardAction> cardActionTable(int dealerId,
 int type,
 Date dateFrom,
 Date dateTo)
                          throws ru.bitel.bgbilling.common.BGException

Список проводок (выдача/возврат карт) по дилеру, типу и периоду.

Parameters:

dealerId - ID дилера (0 — любой).

type - тип проводки (0 — все; 1 — выдача; 2 — возврат).

dateFrom - дата начала периода (null — без ограничения).

dateTo - дата конца периода (null — без ограничения).

Returns:

список проводок.

Throws:

ru.bitel.bgbilling.common.BGException

cardServiceList

List<IdTitle> cardServiceList(int contractId)
                       throws ru.bitel.bgbilling.common.BGException

Список услуг (типов карт) на договоре в модуле.

Parameters:

contractId - ID договора.

Returns:

список услуг.

Throws:

ru.bitel.bgbilling.common.BGException

cardContractInfo

List<CardData> cardContractInfo(int contractId,
 int serviceId)
                         throws ru.bitel.bgbilling.common.BGException

История карты (таблица card_data_) по указанной услуге договора.

Parameters:

contractId - ID договора.

serviceId - ID услуги (типа карты).

Returns:

история карты.

Throws:

ru.bitel.bgbilling.common.BGException

cardSeriesGet

CardSeries cardSeriesGet(int id)
                  throws ru.bitel.bgbilling.common.BGException

Throws:

ru.bitel.bgbilling.common.BGException

cardSeriesNotEmpty

List<CardSeries> cardSeriesNotEmpty()
                             throws ru.bitel.bgbilling.common.BGException

Список серий карт, содержащих карты (передача дилеру).

Returns:

список серий.

Throws:

ru.bitel.bgbilling.common.BGException

cardSeriesUpdate

void cardSeriesUpdate(CardSeries cardSeries)
               throws ru.bitel.bgbilling.common.BGException

Throws:

ru.bitel.bgbilling.common.BGException

cardSeriesDelete

void cardSeriesDelete(int id)
               throws ru.bitel.bgbilling.common.BGException

Throws:

ru.bitel.bgbilling.common.BGException

cardLoad

CardLoadResult cardLoad(float summa,
 Date dateFrom,
 Date dateTo,
 String cards,
 int patternId,
 int servicePayId,
 int serviceActivateId,
 int paymentType,
 String series)
                 throws ru.bitel.bgbilling.common.BGException

Загрузка карт из файла.

Parameters:

summa - сумма карты (-1 — не задана).

dateFrom - дата начала действия.

dateTo - дата конца действия.

cards - строки "id\tкод\tпин".

patternId - ID шаблона договора.

servicePayId - ID услуги пополнения (-1 — не задана).

serviceActivateId - ID услуги активации (-1 — не задана).

paymentType - ID типа платежа.

series - название серии.

Returns:

отчёт и ошибки.

Throws:

ru.bitel.bgbilling.common.BGException

dealerList

List<Dealer> dealerList(int type)
                 throws ru.bitel.bgbilling.common.BGException

Throws:

ru.bitel.bgbilling.common.BGException

dealerUpdate

void dealerUpdate(Dealer dealer)
           throws ru.bitel.bgbilling.common.BGException

Throws:

ru.bitel.bgbilling.common.BGException

dealerDelete

void dealerDelete(int id)
           throws ru.bitel.bgbilling.common.BGException

Throws:

ru.bitel.bgbilling.common.BGException

dealerInfo

Dealer dealerInfo(int id)
           throws ru.bitel.bgbilling.common.BGException

Просмотр дилера.

Parameters:

id - ID дилера.

Returns:

дилер (findmodes/allowcontracts/contractTitle уже разобраны).

Throws:

ru.bitel.bgbilling.common.BGException

dealerList

List<Dealer> dealerList(String title,
 Period period,
 int type)
                 throws ru.bitel.bgbilling.common.BGException

Список дилеров (по названию, периоду, типу).

Parameters:

title - название (null — все).

period - период (null — без ограничения).

type - тип дилера (0 — все; 1 — карта; 2 — платёж).

Returns:

список дилеров.

Throws:

ru.bitel.bgbilling.common.BGException

dealerPaymentTypes

List<IdTitle> dealerPaymentTypes(String excludeIds)
                          throws ru.bitel.bgbilling.common.BGException

Типы платежей, доступные дилеру (кроме заданных).

Parameters:

excludeIds - список исключаемых ID, запятыми (пусто — все).

Returns:

список ID/title.

Throws:

ru.bitel.bgbilling.common.BGException

dealerParamsList

DealerParams dealerParamsList()
                       throws ru.bitel.bgbilling.common.BGException

Настройки дилера: списки параметров, режимов поиска и допустимых договоров.

Returns:

три списка ID/title.

Throws:

ru.bitel.bgbilling.common.BGException

dealerRevise

RevisePayments dealerRevise(int dealerId,
 Date from,
 Date until,
 String file)
                     throws ru.bitel.bgbilling.common.BGException

Сверка платежей дилера по файлу.

Parameters:

dealerId - ID дилера.

from - дата начала периода.

until - дата конца периода.

file - содержимое файла со сверкой.

Returns:

результаты сверки (проведенные/мис/отмененные).

Throws:

ru.bitel.bgbilling.common.BGException

dealerPaymentList

Result<DealerPayment> dealerPaymentList(int dealerId,
 Date dateFrom,
 Date dateTo,
 Page page)
                                 throws ru.bitel.bgbilling.common.BGException

Платежи дилера (по его типам платежей) с пагинацией.

Parameters:

dealerId - ID дилера.

dateFrom - дата начала периода (null — без ограничения).

dateTo - дата конца периода (null — без ограничения).

page - страница.

Returns:

список платежей + атрибуты summa/allRecord.

Throws:

ru.bitel.bgbilling.common.BGException

cardReportDealers

List<IdTitle> cardReportDealers(int type)
                         throws ru.bitel.bgbilling.common.BGException

Дилеры отчёта карты (по битам типа: 1 — выдача, 2 — возврат).

Parameters:

type - 0 — все; 1 — выдача; 2 (и любое другое ≠1/0) — возврат.

Returns:

список ID/title.

Throws:

ru.bitel.bgbilling.common.BGException

cardReportTemplates

List<IdTitle> cardReportTemplates()
                           throws ru.bitel.bgbilling.common.BGException

Шаблоны отчёта карты (moduleSetup XSLT_K1...).

Returns:

список ID/title.

Throws:

ru.bitel.bgbilling.common.BGException

dealerContractPatterns

List<String> dealerContractPatterns()
                             throws ru.bitel.bgbilling.common.BGException

Шаблоны поиска договора дилера (moduleSetup CONTRACT_PATTERN).

Returns:

список шаблонов.

Throws:

ru.bitel.bgbilling.common.BGException

dealerContractFind

ContractFound dealerContractFind(int contractId,
 String title)
                          throws ru.bitel.bgbilling.common.BGException

Поиск договора дилера по номеру/названию (проверка по шаблонам CONTRACT_PATTERN).

Parameters:

contractId - ID договора (0 — искать по названию).

title - номер/название договора.

Returns:

найденный договор (id, comment, summa, firm_id).

Throws:

ru.bitel.bgbilling.common.BGException

checkCardInfo

CardCheckResult checkCardInfo(int serviceId,
 long cardCode,
 long cardPinCode)
                       throws ru.bitel.bgbilling.common.BGException

Проверка карты (номер/pin/период/статус) по услуге.

Parameters:

serviceId - ID услуги.

cardCode - номер карты.

cardPinCode - PIN-код карты.

Returns:

результат проверки (code/pinCode/period/status/contractId).

Throws:

ru.bitel.bgbilling.common.BGException

cardContractList

List<CardContract> cardContractList()
                             throws ru.bitel.bgbilling.common.BGException

Список договоров на карты (card_contract).

Returns:

список (id, шаблон, период, комментарий).

Throws:

ru.bitel.bgbilling.common.BGException

cardDealerInfo

Result<DealerCard> cardDealerInfo(int dealerId,
 Page page)
                           throws ru.bitel.bgbilling.common.BGException

Карты дилера (с пагинацией).

Parameters:

dealerId - ID дилера.

page - страница.

Returns:

список карт + атрибуты summa/allRecord.

Throws:

ru.bitel.bgbilling.common.BGException

dPaymentList

DPaymentList dPaymentList(int dealerId,
 Date from,
 Date until,
 int type,
 Page page)
                   throws ru.bitel.bgbilling.common.BGException

Платежи дилера (DPaymentManager).

Parameters:

dealerId - ID дилера (0 — все).

from - дата начала (null — без ограничения).

until - дата конца (null — без ограничения).

type - тип (0 — все).

page - страница.

Returns:

список платежей + число/сумма + страница.

Throws:

ru.bitel.bgbilling.common.BGException

cardReport

CardReport cardReport(int report,
 String dealers,
 Date date1,
 Date date2,
 float summaFrom,
 float summaTo)
               throws ru.bitel.bgbilling.common.BGException

Отчёт по картам дилеров (выданные/возвращённые/истёкшие).

Parameters:

report - ID шаблона отчёта (XSLT_K1...).

dealers - список ID дилеров, запятыми (пусто — все).

date1 - дата начала.

date2 - дата конца.

summa1 - сумма от (-1 — без ограничения).

summa2 - сумма до (-1 — без ограничения).

Returns:

отчёт (dealers + dealerCards status_1/2/3 + xslt).

Throws:

ru.bitel.bgbilling.common.BGException

dealerPaymentAdd

int dealerPaymentAdd(int contractId,
 String title,
 BigDecimal summa,
 String comment,
 int dealerId)
              throws ru.bitel.bgbilling.common.BGException

Платёж дилера (по договору или названию договора).

Parameters:

contractId - ID договора (0 — искать по title).

title - название договора.

summa - сумма.

comment - комментарий.

dealerId - ID дилера (user_id сессии).

Returns:

ID платежа (-1, если не создан).

Throws:

ru.bitel.bgbilling.common.BGException