de.hybris.platform.returns.impl

Class DefaultReturnService

java.lang.Object

de.hybris.platform.servicelayer.internal.service.AbstractService

de.hybris.platform.servicelayer.internal.service.AbstractBusinessService

de.hybris.platform.returns.impl.DefaultReturnService

All Implemented Interfaces:

ReturnCallbackService, ReturnService, Serializable

Direct Known Subclasses:

WarehousingReturnService

public class DefaultReturnService
extends AbstractBusinessService
implements ReturnService, ReturnCallbackService

Default implementation of "Returns handling". It offers ...

• Configurable "Return Merchandise Authorization" aka "Return Material Authorization" (RMA) handling
• Replacement Order handling
• Refund handling incl. configurable calculation
• Configurable 'is returnable' check

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class de.hybris.platform.servicelayer.internal.service.AbstractService

AbstractService.SerializableDTO

Field Summary

Fields inherited from class de.hybris.platform.servicelayer.internal.service.AbstractBusinessService

modelService, sessionService, txManager

Fields inherited from class de.hybris.platform.servicelayer.internal.service.AbstractService

tenant

Constructor Summary

Constructors

Constructor and Description
DefaultReturnService()

Method Summary

Modifier and Type	Method and Description
void	addReplacementOrderEntries(ReplacementOrderModel order, List<ReplacementEntryModel> replacements) Adds ReplacementOrderEntryModel entries from the specified ReplacementEntryModel.
RefundEntryModel	createRefund(ReturnRequestModel request, AbstractOrderEntryModel entry, String notes, Long expectedQuantity, ReturnAction action, RefundReason reason) Creates a ReplRefundacement based on the assigned OrderEntry instance
ReplacementEntryModel	createReplacement(ReturnRequestModel request, AbstractOrderEntryModel entry, String notes, Long expectedQuantity, ReturnAction action, ReplacementReason reason) Creates a Replacement based on the assigned OrderEntry instance
ReplacementOrderModel	createReplacementOrder(ReturnRequestModel request) Creates a ReplacementOrderModel
ReturnRequestModel	createReturnRequest(OrderModel order) Creates an "authorization" object (@link ReturnRequest} for the order to be returned, if there doesn't exists one for that order so far
String	createRMA(ReturnRequestModel request) creates "Return Merchandise Authorization" aka "Return Material Authorization" (RMA) and assigns it to the assigned ReturnRequestModel
Map<AbstractOrderEntryModel,Long>	getAllReturnableEntries(OrderModel order) Returns all returnable OrderEntry's.
protected FlexibleSearchService	getFlexibleSearchService()
protected RMAGenerator	getGenerator()
OrderModel	getOrderByCode(String code) Returns an order by its code
OrderReturnRecordModel	getOrderReturnRecordForOrder(OrderModel order) Gets order return record for a given order.
protected RefundOrderProcessor	getRefundOrderProcessor()
protected RefundService	getRefundService()
ReplacementOrderModel	getReplacementOrder(String rma) Returns the ReplacementOrderModel by the specified 'RMA value'
protected ReplacementOrderProcessor	getReplacementOrderProcessor()
List<ReplacementEntryModel>	getReplacements(ReturnRequestModel request) Returns all Replacements for the specified returns request
protected List<ReturnableCheck>	getReturnableChecks()
protected ReturnActionRequestExecutor	getReturnActionRequestExecutor()
List<ReturnEntryModel>	getReturnEntries(ProductModel product) Returns the ReturnsEntries for the specified product
List<ReturnEntryModel>	getReturnEntry(AbstractOrderEntryModel entry) Returns the ReturnsEntries for the specified order entry
List<ReturnRequestModel>	getReturnRequests(String code) Returns the "return request" for the specified order
protected ReturnEntryProcessor	getReturnsEntryProcessor()
String	getRMA(ReturnRequestModel request) returns a "Return Merchandise Authorization" aka "Return Material Authorization" (RMA).
boolean	isReturnable(OrderModel order, AbstractOrderEntryModel entry, long returnQuantity) Determines if the product is 'returnable' by using the injected ReturnableCheck implementations.
void	onReturnApprovalResponse(ReturnActionResponse approvalResponse) Callback method used by the adapter to pass approval operation result.
void	onReturnCancelResponse(ReturnActionResponse cancelResponse) Callback method used by the adapter to pass cancellation operation result.
void	onReturnReceptionResponse(ReturnActionResponse receptionResponse) Callback method used by the adapter to pass reception operation result.
void	processRefundOrder(OrderModel order) Here you have the chance to 'inject' your final Refund order processing.
void	processReplacementOrder(ReplacementOrderModel order) Here you have the chance to 'inject' your final Replacement order processing.
void	processReturnEntries(List<ReturnEntryModel> entries) Here you have the chance to 'inject' your final Returns Entry processing.
void	requestManualPaymentReversalForReturnRequest(ReturnRequestModel returnRequest) Request manual payment reversal for the (@link ReturnRequest}.
void	requestManualTaxReversalForReturnRequest(ReturnRequestModel returnRequest) Request manual tax reversal for the (@link ReturnRequest}.
void	setFlexibleSearchService(FlexibleSearchService flexibleSearchService)
void	setGenerator(RMAGenerator generator)
void	setModificationHandler(OrderReturnRecordHandler modificationHandler)
void	setRefundOrderProcessor(RefundOrderProcessor refundOrderProcessor)
void	setRefundService(RefundService refundService)
void	setReplacementOrderDao(ReplacementOrderDao replacementOrderDao)
void	setReplacementOrderProcessor(ReplacementOrderProcessor replacementOrderProcessor)
void	setReturnableChecks(List<ReturnableCheck> returnableChecks)
void	setReturnActionRequestExecutor(ReturnActionRequestExecutor returnActionRequestExecutor)
void	setReturnRequestDao(ReturnRequestDao returnRequestDao)
void	setReturnsEntryProcessor(ReturnEntryProcessor returnEntryProcessor)

