The product import of the YourSurprise module basicly imports all the products that YourSurprise has to offer. For this import to work it uses a few fields in the configuration screen. The products are imported at a global level, so the products will be available in every store that is configured in the magento installation.

Connection

The import uses the account information of the customer to make a connection to the YourSurprise server to get the offered products. You need to supply the module with the following information to make a connection possible:

The above information should be sent to you by YourSurprise when you created a account. Please make sure you copy and pasted the exact information that is supplied to you or else the import may not work as expected.

Import settings in the configuration screen

During the import the module will check some configuration settings that are set in the backffoffice. The following settings are used:

More information about these fields can be found on the Configuring the Settings page.

Product fields that are used in the import

The import uses a few fields of a product on update/creation. Only the fields found in the table below can or will be set by the module. All other fields will be left unchanged. The fields that are used can be found below:

Field nameDescriptionDefault ValueConfigurable?Set on creation?Set on update?
SKUThe SKU of the product. This is created beginning with "YS_" followed by the YourSurprise Product ID.YS_[yoursurpriseid]
YourSurprise Product IdThe YourSurprise product ID given by YourSurprise. 
Product TypeThe product type (simple, configurable etc.)simple
Attribute SetThe Attribute set where this product belongs to.YourSurprise
VisibilityVisibility on the website.both
StatusStatus of the product (enabled or disabled).disabled
YourSurprise custom optionThe YourSurpriseYoursurprise ID
NameThe name of the product 
Meta TitleThe meta title of the product 
DescriptionThe description of the product 
Short DescriptionThe short description of the product 
Meta DescriptionThe meta description of the product 
Product ImagesThe product images 
Tax ClassThe tax class of a productNone
PriceThe price, including tax, of the product that is used during the checkout 

 From version 1.1.0.1 and up

Product CostThe costs of the product for the reseller, without tax 
Customise AttributeThe on/off attribute to see if this product is customizable 

The  tells you that this will be updated depending on the "Automatically overwrite" option in the configuration screen. If the "Automatically overwrite" option is set to "Disabled", the the fields with  will not be updated and vice versa.

Please be aware that changes to the configuration screen will not be recursively set to all the products that where already imported. For example, if you change the Attribute Set configuration field the products that where already imported will not be changed! If you want to make a change to the way products are imported, please delete all the YourSurprise products and run the import again with the new settings.

Auto update time

In case you activated the "Automatically update" option in the configuration screen, the import process will run once a day at midnight (0:00).