Skip to content

eBay Carrier Mapping

The eBay Carrier Mappings page assigns Business Central shipping agents the eBay carrier code – the carrier eBay knows the parcel by. This is only needed where the code and the name of the shipping agent do not give the carrier away. Without a carrier, no shipment confirmation goes to eBay; with the right one, eBay counts the tracking number as valid tracking.

Open the page

  • Via search: eBay Carrier Mappings
  • Via the eBay dashboard → Carrier Mapping
  • Via the eBay setup (marketplace card on the EBAY row) → action eBay Carrier Mapping (active only with an eBay permission set)

Fields

Field Description
Shipping Agent Code Business Central shipping agent being mapped.
Shipping Agent Name Name of the shipping agent.
eBay Carrier Code eBay code of the carrier (e.g. DHL, DPD_DE, HERMES_DE, UPS, FEDEX).

When a delivery is reported to eBay

Every posted sales shipment with a tracking number is a shipment confirmation of its own: with Auto Send Shipment Confirmation enabled on the next run of the job queue (FULFILLMENT, every 5 minutes), by hand with Send Shipment Confirmation under Marketplace on the posted sales shipment. The tracking number is on the shipment or arrives after posting through merchantCENTRAL's shipment tracking – for example with a label created later or, for a drop shipment, with the supplier's report for its purchase order.

A shipment confirmation carries only the line items of its own shipment. When an order ships partly from your own warehouse and partly as a drop shipment from the supplier, the connector reports two shipment confirmations, each with its own line items and its own tracking number. When no line of a shipment belongs to a line item of the eBay order, nothing is reported for it.

Several parcels of one shipment

When a shipment goes out in several parcels, eBay gets every tracking number – the one on the shipment and every one merchantCENTRAL's shipment tracking knows for it, for example from a label with several parcels. Each tracking number goes to eBay exactly once, also when the run is repeated or Send Shipment Confirmation is chosen again; the connector never reports a quantity twice.

  • Contents of the parcels known: When merchantCENTRAL knows what is in the parcels (packages with content lines), each parcel reports the line items and quantities it carries – one shipment confirmation per parcel.
  • Contents not known: The first parcel reports all line items of the shipment with their quantities. Every further parcel adds its tracking number to these line items, without a quantity. eBay assigns a line item only one tracking number within a shipment confirmation, so the connector reports the further ones through eBay's Trading API (CompleteSale), which knows several packages per line item.

A parcel that only comes in after the first report – such as a label created afterwards – goes to eBay with the next run, also when eBay already shows the order as shipped. Which parcels eBay has is shown on the posted sales shipment in the field Parcels Reported to eBay (FastTab eBay); the number opens the parcels with tracking number, carrier, report type and time.

How the carrier of a shipment confirmation is determined

The carrier follows from the shipping agent of the posted shipment. If the shipment has none, the shipping agent merchantCENTRAL's shipment tracking knows for its parcel applies – from the shipping label or the supplier's report.

  1. Your own extension: A subscriber to the event OnBeforeMapShippingAgentToCarrier (codeunit ALN MCE Fulfillment Handler) decides before anything else.
  2. Mapping on this page, if there is one with an eBay carrier code for the shipping agent.
  3. Code, then name of the shipping agent: If the code or the name names one of the carriers DHL, DPD, GLS, Hermes, UPS, FedEx, TNT or Deutsche Post, it is recognized – a shipping agent DPD or one named "DHL Paket" needs no mapping.

merchantCENTRAL does not guess a carrier and does not fill in a default – a wrong one would report the parcel to eBay under another service. If no carrier results, the shipment confirmation is not sent; it waits.

Waiting shipment confirmation

Why a delivery has not been reported to eBay yet is shown on the posted sales shipment in the field eBay Shipment Confirmation Error (FastTab eBay): a shipping agent without an eBay carrier, a shipment without a shipping agent, lines without a line item of the eBay order, or eBay's answer to a refused shipment confirmation. The activity log names the reason once, when it is new – not with every run.

  • Shipping agent without an eBay carrier: Map the shipping agent on this page.
  • Shipment without a shipping agent: Enter the shipping agent on the posted sales shipment with Update Document.

With the next run the shipment confirmation goes to eBay, and the field is empty again. Send Shipment Confirmation by hand reports a missing carrier as the error "No eBay Carrier for the Shipping Agent", which names the shipping agent and leads here.


Tips

Valid tracking pays into your seller account

Only with the correct carrier does eBay count the tracking number as valid — improving the Valid Tracking Rate in the seller standards.