Before you can start using SEMA Data with your X-Cart store, you need to obtain and save in your integration settings a security token that will enable your X-Cart store to make calls to SEMA API. You will also need to configure your SEMA Data integration import options.
For details, see:
Getting Your Security Token for SEMA Data
The process of connecting your SEMA Data integration involves submitting your SEMA Data account username and password on the SEMA Data add-on settings page in your X-Cart store. Your X-Cart store will use those credentials to access SEMA Data on your behalf and obtain a security token required to make calls to the API for data exchange with SEMA Data. If you do not yet have an account with SEMA, you can sign up for an account on SEMA Data website.
To get your security token:
Log in to your X-Cart store's Admin area and go to SEMA Data Settings page.
Method 1:
Go to Catalog > SEMA Data.
Make sure you are looking at the Settings page tab.
Method 2:
On the list of your X-Cart store's add-ons (Apps > My Apps), find the add-on "SEMA Data" and click on the Settings link for it.
Make sure you are looking at the Settings page tab.
Copy and paste your SEMA Data username and password into the CDC login field. The field provides two input boxes: one for your username, and another one for your password. Then click the Generate Token button next to the CDC login field.
Provided that the username and password submitted via the CDC login field are correct, your X-Cart store will connect to SEMA Data and obtain a security token. This token will enable X-Cart to exchange information with SEMA Data. The token will appear in the Your Token field on the same page. Please note that your security token is confidential information.
Click the Save Changes button at the bottom of the screen to save the token.
After you click the Save Changes button, the token will be saved in your X-Cart SEMA Data integration settings.
Your X-Cart store should now be able to connect to SEMA Data and access product information.
Configuring the Import Options
Before you start importing catalog data from SEMA Data, it is essential that you configure the most general options that affect the import process. You can do it using the Import Options section.
To configure the import options:
Use the Import mode setting to specify the mode that you would like to use for importing catalog data from SEMA.
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:
Product name;
Descriptions;
Dimensions;
Prices;
Weight;
Fitments;
Images;
Attributes.
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.
Use the New product status drop-down box to specify whether products newly imported from SEMA Data 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.
Setting up the Currency & Price Conversion
Another important task that needs to be completed before you start importing catalog data from SEMA Data is adjusting currency and price conversion settings in the Currency & Price Conversion section.
As a catalog data provider, SEMA Data provides prices for most products in USD; it may also provide prices for some products in currencies other than USD. The settings in the Currency & Price Conversion section allow you to specify which prices (in which currency/-ies) you want to import from SEMA Data, and which conversion rate should be applied if importing prices set in a currency other than the currency used by the store.
First of all, in this section, you can see what currency is set as your store's default currency.
This information is provided for your convenience; the default currency cannot be edited here. Should you require to change your store's default currency, you will need to do that via your store's Localization settings. You can access your store's Localization settings using the 'Manage' link.
The Currency to import setting sets the currency in which prices will be imported from SEMA Data.
If your store's default currency is USD, the Currency to import option is not adjustable. Only prices set in USD will be imported.
If your store's default currency is a currency other than USD (for example, Canadian Dollar (CAD)), the Currency to import setting is provided as a drop-down selector.
You can use this selector to specify which prices (in which currency/-ies) should be imported from SEMA Data. You will get the option to import:
only the prices in your store's default currency,
only the prices in US Dollar (USD),
prices in both your store's default currency and USD.
For example, if the store's default currency is Canadian Dollar (CAD), you get the following options in the Currency to import selector:
US Dollar (USD);
Canadian Dollar (CAD);
Canadian Dollar (CAD), US Dollar (USD).
For configurations involving the import of prices in a currency other than the store's default currency (for example, when the Default currency is Canadian Dollar (CAD) and the Currency to import is set to "US Dollar (USD)" or "Canadian Dollar (CAD), US Dollar (USD)"), a Conversion rate field is provided. It allows you to set the conversion rate.
The ability to select an option for importing prices in a currency other than USD does not guarantee that such prices will actually be provided in the SEMA Data catalog. If a product in the SEMA Data catalog does not have a price in the currency specified as the Currency to import, the price in the corresponding currency cannot be imported.
Following are some examples that demonstrate what happens with different Currency & Price Conversion configurations.
Example 1
We are doing an import with the following currency & price conversion settings:
Default currency = Canadian Dollar (CAD)
Currency to import = Canadian Dollar (CAD) [Only prices in Canadian Dollars are imported]
Products in the SEMA Data catalog that have a price specified in Canadian Dollars (CAD) are imported into our X-Cart store with prices calculated as Provider's price in CAD [default_store_currency] + Price adjustment value
The price adjustment value in this formula is a discount or markup specified in the brand settings (the fields "Price to Import" and "Price Adjustment").
Products in the SEMA Data catalog that do not have a price specified in Canadian Dollars (CAD) are imported/updated partially (without the price information). Products imported without a price are created in the store catalog as inactive (Available for sale = OFF). Before anyone can buy these products, the store admin will have to adjust their price and activate them.
Example 2
We are doing an import with the following currency & price conversion settings:
Default currency = Canadian Dollar (CAD)
Currency to import = US Dollar (USD) [Only prices in US Dollars are imported]
Conversion rate = 1.34 [Store prices will be shown in CAD as calculated using the set conversion rate]
Products in the SEMA Data catalog that have a price specified in US Dollars (USD) are imported into our X-Cart store with prices calculated as Provider's price in USD + Price conversion rate + Price adjustment value
The price adjustment value in this formula is a discount or markup specified in the brand settings (the fields "Price to Import" and "Price Adjustment").
Example 3
We are doing an import with the following currency & price conversion settings:
Default currency = Canadian Dollar (CAD)
Currency to import = US Dollar (USD), Canadian Dollar (CAD) [Prices in both US Dollars and Canadian Dollars are imported]
Conversion rate = 1.34 [Store prices will be shown in CAD as calculated using the set conversion rate]
Products in the SEMA Data catalog that have a price specified in Canadian Dollars (CAD) are imported into our X-Cart store with prices calculated as Provider's price in CAD + Price adjustment value
Products in the SEMA Data catalog that do not have a price specified in Canadian Dollars (CAD) but have a price specified in US Dollars (USD) are imported with prices calculated as Provider's price in USD х Price conversion rate + Price adjustment value
The price adjustment value is a discount or markup specified in the brand settings (the fields "Price to Import" and "Price Adjustment").
Example 4
We are doing an import with the following currency & price conversion settings:
Default currency = US Dollar (USD)
Currency to import = US Dollar (USD) [Only prices US Dollars are imported]
Products are imported from the SEMA Data catalog with their original prices set in USD.
After making any changes to the settings in the "Currency & Price Conversion" section, be sure to save your changes using the Save Changes button at the bottom of the screen.
Related pages: