> ## Documentation Index
> Fetch the complete documentation index at: https://developers.redo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Radial

> Send Radial an advance ship notice (ASN) for each approved return so its warehouse can receive the package

## What is Radial?

Radial is a commerce technology and fulfillment provider that operates warehouses for retailers. Radial's warehouse receives returned packages against an advance ship notice (ASN), a file that lists what is on the way. Redo's Radial integration sends that ASN for each return, so Radial knows what to expect before the package arrives.

## What does the integration do?

When a return is approved in Redo, the integration builds an ASN in Radial's `ReceivingDetail` XML format and uploads it to Radial over SFTP. Each ASN holds:

| ASN field | Value |
| - | - |
| `StoreCode` | **Store code** from your setup |
| `ReceivingType` | `A` |
| `ShipmentNumber` and `ASNNumber` | The Redo RMA ID: `r_` followed by the return's public ID |
| `OrderDate` | The date the return was created |
| `ShipmentReceiptDate` | The expected receipt date: 10 days after the return was created |
| `ShipperName` | **Shipper name** from your setup |
| `ReceivingWarehouseId` | **Receiving warehouse ID** from your setup |
| `ClientItemId` | The Radial item number of each returned item |
| `ShippedQuantity` | The quantity returned |
| `ItemCost` | The average unit price of the line, with two decimals |
| `CartonId` | The scan value of the label code on the item's return shipment |
| `SegId` extended attribute | **Segment ID** from your setup |

How the ASN is built:

* **Return items only.** Items the customer keeps (green returns) are left off.
* **One line per item and carton.** Items with the same item number on the same shipment share a line.
* **Radial item numbers** come from the Shopify variant metafield `custom.ql_item_number`. A return with an item that has no value in that metafield fails to send, and the error lists the SKUs.
* **Carton IDs** come from the return label code, so each package carries a code that the ASN references. The code type is your **Label code type** setting (default **External RMA ID**). A return with no external RMA ID has no carton code under that type. **SSCC** codes need **Print return barcode on label** on.
* **File name.** `EIRCDT_ASN_<timestamp>_<ASN number>.xml`, where the timestamp is the upload time in UTC. Redo writes it to the top-level folder of your Radial SFTP account.

Redo sends one ASN per return. Retrying a return whose ASN was already uploaded does not send a second file.

### What Redo does not send

Redo sends the ASN when the return is approved and does not send later changes. The integration does not:

* Receive receiving or status updates from Radial.
* Send tracking updates.
* Cancel or update the ASN when a return is rejected, reset, or processed in Redo.

### Returns without an ASN

Redo sends no ASN for:

* Returns whose destination is a Redo returns center
* Returns with only green-return items
* Returns dropped off without a label
* Point-of-sale returns

## How to set it up

Radial is set up by the Redo team. Contact [support@getredo.com](mailto:support@getredo.com) with your Radial details, and Redo connects it for you.

### Prerequisites

> [accordion] Radial SFTP Account
>
> Radial gives you the SFTP username and password that Redo uploads ASNs with, plus your store code, shipper name, receiving warehouse ID, and segment ID.

> [accordion] Shopify Store
>
> Redo reads Radial item numbers from Shopify variant metafields, so returns need to come from a Shopify order.

> [accordion] Radial Item Numbers on Variants
>
> Add each item's Radial item number to the variant metafield `custom.ql_item_number` in Shopify.

> [accordion] Label Code Type
>
> Pick a **Label code type** in your return label settings: **External RMA ID**, **ID**, or **SSCC**. Redo sends this code as the carton ID. For **SSCC**, also turn on **Print return barcode on label**.

### Configuration steps

The Redo team completes these steps with you.

**1. Open Radial**

Open **Integrations** and select **Radial**. This page is visible to Redo staff only.

**2. Connect Radial**

On the **Returns** row, click **Connect** and fill in:

* **Store code**: Radial's store code for the merchant
* **Shipper name**: the sender name on each ASN
* **Receiving warehouse ID**: the Radial warehouse that receives the returns
* **Segment ID**: the Radial-assigned segment for each ASN line (defaults to `AVL`)
* **SFTP server**: the Radial server to upload to. The options list each server's address.
* **SFTP username**
* **SFTP password**

Every field is required. Click **Connect**.

**3. Test the integration**

Approve a return that has a Radial item number on every returned item, then check that the ASN file appears in your Radial SFTP account.

To change a setting, click **Manage** on the **Returns** row, edit the field, and click **Save**. Redo stores the SFTP password securely and does not show it again. To replace it, click **Replace** in the **SFTP password** field and enter the new one. To stop sending ASNs, click **Disconnect**. Returns are no longer sent to Radial.

## Important considerations

> [!WARNING]
>
> **One ASN, sent at approval:** Redo does not update or cancel an ASN after upload. If you change or reject a return in Redo, tell your Radial contact.

## Troubleshooting

ASN failures show on the return in Redo. Retry from the return's actions menu after you fix the cause.

> [accordion] Items Have No Radial Item Number
>
> Redo shows that some items on the return have no Radial item number.
>
> **Solution:**
>
> * Add the item number to the variant metafield `custom.ql_item_number` in Shopify
> * Retry the return

> [accordion] No Carton Code on the Label
>
> Redo shows that the return label has no carton code to send to Radial.
>
> **Solution:**
>
> * Choose a **Label code type** the return has (for **SSCC**, turn on **Print return barcode on label**)
> * Regenerate the label, then retry the return

> [accordion] ASN Could Not Be Delivered
>
> Redo shows that the ASN could not be delivered to Radial. The SFTP upload failed.
>
> **Solution:**
>
> * Check the **SFTP server**, **SFTP username**, and **SFTP password** in the Radial settings
> * Retry the return
> * Contact Redo support with the return ID if it keeps failing

## Support

For issues with the Redo integration configuration, return processing, or data synchronization, contact **[support@getredo.com](mailto:support@getredo.com)**.

For issues with Radial access, API credentials, or warehouse operations, contact your Radial account manager or support team.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.