Downloading eBay orders

Once the eBay integration has been authorized and activated, orders will begin to download as of the download start date. Any orders in eBay dated prior to this will be ignored.

Each download will check for new orders within the last seven days - but restricted to those after the order download start date.

Deactivating then reactivating the channel will not change the order download start date. This means that the integration can be deactivated to put the order download on hold, and as long as it is reactivated within seven days any orders placed during this time will download.

Reauthorizing the eBay account will reset the order download start date.

There are three order download triggers:

  • New order notification received from eBay (automatic download)

    eBay alerts your Brightpearl account when a new order is taken, which triggers Brightpearl to automatically download the order.

  • Manual download

    A download can also be manually triggered from the recent sales list in Brightpearl, subject to the above restrictions.

  • Twice daily sweep triggered by Brightpearl (automatic download)

    An automatic download looking for any missing orders will be carried out twice a day. This ensures that if for any reason an order was not successfully created in Brightpearl, it will be captured.

How long does it take for an eBay order to download into Brightpearl?

Typically orders download as they are made, when eBay sends a notification of a new order. However, the exact time and order of download can vary due to a number of factors:

  • eBay API speed and timely sending of notification
  • Fraud checks being carried out
  • Network connectivity
  • A large number of orders waiting to download

The majority of orders download within an hour of being placed. It is therefore recommended that this is considered when setting cut offs for next day delivery times. For example, if orders are required by 2pm for next day delivery, a safe cut off time for eBay orders is 1pm.

Occasionally the factors mentioned above could cause a small percentage of orders to take longer than an hour. Brightpearl will create the order as soon as the required information has been provided and it is picked up by one of the three download triggers.

Adding items to the shopping basket

A single order is created for all items when an eBay buyer places items into their basket or cart and uses the checkout. In this case all items are contained in a single order and the single payment can be automatically allocated in Brightpearl.

Multiple orders will be created when the "Commit to buy" option is used by the customer, unless the "Download only paid orders" setting is enabled.

An order is created in Brightpearl at the point the eBay buyer clicks "Commit to buy" (using the "Buy it now" option). This is the case even if the customer pays for the items all together. When this occurs the payment will not be auto-allocated to the individual orders in Brightpearl - it will need to be done manually.

Note that is is not possible to manually merge these orders in Brightpearl as the connection to eBay will be broken. If this happens the items will need to be manually updated as shipped in eBay.

To avoid multiple orders and failed payment allocations, it is recommended that the eBay channel is set to download only paid orders.

Download only paid orders

There is an option to only download eBay orders once checkout is complete, which happens when a payment is received (including part payments and cash on delivery).

Enabling this setting means that Brightpearl will capture only the most up to date information on the order and download the final version of items into a single order. This will help to ensure items for the same customer are shipped together where they have committed to buy multiple items separately. Turn on this option within the eBay channel settings at Channels > eBay > Settings.

If the option is left unchecked, orders download as soon as the customer commits to buy an item, even if they have't yet paid. This ensures that stock is reserved as soon as possible, but can result in multiple orders being created where the customer purchases multiple items (using commit to buy over add to basket).

PayPal eChecks

Sometimes, when customer places an order, a payment will be sent as an eCheck if their PayPal balance is not enough to cover the payment and they don’t have a credit or debit card linked to their account.

Please note that eChecks are not instant payments. It usually takes between four and five working days for an eCheck to complete and the money to appear in the recipient’s PayPal account.

However, due to the way eBay transmits information, even if the "Download only paid orders" setting is turned on, Brightpearl will still download an order paid via PayPal eCheck once checkout is complete.

The order will appear in Brightpearl as unpaid.

Note: Sellers cannot block eCheck payments on eBay.

Order updates made in eBay

If a customer edits their order in eBay those changes can be reflected in Brightpearl, even after it has already downloaded. The following details can be updated:

  • Delivery address
  • Shipping method
  • Shipping charge

If the order has already been shipped in Brightpearl, the changes will still be made to the order and a channel alert will be created.

