|
|
Overview
With eZCom and RyderShip working together, you’ll be able to implement an effective Electronic Data Interchange (EDI) solution to manage your inventory, orders, and fulfillment data.
An eZCom | RyderShip integration is available to all customers with an eZCom account. eZCom’s platform is called Lingo, which you’ll also see referenced in this article as needed.
The integration allows two different workflows, depending on your needs:
- Importing orders created on Lingo to RyderShip (see Workflow #1 – How it works for more details).
-
Fulfilling orders managed by e-commerce platforms or ERPs integrated with eZCom (see Workflow #2 – How it works for more details).
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.
- Leverage 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.
Workflow #1: Direct integration with eZCom / Lingo
This integration workflow is between RyderShip and eZCom/Lingo. This workflow applies if you do not use an ERP or another e-commerce platform, such as Shopify, for your wholesale orders.
How it works
1. Wholesale orders are received in Lingo from the wholesaler.
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.
2. Order details are pushed from Lingo to RyderShip once the export order tags are applied to the order in Lingo.
If an order comes in from Lingo that contains new items that were added after the initial integration setup, these items are created as new SKUs in RyderShip. Solutions to address this are discussed later in Ongoing Responsibilities.
3. Wholesale orders are batched in RyderShip, and the items are picked and packed at the warehouse.4. RyderShip operations team prepares the cartons for shipping, including printing the GS1/UCC labels and applying them to corresponding cartons.
The GS1/UCC labels can be printed from Lingo or RyderShip. There are limitations on which retailer labels are supported through RyderShip. For more details, see GS1 Label Field Mapping & Setup, or contact your customer success manager.
5. RyderShip notifies Lingo of a new shipment with carton content details.
6. The pickup, if applicable, is scheduled with the wholesaler, and Lingo is updated with pickup details.
If a small parcel is used, which is used for dropship orders, a label is purchased in RyderShip, and Lingo is updated through the integration with tracking details.
7. RyderShip team prepares a master BOL including all shipments going to the wholesaler.
8. When the order is picked up, shipment is confirmed in both RyderShip and Lingo by the Ryder operations team.
9. Lingo notifies the wholesaler that the shipment is on the way, and an ASN is generated in Lingo after Ryder operations completes the details in step 8.
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:
- The type integration you’ll be setting up – a direct integration between eZCom and RyderShip. You do not use an ERP or other e-commerce platform.
- Your ideal go-live date and timeline
- The names of wholesalers you hope 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
|
|
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(s):
- 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”.
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.
5. Reach out to your CSM 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.
- Item’s Country of Origin column must have a valid 2-character ISO-3166 Country Code.
- You must maintain, per item, the RyderShip SKU in the Warehouse XRef even if this is the same SKU used in any other field.
|
|
Workflow #2: Integration with ERP or e-comm & eZCom / Lingo
This integration workflow is between RyderShip, eZCom/Lingo, and the ERP or e-commerce platform that you’re already working with.
How it works
This workflow requires you to use the RyderShip API to connect eZCom orders with RyderShip.
1. Wholesale orders are received in Lingo from the wholesaler.
2. Lingo pushes the orders to the ERP or e-commerce system. Additional costs from eZCom may apply.
Orders from the customer’s ERP/order management system must come down to RyderShip with appropriate metafields in order for this integration to complete steps 4 and onward in the workflow – see details below.
3. Wholesale orders are batched in RyderShip and the items are picked and packed at the warehouse.
4. RyderShip operations team prepares the cartons for shipping, including printing the GS1/UCC labels and applying them to corresponding cartons.
The GS1/UCC labels can be printed from Lingo or RyderShip. There are limitations on which retailer labels are supported through RyderShip. For more details, see GS1 Label Field Mapping & Setup, or contact your customer success manager.
5. RyderShip notifies Lingo of a new shipment with carton content details.
6. 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.
7. RyderShip team prepares a master BOL including all shipments going to the wholesaler.
8. When the order is picked up, shipment is confirmed in both RyderShip and Lingo by the RyderShip operations team.
9. Lingo notifies the wholesaler that the shipment is on the way, and an ASN is generated in Lingo after Ryder operations completes the details in step 8.
10. Lingo notifies the ERP or e-commerce system that orders have shipped. Additional costs from eZCom may apply.
Information sharing
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, ERP/e-commerce system, 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:
- The type integration you’ll be setting up – a direct integration between eZCom and RyderShip. You do not use an ERP or other e-commerce platform.
- Your ideal go-live date and timeline
- The names of wholesalers you hope 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.
|
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. You will see the integration marked as active and syncing in your marketplace.
Tips to use the RyderShip API
You must use the RyderShip API to send orders and items to RyderShip from your existing ERP integration or other e-commerce platform (Shopify).
See the API example below to make sure all the following data is included in your RyderShip API request. Make any changes as necessary.
API example
This API request applies if you’d like to continue to use your existing ERP integration to send orders and items to RyderShip via the RyderShip APIs.
{
"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.
},
"association_fields": {
"order_items": [
{
"originator_id": "1", //same as the corresponding order_items.originator_id
"edi_line_no": "0001", //this is the line number in the edi file
}
]
}
}
}
FAQs
Why are my orders not flowing from Lingo to RyderShip?
Please reach out to Customer Support at support@whiplash.com to help you resolve this issue
Should I send orders both to Lingo and to RyderShip - if using Workflow #1?
Send your orders only to Lingo. The orders will be pushed from Lingo to RyderShip once you’ve added the appropriate tag(s).
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.
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?