Methods inherited from class de.hybris.platform.servicelayer.internal.service.AbstractBusinessService

getModelService, getSessionService, getTxManager, setModelService, setSessionService, setTxManager

Methods inherited from class de.hybris.platform.servicelayer.internal.service.AbstractService

afterPropertiesSet, getCurrentTenant, setBeanName, setCurrentTenant, setTenantScope, writeReplace

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DefaultReturnService

public DefaultReturnService()

Method Detail

getRefundService

protected RefundService getRefundService()

Returns:

the configured refundService (calculation)

setRefundService

public void setRefundService(RefundService refundService)

Parameters:

refundService - the service to set

setReturnsEntryProcessor

public void setReturnsEntryProcessor(ReturnEntryProcessor returnEntryProcessor)

getReturnsEntryProcessor

protected ReturnEntryProcessor getReturnsEntryProcessor()

setReplacementOrderProcessor

public void setReplacementOrderProcessor(ReplacementOrderProcessor replacementOrderProcessor)

getReplacementOrderProcessor

protected ReplacementOrderProcessor getReplacementOrderProcessor()

setRefundOrderProcessor

public void setRefundOrderProcessor(RefundOrderProcessor refundOrderProcessor)

getRefundOrderProcessor

protected RefundOrderProcessor getRefundOrderProcessor()

setReplacementOrderDao

public void setReplacementOrderDao(ReplacementOrderDao replacementOrderDao)

Parameters:

replacementOrderDao - the replacementOrderDao to set

setReturnRequestDao

public void setReturnRequestDao(ReturnRequestDao returnRequestDao)

Parameters:

returnRequestDao - the returnRequestDao to set

getReturnableChecks

protected List<ReturnableCheck> getReturnableChecks()

Returns:

the returnableChecks

setReturnableChecks

public void setReturnableChecks(List<ReturnableCheck> returnableChecks)

Parameters:

returnableChecks - the strategiesList to set

setGenerator

public void setGenerator(RMAGenerator generator)

getGenerator

protected RMAGenerator getGenerator()

getRMA

public String getRMA(ReturnRequestModel request)

returns a "Return Merchandise Authorization" aka "Return Material Authorization" (RMA).

Specified by:

getRMA in interface ReturnService

Parameters:

request - reference of the related ReturnsRequest

Returns:

RMA

setModificationHandler

public void setModificationHandler(OrderReturnRecordHandler modificationHandler)

Parameters:

modificationHandler - the modificationHandler to set

createRMA

public String createRMA(ReturnRequestModel request)

creates "Return Merchandise Authorization" aka "Return Material Authorization" (RMA) and assigns it to the assigned ReturnRequestModel

Specified by:

createRMA in interface ReturnService

Parameters:

request - reference of the related "ReturnRequest" for which this RMA will be created

Returns:

RMA

createReturnRequest

