Returns
Explore the structured process of handling returns in OMS, from creating return items to managing refunds.
Last updated
Explore the structured process of handling returns in OMS, from creating return items to managing refunds.
Last updated
Returns in the OMS are structured to work as the inverse of a sales order, so every element of a sales order has an effective inverse allowing retailers to accept return details against an order in the way that works best for their business.
Before a return can be created for an order item, the sales order item being returned must be completed, the entire order does not have to be completed for a return to be initiated.
If a sales order is being returned in multiple phases, then the OMS will create multiple returns against that sales order instead of appending to a single return.
Returns in the OMS can be broken down into 3 primary sections, return items, returned inventory and refund to the customer.
The return header contains details about a return that are relevant regardless of the return items like the created date and return channel. The return header intentionally does not store a direct reference to the original sales order ID. This deliberate design choice, allowing a return to encompass items from multiple sales orders if the need arises.
External System Integration:
For returns initiated from an external system, integration remains a critical aspect.
It is essential to include the internal ID of the return in the OMS's return external ID for effective tracking and seamless integration across systems.
Return Level Adjustments:
Return header level adjustments help manage overarching adjustments that are not directly tied to specific items.
Common use cases include refunding order-level charges such as shipping fees or taxes. Additionally, return level adjustments can be strategically employed to modify the refund tender amount, accommodating scenarios like restocking fees.
Field Name | Description |
---|---|
Most of the return details that retailers want to analyze about their returns, such as return type, reason and amounts are stored at the item level. Every return item is required to be linked to the original sales order line ID that it is being issued against using the item sequence id of the original order item.
The type of a return item often defines the handing of the returned item for the business. Some of the most commonly used types of return items include:
How the return was issued is stored at an item level in the form of types to allow retailers to create mixed returns where each item can be returned as different methods. For example, a store rep can issue a refund for some items of an order while offering an exchange for other items in the same transaction instead of being forced to create separate transactions.
The type of a return item helps the OMS select the refund method. To issue refunds to customers, a new payment preference is created in the original sales order with the type “refund” and the method corresponding to the type of the return item. Payment type and method are used in combination to identify how the customer received their refund, for example if a customer received store credit in the form of a gift card, it will be presented as a refund type payment with the method of “gift card” or “store credit” depending on what the retailer chooses to configure.
The amount that needs to be refunded to the customer is computed based on the sum of the refund item totals and the return adjustments. This computed sum is not actually stored in the OMS and is instead a computed value when return details are fetched. The final tender amount is then applied to the refund payment preference created on the order the returned order item was placed in.
Status Id | Status Code | Description |
---|---|---|
Return Adjustment Type Id | Description |
---|---|
Return Type Id | Description | Parent Type Id |
---|---|---|
Return Id
A unique identifier for each return header. System generate.
External Id
The internal ID of the return in cases where returns are posted to the OMS from an external system.
Return Header Type Id
Identifies the type of return. Possible values: CUSTOMER_RETURN or VENDOR_RETURN
Status Id
Indicates the current status of the return. See table below for all statuses
Created By
The user or system entity responsible for creating the return.
From Party Id
Represents the party initiating the return, typically associated with the customer.
To Party Id
Specifies the recipient party or entity for the return, often the business or organization receiving the returned items.
Payment Method Id
Identifies the payment method associated with the return.
Fin Account Id
Refers to the financial account linked to the return.
Billing Account Id
Specifies the billing account related to the return.
Entry Date
Records the date when the return was entred into the OMS.
Origin Contact Mech Id
Identifies the contact mechanism associated with the origin of the return.
Destination Facility Id
Represents the facility or location where the returned items are intended to be processed or received.
Needs Inventory Receive
A boolean field indicating whether the return requires inventory receiving.
Currency Uom Id
Specifies the currency unit of measure associated with the return.
Supplier Rma Id
Refers to the Return Merchandise Authorization (RMA) ID associated with the supplier.
Return Channel Enum Id
Enumerates the return channel, categorizing the channel through which the return is initiated.
Last Updated Stamp
Timestamp of the last update to the return header.
Last Updated Tx Stamp
The transaction timestamp of the last update to the return header.
Created Stamp
The timestamp when the return header was initially created.
Created Tx Stamp
The transaction timestamp when the return header was initially created.
Transaction Id
The transaction ID associated with the return header.
Return Date
The date when the return was processed or completed.
Employee Id
The employee associated with the return, providing insights into the personnel involved in the return process.
RETURN_ACCEPTED
ACCEPTED
Authorized
RETURN_CANCELLED
CANCELLED
Cancelled
RETURN_COMPLETED
COMPLETED
Completed
RETURN_MAN_REFUND
MANUAL_REFUND
Manual Refund Required
RETURN_RECEIVED
RECEIVED
Received
RETURN_REJECTED
REJECTED
Rejected
RETURN_REQUESTED
REQUESTED
Requested
RET_ADD_FEATURE_ADJ
Return Additional Feature
RET_DEPOSIT_ADJ
Return Deposit Adjustment
RET_DISCOUNT_ADJ
Return Discount
RET_DUTY_ADJ
RMA Duty
RET_EXT_PRM_ADJ
Return External Promotion Adjustment
RET_FEE_ADJ
Return Fee
RET_MAN_ADJ
Return Manual Adjustment
RET_MISC_ADJ
Return Miscellaneous Charges
RET_MKTG_PKG_ADJ
Return Marketing Package Adjustment
RET_PROMOTION_ADJ
Return Promotion
RET_REPLACE_ADJ
Return Replacement
RET_RMA_ADJ
RMA Fee Adjustment
RET_SALES_TAX_ADJ
Return Sales Tax
RET_SHIPPING_ADJ
Return S&H
RET_SURCHARGE_ADJ
Return Surcharge
RET_VAT_PC_ADJ
Return VAT Price Correction
RET_VAT_TAX_ADJ
Return VAT Tax
RET_WARRANTY_ADJ
Return Warranty
HC_RETURN
HC allowed returns
RTN_CREDIT
Store Credit
HC_RETURN
RTN_EXCHANGE
Exchange
HC_RETURN
RTN_REFUND
Refund
HC_RETURN
RTN_REPLACE
Replacement
HC_RETURN