All Collections
Syncing with Back Market
Syncing with Back Market
Brennan Zelener avatar
Written by Brennan Zelener
Updated over a week ago

WholeCell's Back Market integration automates listing quantity management, order importing, and shipment information exporting between WholeCell and Back Market.

This integration syncs:

  • Inventory quantities (WholeCell → Back Market)

  • Listings (Back Market → WholeCell)

  • Orders (Back Market → WholeCell)

  • Order Validation (WholeCell → Back Market)

  • Shipments (WholeCell → Back Market)

  • RMAs (Back Market → WholeCell)

  • IMEIs (WholeCell → Back Market)

Enabling the Integration

Enable the Back Market integration from your Integrations Dashboard:

Follow this guide from Back Market to generate your API Key for WholeCell. Then, enter your Back Market API Key to connect your account.

Configuring the Integration

Order Import

Enabling Order Import will automatically import any open orders from your Back Market account. This may take a few minutes to complete. After the first import, WholeCell will begin automatically importing any new Back Market orders.

You can also choose to Auto Validate Orders so that shipment information can be imported from WholeCell to Back Market by checking the 'Auto Validate Orders' box. If you choose to validate them manually, you'll need to make sure to do so before committing inventory or shipping Back Market orders.

Enabling Auto Validation will "validate" your Back Market orders immediately when they are imported to WholeCell. This validation is automatic for every order and is not dependent on inventory quantities.

Back Market requires orders to be validated before WholeCell can sync shipment tracking or IMEIs, so enabling auto validation typically improves sync workflows.

Listing Import

Check the box if you want to automatically import new listings from BackMarket.

RMA Import

WholeCell can automatically import RMAs from Back Market support threads. If this option is enabled, WholeCell will import support messages as RMAs if the customer has requested a return and a label has been issued.

Organization Type

When Back Market orders are automatically imported, WholeCell can use either the customer's name from the shipping address that is sent from Back Market (the Shipping Name) or it can use an automatically generated customer in WholeCell named "Back Market" (the Channel Name).

This choice depends on how you want to be able to search and filter your sales orders within WholeCell. If you want to be able to search for a customer's name to find their order, choose Shipping Name here. Otherwise, if you want to keep your orders a bit cleaner and you're OK finding orders by the Back Market transaction number, you can choose Channel Name.

Order Statuses

You need to map Back Market's order statuses to your WholeCell order statuses for orders to be imported. If you need to create new order statuses in WholeCell for this, follow the instructions in this article to do so: Managing Sales Order Statuses.

Sales order statuses in WholeCell are controlled by the actions that you take in Back Market. Changing the order status in WholeCell won't affect the status in Back Market.


WholeCell has the ability to update your Back Market orders with the IMEI of the device once it has been committed.

Inventory Quantity Sync

Enabling Inventory Quantity Sync will automatically update the quantities of your Back Market listings based on the calculated quantities* of associated Product Variations or SKUs in WholeCell.

* Calculated Quantity = Available Quantity - Outstanding Quantity

Inventory Statuses

With Inventory Quantity Sync enabled, choose the inventory statuses that should count towards your total calculated quantity* of available inventory to update your Back Market listings with.


With Inventory Quantity Sync enabled, choose which warehouse(s)' inventory should count towards your total calculated quantity* of available inventory to update your Back Market listings with.


Select which Back Market region you’ll be integrating your WholeCell account with, US or EU

Listing Import

WholeCell can import Back Market listings that are actively online or ALL of them (including the ones that are out of stock and inactive).

Online listings are the ones that are active and in stock. On your Back Market dashboard, you can see how many of them there are.


Put a check in the box if you want to enable the BackPricer. This needs to be enabled on Back Market's side as well. You'll be able to view and edit the target price, BackPricer price, and listing comments from your Back Market listings pages in WholeCell.

Importing Your Back Market Listings

Once the integration is turned on and your account is connected you can sync your Back Market listings to WholeCell from the Listings tab by clicking on 'Sync Listings':

As you sell in Back Market and fulfill orders in WholeCell, you will see your listing quantities adjust. Note that they will sync when they have changed in quantity since the last update. Calculated Quantity is updated when:

  • more of a product is added to inventory

  • any "open" orders are created with that product as an order item

Back Market listings that are offline will also be updated when you add inventory in WholeCell for these SKUs or product variation as long as these listings are imported in WholeCell.

Mapping your Back Market listings

Once you've imported your Back Market listings, clicking on any listing title will take you to a page where you can see if the listing is mapped correctly to a Product Variation or SKU.

