Note
This article describes the previous connection (legacy). You set up the current integration under Settings > Integrations, see article Amazon: Overview. How to switch and what changes is described in the article Updating the shop importer.
In this section you will be explained the possible settings in the shop interface.
When you open the Amazon interface settings, you will first be in the Details > Interface tab.
Settings:
-
Designation: Name freely selectable for the shop (shown e.g. in the product and in the import menu)
-
Active: Check the box to make the interface active. You can set interfaces that are no longer needed to inactive
Note
If your token is invalid, your shop interface will be disabled and this information will be displayed in your System Health Dashboard.
-
Project: Linking the shop to a project. In the project you can make the logistics settings
-
Pickup Mode: You can pick up from a specific date at Amazon
-
Date of: From this point on, sales orders are picked up, updates when you use the Pick Up Sales Orders function
-
Interface start: No sales orders are picked up before this date
-
Import Mode: Determines whether the sales orders from the shop should be imported manually (with the push of a button) or automatically
-
Demo (for testing): The sales order status in the shop not changed, no products or stock numbers transferred
-
Manual (with import control): The sales orders are not picked up until the Pick Up Sales Orders button is clicked
-
Automatically (via process starter): The sales orders are picked up automatically by the shop on a regular basis. The shop importer process starter is required for this
-
-
Only 1 sales order per request: Only 1 sales order per request is transferred from the shop
-
Sales orders in intermediate table: When picking up the sales orders, the sales orders are not created directly, but are first stored in an intermediate table for viewing. Here you can decide which orders should be created and which should be imported later
Settings for shop or marketplace:
-
SellerID: SellerID from Amazon Seller Central
Access data:
-
AWS Access Key ID: With a developer account, an access key and secret key can be used for the connection instead of the MWS Auth Token
-
AWS Secret Key: Only available with a developer account
-
Time Zone: Amazon Main Store Time Zone
-
Currency: Currency of Amazon main store
-
Set Wishlist Date: Date when delivery should be made is imported from Amazon. If the lowest delivery date on Amazon is less than the number of days entered in the future, a new desired delivery date is set in the order
-
Debug: If you check the box, the debugging mode is activated and the calls are stored in logs
FBA settings:
-
Pick up FBA Orders: Check if you want to pick up FBA sales orders
-
Own project for FBA: Here you can set a project for FBA sales orders
-
Use Amazon invoice number (only with Amazon invoice service): Check if you want Amazon to use the invoice number
-
Maximum days for reports: The maximum number of last days from which the reports are imported (typically 30)
-
Set sales order to completed: Sales orders are imported directly with the gray "Completed" checkmark
FBM settings:
-
Pick up FBM sales orders: Check if you want to pick up FBM sales orders
-
Own project for FBM: Here you can set a project for FBM sales orders
-
Gift packaging: A postage product must be entered here.
Invoice handling (invoice settings):
Note
Correctly configuring invoice processing with Amazon can be challenging, for Settings for different invoice scenarios (Amazon) (Classic), we present useful settings for the different scenarios.
-
Create Credits: Here you can choose whether or not to generate a credit
-
Use Invoice Upload Service: Check this box so that invoices are transferred to the shop when shipping is reported
-
Transfer invoices no later than x days after invoice date: After the entered number of days, the invoice will be transferred no later than
-
Upload Start Date: Date from which the invoice is uploaded
-
Accept VAT from: Date from which invoice numbers are adopted from VAT report
-
FBA:
-
Create invoice: Here you can set whether or not to create an invoice for FBA sales orders
-
Send invoice by email: Check if the invoice is to be sent to customers by email
-
Send credit notes by email: Check if the credit note is to be sent to customers by email
-
-
FBM:
-
Create invoice: Here you can set whether or not to create an invoice for FBM sales orders
-
Send invoice by email: Check if the invoice is to be sent to customers by email
-
Marketplaces:
-
[Country] Checkbox: Activate a marketplace by checking the box next to the country.
-
Price Group: Enter the price group that applies to the respective marketplace here.
Action:
-
Check connection: Check the correct connection to Amazon
-
Get Sales Orders: Get the sales orders from your store. This is necessary if you have set the import mode of the interface to manual.
Note
You should also make sure that the status messages for “Order open”, “Order in progress”, and “Order ready” are unique; the same status must not be used in multiple places.
-
Shopimport intermediate table: Jumps to the intermediate table of sales orders from the shop. The intermediate table is only populated in manual import mode and when the option 'Orders in intermediate table' is enabled.
In the intermediate table, select between "Import", "Waste" and "Later" in the left column.
-
Import: Sales order is imported directly
-
Trash: Sales order ends up in the garbage and cannot be imported a second time
-
Later: Sales order can be imported at a later date
-
-
To the Amazon App: Redirects you to the Amazon Seller App
-
Import old sales orders: Old sales orders are loaded into the clipboard where you can decide again whether the sales orders should be imported. Importantly, no simultaneous operation is possible (i.e. current sales orders and old sales orders cannot be imported simultaneously)
Below you will find all the settings you can make in the Settings tab.
The settings in the Order Import section control the way of transfer and synchronization between Xentral and shop. Please note that not every shop interface supports every function. You can find out which shop interfaces cover which functions in the articles for the individual interfaces.
-
Use payment method mapping→ Payment methods in Xentral should be linked to payment methods in the shop.
-
Use shipping method mapping→ Shipping methods in Xentral should be linked to shipping methods in the shop.
-
Mark as paid in advance→ Orders from the shop are marked as paid in advance in Xentral. This function marks orders with special payment types (special payment types via payment providers, financial institutions) as "prepaid". The order status indicator is always set to green
for these payment types . So the order status indicator with the paid icon does not switch to orange
(orders without payment (for pre-paid payment types) are usually always orange, because a manual payment release or the linking of the payment to the order via the bank statement is required).
-
UTF8 encoding→ The shop importer uses UTF8 encoding (please activate to avoid display errors with special characters etc.!).
-
Multi-project store→ In this shop products from different projects are offered. This is a special function.
You only need this option if you offer products from different projects in your shop.
Example: In your shop some products are offered, which require a different logistic process or for which a special customer check (e.g. request trade register excerpt) is necessary directly after the order. These items can be purchased together in this way. However, after picking up the orders after Xentral, different processes are triggered (e.g. different email templates, customer check is required, different logistics process, different invoice dispatch, different stationery, etc.).
-
VAT checked + release for shipping→ The checkbox 'VAT ID checked' is automatically set in all orders from the shop, so that the VAT check releases the orders for shipping. In other words: If a check mark is set here, the VAT ID check is deactivated.
-
Postage→ Product in Xentral that maps the shipping costs from the shop order as a separate item.
-
Postage reduced→ Product in Xentral, which should be used to map reduced postage for orders from this shop.
-
Create postage item→ If no postage item is stored, a postage item with the name from the shop is created and inserted into the order in Xentral to map the postage.
-
C.O.D. fee as extra item→ For C.O.D. orders, the C.O.D. fee is inserted as a separate item in the order
-
C.O.D. fee→ item in Xentral that maps the C.O.D. fee as an order line item
-
Report order status→ Xentral is allowed to report the status of imported orders back to the shop
-
Disable automatic feedback→ This disables automatic feedback to the shop for orders without tracking number. So the feedback will only take place after saving the tracking number or by the automatic feedback without tracking number in the transfer module.
-
Get any status→ All orders will be transferred from the shop to Xentral, regardless of status
-
Free text from store interface→ This setting allows you to transfer the free text (comment field in the store) either to the free text or to the internal comment of the order. To do this, set the setting to:
-
load into free text field
-
or: load into internal comment field
Customer information/customer comments are thus included in the order after Xentral in the 'Free text' field and are thus printed on the documents. Practical tip: In logistics, you can also display this information as a red box in the shipping process at the packing table. This information must be confirmed at the packing table. The settings can be found in the system settings (central settings).
-
-
Create offers instead of orders→ The orders from the shop are not created as orders in Xentral but as offers.
-
Deactivate auto-shipping on comment in shopping cart→ If the customer has left a comment during checkout in the shop, auto-shipment for this order will be deactivated in Xentral (thus allowing the employee to check the orders manually).
-
Report cancellation→ If an order is cancelled in Xentral, the cancellation is reported to the shop so that the order gets the status 'cancelled' there as well (currently available for Shopify, Shopware and WooCommerce)
-
Make taxation in third country dependent on delivery address→ taxation for export orders is determined based on the delivery address instead of the billing address
-
Set total amount→ The total amount of the orders will be taken from the shop for Xentral and not recalculated in Xentral from the item positions
-
Maximum difference from the calculated total→ range for which the Set total amount setting should apply. Useful e.g. when order totals are rounded to 0.05 currency units or there are rounding errors up to 1 cent
-
Overwrite direct debit data in address→ The direct debit data of an address in the address master will be overwritten if they were different for a shop order of this customer.
-
Allow stock figures transfer→ Xentral is allowed to export the stock figures of the products to the shop
-
Stock basis→ Stock level of the product to be reported to the shop (sellable or total stock minus reservations).
Note
This option has no effect on Pseudo stock rules. If you want to subtract reservations from pseudo stock, you need to add "- RES" to the pseudo stock rule.
-
Overwrite stock correction value→ The stock correction value entered here will be reported to the shop for all products and thus no longer needs to be maintained per product in the product master (click to allow stock correction value to be entered)
-
Pseudo stock rules→ Reports stock numbers to the shop according to a set of rules that can be set via formulas. For more info see the help center article Pseudo stock numbers formulas.
-
Allow article transfer→ Xentral may export products to the shop
-
Automatically transfer all changed articles→ Checking this box will automatically transfer all changed products from Xentral to the shop. This field is related to the artikeluebertragencronjob. When the cronjob is running and there are no products for export, the cronjob searches for all products associated with a shop where this field is active. It then checks each of these products to see if there have been any changes since the last export. If so, the respective product will be added to the list of products to be exported, which will be exported after the check is complete
-
Transfer images→ Xentral may export product images to the shop
-
Transfer properties→ Xentral may export product properties to the shop
-
Transfer categories→ Xentral may export product categories to the shop
-
Transfer cross-selling→ Xentral may export cross-selling links between products to the shop
-
Transfer scale prices→ Xentral may export scale prices of products to the shop
-
Transfer vouchers→ vouchers from Shopware 5 are transferred and can be processed in Xentral.
-
Suppress article text transfer→ The export of product texts from Xentral to shop is disabled for the whole interface
-
Pick up article list only create new articles→ With the action 'Pick up article list' only missing products are newly created, but products already existing in the address master of Xentral are not updated
-
Take over article number when creating from store→ The product number from the shop will also be created as product number in Xentral when the product is imported from the shop
-
Discount→ Here you enter the product number of the product from Xentral that maps discounts in the shop order as a separate item in the order with a negative sales price.
-
Tax rate for discount items→ VAT rate of the discount product used (normal or reduced). For a B2B shop with net invoice you have to enter the value 0. You can leave this field empty if you want to use the tax rate from the product
-
URL: Enter the URL to the importer here
-
ImportKey: 32 characters long security password
-
ImportToken: 6 characters long security token
-
Create missing items→ Products in the shop order that are not found in the product master are automatically created in the Xentral product master.
-
Fix discounts and postage→ Discounts and postage are taken from the shop and fixed.
-
Description texts from store→ Texts from the shop are taken over into the product master of Xentral
-
Article numbers from number range→ Product numbers from the number range of Xentral are assigned to the products coming from the shop
-
Single→ Only for products with the option 'Online Shop Matching' in the product master the above setting is applied
-
Item numbers from store→ If the product numbers from the shop differ from those in Xentral (found via external numbers), the product numbers from the shop will be used
-
Article description from xentral→ The product descriptions from Xentral will be taken over into the order items
-
Article descriptions from xentral→ Product descriptions from Xentral are taken over into the order items
-
Article descriptions from the store→ If the store transfers the article descriptions, these are taken over in the order
-
Supplement parts lists→ For 'mix & match' items (e.g. bundled items in Magento) the parts lists are supplemented in the same way as in the shop
-
Special tax rates per items→ The tax rates from the shop are also taken over for orders with mixed tax rates
-
Use existing customers only from project→ Check the box if the customer should be created with a new address per project (the customer address then exists per project and e.g. per shop, i.e. several times in total in Xentral, if the customer orders via several shops).
-
Do not overwrite existing addresses→ The new data entered in the shop does not overwrite the customer address in xYntral (no address update in the master data)
-
Manual address transfer
-
This function allows the manual transfer of address data to the shop.
-
The manual address transfer adds a button in Address (Master data → Addresses → Select address) (precondition: the address has the same project as the shop), which - if you click it - creates the address in the shop. However, nothing is transferred automatically.
The manual transfer also shows the password, which is the customer number.
Note
The manual address transfer is only available in the Shopware 5 interface.
-
-
Sales→ Here you can enter the sales contact. This is currently only transferred to the order but not to the address
A different delivery address from the shop will not be included in the address during order import.
There is also the possibility in the shop settings to specify a price group for which their sales price should be transferred to the shop.
Once you have created the sales price on this group, Xentral will transfer this sales price to your shop and not e.g. the default sales price.
If you change the shop provider, you can also change or update the module in the shop importer here. This includes, for example, a change from an external importer to a new internal importer.
All general settings as well as all links to products, categories, external numbers, shipping and payment mappings as well as sub-shops will then remain, but a new API will be addressed.
Important
All shop specific settings will be lost! You have to re-enter and save the credentials.
In the tab Payment methodsyou can map the parameters for the different payment methods transferred from the shop to the payment methods created in Xentral. To do this, you must have activated the option "Use payment method mapping" under Settings. So that unknown payment methods from online shops can be linked to known payment methods in Xentral, the parameters transferred from the shop are automatically created as an empty entry in the mapping table.
Settings
With a click on the edit icon of a created payment method you get to the settings. For each payment method you can make settings how orders with this payment method are to be handled.
-
Payment method store→ Designation of the payment method in the shop
-
Payment method xentral→ Payment method in Xentral
-
Mark as paid in advance→ Mark orders with this payment method as paid in advance
-
Auto shipping active→ Orders with this payment method are released for auto-shipment
-
Do not create invoice→ No invoice will be created for orders with this invoice
-
Fast lane→ Orders with this payment method are automatically transferred to the fast lane
-
Active→ Payment method is active
When you click Check Connection (Details > Interface), the interface imports all shipping service providers (carriers) available from Amazon. In addition to mapping with carriers, Xentral now also has a mapping for the product, so it displays the shipping service providers and the respective product ID.
You will then need to map the shipping methods you created to the appropriate shipping methods on the Shipping Methods tab. You will need to map this in every Amazon interface you create. There is a new mapping field called "Product Outgoing." Here you can enter the appropriate product ID for the shipping method for the mapping.
It is necessary that the mapping is performed in each Amazon interface so that when the tracking number of shipped sales orders is reported back, information can also be returned to Amazon about which shipping service provider was used.
If the shipping provider data changes on Amazon’s part, you can retrieve the updated data at any time via the Check Connection button.
The log file of the shop interface lists all error messages regarding the assignment of shipping methods. The message "Carriers have not yet been retrieved from the store" is displayed if you have not yet added the shipping providers via the Check Connection button.
In the Shipping methodstab you can map the parameters transferred from the shop for the different shipping methods to the shipping methodscreated in Xentral. To do this, you must activate the "Use shipping method mapping" option under Settings. So that unknown shipping methods from online shops can be linked to known shipping methods in Xentral, the parameters transferred from the shop are automatically created as an empty entry in the mapping table.
Settings
With a click on the edit icon of a created shipping method you open the settings. For each shipping method you can define settings on how orders with this shipping method are to be handled.
-
Shipping method shop→ Designation of the shipping method in the shop.
-
Shipping method xentral→ Shipping method in Xentral
-
Shipping method outbound→ Only relevant for Amazon and Billbee
-
Shipping method Outbound→ Only relevant for Amazon and Billbee
-
Country (comma separated, two-digit ISO)→ Restriction for which country shipping method is available (empty = no restriction).
-
Fast lane→ Orders with this shipping method automatically transferred to fast lane
-
Auto shipping active→ orders with this shipping method are released for auto-shipment
Active → shipping type is active
The textual labeling of the shipping method for the software interface and the labeling on the documents (printed text on invoice, order, etc.) is done via the mapping in the shipping methods (Administration → Settings → Shipping methods).
There the method (= field description in Xentral, e.g. "self-collector") is linked to the textual description such as "self-collector" or "yard sale". More information about defining shipping methods can be found here.
With the sub-shop mapping you can set a separate project with your own logistics procedure for each marketplace ID, or you can differentiate the sub-shops according to FBA and FBM.
To do this, you can create the sub-shops in the interface in the Sub-shop tab as follows: Marketplace (lower case) + underscore + FBA or FBM, for example:
-
de_FBA for Marketplace Germany FBA
-
it_FBM for Marketplace Italy FBM
-
gb_FBM for Marketplace Great Britain FBM
In the Language/Supply Countrytab you can set different languages for the documents by entering and saving the country code and the corresponding language.
Note
Only the billing address is taken into account here, i.e. if there is a differing shipping address, this will not be taken into account. For example, if the shipping address is UK and the billing address is DE, then the language of the order will be German.
You can disable or enable a saved language by clicking on the edit icon and unchecking or adding the "active" checkbox.
If you leave the country blank, the language will be used for all countries except those for which you have also created an entry. For example, you can enter German as the language for the DACH region (D, AT, CH). As a further entry English without country. Then English will be stored as the language for all countries that are not from the DACH region.
Learn more about using Smarty in this Help Center article: Smarty at Shopimporter.
The ASIN is not relevant for Amazon - whether FBA or FBM - the associated seller SKU is relevant, which must be stored with external product numbers in the product. The ASIN is not unique for Amazon, as it can have different states like new, used or overhauled. In the Amazon interface under Details → external product numbers you can also link the external product numbers of the FBA products picked up by Amazon by using the SKU to link the product number in Xentral or by using the SKU directly as Xentral product number.
The external product numbers table is populated from the Stocks table in the Amazon Seller app. Only products that are listed as FBA products in Amazon are picked up. You can then manage these in the Amazon Seller app. The external product numbers of FBM items must be created directly in the product master data.
-
Create unassigned products → Amazon products that have not been linked are newly created in Xentral.
-
Use SKU as WaWi product number → The SKU of the product will be created in Xentral as product number
By clicking on update product you save the entered links.