Note: Our name is changing from Whiplash to RyderShip!

In this article:

Introduction

When growing an e-commerce business, implementing, connecting, and managing an Electronic Data Interchange (EDI) is no small feat. To help merchants better navigate selling their products through new channels and retailers, they can rely on RyderShip’s integration with eZCom. Together, we provide a complete solution to manage e-commerce data, inventory, orders, and fulfillment across both direct-to-consumer and retail.

eZCom integration with RyderShip’s Warehouse Management System (WMS) is available to all customers with an eZCom Lingo account. The integration allows:

Importing orders created on Lingo to RyderShip.
Fulfilling orders managed by e-commerce platforms or ERPs integrated with eZCom (see the alternative flow).

Benefits

Leveraging RyderShip and eZCom for your wholesale orders allows you to:

Stay up-to-date with retailer rules to avoid costly chargebacks and slowdowns.
Work with routing and compliance specialists to ensure accurate shipment routing and maintaining compliance with your retail trading partners.
Leveraging advanced wholesale solutions for your business and partner with eZCom’s existing retailers, e-commerce platforms, and ERPs (additional costs may apply from eZCom).
Take advantage of automated processes that increase warehouse efficiency and reliability.

GS1 labels and templates are supported for customers with an eZCom integration. If you're a RyderShip customer, see GSI Label Overview for more information.

How it works

Wholesale orders are received in Lingo from the wholesaler.
Note: Items in Lingo must contain the RyderShip SKU in the Warehouse Xref attribute regardless of the other attributes in which this same SKU may appear.
A. Orders details are pushed from Lingo to RyderShip.
Note: If an order comes in from Lingo that contains new SKUs, these new SKUs are automatically created in RyderShip.

B. Additionally, if an e-commerce platform (i.e., Shopify) or ERP is integrated with eZCom, Lingo will also push orders to this system (additional costs from eZCom may apply).
Wholesale orders are batched in RyderShip and items are picked and packed at the warehouse.
The RyderShip team prepares the cartons for shipping, including printing the GS1/UCC labels and applying them to corresponding cartons.
RyderShip notifies Lingo of a new shipment with carton content details.
The pickup, if applicable, is scheduled with the wholesaler and Lingo is updated with pickup details.
If a small parcel is used, a label is purchased, and Lingo is updated with tracking details.
RyderShip team prepares a master BOL including all shipments going to the wholesaler.
When the order is picked up, shipment is confirmed in both RyderShip and Lingo.
Lingo notifies the wholesaler that the shipment is on the way and an ASN is created.
If an e-commerce platform (i.e., Shopify) or ERP is integrated with eZCom, Lingo will notify this system that orders have shipped (additional costs from eZCom may apply).

Information sharing

Lingo pushes these order details to RyderShip:

SKU
SKU quantity
Order type
Recipient’s full name
Shipping method
Carrier
Shipping address
Billing address
Contact phone
Shipping notes
Tracking data
Whether signature is required
Whether order contains alcohol
Estimated delivery date
Return address

Lingo pushes product information to RyderShip with each order:

SKU
Vendor name
Product name
Description
Weight
Dimensions
Price
Country of origin

RyderShip notifies Lingo of the following shipment details for each shipment:

Order Number
Store #
UPC
Quantity in Carton
Carton Number
Package weight

Setup instructions

Complete the following steps to set up an integration between your online store, RyderShip, and eZCom.

Complete these first steps:

1. Be a current customer of eZCom and have a Lingo account.

Interested but don’t have an account with eZCom yet? Contact our Partnerships team to find out more.

2. Contact your RyderShip Customer Success Manager (CSM) to request the eZCom integration and share the following information:

Do you want to setup the direct integration (eZCom | RyderShip) or leverage the ERP alternative flow (ERP | RyderShip)?
What is your ideal go-live date and timeline?
Which wholesalers are you hoping to work with?
Contact details of the person who can provide your eZCom Lingo Warehouse Login.

Connect eZCom and RyderShip using the Integrations marketplace

1. In RyderShip, click the menu under your Customer name, and then click Integrations.

The Integrations marketplace page opens.

2. Locate the integration to install and click Learn More.

