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’sReceivingDetail 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.
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 SFTP Account
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.
Shopify Store
Shopify Store
Redo reads Radial item numbers from Shopify variant metafields, so returns need to come from a Shopify order.
Radial Item Numbers on Variants
Radial Item Numbers on Variants
Add each item’s Radial item number to the variant metafield
custom.ql_item_number in Shopify.Label Code Type
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
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.
Important considerations
Troubleshooting
ASN failures show on the return in Redo. Retry from the return’s actions menu after you fix the cause.Items Have No Radial Item Number
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_numberin Shopify - Retry the return
No Carton Code on the Label
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
ASN Could Not Be Delivered
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