TB.One > Order Data and Order Processing > Order Management - Basics and Setup > Return Announcements From Marketplaces
TIP: |
What are Return Announcements?
Return Announcements are optional information that may be useful for returns processing:
When customers return articles, they sometimes have to announce these returns to the marketplace where they made the purchase (for example, to receive a shipping label). When a marketplace forwards return announcement data to TB.One, you can use them to prepare for incoming returns and track shipments.
How to Set Up Return Announcements in TB.One?
Tradebyte has to configure your system for Return Announcements:
Reach out to Tradebyte Support or your Solution Delivery manager and request the activation of Return Merchandize Authorization.
TIP: •Let your Tradebyte contact know whether you will retrieve the return announcements via SFTP or REST and whether the CSV or XML format should be used. •Only the XML format supports shipping numbers. If you want to track the shipments, use XML. |
What do the Return Announcements Look Like?
Depending on the file format chosen, you will either receive "MESSAGE.xml" or "DESADV.csv" files.
Fields in CSV Return Announcements
The "DESADV.csv" files for return announcements contain data in the following columns:
Column |
Content |
|---|---|
SV_ORDER_ID |
Order ID; a unique order number assigned by TB.One (corresponds to TB_ORDER_ID in other CSV files). |
POS_SV_ID |
Unique number of the item across all orders (corresponds to POS_TB_ID in other CSV files). |
RMA_RETURN_CODE |
The marketplace's ID for this return process (also called RMA-ID). |
RMA_QUANTITY |
The number of articles returned. |
Fields in XML Return Announcements
The "MESSAGE.xml" return announcements contain the following nodes:
Node |
Content |
|---|---|
<MESSAGE_ID> |
Unique identifier assigned to the message by TB.One. |
<MESSAGE_TYPE> |
For return announcements, the message type is "RMA_ANNOUNCEMENT". |
<TB_ORDER_ID> |
Order ID; a unique order number assigned by TB.One. |
<CHANNEL_SIGN> |
Channel sign (usually 4 characters). |
<CHANNEL_ORDER_ID> |
The channel's order number (if available) |
<CHANNEL_ORDER_ITEM_ID> |
The channel's item number (if available) |
<CHANNEL_SKU> |
The channel's article number (if available) |
<QUANTITY> |
The number of articles returned. |
<IDCODE> |
The marketplace's ID for this return process (also called RMA-ID). |
<PROCESSED> |
"Processed" flag; indicates that the message has been transferred from TB.One to the channel (export only, therefore not relevant in this context). |
<EXPORTED> |
"Exported" flag; indicates that the message has been exported to the merchant (export only, therefore not relevant in this context). |
<DATE_CREATED> |
Date when the return was created (if transmitted by the marketplace); otherwise the creation date of the message in TB.One. |
<CHANNEL_DATA key="rma_return_code"> |
Return tracking code provided by the marketplace (not all marketplaces transmit this data). |
<CHANNEL_DATA key="rma_return_carrier"> |
Return carrier (not all marketplaces transmit this data). |
<CHANNEL_DATA key="rma_return_reason"> |
Return cause (not all marketplaces transmit this data). |
<CHANNEL_DATA key="rma_type"> |
Return type (not all marketplaces transmit this data). |
EXAMPLE:
|