de.hybris.platform.refund.impl

Class DefaultRefundService

java.lang.Object

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

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

de.hybris.platform.refund.impl.DefaultRefundService

All Implemented Interfaces:

RefundService, Serializable

Direct Known Subclasses:

WarehousingRefundService

public class DefaultRefundService
extends AbstractBusinessService
implements RefundService

Default implementation of RefundService
Sample usage:

 // order creation 
 final OrderModel order = orderService.placeOrder(cart, deliveryAddress, null, paymentInfo);
 // create 'returns request'
 final ReturnRequestModel request = returnService.createReturnRequest(order);
 // assign RMA to 'return request'
 returnService.createRMA(request);
 // based on the original order a 'preview' will be created, so that we can apply the refunds without modifying the original order.
 final OrderModel refundOrderPreview = refundService.createRefundOrderPreview(request, order);
 // ... after that we will apply the refunds on the preview of our order AND DON'T create a OrderHistoryEntryModel entry
 refundService.apply(Arrays.asList(refundEntry), refundOrderPreview), false);
 // afterwards, if the customer agrees with the offered refund, we would apply the refund on the original order AND create a OrderHistoryEntryModel entry
 refundService.apply(Arrays.asList(refundEntry), order), true);
 

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
DefaultRefundService()

Method Summary

Modifier and Type	Method and Description
void	apply(List<RefundEntryModel> refunds, OrderModel order) Based on the assigned refund entries the order will be recalculated
void	apply(OrderModel previewOrder, ReturnRequestModel request) Based on the assigned refund entries of the 'previewOrder' RefundService.createRefundOrderPreview(OrderModel) , the 'finalOrder' will be recalculated and modification entries will be written.
protected OrderHistoryEntryModel	createOrderHistoryEntry(OrderModel processedOrder, OrderModel snapshot) Creates a history entry for the 'processedOrder'.
protected String	createOrderHistoryEntryDescription(List<RefundEntryModel> refunds) Generates a order history comment from the specified refunds by collecting the stored 'refund notes'
OrderModel	createRefundOrderPreview(OrderModel original) Create a "refund order" based on the specified order instance.
protected AbstractOrderEntryModel	getEntry(AbstractOrderModel order, Integer postion) Returns the order entry at a specified position.
protected FlexibleSearchService	getFlexibleSearchService()
OrderReturnRecordHandler	getModificationHandler()
protected AbstractOrderEntryModel	getOrderEntry(RefundEntryModel refund, AbstractOrderModel order)
protected OrderHistoryService	getOrderHistoryService()
protected OrderService	getOrderService()
protected RefundDao	getRefundDao()
List<RefundEntryModel>	getRefunds(ReturnRequestModel request) Returns the refunds for the specified order
void	setFlexibleSearchService(FlexibleSearchService flexibleSearchService)
void	setModificationHandler(OrderReturnRecordHandler modificationHandler)
void	setOrderHistoryService(OrderHistoryService orderHistoryService)
void	setOrderService(OrderService orderService)
void	setRefundDao(RefundDao refundDao)

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

DefaultRefundService

public DefaultRefundService()

Method Detail

setRefundDao

public void setRefundDao(RefundDao refundDao)

Parameters:

refundDao - the refundDao to set

setModificationHandler

public void setModificationHandler(OrderReturnRecordHandler modificationHandler)

Parameters:

modificationHandler - the modificationHandler to set

getModificationHandler

public OrderReturnRecordHandler getModificationHandler()

getOrderEntry

protected AbstractOrderEntryModel getOrderEntry(RefundEntryModel refund,
                                                AbstractOrderModel order)

createRefundOrderPreview

public OrderModel createRefundOrderPreview(OrderModel original)

Create a "refund order" based on the specified order instance. The returned refund order, will be a clone of the original one (see OrderHistoryService.createHistorySnapshot(OrderModel). This new instance should be used for applying the refund. (see: RefundService#calculate)
Note:the ReturnRequest instance of the specified order will not be 'cloned' or 'referenced'.

Specified by:

createRefundOrderPreview in interface RefundService

Parameters:

original - the original order

Returns:

the refund order

apply

public void apply(List<RefundEntryModel> refunds,
                  OrderModel order)

Based on the assigned refund entries the order will be recalculated

Specified by:

apply in interface RefundService

Parameters:

refunds - the refunds for which the amount will be calculated

order - the refund order for which the refund will be calculated

apply

public void apply(OrderModel previewOrder,
                  ReturnRequestModel request)
           throws OrderReturnRecordsHandlerException

Based on the assigned refund entries of the 'previewOrder' RefundService.createRefundOrderPreview(OrderModel) , the 'finalOrder' will be recalculated and modification entries will be written.

Specified by:

apply in interface RefundService

Parameters:

previewOrder - the order which holds the preview of refund

request - the request which holds the order for which the refunds will be calculated AND the "refund entries" which will be logged by OrderReturnRecordHandler

Throws:

OrderReturnRecordsHandlerException

createOrderHistoryEntryDescription

protected String createOrderHistoryEntryDescription(List<RefundEntryModel> refunds)

Generates a order history comment from the specified refunds by collecting the stored 'refund notes'

Parameters:

refunds - the refunds from which the nodes will be extracted

Returns:

the generated order history comment

createOrderHistoryEntry

protected OrderHistoryEntryModel createOrderHistoryEntry(OrderModel processedOrder,
                                                         OrderModel snapshot)

Creates a history entry for the 'processedOrder'.

Parameters:

processedOrder - the 'modified' order

snapshot - the original of the order

Returns:

the created order history entry

getEntry

protected AbstractOrderEntryModel getEntry(AbstractOrderModel order,
                                           Integer postion)
                                    throws JaloItemNotFoundException

Returns the order entry at a specified position.

Parameters:

postion -

Returns:

the related order entry (can be 'null')

Throws:

JaloItemNotFoundException

getRefunds

public List<RefundEntryModel> getRefunds(ReturnRequestModel request)

Returns the refunds for the specified order

Specified by:

getRefunds in interface RefundService

Parameters:

request - the request

Returns:

the refunds

getRefundDao

protected RefundDao getRefundDao()

getOrderService

protected OrderService getOrderService()

setOrderService

public void setOrderService(OrderService orderService)

getFlexibleSearchService

protected FlexibleSearchService getFlexibleSearchService()

setFlexibleSearchService

public void setFlexibleSearchService(FlexibleSearchService flexibleSearchService)

getOrderHistoryService

protected OrderHistoryService getOrderHistoryService()

setOrderHistoryService

public void setOrderHistoryService(OrderHistoryService orderHistoryService)