public ReturnRequestModel createReturnRequest(OrderModel order)

Creates an "authorization" object (@link ReturnRequest} for the order to be returned, if there doesn't exists one for that order so far

Specified by:

createReturnRequest in interface ReturnService

Parameters:

order - the order which should be returned

Returns:

ReturnRequest instance, which will deliver among others the RMA code of every processed "return order".

getReturnRequests

public List<ReturnRequestModel> getReturnRequests(String code)

Description copied from interface: ReturnService

Returns the "return request" for the specified order

Specified by:

getReturnRequests in interface ReturnService

Parameters:

code - code of the order we ask for the "return request"

Returns:

"return request" of the order

getOrderByCode

public OrderModel getOrderByCode(String code)

Returns an order by its code

Parameters:

code - the code of the order

Returns:

the order

getReplacementOrder

public ReplacementOrderModel getReplacementOrder(String rma)

Description copied from interface: ReturnService

Returns the ReplacementOrderModel by the specified 'RMA value'

Specified by:

getReplacementOrder in interface ReturnService

Parameters:

rma - value

Returns:

replacement order

createReplacementOrder

public ReplacementOrderModel createReplacementOrder(ReturnRequestModel request)

Creates a ReplacementOrderModel

Specified by:

createReplacementOrder in interface ReturnService

Parameters:

request - the returns request to which the order will be assigned

Returns:

the Replacement Order'

createReplacement

public ReplacementEntryModel createReplacement(ReturnRequestModel request,
                                               AbstractOrderEntryModel entry,
                                               String notes,
                                               Long expectedQuantity,
                                               ReturnAction action,
                                               ReplacementReason reason)

Creates a Replacement based on the assigned OrderEntry instance

Specified by:

createReplacement in interface ReturnService

Parameters:

request - we use this for the verification process (order)

entry - the original OrderEntry

notes - some notes

expectedQuantity - the amount of products which the customer wants to return.

action - action which indicates if the 'returns process' will be executed immediately or is still on hold (waiting for the article to be send back)

reason - reason for the replacement

Returns:

ReplacementEntryModel

createRefund

public RefundEntryModel createRefund(ReturnRequestModel request,
                                     AbstractOrderEntryModel entry,
                                     String notes,
                                     Long expectedQuantity,
                                     ReturnAction action,
                                     RefundReason reason)

Creates a ReplRefundacement based on the assigned OrderEntry instance

Specified by:

createRefund in interface ReturnService

Parameters:

request - we use this for the verification process (order)

entry - the original OrderEntry

notes - some notes

expectedQuantity - the amount of products which the customer wants to got a refund.

action - action which indicates if the 'returns process' will be executed immediately or is still on hold (waiting for the article to be send back)

reason - reason for the refund

Returns:

RefundEntryModel

addReplacementOrderEntries

public void addReplacementOrderEntries(ReplacementOrderModel order,
                                       List<ReplacementEntryModel> replacements)

Adds ReplacementOrderEntryModel entries from the specified ReplacementEntryModel. Caution: This impl. only accepts ReplacementEntryModel which are not on HOLD ReturnAction.

Specified by:

addReplacementOrderEntries in interface ReturnService

Parameters:

order - the replacement order

replacements - the 'replacement' entries (instances which are on HOLD will be ignored)

getReturnEntries

public List<ReturnEntryModel> getReturnEntries(ProductModel product)

Returns the ReturnsEntries for the specified product

Specified by:

getReturnEntries in interface ReturnService

Parameters:

product - the product

Returns:

the ReturnsEntry

getReturnEntry

public List<ReturnEntryModel> getReturnEntry(AbstractOrderEntryModel entry)

Returns the ReturnsEntries for the specified order entry

Specified by:

getReturnEntry in interface ReturnService

Parameters:

entry - the OrderEntry

Returns:

the ReturnsEntry

getReplacements

public List<ReplacementEntryModel> getReplacements(ReturnRequestModel request)

Returns all Replacements for the specified returns request

Specified by:

getReplacements in interface ReturnService

Parameters:

request - the ReturnRequestModel

Returns:

the replacements

isReturnable

public boolean isReturnable(OrderModel order,
                            AbstractOrderEntryModel entry,
                            long returnQuantity)

Determines if the product is 'returnable' by using the injected ReturnableCheck implementations. To be successful every strategy has to return 'true'. If no strategies were injected at all, 'true' will be returned as default.

Specified by:

isReturnable in interface ReturnService

Parameters:

order - the related original order

entry - the ordered product which will be returned

returnQuantity - the quantity of entries to be returned

Returns:

true if product is 'returnable'

getAllReturnableEntries

public Map<AbstractOrderEntryModel,Long> getAllReturnableEntries(OrderModel order)

Returns all returnable OrderEntry's. The algorithm returns the max. returnable quantity for every single(!) order entry.

Specified by:

getAllReturnableEntries in interface ReturnService

Parameters:

order - the related order

Returns:

all returnable OrderEntry and their returnable quantity

getOrderReturnRecordForOrder

public OrderReturnRecordModel getOrderReturnRecordForOrder(OrderModel order)
                                                    throws OrderReturnException

Description copied from interface: ReturnService

Gets order return record for a given order.

Specified by:

getOrderReturnRecordForOrder in interface ReturnService

Parameters:

order - Order

Returns:

order return record for the given order

Throws:

OrderReturnException

requestManualPaymentReversalForReturnRequest

public void requestManualPaymentReversalForReturnRequest(ReturnRequestModel returnRequest)
                                                  throws OrderReturnException

Description copied from interface: ReturnService

Request manual payment reversal for the (@link ReturnRequest}.

Specified by:

requestManualPaymentReversalForReturnRequest in interface ReturnService

Parameters:

returnRequest - the return request for which payment should be manually reversed

Throws:

OrderReturnException

requestManualTaxReversalForReturnRequest

public void requestManualTaxReversalForReturnRequest(ReturnRequestModel returnRequest)
                                              throws OrderReturnException

Description copied from interface: ReturnService

Request manual tax reversal for the (@link ReturnRequest}.

Specified by:

requestManualTaxReversalForReturnRequest in interface ReturnService

Parameters:

returnRequest - the return request for which tax should be manually reversed

Throws:

OrderReturnException

processReturnEntries

public void processReturnEntries(List<ReturnEntryModel> entries)

Here you have the chance to 'inject' your final Returns Entry processing. For example for handling consignment creation

Specified by:

processReturnEntries in interface ReturnService

Parameters:

entries - the entries to be process

processReplacementOrder

public void processReplacementOrder(ReplacementOrderModel order)

Here you have the chance to 'inject' your final Replacement order processing. For example for handling consignment creation

Specified by:

processReplacementOrder in interface ReturnService

Parameters:

order - the order to be process

processRefundOrder

public void processRefundOrder(OrderModel order)

Here you have the chance to 'inject' your final Refund order processing. For example for handling consignment creation or initiating the final payment transaction.

Specified by:

processRefundOrder in interface ReturnService

Parameters:

order - the order to be process

onReturnApprovalResponse

public void onReturnApprovalResponse(ReturnActionResponse approvalResponse)
                              throws OrderReturnException

Description copied from interface: ReturnCallbackService

Callback method used by the adapter to pass approval operation result. Adapter uses this method to provide feedback information how was the ReturnRequest approved (completely, partially, not at all).

Specified by:

onReturnApprovalResponse in interface ReturnCallbackService

Throws:

OrderReturnException

onReturnCancelResponse

public void onReturnCancelResponse(ReturnActionResponse cancelResponse)
                            throws OrderReturnException

Description copied from interface: ReturnCallbackService

Callback method used by the adapter to pass cancellation operation result. Adapter uses this method to provide feedback information how was the ReturnRequest cancelled (completely, partially, not at all).

Specified by:

onReturnCancelResponse in interface ReturnCallbackService

Throws:

OrderReturnException

onReturnReceptionResponse

public void onReturnReceptionResponse(ReturnActionResponse receptionResponse)
                               throws OrderReturnException

Description copied from interface: ReturnCallbackService

Callback method used by the adapter to pass reception operation result. Adapter uses this method to provide feedback information how was the ReturnRequest received (completely, partially, not at all).

Specified by:

onReturnReceptionResponse in interface ReturnCallbackService

Throws:

OrderReturnException

getFlexibleSearchService

protected FlexibleSearchService getFlexibleSearchService()

setFlexibleSearchService

public void setFlexibleSearchService(FlexibleSearchService flexibleSearchService)

getReturnActionRequestExecutor

protected ReturnActionRequestExecutor getReturnActionRequestExecutor()

setReturnActionRequestExecutor

public void setReturnActionRequestExecutor(ReturnActionRequestExecutor returnActionRequestExecutor)