3. Click Get Integration to connect RyderShip with the integration.

If you already have an instance of this integration installed, you’ll click Connect instead.

4. Click Connect to automatically add your RyderShip auth code and link RyderShip to the integration.

5. Click Connect to authenticate your eZCom account.

6. Enter the following eZCom information for your account:

Account name
API Key
User name
User password

eZCom can help you with these items, if needed.

7. Click Connect.

8. Once you’re fully connected, click Next to move to the Configure process.

Load the configurations for the new integration

The configuration settings will load automatically and will take some time to complete.

During the load process, you’ll see a date in the upper right corner appear, indicating when the options were loaded.

If you continue to see “Options loaded never” and a date doesn’t appear, the initial sync was unsuccessful. You can find more information in the logs.

Important workflow and Warehouse XRef setup

During the setup process, it’s necessary to set tags that reflect the status of the orders and items that flow to RyderShip. You'll also need to set up the Warehouse XRef correctly.

1. Next, you’ll see the following page where you must complete the tags for orders and items correctly to successfully run a normal sync or “sync”.

2. The tag dropdowns have been populated with the specific tags from eZCom for your integration instance (tenant) for you to select.

The eZCom team will assist you with the following:

Enabling “Custom document/Item tags”
Setting up initial tags for orders to match up to the tags listed in the Configuration section of integration setup:
- RyderShip Order Export Pending
- RyderShip Order Export Successful
- RyderShip Order Export Failed
Setting up initial tags for items to also match the tags listed in Configuration:
- RyderShip Item Export Successful
- RyderShip Item Export Failed

Additionally, for each partner (wholesaler) that will be part of this integration, the eZCom team will also assist configuring the default document tag for that partner’s orders to “RyderShip Order Export Pending”.

Note: These requirements are not applicable if the customer uses the alternative flow, where the ERP communicates directly to RyderShip.

3. Save your item and order tag selections. Keep in mind that you won’t be able to run a normal sync until it has been enabled by a RyderShip admin. If you try to run a sync prior to being enabled, you’ll receive an error in your sync logs.

4. Work with your customer success manager and your eZCom team to successfully pull items into RyderShip by ensuring the RyderShip SKU is in the "Warehouse XRef ."

If this is not setup properly, it could duplicate your SKUs in RyderShip and not accurately build the eZCom order with the right items.

Note: These requirements are not applicable if the customer uses the alternative flow, where the ERP communicates directly to RyderShip.

You must reach out to your Customer Success Manager to enable the configuration and confirm that RyderShip is prepared to ship your eZCom packages.

Your integration will not be complete until it’s enabled by RyderShip.

Optional: Set the sync frequency

Under Schedule, you can set the time frequency of your normal syncs for this integration. Options include:

Every 30 minutes
Every 10 minutes
Paused

Note: If you're unsure of the best sync frequency for your integration, reach out to your Customer Success Manager to confirm how regularly you'll want to run the syncs.

Update the frequency and then click Save (saves only & does not start a manual sync) or Save + Sync Now (saves & begins a manual sync).

You’ll know your integration is active when a RyderShip team member has confirmed they performed an initial sync and you will see the integration marked as active and syncing in your marketplace.

Ongoing responsibilities

You must maintain your item catalog in Lingo.
You are responsible for the initial setup of items in Lingo.
You are responsible for adding/deleting items in Lingo.
You must maintain, per item, the RyderShip SKU in the “Warehouse XRef” even if this is the same SKU used in any other field.
Item’s Country of Origin column must have a valid 2-character ISO-3166 Country Code.

Note: These responsibilities don’t apply if the customer uses the alternative flow, in which the ERP communicates directly to RyderShip.

FAQs

Will we need to provide a Lingo login for the RyderShip team?

Yes, you will need to provide the RyderShip team with a Lingo login with access to the Lingo APIs. eZCom has a Warehouse Login credential you can share with the RyderShip team to help them complete the setup and initial testing. Additional costs from eZCom may apply for this login.

How will my orders flow to my e-commerce platform or ERP?

We recommend that you reach out to eZCom to discussion options to integrate your e-commerce platform or ERP into your order workflow. You can review the Alternative Workflow to see how this integration can support workflows that feed orders from outside of eZCom.