In the screenshot below, this integration is configured with Product Variations: Match via SKU. This listing has a SKU that is not recognized in WholeCell. To map this listing, the SKU "BMTESTSKU1" would need to be added to at least one Product Variation.

(To add SKUs in WholeCell, see the Setting Your Product Variations and SKUs article.)

In this next screenshot, this listing is not yet linked to a product variation so we need to link it to one by choosing 'Select specific Product Variations' then save. Click on the '+Connect' button after.

As soon as you start typing the manufacturer and model of the product, a list of matching products will appear. Select one from the list. Select the grade and condition for that variation and hit Save.

Choosing a Product Variation or having a matching SKU for a listing SKU in WholeCell is required if you want to enable Inventory Quantity Sync.

Syncing Orders and Shipments

As you receive orders on Back Market they will be automatically created in WholeCell. If your Back Market setting in WholeCell is not set to auto-validate orders, make sure to validate your orders in Back Market and then add shipping information to them in WholeCell when you fulfill and ship them. If you add shipment information to a Back Market order before validating it in Back Market, the shipment information will not sync from WholeCell to Back Market.

If you are also using the ShipStation integration and you create a shipment in ShipStation, the tracking number will be systematically imported to WholeCell and then later to Back Market; Shipstation tracking number → WholeCell → Back Market.

**If you have not created the sales channel's name in WholeCell yet, you can do that here. WholeCell will not be able to sync orders to ShipStation if your sales channels don't exactly match (case sensitive) the channel names that the integration uses -- like "Backmarket", in this case. Changing these channel names will prevent the sync from working. After creating the channel name, put a check in the box here if you want to sync orders with ShipStation:

Syncing IMEIs

For single-item orders, WholeCell can send your committed inventory's IMEI to Back Market if this is enabled in your Back Market integration settings:

Once enabled, WholeCell will send the IMEI of the inventory item that you commit to Back Market as long as the order has already been validated. This sync should happen shortly after the inventory is committed. If your IMEI is not syncing, read on:

The inventory item must fulfill the original order item (it must be the same SKU/Product Variation as the product on the Back Market order). The IMEI will not sync to Back Market if the imported order item has an "Unknown SKU" unless you edit that order item to match what you are committing. If you delete the original order item and commit inventory items to the order, the IMEIs will not sync with Back Market.

The inventory item you're committing must have a value in its "ESN" attribute BEFORE you commit it to the Back Market order. If you add the ESN/IMEI to the inventory after committing it to the order, it will not sync with Back Market.

Important Notes or Reminders

  • When you enable 'Order Import' and receive orders with unknown SKUs, you won't be able to map different SKUs for the order item (e.g. mapping a WholeCell SKU to the channel's listing's SKU settings page in WholeCell). Even if you map the WholeCell SKU for that listing in WholeCell, the order item will still show "Unknown SKU". The only way to make those SKUs be recognized is to add them to the WholeCell product catalog. To proceed, you can either do a 'Direct Commit', or delete the order item and just commit whatever item you want to fulfill the channel order.

  • Related to the note above, WholeCell will not send the IMEI of the item if it's not fulfilling the original order item.

Listing Opportunities

WholeCell's Listing Opportunities tab shows you which SKUs you have sellable inventory for but are not yet listed on Back Market. For more details, check this article: Listing Opportunities

Troubleshooting Back Market Sync Issues

  • The listing quantities are not being updated

    • Has the listing been imported to WholeCell?

    • Is the listing connected?

    • Is the 'Enable Quantity Sync' box checked?

    • Is your Back Market account connected to any other integrations?

    • Is the warehouse set on the inventory items you want to sync?

  • If an order comes in and shows "Unknown SKU", check:

    • Are there matching SKUs in both Back Market and WholeCell?

    • Have all of your listings been imported to WholeCell?

  • If your orders are not coming into WholeCell, check:

    • Is the 'Enable Order Import' box checked?

  • Shipment information is not syncing to Back Market.

    • Was the order validated in Back Market before the shipment was added?

    • Have you turned on the 'Auto Validate Orders' setting on the Back Market settings page in WholeCell?

  • Sales order status is not sticking (they unexpectedly change to other statuses)

    • Check the order status mapping on the Back Market settings page in WholeCell. When this happens, it's usually a case where the Back Market order status is mapped to an "incorrect" WholeCell sales order status.

  • The outstanding count is incorrect

    • Check which sales order statuses are supposed to count toward open orders

      • Check if the 'Shipped' and 'Canceled' order statuses are set to count toward open orders

  • Are your listings being set to out-of-stock even though WholeCell is actively syncing non-zero quantities? Check to see if you have other eCommerce software connected to the channel.

Did this answer your question?