Skip to main content

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: 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 with your Radial details, and Redo connects it for you.

Prerequisites

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.
Redo reads Radial item numbers from Shopify variant metafields, so returns need to come from a Shopify order.
Add each item’s Radial item number to the variant metafield custom.ql_item_number in Shopify.
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

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.
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
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
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. For issues with Radial access, API credentials, or warehouse operations, contact your Radial account manager or support team.