Skip to content

Amazon Administration

The Amazon Administration page bundles the administrative tasks of the Amazon connector: setting up automation, checking the connection, license, test emails, diagnostics and product types. You do not change the settings of the seller account itself here, but in the Amazon Settings in the hub – Open in Hub takes you there.

Opening the Page

Fields

FastTab Active Seller Account, display only.

Field Description
Account Name Name of the Amazon seller account.
Merchant ID Your Amazon seller ID (Merchant Token).
Home Marketplace Code Home marketplace, e.g. DE, selected from the retrieved Amazon Marketplace Participations. Pages and actions that are not opened for a specific marketplace start with it, and it applies to data without a marketplace of its own. You can change it in the Amazon Settings.

Actions

Process

Action Description
Setup Wizard Opens the Amazon Connector Setup wizard.
License Shows the license of the Amazon connector (module AMAZON) with demo registration and subscription.
Open in Hub Opens the Marketplace Setup hub card of the AMAZON marketplace with the Amazon Settings.
Reset Offer Audience of Items Hands every Amazon item with an Offer Audience of its own back to the default of the account. A confirmation states the number; the changed offers go to Amazon with the next price sync. See Prices and Offers.
Import Marketplaces Retrieves the marketplace participations of the account from Amazon and opens the Amazon Marketplace Participations page.

Authorization

Action Description
Connect to Amazon Starts the authorization in the European Seller Central via a one-time consent link from the token service (see Amazon Settings).
Check Amazon Connection Asks the token service whether the account is authorized.
Disconnect from Amazon Deletes the authorization in the token service after a confirmation.

Test Emails

The test emails go to the same address as the real notifications: to Notification Email in the Amazon Settings 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.
Open Amazon Activity Log Opens the Amazon Activity Log.

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.

LWA Access Token

Action Description
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.

These actions are for troubleshooting together with support; you do not need them in daily work.

Diagnostics

In the action bar, in the Actions menu → Diagnostics. The tools help when the price and inventory sync or the order import 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.

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.

Product Types

In the action bar, in the Actions menu → Product Types. 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.

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 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. Open Marketplace Participations in the message takes you to the Amazon Marketplace Participations; there you retrieve the marketplaces with Import Marketplaces.

These actions are in the Related menu of the action bar; Marketplace Participations and Data Takeover also appear under Listings.

Action Description
Activity Log Opens the Amazon Activity Log.
Open Amazon Dashboard Opens the Amazon Dashboard with the key figures and the daily work.
Data Takeover Opens the Amazon Data Takeover: it takes over an Amazon channel that you have run with another system so far – cut-over date per marketplace, listings, SKU assignment, open orders, release of prices and inventory, FBA opening stock, order history, and images and product data.
Marketplace Participations Opens the Amazon Marketplace Participations.
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.
Category Mappings Opens the Item Category Mapping.
Listing Mappings Opens the Amazon Listing Mappings: which data fills the properties of a product type. Required before creating new products.

Automation Setup

In the action bar, in the Related menu → Automation Setup.

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.
View Job Queue Entries Opens the job queue entries.

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 of a marketplace participation: 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.

Tips

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). Test Connection in the Amazon Settings checks it; if the module is not registered yet, the hub opens the demo registration. Settlements are a separate add-on module (AMAZON-SETTLE); without it, no settlements are imported, matched or posted.