Where in Lingo do I add the RyderShip SKU?

The RyderShip SKU must be in the Item’s "Warehouse Xref" attribute in Lingo. To view or enter this information, in Lingo navigate to Administration > Item/Carton Maintenance > Edit Item. Scroll down to the “External Inventory/Warehouse System” section.

Why do I see duplicate SKUs?

On the initial sync, the integration will first create duplicate SKUs in RyderShip, which we will auto merge with the existing RyderShip SKU. If any new SKUs are added after the initial sync, it will be up to the customer to merge them.

For more information on how to handle duplicate SKUs, click here.

Why are my orders not flowing from Lingo to RyderShip?

Please check the rules you have set up in Lingo on which orders to tag to flow to RyderShip.

During the go-live setup process, eZCom team will assist you with the initial setup of these rules.

Example: Configure initial tags for orders (Whiplash Order Export Failed, Whiplash Order Export Pending, and Whiplash Order Export Successful) and items (Whiplash Item Export Failed and Whiplash Item Export Successful).

Also, please confirm that items have the RyderShip SKU in the Item’s "Warehouse Xref" in Lingo.

Where can I find a list of country of origin codes?

The ISO 3166 country codes can be found at here.

Should I send orders both to Lingo and to RyderShip?

No, orders should only be sent to Lingo.

The automated processes should push those orders from Lingo to RyderShip. During the go-live setup process, it is strongly advised to stop other processes that you may currently have in place to send orders directly to RyderShip to prevent duplicate orders.

What are the units of measure that RyderShip supports?

Currently, RyderShip only supports “each” as a unit of measure.

How can I set up a new trading partner?

If you wish to set up a new trading partner with eZCom and RyderShip, you'll need to confirm what the requirements are in the trading partner's routing guide. This can be reviewed by your operations team, eZCom and the RyderShip integration team. For example, if the trading partner requires truck IDs or grouping shipments into pallets, we will need to review those to confirm the proper workflow.

Can I use this integration if I still want my ERP to control the release of orders to Whiplash?

Yes, we offer an alternative flow if you’d like to continue to use your existing ERP integration to send orders and items to RyderShip via the RyderShip APIs.

Here’s what the alternative flow would look like:

Only the first couple of steps vary from the main flow, given the ERP communicates directly to RyderShip. You will not need to maintain the RyderShip SKU in the Lingo Item’s "Warehouse Xref", but you will still have to provide RyderShip with a Lingo warehouse account.

Additionally, you may need to make changes to make sure all the following data is included in your RyderShip API request. See API request below for details.

API request


{ 
"order_type": "wholesale" or "dropship",  
//... order details  
"order_items": [  
    { 
        "item_originator_id": "3105681659", // sku, or id can be used to indicate the item instead  
        // ... other order item details 
        "originator_id": "1", // This could be the line number in the edi file or the line number in NetSuite  
        "quantity": 1 
    }  
    ], 
"meta_fields": {  
    "fields": {  
        "ezcom_documentId": "5610689846", // Document id of the order in ezcom that will be updated by the integration.  
        // ... other edi and meta fields 
        "edi_vendor": "",  
        "edi_distribution_center": "",  
        "edi_department": "",  
        "edi_department_description": "",  
        "edi_merchandise_type_code": "",  
        "edi_vendor_number": "",  
        "edi_start_date": "",  
        "edi_cancel_date": "",
        "edi_po_number": "",
        "edi_store": ""
    },  


    "association_fields": { 
        "order_items": [  
            {  
            "originator_id": "1", //same as the coresponding order_items.originator_id  
            "edi_line_no": "0001", //this is the line number in the edi file  
            // ... other edi and meta fields  
            "edi_item_alias": "",  
            "edi_item_color": "",  
            "edi_item_size": "",  
            "edi_customer_style": "" 
            }  
        ] 
    } 
    } 
}

Related questions:

What does the eZCom integration do?

What are the benefits of eZCom?

How does eZCom work?

How do I start/set up my integration with eZCom?

What are the setup requirements for eZCom?

eZCom Integration