Skip to content

Amazon Settings

Amazon Settings is the setup of your Amazon seller account. It is located on the hub card Marketplace Setup of the AMAZON marketplace, in the Marketplace Settings section, and appears only there. This card – called Amazon Marketplace Setup in the connector – is the only setup page of the Amazon channel.

The connector manages exactly one Amazon seller account. The countries you sell in (DE, FR, IT …) are marketplaces of this account; each one your account participates in is a sales channel in the hub.

What is where on the Amazon Marketplace Setup:

  • Marketplace Settings → Amazon Settings (this page): the seller account as a whole – connection, notifications, offer and fulfillment settings, texts, product safety, returns, settlements, API.
  • Sales Channels: the Amazon marketplaces your account participates in (DE, FR …). Below it, for the selected marketplace, the hub settings of the sales channel and the Amazon Marketplace section: what the connector uses the marketplace for, invoice upload and FBA price surcharge.
  • The hub's own sections and actions of the card – activation, License, Setup Wizard, Data Takeover, synchronization, order import, prices – are described in the hub help Marketplace Setup.
  • The Amazon actions of the card – Import Marketplaces, jobs, product types, diagnostics and the Amazon lists – are listed below under Actions of the Amazon Marketplace Setup.

Opening the Page

  • Role Center → merchantCENTRAL → Setup: on the merchantCENTRAL Setup page, select the Amazon line in the Marketplaces section → Set Up
  • From error messages of the connector → Open Amazon Marketplace Setup; if the error names a marketplace, it is selected in the Sales Channels list
  • From the Amazon Activity Log and the Amazon Feed Tracker → Amazon Marketplace Setup
  • From the Amazon Dashboard: click Connection Mode
  • At the end of the Amazon Connector Setup wizard: Finish opens the card
  • From the Amazon Marketplaces overview → Set Up, with the chosen marketplace selected

When an administrator opens the card on AMAZON, it adds to the Sales Channels list the marketplaces that are already imported but still missing there.


Fields

General

FastTab General.

Field Description
Account Name Name of the Amazon seller account. The setup wizard suggests Amazon.
Active Only an active account calls Amazon. If the switch is off, every action and every job ends with "The Amazon seller account is not active."
Home Marketplace Code Home marketplace (e.g. DE), selected from the imported Amazon Marketplaces. Pages and actions that are not opened for a specific marketplace start with this marketplace, and it applies to data without a marketplace of its own, such as an order with an unknown marketplace ID.
Home Marketplace ID Amazon marketplace ID of the home marketplace (e.g. A1PA6795UKMFR9 for Germany). It follows from the Home Marketplace Code and cannot be changed.
Merchant ID Your Amazon seller ID (Merchant Token). Required.
Service Country Country of the seller account as a two-letter code (e.g. DE). Among other things, it determines the language of Amazon's listing messages.
Use Sandbox The connector works with Amazon's SP-API sandbox instead of the real marketplaces, for example while you set up a new installation (default: off). The sandbox answers with test data from Amazon and changes nothing in your Amazon account; it still needs a connection to Amazon (Connect to Amazon). For live operation, turn the switch off.

Amazon Connection

