Before you can start using ASAP Networks with your X-Cart store, you need to obtain and save in your integration settings an API key that will enable your X-Cart store to connect to ASAP Network. You will also need to configure your ASAP Network integration import options.
For details, see:
Getting Your Web API Key for ASAP Network
ASAP provides an API for accessing product information and bringing it over to your store. To be able to use this API, the ASAP Network integration in your store will need a Web API key (also known as "Bearer Authorization Token"). The Web API key is supplied by ASAP Network. To get your API key:
Login to your ASAP Network account. If you do not yet have an account, you can create one at ASAP Network Automotive Data Website.
Go to the ASAP Developer API page. This page provides a form that needs to be completed. You may need to scroll down the page to be able to see the form.
Note that the form is not visible on the page unless you are logged in.
The form looks as follows:
Complete the form with your information and submit it.
After reviewing your request, ASAP will set your account up to begin using the API. Your API key will be auto-generated for you.
You will be able to find your API key in the API Keys section of your ASAP account.
See the WEB API Key section:
You will need to copy and paste this API key to be able to save it in your ASAP Network integration settings in your X-Cart store.
Saving Your Web API Key in Your ASAP Network Integration Settings
After obtaining your Web API key for ASAP Network, you need to save it in your X-Cart store:
Log in to your X-Cart store's Admin area and go to ASAP Network Import Settings page.
Method 1:
Go to Catalog > ASAP Network.
Make sure you are looking at the Import Settings page tab.
Method 2:
On the list of your X-Cart store's add-ons (Apps > My Apps), find the add-on "ASAP Network" and click on the Settings link for it.
Make sure you are looking at the Settings page tab.
Copy and paste your ASAP Network Web API key into the respective field.
Click the Save Changes button at the bottom of the screen to save your changes.
After you click the Save Changes button, the Web API key will be saved in your X-Cart ASAP Network integration settings. Provided that the API key is valid, your X-Cart store should now be able to connect to ASAP Network and access product information.
Configuring the Import Options
Before you start importing catalog data from ASAP Network, it is essential that you configure the most general options that affect the import process. It can be done in the Import Options section of the ASAP Network Settings page.
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 ASAP.
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.
Also, choose the update mode that meets your needs:
Update only products that require updating [Update only those X-Cart products that have been updated in the ASAP Network catalog since the latest import.]
Update all existing products [Update all existing X-Cart products, regardless of whether updates are available in the ASAP Network catalog.]
Use the New product status drop-down box to specify whether products newly imported from ASAP Network 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.
After you click the Save Changes button, the import options will be saved the way you have adjusted them.
Setting up the Currency & Price Conversion
Another important task that needs to be completed before you start importing catalog data from ASAP Network is adjusting currency and price conversion settings in the Currency & Price Conversion section.
As a catalog data provider, ASAP Network provides prices for products in USD. The settings in the Currency & Price Conversion section allow you to specify a conversion rate that should be applied if the currency used by the store is different from the currency in which prices are imported.
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 ASAP Network.
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.
Currently, X-Cart's ASAP Network integration supports the import of prices only in the US Dollar (USD); hence, the selector will have only one option: 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)"), a Conversion rate field is provided. It allows you to set the conversion rate.
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 = 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 ASAP Network 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 2
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 ASAP Network 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: