Once you have connected your Springboard Retail account to your Magento eCommerce store, you can start pulling items from Magento. If you have not completed this step yet, please see this article first: Configuring Your Magento Integration
If you do not want to sync your items from Magento, you can choose to manually manage the item records in both Springboard Retail and Magento separately.
Prerequisites to starting a sync
Create matching tax rules for your tax classes
To ensure your items are properly taxed, you will want to create tax rules in Springboard for the corresponding tax classes in Magento.
To view your existing tax classes on Magento:
- Log in to your Magento admin panel
- Along the top bar select Sales -> Tax -> Product Tax Class
You can view your existing tax categories and rules in Springboard by navigating to Settings -> Tax. To create new tax rules please see this knowlegebase guide: Tax rules and jurisdictions in Springboard
Matching existing items to avoid duplicates
If you already have items in both Springboard Retail and Magento, you will want to ensure we link these items to avoid creating duplicate items. To do this you will need to make the Springboard Retail Item # and the Magento SKU field both contain the exact same value. As long as both these numbers match, we will know these items are one and the same so we will not create an additional item.
Create corresponding attributes and custom fields
During the sync process you will need to map fields in Springboard to attribute sets on Magento. To ensure you have all the data you need, you will want to make sure you have created the necessary fields/attributes in both locations.
To create custom fields in Springboard Retail, you can follow this knowledgebase guide: Adding, Editing or Deleting Custom Fields
On Magento, you can view the attributes which will assist you in creating custom fields on Springboard Retail.
- Log in to your Magento admin panel
- Along the top bar select Catalog -> Attributes -> Manage Attributes
If your field is a picklist on Magento and you would like it to be a picklist on Springboard, you will want to add the values to the custom field in Springboard.
Once you have finished the prerequisites, you are ready to choose one of the two sync methods.
Pull Items from Magento to Springboard Retail
With this configuration, Magento becomes the master record holder and we sync the items into Springboard Retail. This setup is ideal if you will be having items in store that you do not want listed online because if you create an item in Springboard Retail it will not sync to Magento.
Important: In order for items to sync from Magento to Springboard Retail, all Springboard required fields must be entered on Magento. Cost is required in Springboard but not on Magento by default, so we recommend making the cost attribute a "Required Value" to ensure your products are synced properly.
Map item fields
You will now be able to map fields from Springboard to Magento to initiate a sync. Start by going back to the Magento integration page on Springboard Retail and select the Item Information Tab. From here you can select Pull Sync and you should see a list of all of your Magento attribute sets.
You will want to create a field mapping for each attribute set that you would like to sync to Springboard Retail. This means you can ignore a certain group of products if you have some online-only products, you can just not sync that specific attribute set.
Once you select an attribute set, you will be presented with a list of attributes on Magento to be able to map Springboard fields.
You will select an attribute and match it to a field in Springboard using the dropdown.
The Sku field on Magento must be mapped to a unique field in Springboard as they need to each contain a value that is only used for one single item. If you do not see your field as a selectable option to map to Sku, go to Settings -> Custom Fields and select your custom field to verify Unique is turned on.
Below is a list of recommended field mappings for default Springboard Retail fields:
Once you have completed mapping all fields that you would like synced between the two systems, you can scroll to the bottom and check the box to begin syncing!
The initial sync will begin shortly and your items will start appearing in batches. It can take several hours before your initial sync will complete. If you view the events tab on the Magento integration page, it will display when the sync has completed.
During this process, if any items have incompatible field values, they will fail to sync and you will need to select the errors tab to resolve those issues to sync the items. Please see a guide on error resolution here:
Manage Items Manually
When you select to manually manage item information, we will not create items automatically on either system. In this scenario, you are in charge of creating the items on both systems and you will need to make the Item # in Springboard identical to the Magento SKU field. This sync method is recommended for advanced users and custom applications as missing items can cause sales orders to fail to sync.