General

The WSPManager (WEBSALE Product Manager) is a Windows program which must be installed on your system. The following data can be sent to the shop server:

• Product data

• Customer data

• Coupon data

Format and content of the data

All data is transferred by means of files. The file names, format and content are described in the following documentation:

• Product and category data: Format and content - WS-SFTP-Produkte PRO (EN)

• Customer data: Format and content - WS-SFTP-Kunden PRO (EN)

• Voucher data: Format and content - WS-SFTP-Gutscheindaten (to-Shop) (EN)

Data transfer

Manual transfer

Call the "Transfer shop data to the Internet" function of the WSPManager. Make sure that the option "Product data and category structure" is activated and start the transfer by clicking the "OK" button.

Automatic transfer ("Autoimport")

With the help of the "Autoimport" function, the import files can be transferred without manual intervention. To configure the Autoimport in the WSPManager click on "Shop settings" in the tree structure in the left part of the window and then select the "Autoimport" tab in the right part of the window. If the "Autoimport" tab is not displayed, you must first call up the "Settings"/"Divers..." menu item and activate the "Show advanced settings" option there.

On the "Autoimport"/"File settings" tab, then select the "Article import Pro" entry under "Import file format". On the "Autoimport"/"Selective transfer" tab, at least the "Product data and category structure" box must be checked. If you want to transfer additional data (e.g. product images) as part of the import, you can of course also use the other boxes on this tab.

The settings on the "Autoimport"/"Error emails" tab are generally not relevant for the article import Pro. If you want to be informed by eMail in case of errors, this has to be configured on the server. (In the shop.config file of the first subshop in the section "ImportErrorMail").

After you have configured the autoimport you can start it by clicking on the green arrow above "Autoimport".

To prevent the transfer of the files from starting before they are fully generated, a special "signal file" must be written to start the transfer. This file is called "start.sgn" and must be placed in the "...\data-exchange\directimport" directory.

Note that after creating the "start.sgn" you must not put any other files into the "...\data-exchange\directimport" directory until the "start.sgn" has been deleted or moved by the WSPManager. If you do so, these files will either not be processed at all or will lead to undesired effects during import.

Sending files

The WSPManager installed at the mail order company or logistics provider manages locally a shop directory with subdirectories.

If product/category files are to be transferred with the WSPManager, they must be stored in the"....\data-exchange\directimport\" subdirectory of the local shop directory. For example, if the shop is located in the directory
"c:\shop\websale8_shop-meinshop", then the directory for the import files is: "c:\shopwebsale8_shop-myshop\data-exchange\directimport".

The files that are imported per subshop must be stored in another subdirectory with the ID of the subshop (SubshopID). Please note that for technical reasons the main shop is treated as the "first subshop" and therefore always has its own SubshopID, even if there should be no other subshop.
Example for a german subshop with the subshopID "german":
"d:\shops\websale8_shop-MeinShop\data-exchange\directimport\german".

All files in the "directimport" directory will only be transferred by the WSPManager if the transfer options "Product data and category structure" or "Stock" are checked.

After the transfer, the local "directimport" directory is renamed to "directimport.1" and archived by moving it to the "...\data-exchange\archiv\" directory. A directory with this name that may already exist there is rotated from the naming (numbering), i.e. an already existing directimport.1 → directimport .2, directimport.2 → directimport.3, etc.

A maximum of 10 directories will be archived. If 10 directories are exceeded, the oldest directory will be deleted.

Customer data to be transferred must be stored in the"....\data-exchange\customerimport\" directory of the local shop directory.

Voucher data in the directory"....\data-exchange\voucherimport\".

Behavior in case of transfer problems

If the WSPManager cannot transmit a data block, it tries to send it again up to ten times, so that not every short disturbance of the connection leads to an abort of the transmission.

If the last attempt to transmit a data block also fails, the entire transmission is aborted. If the WSPManager runs in "Autoimport" mode, it will automatically start a new transmission after an aborted transmission. How often it does this and which pauses it takes between the transmission attempts can be configured in the WSPManager under "WSPManager settings"/ "Data transmission"/ "Autoimport".

If a transfer is restarted (whether manually or automatically), all import files are transferred again. For all other files (e.g. images, templates) the WSPManager remembers if they were transferred and does not send them again.

If the connection is interrupted after the import files have been transferred and while they are being processed on the shop server, this has no effect on the processing of the data, i.e. it is completed as if there had been no interruption.

If an error "E093: Connection error (receive): Timeout" occurs during a transmission, it may be a solution to increase the timeout in the WSPManager ("WSPManager Settings"/ "Data Transmission"/ "Timeout"). In general, however, the cause of the timeout should be eliminated; raising the timeout is only a workaround.