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
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.
Check the box if you want to automatically import new listings from BackMarket.
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.
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.
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
With Inventory Quantity Sync enabled, choose the inventory statuses which 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
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.
**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.
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.
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 towards open orders
Check if the 'Canceled' order status is set to count towards open orders