FastTab Amazon Connection. The access tokens for Amazon are issued by the merchantCENTRAL token service (https://mca-token.merchantcentral.de). The credentials of the Amazon application and your refresh token are kept only there; Business Central does not store them. You grant the authorization once in Amazon Seller Central with Connect to Amazon. The key with which Business Central identifies itself to the token service is created by the completed authorization itself – you do not enter it anywhere.

Field Description
Amazon Authorization Status of the authorization: Connected (green), Not connected (red) or Not checked - click to check. If required information is missing, it shows Setup incomplete: followed by what is missing (Merchant ID, Home Marketplace Code, Amazon authorization). Clicking it checks with the token service.

Push Notifications

FastTab Push Notifications. By default, the connector fetches all data via the job queue; orders and cancellations come with the order import. Nothing else is needed for this. Push notifications from Amazon are set up for your company by ALTENBRAND support; the connector itself does not create any destinations or subscriptions at Amazon. The notifications reach Business Central via the API page Amazon Notification API.

Field Description
Notification API Key Key that every notification to the API page Amazon Notification API must carry; without it, the page rejects the notification. The key applies to all companies of this environment. Only needed if ALTENBRAND support has set up push notifications. Shows only Configured or Not configured; clicking it opens the input.

Email Notifications

FastTab Email Notifications. These emails concern feeds. For the feeds of the invoice upload – one feed per invoice – the connector does not send any of these emails on its own. Error emails about orders that could not be imported, about failed shipment confirmations and about failed invoice uploads are sent by the hub's error notification to the recipients from the merchantCENTRAL Setup page.

Field Description
Enable Email Notifications Turns on the emails about feed submissions and feed results.
Notification Email Recipients; separate multiple addresses with semicolons.
Sender Email Account Email account used for sending, selected via AssistEdit from the email accounts of Business Central.
Notify on Success Email when Amazon has processed a feed successfully.
Notify on Error Email when an error has occurred.
Notify on Feed Submission Email when a feed has been submitted to Amazon.

You send test emails with the actions of the Test Emails group of this section (see Actions).

Offer Settings

FastTab Offer Settings.

Field Description
Default Offer Audience Whom items are offered to on Amazon unless an item says otherwise: B2C and B2B (default), B2B Only or B2C Only. A change affects all items that follow the default; a confirmation states their number, and the changed offers go to Amazon with the next price sync. See Prices and Offers.

Fulfillment Settings

FastTab Fulfillment Settings.

Field Description
Enable FBA Shows the FBA actions, pages and fields throughout the connector (default: off). Leave it off if you only ship yourself (MFN). When you turn it on, the connector asks whether merchantCENTRAL should post shipment and invoice of FBA orders on its own – Amazon has already shipped these orders when they are imported. The question only comes as long as no automation is set there yet. With Yes, it sets the Automation for Orders Shipped by Marketplace on the hub's Marketplace Setup of AMAZON to Release and Post Shipment and Invoice; you can also change this there later. The connector only imports FBA orders with Enable FBA turned on and an FBA Location Code entered.
Default Handling Time (Days) Handling time in working days until shipping (default: 2). It goes to Amazon with every quantity as lead_time_to_ship_max_days and applies to all items.
Confirm Shipments Automatically Every posted shipment of an order that you ship yourself is queued, and the job confirms it to Amazon within about 15 minutes, with the tracking numbers of its packages (default: off). When you turn it on, the connector creates the SHIPMENT_CONFIRM job. It never confirms orders that Amazon has shipped. See Amazon Shipment Confirmations.
Wait for Tracking (Hours) How long a posted shipment without a tracking number waits for one before it is confirmed without it (default: 4, 0 to 168). If the number arrives later, it goes to Amazon in a second confirmation. Can only be changed with Confirm Shipments Automatically.
Acknowledge Orders Automatically Every order import reports to Amazon which orders have become sales orders – one feed per marketplace (default: on). Orders that are held back because of an unknown SKU are acknowledged as soon as their sales order exists.
FBA Location Code Location that represents the inventory in Amazon's fulfillment centers. Orders that Amazon ships (FBA) are imported with this location; their shipments take the inventory from there. Choose a location without warehouse shipments, picks and bins – any other location is rejected. The connector marks it in the hub as Marketplace Warehouse, so that no sales channel offers its inventory as your own. Without a location, FBA orders are not imported: they stay at Amazon, the Amazon Activity Log states the reason, and the next import fetches them as soon as the location is entered. Can only be changed with Enable FBA.
FBA Unsellable Location Code Optional location for units at Amazon that cannot be sold – damaged, defective or expired. FBA returns in such a condition and condition changes at Amazon are posted there, and Suggest FBA Adjustments compares it with Amazon's unfulfillable inventory. The same rules apply to it as to the FBA location, and it also becomes a Marketplace Warehouse. Leave it empty to keep these units on the FBA location. Can only be changed with Enable FBA.
FBA Adjustment Journal Template Item journal template of the journal that receives the adjustment suggestions for the FBA location. Can only be changed with Enable FBA.
FBA Adjustment Journal Batch Item journal batch for the adjustment suggestions. Every suggestion replaces the lines of this journal batch, so use a dedicated one. Nothing is posted until you post the journal. Can only be changed with Enable FBA.
FBA Reconciliation Reason Code Reason code of the remaining lines of the adjustment suggestion: the difference that no movement in Amazon's inventory ledger explains. The lines of the individual ledger entries get the reason code of their Amazon reason from the Amazon FBA Adjustment Reasons. Leave it empty to post without a reason code. Can only be changed with Enable FBA.
FBA Removal Location Code Your own location that receives what Amazon sends back through a removal order. The returns job puts the units shipped by Amazon on a transfer order from the FBA location (or the FBA unsellable location) to this location; you post the shipment, your warehouse posts the receipt (see Amazon FBA Removal Orders). The FBA location and the FBA unsellable location are rejected. Leave it empty to post removals as adjustments of the FBA location. If you enter it later, it only takes over what Amazon sends back from then on; what was sent back before counts as done. You can only clear it as long as no transfer order of a removal is open. Can only be changed with Enable FBA.
FBA In-Transit Code In-transit location of the transfer orders for removals, for the goods on their way back from Amazon. Leave it empty if a transfer route from the FBA location to the removal location specifies it; if both are missing, creating the transfer order fails with a message. Can only be changed with Enable FBA.

Reconciling FBA inventory

Suggest FBA Adjustments – in the Amazon Items list and on the Amazon FBA Ledger Entries page – fills the journal in two steps: first, every new entry from Amazon's inventory ledger gets a line of its own with the reason code of its Amazon reason; after that, per item and location, only the remaining difference with the FBA Reconciliation Reason Code. Amazon counts units that are available, reserved, unfulfillable or being researched, but no units on their way to Amazon; Business Central counts the inventory of the FBA location, minus open sales orders and plus open sales return orders and credit memos there. What Amazon has already received from an FBA shipment already counts toward the FBA location; what Amazon has sent back through a removal order no longer does. With an FBA Unsellable Location Code, sellable and unsellable inventory are compared separately. This requires a complete retrieval of the FBA inventory within the last 24 hours (job FBA_INVENTORY or Refresh FBA Inventory in the Amazon Items list). Items without an FBA SKU, blocked items and items with item tracking are skipped; the message states their number.

Texts

FastTab Texts.

Field Description
Send Content Automatically About every hour, the job queue sends the changed texts of every listing with Send Content to Amazon – title, item highlights, description, bullet points and search terms, each in the language of its marketplace (job CONTENT). When you turn it on, Send Content is set for the listings that have texts of their own at Amazon.

Returns

FastTab Returns.

Field Description
Customer for Unknown Returns Customer for whom a sales return order or credit memo is created if the Amazon order of a return is not in Business Central – for example because it was sold before the connector was in use. Without it, such returns remain with an error on the Amazon Returns page.

Settlements

FastTab Settlements. The settings only take effect with the add-on module AMAZON-SETTLE (€105 net per 4 weeks per channel); without it, no settlements are imported, matched or posted. You work on the settlements themselves on the hub page Settlements.

Field Description
Settlement Lookback (Days) How far back the first import of a marketplace reads (default and maximum: 90 days – that is how long Amazon keeps the reports). After that, every marketplace keeps its own position: later imports continue where the last error-free run on this marketplace began. A marketplace whose report cannot be retrieved or read does not move forward; the others do.
Post Settlements Automatically Every settlement import posts the Amazon payouts whose lines are matched and that add up to the transferred amount within the settlement tolerance of the merchantCENTRAL Setup page. A payout that does not stays open for review; the hub monitor shows it three days after the transfer. The matching always runs, even without this switch.

If an import fetches a settlement again, it only replaces it as long as it has the status New; reviewed, matched and posted settlements stay unchanged.

API Settings

FastTab API Settings.

Field Description
SP-API Endpoint URL Address of the Amazon SP-API (default: https://sellingpartnerapi-eu.amazon.com). Only Amazon's regional endpoints (EU, NA, FE) are accepted, because the access token is sent to this address. Do not enter a sandbox address here; that is what Use Sandbox is for (see General).

Actions

The actions are in the menu of the Amazon Settings section.

Action Description
Connect to Amazon Starts the authorization in Amazon Seller Central. The token service issues a one-time consent link for the European Seller Central, which opens in the browser. Confirm the authorization there and then answer Yes in Business Central – the connection is then complete. Only possible in a user session.
Test Connection Checks both halves of the connection: the token service must issue an access token, and Amazon must use it to return the marketplaces of the account. The message states their number. Before that, the hub checks the AMAZON license: if the module is not registered yet, it opens the demo registration; without a valid license, the test stops and states the reason.
Finish Connection with Code Completes an authorization that was started in the Amazon Appstore: paste the connection code from the Amazon connection page (see Finish Amazon Connection). Not needed with Connect to Amazon.
Disconnect from Amazon Deletes the authorization in the token service after a confirmation. After that, the token service no longer issues access tokens until you connect again in Seller Central.
Reset Offer Audience of Items Resets all Amazon items with their own value in Offer Audience to the account default (Default Offer Audience). A confirmation states the number; the changed offers go to Amazon with the next price sync. See Prices and Offers.

Test Emails

Group Test Emails in the menu of the section. The test emails go to the same address as the real notifications: to Notification Email (see Email Notifications) or, if no address is entered there, to the default notification address of the hub (provided email notifications are turned on there). If there is no address, the action stops with a note pointing to the Default Notification Email field on the merchantCENTRAL Setup page. Each test email is structured like the real email for its event, with sample data, and its subject starts with "[Test]". The switches for the individual events (Notify on Success etc.) do not apply to test emails.

Action Description
Test: Feed Submission Test email about a feed submission.
Test: Feed Result (Success) Test email about a feed that Amazon processed without errors.
Test: Feed Result (Error) Test email about a feed that Amazon processed with errors.
Test: Error Notification Test error notification.

The message says that the test email was handed over for sending, and to whom. If it does not arrive, the email outbox of Business Central shows the reason. If even the handover fails, for example because no valid email account is set up, the action ends with the error Test Email Failed; the Amazon Activity Log shows the reason.


Actions of the Amazon Marketplace Setup

The connector adds these actions to the hub card Marketplace Setup; they appear only on AMAZON. The processing actions are in the Actions menu, Import Marketplaces and Set Up Automation also under Process; the lists are under Related. Activation, License, Setup Wizard, Data Takeover and the synchronization actions belong to the hub card itself (see Marketplace Setup).

Action Description
Import Marketplaces Imports the marketplaces of your account from Amazon: name, country, currency, language, domain, participation and suspended listings. Each marketplace your account participates in then appears in the Sales Channels list, where you set it up. New marketplaces are not used for anything; the message states their number – turn them on in the Amazon Marketplace section. Before that, the hub checks the AMAZON license. Only available to hub administrators.
Settlements Add-on License Opens the license of the add-on module AMAZON-SETTLE (settlements), which is licensed separately from the connector: start a 30-day demo, subscribe or view the status.

Amazon Jobs

Group Amazon Jobs in the Actions menu. The actions create job queue entries; they are only available if you are allowed to create job queue entries.

Action Description
Set Up Automation Creates every missing job that the connector needs to run on its own – which ones and under which condition is explained in the tip below. A confirmation first lists which ones are missing; existing jobs keep their schedule and status.
Setup Order Import Job Order import (ORDERS), every 30 minutes, 06:00–22:00, Mon–Sun.
Setup Returns Import Job Returns import (REFUNDS), every 60 minutes, 06:00–22:00, Mon–Sun. See Amazon Returns.
Setup FBA Inventory Sync Job FBA inventory (FBA_INVENTORY), every 2 hours, around the clock. Only visible with Enable FBA.
Setup Price & Inventory Sync Job Price and inventory sync, every 30 minutes, 06:00–22:00, Mon–Sat.
1. Setup ASIN Sync (04:00) Nightly ASIN search (ASIN_SYNC) for the existing Amazon items without an ASIN, on every marketplace with Use for Listings: via the GTIN, and via the manufacturer part number (Common Item No.) where the item has no GTIN or Amazon does not know it. The job enters an ASIN found via the GTIN right away; products whose part or model number on Amazon matches the manufacturer part number go to the Amazon ASIN Search Queue for review. After that, it fetches the missing image URLs of the items with an ASIN. It does not create Amazon items. Prerequisite for the two following jobs.
2. Setup Fees Sync (04:10) Nightly fee estimate for items with an ASIN (FEES_SYNC).
3. Setup Issue Scan (04:40) Nightly check for listing issues (LISTING_ISSUES), the last job in the chain: asks Amazon on every marketplace for the listing issues of the Amazon items that have an ASIN and the status Inactive, Incomplete, Blocked or Suppressed. Result on the Amazon Listing Issues page.
Setup PII Retention (03:30) Retention job under the Amazon Data Protection Policy (PII_RETENTION): deletes notification log entries and failed order imports after 30 days, the connector's entries in the Amazon Activity Log after 90 days, and completed, evaluated feeds that were submitted more than 90 days ago, together with their feed errors and image lines; it cleans up the merchantCENTRAL activity log according to that log's retention period. The buyer data of the orders is cleaned up by the merchantCENTRAL retention job. The job is created during installation and, if it is missing, recreates itself with the next Amazon job; the action creates it again or reschedules it.

There is no action of its own for the invoice upload (INVOICE_UPLOAD, every 15 minutes) and the VCS report import (VCS_REPORTS, every 6 hours). Their job queue entries are created by the Invoice Upload field in the Amazon Marketplace section: the invoice upload as soon as a marketplace uploads invoices (Own Invoices without VCS or VCS with Own Invoices), the VCS report import as soon as it invoices with VCS (VCS with Own Invoices or VCS with Amazon Invoices). If one of the entries is missing, Set Up Automation adds it.

Amazon Product Types

Group Amazon Product Types in the Actions menu. The tools load and show Amazon's description of the product types that creating new products requires (see Create New Amazon Product).

Action Description
Prepare Listing JSON (Advanced) Diagnostic tool: you choose an item from the item list, then the marketplace and, in the Search Product Type dialog, the product type. The action builds the raw listing JSON of a new product from the Amazon Listing Mappings and the item attributes, without sending it. The message shows the beginning of the JSON and the warnings; afterwards, you can download the JSON as a file.
Import Product Type Definition Retrieves the definition of a product type from Amazon and stores metadata and property groups. After the marketplace, you enter a search term in the Search Product Type dialog and choose the product type from Amazon's matches. The message states the number of stored property groups.
Import Property Descriptions Loads the schema of a product type and stores its property descriptions; the selection works as with Import Product Type Definition. The message states the number of stored descriptions.
Product Type Definitions Opens the Amazon Product Type Definitions of the selected marketplace.
Property Documentation Opens the Property Documentation of the selected marketplace.

If Amazon finds no product type for the search term, the action reports No product types found.

Amazon Diagnostics

Group Amazon Diagnostics in the Actions menu. The tools help when the price and inventory sync, the order import or the connection is stuck; you do not need them in daily work.

Action Description
Diagnose Sync Issues Shows for a marketplace why items are not synchronized (no ASIN, pending feeds, no price from the price list, etc.).
Clear Stale Sync Locks After a confirmation that names the marketplace, releases on this marketplace whatever is no longer waiting: sync locks older than 2 hours, and pending feed IDs whose feed is missing, completed or has been stuck for more than 2 hours. A feed that Amazon has processed but whose processing report has not been read yet keeps its items until 2 hours after it was completed. The message counts what was cleaned up.
Clear ALL Sync Locks NOW After a confirmation that names the marketplace, releases all sync locks and pending feed IDs of this marketplace, including those of feeds that Amazon is still processing. Their results are then no longer applied, and the next sync sends their prices and quantities again. Use only after a program error.
Reset Last Import Date After a confirmation, sets the order import of the marketplace back by 7 days: the next import reads these days again, including the orders that failed before. The other marketplaces keep their state. Orders that were already imported are not created twice.
Re-tag Marketplace Data After a confirmation, assigns orders that were imported without a marketplace to their marketplace once (to the home marketplace if no marketplace is stored), so that the figures of the Amazon Dashboard per marketplace are correct. The message states the number of assigned orders.
Test LWA Access Token / Refresh LWA Token Now / Clear LWA Token Cache Check and renew the access token that the token service issues. Refresh LWA Token Now reports whether a new access token was issued; Clear LWA Token Cache asks first. These actions are for troubleshooting together with support.

You usually do not need to clear orphaned locks yourself: every price and inventory run – the PRICES and INVENTORY jobs, the hub's synchronization, Sync Prices and Stock on the Amazon Dashboard and Sync Stock on the Amazon MFN Inventory Sync – starts by releasing sync locks older than 30 minutes and feed IDs whose feed is missing, completed or has been stuck for more than 2 hours. Items of a feed that Amazon is still processing stay locked – as do, for up to 2 hours, the items of a finished feed whose processing report has not been read yet.

Which marketplace?

The tools for one marketplace – Diagnose Sync Issues, Clear Stale Sync Locks, Clear ALL Sync Locks NOW, Reset Last Import Date and all actions of the Amazon Product Types group – first ask for the marketplace. A selection window (Choose the marketplace:) offers the marketplaces that your account participates in and that have a Marketplace ID; the home marketplace is preselected. If there is only one such marketplace, the question is skipped. If there is none, the action stops with the message No marketplace: Amazon does not list any marketplace for the seller account yet. Retrieve the marketplaces then with Import Marketplaces.

Under Related.

Action Description
Amazon Marketplaces Opens the Amazon Marketplaces overview: all marketplaces imported from Amazon, including those without participation.
Amazon Category Mappings Opens the Item Category Mapping.
Amazon Listing Mappings Opens the Amazon Listing Mappings: which data fills the properties of a product type. Required before creating new products.
Amazon Carrier Mapping Opens the Amazon Carrier Mapping: the Amazon carrier of each shipping agent whose code and name do not name a carrier Amazon lists. Without one, its shipment confirmations wait.
Job Queue Entries Opens the job queue entries.
Amazon Activity Log Opens the Amazon Activity Log.
Amazon Notification Log Opens the Amazon Notification Log with the push notifications received via the Amazon Notification API. Push notifications are set up by ALTENBRAND support.

Tips

Initial Setup

The easiest way is the Amazon Connector Setup wizard (Setup Wizard on the card): it asks for the seller data, guides you through the authorization and creates the marketplaces. After that, Set Up Automation sets up all jobs in one step.

Which jobs Set Up Automation creates

Always: order import, returns import, price and inventory upload, feed status check (FEED_PROCESS, every 5 minutes), the three nightly jobs and the retention job. In addition: the shipment confirmation (SHIPMENT_CONFIRM) if Confirm Shipments Automatically is turned on, the content upload (CONTENT, about hourly) if Send Content Automatically is turned on, the invoice upload (INVOICE_UPLOAD) if a marketplace uploads invoices, the VCS report import (VCS_REPORTS) if a marketplace invoices with VCS, the FBA inventory if Enable FBA is turned on, and the settlement import (SETTLEMENTS, daily) if the add-on module AMAZON-SETTLE is licensed (€105 net per 4 weeks per channel, see Settlements). Cancellations are handled by the order import; they do not need a job of their own.

License

The connector needs the AMAZON license (30-day demo); it is shown in the License section of the card. Test Connection checks it; if the module is not registered yet, the hub opens the demo registration. Settlements are a separate add-on module (AMAZON-SETTLE, Settlements Add-on License); without it, no settlements are imported, matched or posted.

If the connection fails

  • This Amazon account is not connected to Amazon. – Run Connect to Amazon and confirm the authorization in Seller Central.
  • The token service could not obtain an access token from Amazon. – Usually temporary. If the error persists, the authorization has probably been revoked; connect the account again with Connect to Amazon.
  • The access token works, but Amazon returned no marketplace participations. – Check in Seller Central that the authorization includes the required roles and that the account is active on at least one marketplace.
  • The token service could not be reached. – Outgoing HTTPS connections to mca-token.merchantcentral.de must be possible.
  • The token service did not accept the tenant service key of this Business Central tenant. – Connect the account again with Connect to Amazon; the completed authorization issues a new key. If the error persists, contact ALTENBRAND support.
  • The token service rejected the request data. – Connect the account again with Connect to Amazon. If the error persists, contact ALTENBRAND support.