Skip to content
  • There are no suggestions because the search field is empty.

BigCommerce Order Errors

Common BigCommerce order errors and how to begin troubleshooting them.

On occasion, BigCommerce may return an error when Trade Runner tries to create an order in your BigCommerce store.

Use this guide to match the error message shown in Trade Runner, understand what caused it, and decide what to do next.

Cannot find product variant, sku:

Error message

Cannot find product variant, sku: 1234567890, retailerRef: 54321012345

The SKU and retailer reference numbers shown above are examples. The actual numbers will be different for each order.

What it means

The product or product variant cannot be found, so Trade Runner cannot send the order to BigCommerce.

Common causes

This can happen when:

  • the product has been deleted in BigCommerce
  • the product has been made unavailable in BigCommerce
  • the product has run out of stock
  • product options were added in BigCommerce after the item was listed through Trade Runner

What to do

  1. Check the product in BigCommerce.
  2. If the product has been deleted, made unavailable, or is out of stock, you will need to manually handle the order in Trade Me.
  3. If the product now has options that were not available when the buyer purchased the item, contact the buyer to confirm the correct option, create the order manually in BigCommerce, then mark the order in Trade Runner as manually fulfilled. You will need to manually update the order in Trade Me to shipped.

"status":400,"message":"The options of one or more products are invalid."

Error 

  • Status: 400
  • Message: The options of one or more products are invalid.
  • Type: MandatoryProductOptions
  • Required option example: Colour

Error Message

[{"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"}}]}}]

 

What it means

The product in BigCommerce has required options, such as colour or size, but the product listed through Trade Runner did not include those options when the buyer purchased it.

Common causes

This can happen when:

  • options have recently been added to the product in BigCommerce
  • the product was already listed through Trade Runner before those options were added
  • BigCommerce now requires an option, such as colour or size, before it will accept the order

What to do

  1. Check the product in BigCommerce and confirm which option is now required.
  2. Contact the buyer and confirm which option they want if relevant.
  3. Create the order manually in BigCommerce 
  4. Cancel the order in Trade Runner if the order cannot be sent.

"status":409,"message":"Quantities of one or more products are out of stock or did not meet quantity requirements

Error 

  • Status: 409
  • Message: Quantities of one or more products are out of stock or did not meet quantity requirements.
  • Type: OutOfStock
  • Inventory level: 0

Error Message

 

[{"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"}}]}}]

 

What it means

The product inventory level is zero in BigCommerce, so BigCommerce will not accept the order.

Common causes

This can happen when:

  • the product has sold out in BigCommerce
  • the available inventory is lower than the quantity ordered
  • BigCommerce stock levels have not been updated before the order was made.

What to do

  1. Increase the product inventory in BigCommerce, then resend the order from Trade Runner.
  2. If the item cannot be supplied, cancel the order in Trade Runner and manually refund the customer through Trade Me.

"status":400,"message":"The field 'billing_address.Zipcode' is invalid."

Error 

  • Status: 400
  • Message: The field billing_address.Zipcode is invalid.
  • Reason: Billing address zip code not supplied.

Error Message

{"status":400,"message":"The field 'billing_address.Zipcode' is invalid.","details":{"invalid_reason":"Billing address zip code not supplied."}}] 

What it means

Trade Me may not validate the customer’s address in the same way as BigCommerce.

Common causes

This can happen when:

  • BigCommerce requires a postcode
  • the customer address does not include a postcode
  • the order is from a region where postcodes are not always supplied, such as New Zealand

What to do

  1. Open the order in Trade Runner.
  2. Edit the customer details.
  3. Add a value into the missing postcode field.
  4. If there is no postcode available, repeat the suburb or city in the blank field.
  5. Save the customer details.
  6. Try sending the order to BigCommerce again.