org.beigesoft.ws.srv

Interface ISrCart

All Known Implementing Classes:

SrCart

public interface ISrCart

Service that retrieve/create buyer's shopping cart, make cart totals after any line action, etc. This is shared non-transactional service.

Author:

Yury Demidenko

Method Summary

Modifier and Type	Method and Description
void	delLine(Map<String,Object> pRvs, CartLn pCartLn, TxDst pTxRules) Deletes cart line.
void	emptyCart(Map<String,Object> pRvs, Buyer pBuyr) Empties Cart.
Cart	getCart(Map<String,Object> pRvs, org.beigesoft.mdl.IReqDt pRqDt, boolean pIsNeedToCreate, boolean pIsBuAuth) Get/Create Cart.
void	hndCartChg(Map<String,Object> pRvs, Cart pCart, TxDst pTxRules) Handle event cart delivering or line changed.
void	hndCurrChg(Map<String,Object> pRvs, Cart pCart, AcStg pAs, TrdStg pTs) Handle event cart currency changed.
void	mkCartTots(Map<String,Object> pRvs, TrdStg pTs, CartLn pCartLn, AcStg pAs, TxDst pTxRules) Refresh cart totals by seller cause line inserted/changed/deleted.
void	mkLine(Map<String,Object> pRvs, CartLn pCartLn, AcStg pAs, TrdStg pTs, TxDst pTxRules, boolean pRedoPr, boolean pRedoTxc) Makes cart line.
AItmPri<?,?>	revItmPri(Map<String,Object> pRvs, TrdStg pTs, Buyer pBuyer, EItmTy pItType, Long pItId) Reveals item's price descriptor.
TxDst	revTxRules(Map<String,Object> pRvs, Cart pCart, AcStg pAs) Reveal shared tax rules for cart.

Method Detail

emptyCart

void emptyCart(Map<String,Object> pRvs,
               Buyer pBuyr)
        throws Exception

Empties Cart.

Parameters:

pRvs - request scoped vars

pBuyr - buyer

Throws:

Exception - - an exception

getCart

Cart getCart(Map<String,Object> pRvs,
             org.beigesoft.mdl.IReqDt pRqDt,
             boolean pIsNeedToCreate,
             boolean pIsBuAuth)
      throws Exception

Get/Create Cart.

Parameters:

pRvs - request scoped vars

pRqDt - Request Data

pIsNeedToCreate - if need to create, e.g. "NO" for deleting item from cart, "YES" for adding one.

pIsBuAuth - buyer must be authorized

Returns:

shopping cart or null

Throws:

Exception - - an exception

mkCartTots

void mkCartTots(Map<String,Object> pRvs,
                TrdStg pTs,
                CartLn pCartLn,
                AcStg pAs,
                TxDst pTxRules)
         throws Exception

Refresh cart totals by seller cause line inserted/changed/deleted.

Parameters:

pRvs - request scoped vars

pTs - TrdStg

pCartLn - affected cart line

pAs - Accounting Settings

pTxRules - NULL if not taxable

Throws:

Exception - - an exception.

revTxRules

TxDst revTxRules(Map<String,Object> pRvs,
                 Cart pCart,
                 AcStg pAs)
          throws Exception

Reveal shared tax rules for cart. It also makes buyer-regCustomer.

Parameters:

pRvs - request scoped vars

pCart - cart

pAs - Accounting Settings

Returns:

tax rules, NULL if not taxable

Throws:

Exception - - an exception.

hndCurrChg

void hndCurrChg(Map<String,Object> pRvs,
                Cart pCart,
                AcStg pAs,
                TrdStg pTs)
         throws Exception

Handle event cart currency changed.

Parameters:

pRvs - request scoped vars

pCart - cart

pAs - Accounting Settings

pTs - TrdStg

Throws:

Exception - - an exception.

hndCartChg

void hndCartChg(Map<String,Object> pRvs,
                Cart pCart,
                TxDst pTxRules)
         throws Exception

Handle event cart delivering or line changed.

Parameters:

pRvs - request scoped vars

pCart - cart

pTxRules - Tax Rules

Throws:

Exception - - an exception.

delLine

void delLine(Map<String,Object> pRvs,
             CartLn pCartLn,
             TxDst pTxRules)
      throws Exception

Deletes cart line.

Parameters:

pRvs - request scoped vars

pCartLn - cart line

pTxRules - Tax Rules

Throws:

Exception - - an exception.

mkLine

void mkLine(Map<String,Object> pRvs,
            CartLn pCartLn,
            AcStg pAs,
            TrdStg pTs,
            TxDst pTxRules,
            boolean pRedoPr,
            boolean pRedoTxc)
     throws Exception

Makes cart line. Tax category, price, seller are already done.

Parameters:

pRvs - request scoped vars

pCartLn - cart line

pAs - Accounting Settings

pTs - TrdStg

pTxRules - NULL if not taxable

pRedoPr - redo price

pRedoTxc - redo tax category

Throws:

Exception - - an exception.

revItmPri

AItmPri<?,?> revItmPri(Map<String,Object> pRvs,
                       TrdStg pTs,
                       Buyer pBuyer,
                       EItmTy pItType,
                       Long pItId)
                throws Exception

Reveals item's price descriptor.

Parameters:

pRvs - request scoped vars

pTs - TrdStg

pBuyer - Buyer

pItType - Item Type

pItId - Item ID

Returns:

item's price descriptor or exception

Throws:

Exception - - an exception