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, this triggers Brightpearl to automatically download the order.
- Manual download
A download can also be manually triggered from the recent sales list in Brightpearl, but this download is 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 that 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 send 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 are 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.
"Commit to buy" or "Buy now"
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 when this occurs it is recommended that the eBay channel is set to only download paid orders.
A single order is created for all items when an eBay buyer places items into their basket/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.
Note: Multiple orders will be created when the commit to buy option is used by the customer. See above.
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 an integration 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 - it has been paid and shipped.
Editing eBay orders
If a customer wishes to change the items they have purchased, best practice is to cancel the order in eBay and refund the customer. The order will also need to be manually processed as a credit and refund in Brightpearl. A new order can then be placed.
If the order is simply edited in Brightpearl, those 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 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 processed as normal - all shipping updates will be sent to eBay.
Where an eBay listing is connect 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.
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 this is selected on the eBay account setup in Brightpearl - go to Settings > Brightpearl Apps > eBay to edit account 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.
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.
eBay Global Shipping Programme (GSP)
As of version 4.90, Brightpearl supports the eBay Global Shipping Programme (GSP).
Payments and PayPal
An order in Brightpearl will be marked as paid when the payment method is PayPal. Although Brightpearl has a separate integration with PayPal, the payment details are provided by eBay.
eBay order customer reference
Downloaded eBay orders will display the order reference in the Customer ref field of the Brightpearl order. It is formed of the listing ID followed by the eBay order reference.
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 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.