Table of contents
- Interface features
- Shop settings
- Article transfer
With the "Amazon Vendor DF" app, article lists and orders can be collected from Amazon Vendor. Various settings for the store or marketplace. can be entered. Information about the general setup and workflow of Amazon Vendor DF you can find here.
A general overview of the shipping methods and parcel labels you can use in Xentral you can find here.
- Pick up article lists
- Pick up orders
Create AWS data in Amazon Vendor DF
If you have been accepted for the Amazon Vendor DF system, 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 a data storage questionnaire 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. Select your IAM user name (not the checkbox). Open the Security Credentials tab, then select "Create access key".
To view the new AWS key, click "Show". To also download the AWS Key and AWS Secret, select "Download". More information can be found here.
Create interface in xentral
Under Administration → Shop Interface → Overview → NEW you create a new store and select the module Amazon Vendor DF. You will directly land in the tab Details → Interface
Under the settings for store and marketplace you enter the AWS data you just received. In addition, you 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.
To get started as soon as possible, only a few settings and actions are required. What is necessary for a quickstart with order import, stock number comparison and feedback of tracking numbers you can read here.
In the tab Details you can enter different settings, e.g. for the interface, payment methods or shipping methods.
In the sub tab Interface you can enter different information about the interface of xentral and Amazon Vendor.
- Name → The name for the store is freely selectable, it is displayed e.g. in the article and in the import menu.
- Active → To be able to use the interface, the box must be checked. Interfaces that are no longer needed can be set to inactive
- Project → The specified project is linked to the store. Logistics settings can be made in the project
- Pickup mode → The pickup mode is to be selected from the drop-down menu.
- Date from, time → The date as well as the time from which the orders will be picked up is to be specified.
- Import mode → The desired import mode is to be selected from the drop-down menu. In the "Automatic" mode, the active process starter picks up the orders from the store importer. In manual mode, in addition to selecting this mode from the list, click on the "Pick up order" button. In demo mode, only one order is picked up, there is no feedback to the store. So the order status in the store will not be changed and no items or stock numbers will be transferred
- Only 1 order per request → By checking the box, only one order will be picked up per request from xentral to Amazon Vendor.
- Orders in intermediate table → By ticking, the orders fetched from the store importer are displayed in an intermediate table. The store importer does not create the orders in the process. To be able to use them, the manual release of the intermediate table is necessary.
- Order Limit → By specifying the limit, the number of orders that are actually fetched or processed can be reduced.
- Tax Type → The tax type must be selected 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 → The ID of the seller is to be entered here
- Address Record for Receipts → The address record for receipt processing is required because shipping and billing information does not go to the actual buyer, but to Amazon Vendor DF. The customer will only receive the delivery bill after making a purchase from Amazon
- Warehouse ID → The ID of the warehouse is to be entered, this is supplied by Amazon Vendor Central.
- Name → The name of the warehouse is to be set, this can differ from the name in Amazon Vendor.
- Street → The street where the Warehouse is located is to be entered. This may differ from the street name in Amazon Vendor.
- City → The city in which the Warehouse is located is to be entered. 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 postal 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 → The state in which the Warehouse is located is to be entered. This may differ from the state specified in Amazon Vendor.
After entering all the information, click the Save button.
The overview at the bottom of the page will display a live table:
You can choose from the following filters:
- Errors only → Checking this will show the errors that the importer has logged.
- Show jobs → By ticking, all the most recently imported jobs will be shown. Each job is expandable via the mini-detail to show the actual data.
Show changes → By ticking the changes in the importer are shown, i.e. when and what was changed can be read
- Check connection → xentral checks whether a connection to the store could be successfully established with the entered access data. If the connection was successful, "success" is displayed. If there are several subshops in the store, the subshops and their IDs are listed.
- Fetch orders → Fetches all orders from the store that match the settings. The button must be pressed only in manual import mode
- Store import intermediate table → Jumps to the intermediate table of orders from the store. The intermediate table is filled only 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 → By checking this box, xentral reports the cancellation back to the store.
- Make taxation in third country dependent on delivery address → By checking the box, the taxation in the third country is made dependent on the respective delivery address of the order.
- Set total amount → By checking this box, the total amount will always be transmitted during order import, xentral will no longer calculate it separately
- Maximum difference to calculated total → You can specify the maximum difference between the calculated total in the store and the calculated total in xentral
- Overwrite direct debit data in address → Checking this option will overwrite the direct debit data. 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.
In the sub-tab "Shipping methods" you can see in a table the shipping methods that are possible with this store and create additional shipping methods. In this interface you specify how a particular shipping method should be transferred to the store. This is important, because often the names of the shipping method in xentral and the name in Amazon Vendor DF differ. In addition, the store expects different shipping method descriptions.
Create shipping type
Create a shipping type above the table with the corresponding correct labels:
Fill in the following fields:
- Shipping method store → Specify the shipping method name in the store.
- Shipping method xentral → Select the name of the shipping method in xentral from the drop-down menu
- Shipping method outbound → Specify the shipping method name that goes outbound 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 tick the box.
- Fast-Lane → Check the box to activate Fast-Lane.
Finally, click on the "Save" button.
A general overview of the shipping methods and package labels you can use in xentral can be found here.
There are currently no free fields for Amazon Vendor DF.
Subshop mapping is currently not available for Amazon Vendor DF.
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.
Create language/delivery country
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, enter 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.
Finally, click on the Save button.
The sub-tab "Group mapping" shows an overview of all group-mapped customers, whereby additional customers can also be created.
Create group mapping
Currently, groups are not transmitted from the store nor does xentral pass groups to the store. 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 store will supply the group.
- Project xentral → The project to which this group is to be linked is to be entered.
- Group in store → The respective name of the group in the store is to be entered
- Automatically assign new customers → By checking the box, new customers will be automatically assigned to this group.
Finally, click on the Save button.
In the Smarty subtab, there is the ability to use Smarty to manipulate or refine the shopping cart. For example, you can change the salutation, which is "Woman" in Amazon Vendor, to "Company" by specifying it in this interface in xentral. However, the use of Smarty is optional here.
In the Article transfer tab you can load and transfer articles. The table shows the articles that are to be transferred. You can load the articles either individually or in categories.
You have several actions available for the article transfer.
The following actions are possible:
- Reset stock number cache → This button clears the stock number cache.
- Reset article cache → This button clears the article cache
- Load all articles → This button transfers all articles to the store
- Load all changed articles → This button loads all articles in the overview to which changes have been made
- Cancel transfer completely → This button cancels all transfers of the articles located in the table and no transfer to the store takes place
Loading articles and categories
It is possible to load articles or categories together with the articles they contain into the table in order to transfer them in the next step.
Note: Before articles 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 articles and categories at the same time. This must happen one after the other.You have to enter the desired article or category or select it via the magnifying glass icon. Then click on Load, so that the selected item appears in the table. It is also possible to load the articles or categories including matrix or variants. To do this, check the box "incl. matrix/variants".
For information on Amazon Vendor DF workflows, see this article.