The current article provides integration-specific details for this procedure.
Turn14 Distribution account and credentials
To use X-Cart's Turn14 Distribution integration, you will need a dealer account with Turn14 Distribution. Turn14 is a wholesale distributor and typically requires businesses to meet certain criteria to join. If you don’t have an account yet, apply to become a dealer on the Turn14 Distribution website and complete their onboarding process.
To get your API credentials, check out Settings & Data > API in your Turn14 account.
Connect X-Cart to Turn14 Distribution
To access the Turn14 Distribution integration connection settings, go to Catalog › Catalog Import › Settings › Turn14. The settings you need are located in the Connection section.
 |
|
Your Turn14 Distribution credentials need to be entered into the appropriate fields:
Client ID
Client Secret
Optional: Enable the Order creation test mode
toggle to explore how the Turn14 integration works without processing real orders or spending money.Optional: Enable the Catalog import test mode
toggle to explore how catalog import works on a limited set of products.
Click Save Changes.
Configure shipping for Turn14 Distribution
After connecting to Turn14 Distribution, you need to configure shipping for Turn14 orders.
X-Cart 5.6.x:
The auto integration settings page for Turn14 (Catalog › Catalog Import › Settings › Turn14) no longer includes the Shipping Settings section that was available in X-Cart 5.5.1.x. All shipping-related settings are managed through shipping profiles. See Shipping profiles in X-Cart 5.6.x for more information.
You can create a shipping profile for products sold through Turn14 and define the rules that should be used for shipping calculation. The integration can retrieve shipping rates from Turn14 via API, or you can choose to use flat shipping rates instead. The settings allow you to specify which type of rates should be displayed to customers at checkout. If necessary, you can also configure a handling fee to be added on top of the shipping rates.
 |
|
X-Cart 5.5.1.x:
Shipping settings can be found under Catalog › Catalog Import › Settings › Turn14 in the Shipping Settings section.
 |
|
The Turn14 integration supports multiple approaches to shipping rate calculation:
retrieving real-time shipping rates from the supplier via API
using configured flat shipping rates
offering free shipping for orders over a specified amount
"Shipping rates from supplier" setting (5.5.1.x)
The Shipping rates from supplier setting determines whether shipping rates received from Turn14 via API are displayed to customers at checkout.
Important: Disabling this setting does not stop the store from requesting shipping rates from the supplier. It only controls whether the received rates are shown to customers.
The integration always sends a request to Turn14 for shipping rates as part of the shipment creation process. However, whether rates are actually returned depends on several factors, including:
the terms of your agreement with Turn14 (not all account types provide rates via API)
the availability of the supplier’s API
possible technical issues affecting the response
"Free shipping on orders over [$]" setting (5.5.1.x)
You can offer customers free shipping for Turn14 products when the order total exceeds a specified amount. Enter the desired threshold value in the corresponding field.
Flat shipping rates configuration (5.5.1.x)
Under Catalog › Catalog Import › Settings › Turn14, scroll down to the Shipping Settings section. In this section, click the Manage link near the Flat shipping rates setting.
On the next page, choose to configure a new shipping rate for Turn14 or select an existing one.
Enter the required details.
In the Apply to Stock selector, choose
Turn14.Save the changes.
 |
|
How shipping rates affect checkout
Shipping rates in X-Cart are tied to shipment creation.
A shipment is created only after the store successfully receives a response from the supplier (Turn14).
If the shipment cannot be created (for example, due to missing or failed API response), no shipping rates will be available at checkout.
In this case, no rates will be displayed at all—neither supplier rates nor flat rates.
This behavior ensures that shipping options shown to customers always reflect actual fulfillment capabilities confirmed by the supplier.
Can't find answers you're looking for?
Email us at support@x-cart.com. We will be happy to help!
Related articles