Legacy module
The module described in this article has been marked as a legacy module. This means the following:
-
We don't create new features for this module or fix any bugs.
-
The module is not available anymore in Xentral instances (demo or licensed) created after 28-Sep-2022. If you as a new user have special requirements that could only be fulfilled by this module, please contact our customer support team to discuss a solution.
For more information, see also Why is Xentral deprecating some modules and what does this mean for you?
With the Amazon Vendor DF app you can collect product lists and orders from Amazon Vendor as well as define various settings for the shop or marketplace. You can find information about the general setup and workflow of Amazon Vendor DF here.
A general overview of the shipping methods and shipping labels you can use in Xentral can be found here.
If you have been accepted for the Amazon Vendor DF program, the first step is to create an AWS Key and an AWS Secret in Amazon. Next is an Amazon Security Check, where you must accept the data storage questions or you will not be granted access to Amazon Vendor DF.
To get your AWS Key and AWS Secret select User from the navigation menu. Then select your IAM user name (not the checkbox). Open the Security Credentials tab and select Create access key.
To view the new AWS key click Show. To download the AWS Key and AWS Secret select Download. More information can be found here.
Under Administration → Shop Interface → Overview → +NEW you create a new store and select the Amazon Vendor DF module. The Details → Interface tab is displayed.
Under the settings for store and marketplace enter the AWS data you just received. In addition enter further data such as your Client ID and the Client Secret, which you received during the Amazon Vendor registration. Finally click on Test Connection to test the connection.
For a quick start you only need a few settings and actions. You can find out about the necessary requirements for a quickstart with order import, stock number comparison, and feedback of tracking numbers here.
In the Details tab you can enter different settings, e.g. for the interface, payment methods, or shipping methods.
In the Interface subtab you can enter different information about the interface of Xentral and Amazon Vendor.
Settings
-
Designation → You can select any name for the shop. It is displayed e.g. in the article and the import menu.
-
Active → To be able to use the interface, this check box must be selected. Interfaces that are no longer needed can be set to inactive.
-
Project → The specified project is linked to the shop. Logistics settings can be made in the project.
-
Pick-up mode → Select the pick-up mode from the drop-down menu.
-
Date from, Time → Select the date and time from which the orders are to be retrieved.
-
Import mode → Select the required import mode from the drop-down menu. In automatic mode the active process starter picks up the orders from the store importer. In manual mode you need to click on Pick up orders. In demo mode only one order is picked up - there is no feedback to the shop. So the order status in the shop will not be changed and no items or stock numbers will be transferred.
-
Only 1 order per request → By selecting this check box only one order will be picked up per request by Xentral from Amazon Vendor.
-
Orders in intermediate table → When you select this check box, the orders fetched from the shop importer are displayed in an intermediate table. The shop importer does not create orders in the process. To be able to use them, the manual release of the intermediate table is necessary.
-
Order Limit → Here you can specify the maximum number of orders that are actually fetched or processed.
-
Tax Type → Select the tax type from the drop-down menu. This is relevant for the transfer of tax information to Amazon Vendor. VAT is the default tax type.
-
Refresh Token → This information is provided by Amazon Vendor Registration.
-
Client ID → This information is provided by Amazon Vendor Registration.
-
Client Secret → This information is provided by Amazon Vendor Registration.
-
AWS Key → This custom information is provided by Vendor Central.
-
AWS Secret → This custom information is provided by Vendor Central.
-
Selling Party ID → Enter the ID of the seller here.
-
Address Record for Receipts → The address record for receipt processing is required as shipping and billing information are not going out to the actual buyer but to Amazon Vendor DF. The customer will only receive the delivery note after making a purchase from Amazon
-
Warehouse ID → Enter the ID of the warehouse. This is supplied by Amazon Vendor Central.
-
Name → Enter the name of the warehouse. This can differ from the name in Amazon Vendor.
-
Street → Enter the street where the warehouse is located. This may differ from the street name in Amazon Vendor.
-
City → Enter the city in which the warehouse is located. This may differ from the city name in Amazon Vendor.
-
Zip code → Enter the ZIP code of the city in which the warehouse is located. This may differ from the ZIP code in Amazon Vendor.
-
Country → Enter the country in which the warehouse is located. This may differ from the country specified in Amazon Vendor.
-
State → Enter the state in which the warehouse is located. This may differ from the state specified in Amazon Vendor.
After entering all the information click Save.
The overview at the bottom of the page displays a live table:
You can choose from the following filters:
-
Errors only → Selecting this filter will only show the errors that the importer has logged.
-
Show jobs → Selecting this filter the most recently imported jobs will be shown. Each job is expandable via the minidetail to show the actual data.
Show changes → Selecting this filter the changes in the importer are shown, i.e. when and what was changed.
Action
-
Check connection → Xentral checks whether the connection to the shop was successfully established with the access data entered. If the connection was successful, success is displayed. If there are several subshops in the shop, the subshops and their IDs are listed.
-
Fetch orders → Fetches all orders from the shop that match the settings. Only click this button when the manual import mode is selected.
-
Store import intermediate table → Jumps to the intermediate table of orders from the shop. The intermediate table is only filled in the manual import mode and if the Orders in intermediate table option is enabled.
Importer specific settings
You can set importer specific settings here among other things.
These fields can be filled:
-
Report cancellation → When you select this check box, Xentral reports the cancellation back to the shop.
-
Make taxation in third countries dependent on delivery address → When you select this check box, the taxation in the third country is made dependent on the respective delivery address of the order.
-
Set total amount → When you select this check box, the total amount will always be transmitted during order import.Xentral will no longer calculate it separately.
-
Maximum difference to the calculated sum → You can specify the maximum difference between the calculated total in the shop and the calculated total in Xentral.
-
Overwrite direct debit data in address → When you select this check box, the direct debit data is overwritten. This option is only available for ePages. There bank details that were transferred in the shopping cart will be overwritten in the corresponding address.
More information about this tab can be found here.
Information about this tab can be found here.
The Shipping methods subtab contains a table in which you can find all the shipping methods that are available for this shop and create additional shipping methods. In this interface you specify how a particular shipping method should be transferred to the shop. This is important, as the names of the shipping method in Xentral and in Amazon Vendor DF often differ. In addition the shop expects different shipping method descriptions.
Create a new shipping method above the table with the corresponding correct labels:
Fill in the following fields:
-
Shipping method shop → Specify the shipping method name in the shop.
-
Shipping method Xentral → Select the name of the shipping method in Xentral from the drop-down menu
-
Shipping method outgoing → Specify the outgoing shipping method name when submitting to Amazon.
-
Country → Specify the shipping country as a 2-digit ISO code, for example DE for Germany and AT for Austria. If there are multiple shipping countries, enter the ISO codes separated by commas.
-
Auto-shipping active → Always select this check box.
-
Fast-Lane → Select this check box to activate Fast-Lane.
Click Save.
A general overview of the shipping methods and shipping labels you can use in Xentral can be found here.
The Language/Supply Country subtab allows you to set a core function. This allows you to assign different document languages to specific shipping countries. The interface also shows an overview of the used document languages of the projects in the respective countries. It is possible to create additional subshops.
In the field above the table you can create the language or the country of delivery.
You have to fill in the following fields:
Country → Enter the country of delivery as ISO2 country abbreviation.
Language → From the drop-down menu select the language to be used for the documents for the respective delivery country. Currently, German, English, French, Dutch, Italian, and Spanish are available.
Project Xentral → Here you enter the corresponding project in which this language should be used.
Click Save.
The Group mapping subtab shows an overview of all group-mapped customers, whereby additional customers can also be created.
Currently groups are not transmitted from the shop nor does Xentral transfer groups to the shop. However, groups can be mapped.
The following fields are to be filled in for this purpose:
-
Role → Select the role from the drop-down menu.
-
From → Select from the drop-down menu which shop will supply the group.
-
Project Xentral → The project to which this group is to be linked is to be entered.
-
Group in the shop → Enter the respective name of the group in the shop.
-
Automatically assign new customers → Select this check box and new customers will automatically be assigned to this group.
Click Save.
In the Artikel Übertragung tab you can load and transfer products. The table shows the products that are to be transferred. You can load the products either individually or in categories.
There are several actions available for the product transfer.
The following actions are possible:
-
Reset inventory count cache → This button clears the stock number cache.
-
Reset product cache → This button clears the article cache.
-
Load all products → This button transfers all articles to the store.
-
Load all changed products → This button loads all products in the overview to which changes have been made.
-
Cancel transfer entirely → This button cancels all transfers of the products located in the table and no transfer to the shop takes place
You can to load products or categories with the products they contain into the table in order to transfer them in the next step.
Note
Before products or categories can be loaded, you have to set the checkmark in the yellow highlighted message. Otherwise no transfer is possible.
It is not possible to load products and categories at the same time. This must happen consecutively.
Enter the desired product or category or select it via the magnifying glass icon. Then click Load so that the selected item appears in the table. It is also possible to load products or categories including matrix or variants. To do this, select the incl. matrix/variants check box.
For information on Amazon Vendor DF workflows, see this article .