Order updates effecting the order rows (i.e. shipping charges) will not be made in Brightpearl once the order has been invoiced. For this reason, we recommend that invoicing is only done once the order is complete - i.e., it has been paid and shipped.

Editing eBay orders

If a customer wishes to change the items they have purchased, it is best practice to cancel the order in eBay and refund the customer. The order will also need to be manually processed as a credit and refunded in Brightpearl. A new order can then be placed.

If the order is simply edited in Brightpearl, any changes will not be reflected in eBay. However, as long as the customer reference field contains the eBay listing ID and order reference the order will still be marked as shipped (once shipped in full).


When an order downloads from eBay it will search for an existing contact using the customer email address.

If an existing customer record is found, the order will be created against that record. If any details of the customer have changed, such as their address, they will be seen on the new order but will not update the contact record.

If no contact is matched in Brightpearl, a new customer record is created and the order will be created against this record.

New contacts are created using the eBay buyer first and last name. The eBay customer username wil be recorded in the aliases section of their contact record.

Products and inventory

Where the eBay listing is connected to a product in Brightpearl, that item will be added to the downloaded order. If inventory is available for that item then it will be allocated to the order.

If the eBay listing is not connected to a product in Brightpearl, then a miscellaneous and non-stock tracked line item is added using the item name from eBay.

Miscellaneous items cannot be marked as shipped and therefore will not update eBay with shipping details. If a product record does exist, that item can be swapped onto the order instead and the order can be processed as normal - all shipping updates will be sent to eBay.

Where an eBay listing is connected to a Brightpearl bundle, all the items within the bundle are added to the sales order and the available inventory allocated.

Prices and tax

All item prices and tax values are provided by eBay during the order download to ensure the order in Brightpearl matches what the customer agreed to pay. Brightpearl will use the integration tax rules to calculate which tax code to apply.

Read about integration tax rules for VAT mode
Read about integration tax rules for Sales Tax mode

Shipping charges and tax

A shipping charge is added as a line item on the order.

If tax should be calculated for shipping charges, ensure that you've configured your eBay connector correctly - go to Settings > Brightpearl Apps > eBay to edit your settings. When activated, the company default tax code will always be applied.

If tax is not charged on shipping, the Not Rated tax code will always be assigned.

Shipping method

When an order downloads into Brightpearl from eBay, you can automatically populate the shipping method field. This will allow you to filter your sales list by shipping method and prioritize fulfillment and shipping.

The shipping method is assigned by searching for a method in Brightpearl with the same name as the one applied to the order in eBay. If a matching name is found, it is added to the drop-down field on the order in Brightpearl. The charge is applied as a free text line item with the amount the customer actually paid - it is not related to any shipping prices set on the shipping method in Brightpearl.

When creating your shipping methods you need to name them using the name as it appears in eBay, alternatively you can use the eBay service name.

You can find a full list of the eBay service names here.

set shipping method

eBay Global Shipping Programme (GSP)

Brightpearl supports the eBay Global Shipping Programme (GSP). An eBay distribution centre will be set as the order delivery address to ensure your goods-out notes and shipments automatically go to the correct place.

Any changes needed to the shipping cost on the order are not currently handled and will need to be edited manually.


When eBay confirms payment for an order, Brightpearl will create an order payment to mark the order as paid. The payment details for eBay orders are provided by eBay, and you do not need to integrate any payment providers with Brightpearl separately in order to use the eBay integration.

Learn more about payments for eBay orders.

eBay order customer reference

Downloaded eBay orders will display the order reference in the customer reference field of the Brightpearl order. It matches the eBay order reference, which takes the form 12-123456-12345.

It is important that is reference is not changed in Brightpearl as it is used to link shipping updates to the order in eBay.


Order comments

Order comments added during checkout will not be download with the order into Brightpearl. These can be manually added to the order in Brightpearl.

Redownloading an order

An order can be deleted in Brightpearl and redownloaded from eBay as long as it was placed within the last seven days and is after the order download start date on the channel in Brightpearl.

Have more questions? Submit a request