eBay Order on the “Marketplace Order” Card
An eBay order is a merchantCENTRAL marketplace order and opens on its Marketplace Order card – the same card as the orders of all other marketplaces. The eBay connector adds there what only eBay knows: the eBay section with the statuses at eBay, the eBay buyer, the amounts as eBay splits them, and the refund, the eBay actions for refund and cancellation, and eBay columns in the Order Lines. All of this appears only on eBay orders.
The card is read-only: eBay is the source of the order; you work on it through the actions.
Opening the Page
- From the eBay Orders or the merchantCENTRAL Marketplace Orders by clicking an order
- From the sales order, the posted shipment, and the posted sales invoice of an eBay order → merchantCENTRAL action Show Marketplace Order, or by clicking the Marketplace Order No. field
- From the eBay cancellations, returns and payment disputes → action Show Marketplace Order
The “Marketplace Order” Card
The card is laid out and operated the same for all marketplaces. The title names marketplace and order: the name of the hub marketplace EBAY (such as eBay) and the eBay order ID. General shows the eBay order ID as External Order No., the sales channel (eBay account and country) as Sub-Account Code, the Status in Business Central, the Latest Ship Date, and the Sales Order No.; under Show more, External Reference holds the sales record number from eBay Seller Hub. Errors appears for status Error or On Hold and gives in Error Message the reason why the order has no sales order. Then follow the Order Lines, the Order Details with the total amount the buyer paid, the currency, the shipping costs paid after shipping discounts as Shipping Amount, and the payment status, then Shipping with the ship-to address as the sales order receives it, Contact, and Billing Address – eBay provides no billing address of its own; it is the ship-to address. The first action is Show Sales Order. All fields, the status colors, and the merchantCENTRAL actions – Import Again, Import Without Unknown Items, Tracking Entries, Cancellations, Show Order JSON – are described in the help for the Marketplace Order card.
How an eBay order gets its sales order, and what New, Error, and On Hold mean for eBay, is described under From eBay Order to Sales Order.
“eBay” Section
The section is in the Channel Details group.
| Field | Description |
|---|---|
| eBay Order Status | Status of the order at eBay: Active yellow while it still has to be shipped, Completed green once eBay reports it fulfilled, Cancelled gray once it is cancelled at eBay. |
| eBay Fulfillment Status | How far eBay considers the order shipped: Not Started yellow, In Progress (part of it reported as shipped) blue, Fulfilled green. It is fulfilled only once every line item has been reported in full. |
| eBay Payment Status | Payment status at eBay: Pending yellow, Paid green, Failed red, Partially Refunded blue, or Fully Refunded green. merchantCENTRAL creates the sales order only for Paid or Partially Refunded. |
| eBay Cancellation State | None Requested, Cancellation Requested red – a decision is pending – or Cancelled gray. While a cancellation is requested, no sales order is created. |
| Ship By | Date and time by which eBay expects the order to be shipped: the earliest ship-by date of the line items. The Latest Ship Date under General and on the sales order is the same deadline without the time; the tiles Shipments Due Today and Shipments Overdue count the order by it (ship deadlines). |
| eBay Buyer | eBay user name of the buyer. Cleared when the order is anonymized (see Data Protection). |
| eBay Payment Method | How the buyer paid at eBay. |
eBay Amounts
| Field | Description |
|---|---|
| Subtotal Amount | Sum of the line items before tax, shipping, and discounts. |
| Shipping Cost before Discount | Shipping cost of the order before shipping discounts. The card's Shipping Amount is what the buyer paid after them. |
| Tax Amount | The total tax on the order as eBay reports it, including the tax eBay collects itself. |
| Discount Amount | Discounts on price and shipping as eBay reports them. |
| eBay Collected Tax | Tax eBay collects and remits on your behalf (marketplace facilitator tax). It is not part of your revenue. |
Refund
Appears as soon as a refund of the order has gone to eBay.
| Field | Description |
|---|---|
| Refund ID | The ID under which eBay keeps the refund. |
| Refund Status | Pending yellow while eBay is still processing the refund, Succeeded green, or Failed red. |
| Refund Amount | The amount refunded. |
eBay Actions
The eBay actions follow Show Sales Order under Process, and the merchantCENTRAL actions under Navigate. At eBay, refund and cancellation always apply to the whole order; there are no actions for single lines. Both run in the eBay account of the sales channel the order came in through. If the seller is domiciled in the EU or the United Kingdom, eBay requires a digital signature for both — see Digital signatures.
| Action | Description |
|---|---|
| Refresh Order | Reads the order from eBay again: payment, cancellation, and fulfillment status. If it is then paid and without a cancellation and has no sales order yet, the action creates it. |
| Send Full Refund | Refunds the total amount of the order to the buyer through eBay, after a prompt with amount and currency. Only once per order: afterwards the Refund section shows the refund eBay accepted, and both refund actions are disabled. |
| Send Partial Refund | Refunds part of the order to the buyer through eBay. You enter the amount in a dialog; it cannot exceed the total amount. Also only once per order. |
| Cancel Order | Asks eBay to cancel the order. You choose one of eBay's reasons (preset: out of stock) and confirm the prompt. Only active while the eBay Order Status is Active. See Cancellation and Sales Order. |
| Payment Disputes (Navigate) | Opens the eBay payment disputes the buyer opened for this order. |
| Cancellation Requests (Navigate) | Opens the eBay cancellations of this order – by the buyer or by you – with their status at eBay. The merchantCENTRAL Cancellations action, by contrast, shows what became of the cancellation in the sales order. |
| Returns (Navigate) | Opens the eBay returns of this order. |
A refund does not change the sales order or the posted documents in Business Central; create a credit memo yourself if needed.
Import Again on the card is the merchantCENTRAL action and is active only for On Hold: it creates the sales order of an order on hold once the unknown item is assigned – provided the order is paid and has no cancellation. An order with status Error is created at once with Create Sales Orders in the eBay Orders; otherwise the next run tries it.
Order Lines
Every order line of an eBay order is an eBay line item. The lines are read-only.
For eBay, the merchantCENTRAL columns show:
| Field | Description |
|---|---|
| Line Type | Item for an eBay line item that goes into the sales order. |
| Item No. / Variant Code | Item and variant in Business Central that merchantCENTRAL found by the eBay SKU, see Item and Variant by eBay SKU. Empty if the SKU was unknown. |
| SKU | eBay SKU of the line item. |
| Description | The first 100 characters of the eBay title. |
| Quantity | Quantity ordered. |
| Unit Price / Line Amount | Price per unit the buyer paid – after promotions – and quantity × unit price. The line item goes into the sales order at this price. |
| Cancelled Quantity | How much of the line item was taken out of the sales order after a cancellation. |
Via Personalize, you can show External Item No. (the eBay item number), External Line Reference (the ID of the line item at eBay), Sales Line No., Tax Amount, and Discount Amount (discounts from promotions).
A line with the shipping costs – only when the Shipping Item No. of the eBay setup creates it – is not an eBay line item; the eBay columns stay empty there.
eBay Columns
| Field | Description |
|---|---|
| eBay Title | Title of the eBay listing in full length. Placed directly after Description. |
| Quantity Reported as Shipped | How much of the line item has already been reported to eBay as shipped. Each posted shipment with a tracking number reports only what is still open; further parcels of the same shipment report their tracking number without a quantity. So no quantity goes to eBay twice. |
| Unit Price before Promotions | Price per unit as listed. Unit Price is what the buyer paid after the promotions. |
| eBay Line Total | Total of the line item as eBay reports it. |
| Shipping Cost | Share of the shipping cost in the line item. |
| eBay Collected Tax | Tax of the line item that eBay collects and remits. |
Cancellation and Sales Order
eBay cancels whole orders only. merchantCENTRAL applies a cancellation eBay has accepted as follows:
- Before the sales order: the order gets the status Cancelled; no sales order is created any more.
- After the sales order: merchantCENTRAL takes the order out of the sales order, as for all marketplaces. How this happens is set by Cancellation Handling on the merchantCENTRAL marketplace card: Automatic changes the sales order itself, Manual keeps the cancellation waiting in the merchantCENTRAL Order Cancellations until you apply it. Whatever cannot be done automatically stays there with status Action Required and the reason, and appears on the merchantCENTRAL dashboard. The sales order is not deleted. The Cancellations action of the card shows the cancellations of the order.
Where the cancellation comes from:
- With “Cancel Order”: as soon as eBay has accepted the cancellation, merchantCENTRAL applies it at once.
- Cancelled at eBay (by the buyer or by eBay): the next order import reads the cancellation and reports it to merchantCENTRAL. You decide a buyer's cancellation request in the eBay cancellations; while it is open, the order gets no sales order.
Data Protection
The buyer data of an eBay order is kept only as long as the work requires it. The nightly data protection run of merchantCENTRAL clears it using the periods that apply to all marketplace orders in the merchantCENTRAL Setup (section Data Protection, see retention periods); the eBay connector also clears the eBay Buyer:
| Order | Cleared after | Counted from |
|---|---|---|
| With status Shipped, Invoiced, or Cancelled | Order Data Retention (Days) (default 30 days) | Order date |
| Any other | Unfinished Order Retention (Days) (default 90 days) | Order date; without an order date, the import |
eBay account deletion: When a buyer closes their eBay account, eBay reports this through Marketplace Account Deletion. The eBay connector then anonymizes all orders of this buyer at once, without waiting for the periods, and also clears the buyer in the eBay returns, cancellations, payment disputes, transactions, and messages.
Order ID, dates, amounts, statuses, and payment method remain – these are business data. Neither way touches sales orders and posted documents in Business Central; the statutory retention period applies to them.
An order whose buyer data has already been cleared no longer gets a sales order – it would be created without an address.