On occasion, an error will be reported by Bigcommerce when ebayLINK tries to create the order in the Bigcommerce system.

Below are listed the usual error messages and their explanation.

Error message (example, actual numbers will vary): Cannot find product variant, sku: 1234567890, retailerRef: 54321012345 

Explanation: the product or the variant cannot be found in the ebayLINK system, thus it cannot be sent to Bigcommerce. This could happen if you've deleted the product in Bigcommerce, make it unavailable or sometimes when it runs out of stock. This error could also happen if the product used to have no options, it was purchased on eBay as such, but then you added options in Bigcommerce. See below for the same use case.

Error message (example, actual product name and id will vary):

[{"status":400,"message":"The options of one or more products are invalid.","details":{"errors":[{"type":"MandatoryProductOptions","product":{"id":10986,"name":"Awesome Product","required_product_options":[{"id":151,"option_id":59,"display_name":"Colour","url":"https:\/\/api.bigcommerce.com\/stores\/nxyz1er\/v2\/products\/10986\/options\/151","resource":"\/products\/10986\/options\/151"}],"url":"https:\/\/api.bigcommerce.com\/stores\/nxyz1er\/v2\/products\/10986","resource":"\/products\/10986"}}]}}]

Explanation: the current product in Bigcommerce has options ("Colour" in the above example), but the product in ebayLINK that was listed on eBay doesn't. Most likely you have recently added the options to Bigcommerce. In this case you will need to manually deal with the order, likely you'll need to contact the buyer and confirm what option they want, create the order in Bigcommerce and cancel the order in ebayLINK.

Error message (example, actual numbers will vary): [{"status":409,"message":"Quantities of one or more products are out of stock or did not meet quantity requirements.","details":{"errors":[{"type":"OutOfStock","product":{"id":32,"name":"[Sample] Tomorrow is today, Red printed scarf","inventory_level":0,"url":"https:\/\/api.bigcommerce.com\/stores\/q178ow9j\/v2\/products\/32","resource":"\/products\/32"}}]}}] 

Explanation: the product is out of stock, i.e. inventory quantity is zero in Bigcommerce. Either increase the inventory and resend the order or cancel the order in ebayLINK and refund the customer using the eBay application interface.

Error message: [{"status":401,"message":"No credentials were supplied in the request."}]

Explanation: Your store is using the "old" method of integration using private apps. You will need to install the ebayLINK Bigcommerce app. It's really easy and you don't need to do anything else, the ebayLINK account will be updated automatically. The installation instructions are here:



If the error is none of the above, please submit a request for help or email ebaylink@citybeachsoftware.com clearly stating the store name and the eBay order number.