eBay Setup
eBay is set up like every marketplace on the merchantCENTRAL marketplace card: on the EBAY row of the Marketplaces page. That is where the hub's settings are (switching on, license, customer, sales channels with their price lists, the Setup Wizard) and below them, in the eBay Settings section, everything that concerns eBay only and applies to all accounts — default account, order import, listings, quantity cap and account deletion. This page describes the eBay part. The credentials themselves live on the accounts, the country settings on the marketplaces.
Open the page
- Via search: Marketplaces → row EBAY
- Via search: eBay Setup (the same settings, with the action Open in Hub)
- Via the setup wizard: Assisted Setup → group "AD merchantCENTRAL - Setup"; on the marketplace card via the action Setup Wizard — recommended for the initial setup, see setup wizard
eBay Setup as a page of its own
Set Up in the merchantCENTRAL setup opens the marketplace card on the EBAY row. The eBay Setup page shows the same settings and actions without the marketplace card, plus the License FactBox and the action Settlements Add-on License (see Actions); the links in error messages lead there as well. Open in Hub takes you from there to the marketplace card. On opening, the page checks whether the merchantCENTRAL hub is configured (platform guard).
Fields
| Group | Field | Description |
|---|---|---|
| Default Account | Default Account Code / Default Marketplace Code | Account and marketplace for operations that do not bring their own context — the connection test, the consent flow, the policy lookup. |
| Configured | How many eBay accounts and marketplaces exist; red as long as there is no account. | |
| Mode | Live, Sandbox or Simulation Mode of the enabled accounts (yellow as long as not everything is live). Choosing it opens the accounts, where Simulation Mode is switched per account. | |
| Order Import | Auto Create Customers | Create customers automatically during import. |
| Shipping Item No. | Service item for the shipping cost line of eBay orders — only as a fallback when the Shipping No. in the merchantCENTRAL setup is empty. If that is filled, the hub creates the shipping cost line from it and this field is not used. If both are empty, no shipping cost line is created. | |
| Listings | Default Condition | Item condition of new listings. |
| Description Source | Source of the listing description text (item description, extended texts, marketplace item, description + attributes). | |
| Auto Fill Product Data | Pre-populate Brand/MPN/EAN from the BC item card. | |
| Include Image URLs | Include image URLs when syncing items. When it is off, the pictures on eBay stay as they are — for single items and variant groups alike. In general the item and variant sync keep on eBay whatever Business Central does not send, such as package weight and size or aspects maintained only on eBay. | |
| Auto Send Shipment Confirmation | Report tracking numbers to eBay automatically after posting the shipment – on the next run of the job queue (FULFILLMENT, every 5 minutes), including those from merchantCENTRAL's shipment tracking. Without this setting – or for a single shipment right away – Send Shipment Confirmation (under Marketplace) on the posted sales shipment reports its parcels to eBay; only parcels eBay does not have yet and only quantities eBay does not have as shipped yet are reported (several parcels). | |
| Inventory | Max Listing Qty | Upper limit for the quantity of every eBay offer (0 = no limit). It applies after the hub's inventory calculation; if a Max Quantity is maintained on the marketplace item as well, the lower limit wins. Safety stock, percentage, fixed quantity and locations are maintained in the hub — see Inventory Calculation. |
| Azure Function (Account Deletion) | Azure Function URL / Azure Function Key | Address and key of the Azure Function in your own subscription that receives eBay's notifications about deleted buyer accounts; Business Central collects them there. The setup script prints both values. The key is entered by choosing the field and never shown — the field only says Configured or Not configured. The same function keeps the signing key for the digital signatures that eBay requires for sellers from the EU and the United Kingdom. |
Actions
The actions sit in the eBay Settings section itself. The daily work — importing orders, returns and cancellations, uploading items, sending stock — is on the eBay Dashboard; the marketplace card starts the order, stock and price sync as well (group Synchronisation).
| Group | Action | Description |
|---|---|---|
| Authorization | Request eBay Consent | Opens the eBay consent page in the browser – for the default account. |
| Enter Authorization Code | Exchanges the code eBay returned for a refresh token of the default account. | |
| Connection | Test Connection | Tests the API connection of the default account. |
| Check Seller Privileges | Shows seller privileges and selling limits from the eBay account. | |
| Opt in to Business Policies | Enables business policies for the account (required once). | |
| Create Default Policies | Creates a standard set of fulfillment, payment and return policy and enters it on the default marketplace. | |
| Account Deletion | Set up Azure Function | Opens the guide for deploying the Azure Function. |
| Test Azure Function | Checks that the Azure Function is reachable with URL and key. | |
| Process Account Deletions | Collects pending account deletion notifications now and anonymizes the affected buyer data. | |
| Lists | eBay Accounts / eBay Marketplaces / Carrier Mapping | Opens the respective list. |
Only the eBay Setup page has the action Settlements Add-on License, under Process. It opens the license of the settlement add-on (EBAY-SETTLE), which is licensed on its own next to the connector: start its 30-day demo, subscribe to it or see its status. The License FactBox shows the EBAY module only. The same action is on the eBay account card. What the add-on does is described under Settlements: eBay.
Automation (job queue)
During installation the connector creates recurring job queue entries (initial status On Hold — set to Ready to activate):
| Job | Interval |
|---|---|
| eBay: Import Orders | 5 min |
| eBay: Sync Stock | 5 min |
| eBay: Send Shipment Confirmations | 5 min |
| eBay: Upload Items | 10 min |
| eBay: Import Cancellations | 30 min |
| eBay: Import Returns / eBay: Import Messages | 60 min |
| eBay: Process Account Deletions | 60 min |
| eBay: Import Payment Disputes | 4 h |
| eBay: Import Settlements | daily – only with the add-on module EBAY-SETTLE licensed, see Settlements |
| eBay: Import Analytics / eBay: Import Campaigns | daily |
| eBay: Import eBay Listings | daily |
The descriptions are named like the actions that do the same by hand. The parameter (e.g. RETURNS, FULFILLMENT) decides which run it is, not the description.
eBay: Import eBay Listings reads the listings of all eBay accounts into the eBay Listings list and keeps offer ID, listing ID and online status of the marketplace items up to date; it creates nothing and overwrites no content. Once a day is enough: in between, the listing status sync and, when needed, the dashboard action Refresh Listing Status keep the status current.
Tips
Order of initial setup
Create account → run consent → create marketplace → pick policies → test connection. The setup wizard walks through exactly these steps.