Before you can start using Turn14 Distribution with your X-Cart store, you need to obtain and save in your integration settings your Turn14 Distribution API credentials. That will enable your X-Cart store to make calls to the API. You will also need to configure your Turn14 Distribution integration import options.
For details, see:
Getting Your Turn14 Distribution API Credentials
The process of connecting your Turn14 Distribution integration involves submitting your Turn14 Distribution API credentials - Client ID and Client Secret - on the Turn14 Distribution add-on settings page in your X-Cart store. Your X-Cart store will use those credentials to access the Turn14 Distribution on your behalf and make calls to the API for data exchange with Turn14 Distribution.
You can obtain your API credentials at https://www.turn14.com/api_settings.php#docs
Saving Your Turn14 Distribution API Credentials in Your Integration Settings
After obtaining your API credentials for Turn14 Distribution, you need to save them in your X-Cart store:
Log in to your X-Cart store's Admin area and go to Turn14 Distribution integration settings page. The page can be found under the Catalog > Turn14 menu.
Make sure you are looking at the Settings page tab.
Copy and paste your Turn14 Distribution API credentials (Client ID and Client Secret) into the appropriate fields on the page.
Configure your Import Options (see below) and click the Save Changes button at the bottom of the screen to save both the API credentials and the import options.
After you click the Save Changes button, the API credentials will be saved in your X-Cart Turn14 Distribution integration settings.
Provided that the API credentials are valid, your X-Cart store should now be able to connect to Turn14 Distribution.
Configuring the Import Options
Before you start importing catalog data from Turn14 Distribution, it is essential that you configure the most general options that affect the import process.
You can do it right after obtaining your credentials for API access.
To configure the import options:
Use the Import mode setting in the Import Options section to specify the mode that you would like to use for importing catalog data from Turn14 Distribution.
One of the following options can be selected:
Add new products and update existing ones [default option];
Add new products only;
Update existing products only.
If you have specified in the Import mode field that you want products to be updated during an import, use the Update section to specify the types of product data that need to be updated. Select one or more of the following options:
It is required that at least one option be selected in this section; otherwise, the updating of catalog data during an import will not be done.
Important: As you may prefer to import certain types of data from SEMA Data, be sure to also review your store's import options configuration for SEMA Data integration. This step is crucial to avoid conflicts between the two integrations. We strongly advise against enabling the same import options in both SEMA Data and Turn14 Distribution integration settings simultaneously. For instance, having the option "Product name" enabled in both SEMA Data and Turn14 Distribution settings will result in overwriting the product names already present in the store during each new import, with data from the source used most recently (either SEMA Data or Turn14 Distribution).
For configuration examples, see the section Turn14 Distribution vs. SEMA Data Import.
Use the New product status drop-down box to specify whether products newly imported from Turn14 Distribution should be automatically assigned the status "Available for sale". Select one of the following options:
Active: The "Available for sale" property of newly imported products will be set to "On".
Inactive: The "Available for sale" property of newly imported products will be set to "Off".
Note that the selected option will apply to newly imported products only and will NOT affect any products imported earlier.
Click the Save Changes button at the bottom of the screen.
Clicking the Save Changes button will save both the import options and the API credentials.