Return Credit Request Feed

Overview

The Return Credit Request feed allows a distribution center to initiate a return request to Radial Order Management. This feed file updates Radial Order Management order data with information received for a customer-returned order. The return order details are sent from the Warehouse Management System (WMS) to Radial Order Management to credit any necessary payment charges back to the customer.

Notes:

Default Character Encoding: Unicode: UTF-8
Recipient Acknowledgment Required: Client Specific
Exchange Frequency: Client Specific
Production Mailbox Location: Client Specific
Test Mailbox Location: Client Specific
Filename Format: <ClientId>_<StoreId>_ReturnCreditRequest_<YYYYMMDDHHMISS>.xml
The filename combined with the mailbox determines the destination of the Return Credit Request message.

Schema

Return Credit Request schema: ReturnCreditRequest.xsd

API Structure

Return Credit Request element table: ReturnCreditRequest.xsd.html

Example

In the following example, elements with special meaning for this item type are noted in /*comments*/ before the element.

Copy this code sample.


<ReturnCreditRequest>
   <MessageHeader>
      <Standard>GSI</Standard>
      <HeaderVersion>NGP1.1.0</HeaderVersion>
      <VersionReleaseNumber>NGP1.1.0</VersionReleaseNumber>
      <SourceData>
         <SourceId>TMSNA</SourceId>
         <SourceType>CLIENT</SourceType>
      </SourceData>
      <DestinationData>
         <DestinationId>GSI</DestinationId>
         <DestinationType>FH</DestinationType>
      </DestinationData>
      <EventType>ReturnCreditRequest</EventType>
      <MessageData>
         <MessageId>04194979168599536900</MessageId>
         <CorrelationId/>
      </MessageData>
      <CreateDateAndTime>2014-11-08T19:00:02-06:00</CreateDateAndTime>
   </MessageHeader>
   <ReturnCreditRequestData>
      <ReturnCreditRequestHeader>
         <ClientId>TMSNA</ClientId>
         <FacilityId>289</FacilityId>
         <ReturnOrderId>11001818</ReturnOrderId>
         <ReturnDateTime>2014-11-07T19:44:18.553</ReturnDateTime>
         /*To identify the original order, either the OriginalOMSOrderID or the 
         OriginalCustomerOrderId is required.
         <OriginalOMSOrderID>123456789123001</OriginalOMSOrderID>
         <OriginalCustomerOrderId>0002500014928</OriginalCustomerOrderId>
         <ExtendedAttributes>
            <Name>gsi_store_id</Name>
            <Value>TMSUS</Value>
         </ExtendedAttributes>
         <ExtendedAttributes>
            <Name>gsi_client_id</Name>
            <Value>TMSNA</Value>
         </ExtendedAttributes>
      </ReturnCreditRequestHeader>
      <ReturnCreditRequestDetail>
         <ReturnOrderLineNumber>1</ReturnOrderLineNumber>
         <ItemId>
            <ClientItemId>410009258980</ClientItemId>
            <ExtendedAttributes>
               <Name>CatalogId</Name>
               <Value>18</Value>
            </ExtendedAttributes>
         </ItemId>
         <QuantityReturned>1</QuantityReturned>
         <CustomerReasonCode>ZRN</CustomerReasonCode>
         <FacilityReasonCode>NR1</FacilityReasonCode>
      </ReturnCreditRequestDetail>
   </ReturnCreditRequestData>
</ReturnCreditRequest>

Data Keys

ISO Standard	Definition
Country – ISO 3166-1	2 Letter Country Standard
Currency – ISO 4217	Currency Standard
Time – ISO 8601	Date Time Standard

Customer Reason Code	Description
01	Dissatisfied
02	Damaged
03	Defective
04	Not as Desc or Pictured
05	Mistake in Ordering
06	Wrong Product Shipped
07	Other
08	Package Refused At Door
09	Freight Damaged
10	AAFES Order Return
11	Exchange
12	Bad Address
13	Returned from Store for Credit
14	Returned at Store, No Credit or Ref
15	Wrong Carrier Selected When Shipped16
16	Carrier Does Not Service Address
17	Carrier Could Not Locate Address
18	Missing UPC
19	Return Not Valid
20	Missing Major Component
21	Did not fit - too small
22	Did not fit - too short
23	Did not fit - too narrow
26	Did not fit - too large
28	Incorrect item - Color
AH	AH-Invalid Shipping Address
ALC	Arrived late due to carrier
AM	American Express Fraud
APP	APPEASEMENT (LNT)
ARD	Arrived Damaged
ARL	Arrived Late
ATL	Arrived too late
AW	AW-Whse Zip Code Error
B01	Size too large/small
B02	Did not fit as expected
B03	Item not as described or pictured
B04	Incorrect item received
B05	Order arrived late
B06	Item was damaged
B07	Unwanted gift
B08	Change mind
B09	Other, please specify
BM	Bought multiples, plan to keep 1
CB	Customer Request - Presell
CBL	Chargeback Loss Prevention
CCE	Cancelled Customer Error
CCM	Cancelled Changed Mind
CDE	Cancelled Data Entry Error
CFC	I Ordered Incorrect Color
CFS	I Ordered Incorrect Size
CID	I Didn't Like
CL	Late Shipment Cancel
CLR	Color different from order
CMD	Buyers remorse
CMM	I Changed My Mind
CMN	Cancelled Modified Name,Addres
CN	Shop NBC Cancellation
CNC	Cancelled at Customer Request
COL	Cancelled Order Late
COT	Cancelled Other
CP	Customer Request
CR	Customer Req - Order Replaced
CSU	Cancelled Substitution
CWS	Size Just Didn't Fit
DAM	Damaged refused or concealed damage
DC	Damaged when Customizing
DEE	Date Entry Error
DEF	Manufacturer error
DFC	Destroy Authorization from Vendor
DFT	Defective
DI	Insufficient Credit
DIN	Damaged Interior
DIQ	Disappointed in quality
DLC	Did not like color
DLS	Did not like styling
DNR	Did Not Receive Package
DSD	Drop Ship Damaged
DT	Cancel After Date
DUP	Duplicate order
DW	Wireless Plan Credit Decline
DX	Other Credit Declines
EC	ExpiredPromotional Code
EP	Customer Request - Epiphany
ESC	Corporate Escalation (for GC void)
EX	Expired Product
F1	Finance Cancel-Denied PO
F2	Finance Cancel-Wait greater than 10 Days
FB	Invalid Billing Address
FC	FTC CANCELLATION
FED	Fed Ex Return
FF	Lost Or Stolen Card
FI	International Billing Address
FIT	Did not fit
FRD	Fraud (for voiding GC)
FS	Suspected Fraud
GCF	GC failure
GFT	Gift Certificate Failure (LNT)
GRG	Gratis- Gloss
GSE	GSI site error
GW	Gift Wrap cancel code
HM	Hot Market SKU Cancel
IC	Inappropriate Customization
ID	OOS - Inventory Discrepancy
IK	Fill and Kill
IM	Shipping Mode Mismatch
IN	Too Many Letters in Name
IO	OOS - Out of Stock
IP	Incorrect Product
IR	Warehouse Cancel - unspecified
IS	Inactive Sku
IV	Vendor Direct Cancellation
LOS	Lost item
LP	Wrong Address
LPC	LP-Canadian Post
LPP	LP-Purolator
MIS	Wrong item, size or color sent
MSC	I Received Incorrect Color
MSI	I Received Incorrect Item
MSS	I Received Incorrect Size
MSW	Fulfillment Misship
NAD	Not as pictured or described
NCR	Never Received by Carrier
ND	Duplicate - Don't send email
NDC	Non-Delivered - Claim (LNT)
NDN	Non-Delivered - No Claim (LNT)
NE	Item did not meet my expectations
NEX	Fabric/Color not as expected
NRC	Never Received by Carrier
OBM	OBM Requested
OS	Out of Stock
OTH	Other
OVD	Last resort compensation
PAQ	Package Quality
PC	Pick Cancel (In Store Pick-Up)
PCF	Promo/Coupon Failure (LNT)
PE	Promotional Error
PMF	Promotional failure
PRA	Price Adjustment
PRE	Personal Reaction
PRM	Price match
PRQ	Product Quality
PRT	Partner requested
PST	Return Postage
QPM	Product Melted
QPP	Sloppy Personalization
RAG	Received as gift
RL	Return Lost
RPM	Product misinformation
RV	RTV cancels
SAM	Sample
SC	Size or Color Issue
SD	Backorder - Don't send email
SE	Setup Error
SHE	Shipping error
SHT	Shortage
SSC	Cancel Customer Initiated
SSH	Short Shipped (LNT)
SSR	ISPU Return Reason Code
SZE	Size different from order
TC	OOS - Timing
TDR	30-DAY RETURN
TEX	Tax exempt credit
TLG	Too Large
TLO	Too Long
TQ	OOS - Timing - QVC Default
TSH	Too Short
TSM	Too Small
UND	Undeliverable
VC	Variance Cancel
WA	Wrong Address
XC	Customer Cancel
XF	Fraud
XG	Google Canceled Order
XI	ORDERREVIEWCXL-XI
XU	Fraud Analyst Cancel
YC	Order Clean Up
YD	Duplicate Order
YT	Test Order
YY	GBuy Settlement 29 Day Limit
Z	Cancel Inventory Discrepancy
Z1	PayPal Settlement 60 Day Limit
Z2	Failed PayPal Authorization
ZC	Zero Cost Re-ship Cancel
ZRN	No reason
ZZ	PayPal Settlement 29 Day Limit

Facility Reason Code	Description
CC	Customer Cancelled Order
CC1	Damaged in Shipment - Exterior Damage
CC2	Missing Package, Customer Charged
CF	Third Party Fulfiller Return
CM	Trans claim
CR	Customer Service Credit (non-mdse)
CV	Vendor Direct Credit (non-mdse)
DM	Damaged Mdse
DSD	Drop ship damaged
EA1	Damaged - Manufacturing Defect
EA2	Alleged Product Experiences (APES)
EA3	Add To/Combine Same Day Orders
FP	Frozen Product
FSL	Found at Store Location
GA1	Damaged in Shipment - Interior
GA2	Wrong Mdse. Sent
GA3	Arrived Too late
GA4	Missing Product, Customer Charged
GA5	Missing Product, Customer Not Charged, Not B/O
ISF	In-Store Fulfillment Returns
ISR	In-Store Returns
LPC	LP-Canadian Post
LPP	LP-Purolator
M1	Miss-shipped - Sellable Mdse
M9	Miss-shipped - Damaged
MC	Missing Code
NR1	No Reason
NR2	Didn't like
NR3	Wrong Mdse Ordered
PST	Return Postage
RG	I AM RETURNING A GIFT
RI	Replace with same item
RL	Return Lost
RP	Refund by original method of payment
SL	Sellable Mdse
TS	Product Testing
UN1	Undeliverable
VD	Vendor Direct - Damaged
XN	Exchange for new item
XR	Exchange for new size/new color