Work with Return Interface Errors (WRIE)
Purpose: Use this menu option to review errors that occurred when processing a return from an external system.
Order Management System can receive returns from an external system through:
• the RETURNS_IN process in Working with Integration Layer Processes (IJCT). See Inbound Return API for an overview.
• the ORDER_IN process in Working with Integration Layer Processes (IJCT). However, the system does not post errors to this menu option. See Generic Order Interface (Order API) for an overview.
In this chapter:
• Work with Return Errors Screen
A list of errors that may occur when processing a return from an external system is presented below.
Error description |
Reason |
Invalid Company |
The company code specified for the return was not a valid Order Management System company code. |
Invalid item/SKU for Order Detail Line |
The item information specified for the return is not located on the specified order line. |
Invalid Loc for Return |
The location for the return or the location associated with the Default Return Disposition Code for Inbound Returns (H65) is not a valid location for the warehouse specified. |
Invalid Order Detail Line |
The system: • Could not locate an order line to return against. • Could not return against the order line because there wasn’t an available quantity to return, for example, the item had not shipped yet. |
Invalid Order Header |
The system could not locate an order to return against. |
Invalid Order Ship To |
The system could not locate a ship to order to return against. |
Invalid RA Detail |
The return authorization number for the return does not match the Line # field in the RA Detail table for the specified Order Management System order number, ship to number, and item. |
Invalid RA Header |
The return authorization number for the return does not match a return authorization number for the specified ship to order line. |
Invalid Return Quantity |
The return quantity does not match the quantity available to return for the order line. If you are returning against an RA, the quantity passed must match the quantity to return that was created on the RA. |
Invalid Return Reason |
The return reason specified is not a valid return reason code. Return reason codes are defined in and validated against the Return Reason table. |
Invalid Rtn Disposition |
The return disposition code is blank and a disposition code is not defined in the Default Return Disposition Code for Inbound Returns (H65) system control value. |
Invalid Sales Order Line Number |
The order line number specified does not exist on the specified order. |
Invalid Sales Order Number |
The system could not locate the order to return against. |
Invalid Whs for Return |
The warehouse for the return is not a valid warehouse. |
Line not eligible to be returned - quantity shipped is equal to 0 |
The specified order line has not been shipped. |
Missing Company |
The return did not specify a Order Management System company code. |
Missing Default Charge Code (H64) for misc credit |
A credit amount was specified for the return and an additional charge code was not defined in the Default Additional Charge Code for Inbound Returns (H64) system control value to assign to the charge. |
Missing Return Reason |
The return reason is blank and a return reason code is not defined in the Default Return Reason Code for Inbound Returns (H63) system control value. |
No Active Paytypes |
Typically, this message indicates that the pay type on the order was deactivated by the SECRISK periodic function, though it could indicate that the payment method was deactivated for another reason, such as that it is a retail pickup or delivery order. See the Credit Card Retention Days (K65) system control value for background on the SECRISK periodic function, and see Retail Pickup (including Ship-for-Pickup) or Delivery Orders for background on retail pickup and delivery orders. |
No primary location defined for item |
The return disposition code specifies to return the item to its primary location and a primary location has not been defined for the item. |
Order Detail line already returned |
The item passed has already been returned for the available quantity. |
Quantity returned exceeds quantity remaining |
The quantity that is available to return on the specified order line is less than the requested quantity to return. |
Quantity returned exceeds quantity shipped |
The quantity shipped on the specified order line is less than the requested quantity to return. |
Return Already Processed |
The quantity available to return against the order line has already been returned and processed. |
Return not allowed for Retail Pickup/Delivery Orders. |
The order specified is a retail pickup or delivery order, and the Suppress Returns for Retail Pickup/Delivery (L88) system control value is selected. See that system control value for background. |
Return not allowed for Ship for Pickup Orders. |
The order specified is a ship-for-pickup order, and the Payment at POS for Ship for Pickup Orders (L60) system control value is selected. See that system control value for background. |
Work with Return Errors Screen
This screen displays all records in the Return Error table (CSRTER). This table is not company-specific; return errors for all companies in an environment display.
How to display this screen: Enter WRIE in the Fast path field at the top of any menu or select Work with Return Errors from a menu.
Field |
Description |
Co# (company) |
Order Management System company code. Enter the code for any company in the current environment to display return errors in that company. Numeric, 3 positions, optional. |
Item |
A code for item associated with the return. Item codes are defined in and validated against the Item table. Alphanumeric, 12 positions, display-only. |
SKU |
The SKU code for the item associated with the return. Alphanumeric, three 4-position fields; required if the item has SKUs. |
Qty (quantity) |
The number of units of the item being returned. Numeric, 5 positions, display-only. |
Whs (warehouse) |
A code for the warehouse to which the item will be returned, specified on the return authorization, or defaulted from the return disposition code on the return authorization. For returns received from an outside system without a return authorization, the return disposition code may default from system control value Default Return Disposition Code for Inbound Returns (H65). For items with a return disposition code which specifies that the item not be returned to inventory, the warehouse code is 0. Numeric, 3 positions, display-only. |
Location |
The warehouse location to which the item will be returned. Alphanumeric, 7 positions, display-only. |
Order #/Line # |
The order number, ship-to number, and line number of the Order Management System order associated with the return. Order number: numeric, 8 positions, display-only. Ship to number: numeric, 3 positions; display-only. Line number: numeric, 5 positions, display-only. |
Error message (unlabeled field) |
A brief description of the reason for the error. See Return Interface Errors for a list of possible errors. Alphanumeric, 25 positions, display-only. |
Screen option |
Procedure |
Delete an error record from the Return Error table (CSRTER) |
Select Delete for an error record to delete it. The record will be deleted from the Return Error table and will no longer display on the screen. |
Display return error details |
Select Display for an error record to advance to the Display Return Error Screen. |
Purpose: Use this screen to review details of a return error record.
How to display this screen: Select Display for an error record at the Work with Return Errors Screen.
Field |
Description |
Sequence # |
A number assigned by the system to the error record. Sequence numbers are assigned sequentially as errors are received, and are not reassigned when you delete a record. Numeric, 8 positions, display-only. |
Company # |
The code for the company. Numeric, 3 positions, optional. |
Item/SKU |
Item: a code for an existing unit of inventory. Item codes are defined in and validated against the Item table. SKU: a code that further defines an item's color, size, width, or any other type of user-defined attribute. Item: alphanumeric, 12 positions, display-only. SKU: three 4-position fields; display-only if the item has SKUs. |
Return quantity |
The number of units of the item which are being returned. Numeric, 5 positions, display-only. |
Warehouse/Location |
The warehouse and location to which the item will be returned, specified on the return authorization, or defaulted from the return disposition code on the return authorization. For returns received from an outside system without a return authorization, the return disposition code may default from system control value Default Return Disposition Code for Inbound Returns (H65). For items with return disposition code which specifies that the item not be returned to inventory, the warehouse code is 0. Warehouse: numeric, 3 positions, display-only. Location: alphanumeric, 7 positions, display-only. |
Return reason |
The return reason and description for the item, specified on the return authorization. For returns received from an outside system without a return authorization, the return reason code may default from system control value Default Return Reason Code for Inbound Returns (H63). Reason: alphanumeric, 3 positions, display-only. Description: alphanumeric, 30 positions, display-only. |
Return disposition |
The return disposition code and description for the item, specified on the return authorization. The return disposition code determines whether the item being returned will affect inventory, and can specify the warehouse and location where the item will be returned, or that the item will be returned to its primary location. For returns received from an outside system without a return authorization, the return disposition code may default from system control value Default Return Disposition Code for Inbound Returns (H65). Code: alphanumeric, 2 positions, display-only. Description: alphanumeric, 30 positions, display-only. |
Order #/Line # |
The order number, ship-to number, and line number of the sales order. Order number: numeric, 8 positions, display-only. Line number: numeric, 5 positions, display-only. |
RA #/Line # |
A number representing the return authorization, used as a suffix with the order number/ship to number of the order to identify a return authorization. Return authorization number: numeric, 3 positions; display-only. Line number: numeric, 3 positions; display-only. |
Refund freight |
A value indicating whether freight charges on the order will be refunded for a return. Specified on the return authorization. For returns received from an outside system without a return authorization, the Refund freight value may default from system control value Refund Freight Default for Inbound Returns (H59). Alphanumeric, 1 position; display-only. |
Refund handling |
A value indicating whether handling charges on the order will be refunded for a return. Specified on the return authorization. For returns received from an outside system without a return authorization, the Refund handling value may default from system control value Refund Handling Default for Inbound Returns (H61). Alphanumeric, 1 position; display-only. |
Refund charges |
A value indicating whether additional charges on the order will be refunded for a return. Specified on the return authorization. For returns received from an outside system without a return authorization, the Refund charges value may default from system control value Refund Additional Charge Default for Inbound Returns (H60). Alphanumeric, 1 position; display-only. |
Refund duty |
A value indicating whether duty charges on the order will be refunded for a return. Specified on the return authorization. For returns received from an outside system without a return authorization, the Refund duty value may default from system control value Refund Duty Default for Inbound Returns (H62). Alphanumeric, 1 position; display-only. |
Misc credit amount |
A credit amount passed from the outside system. Numeric, 9 positions with a 2-place decimal. |
Called from |
The outside system from which the return was received. |
Error date/time |
The date and time the record in error was received into Order Management System. Date: numeric, 6 positions, in user date format; display-only. Time: numeric, 6 positions, military time HH:MM:SS format; display-only. |
Error message |
A brief description of the reason for the error. See Return Interface Errors for a list of possible errors. Alphanumeric, 25 positions, display-only. |
