Back Market Store Management
The ECOSIRE Back Market Store Management module integrates your Back Market seller account with Odoo ERP. Back Market is Europe's leading recommerce marketplace for refurbished electronics and devices, operating in 16 countries with over 35 million customers. This module synchronizes your refurbished product listings, orders, customer information, and inventory between Back Market and Odoo to streamline your circular economy operations.
| Compatibility | Odoo 17.0, 18.0, 19.0 (Community or Enterprise) |
| Current shipped version | 17.0 → 17.0.2.4.0, 18.0 → 18.0.2.4.0, 19.0 → 19.0.2.4.0 |
| Price | $499 (one-time, per Odoo version) |
| Odoo module licence | OPL-1 |
Key Features
- Back Market Seller API integration with API key authentication
- Refurbished product listing management with condition grading (Excellent, Good, Fair)
- Automatic order import and fulfillment tracking
- Real-time inventory synchronization
- Multi-country support (FR, DE, ES, IT, UK, US, and more)
- Buyer message and dispute management
- Returns and buyback processing
- Seller scorecard and quality metrics monitoring
- Multi-company record rules for isolated data management
Prerequisites
- Odoo 17, 18, or 19 (Community or Enterprise edition)
- A Back Market seller account with API access
- Back Market API key from the seller dashboard
Installation
- Download the module ZIP from your ECOSIRE Dashboard
- Extract to your Odoo addons directory:
unzip ecosire-backmarket-*.zip -d /opt/odoo/addons/
- Restart the Odoo service:
sudo systemctl restart odoo
- Navigate to Apps, click Update Apps List
- Search for "ECOSIRE Back Market Store Management" and click Install
There is no licence key and no activation step -- the module is fully functional once installed.
Configuration
Step 1: Obtain Back Market API Credentials
- Log in to your Back Market Seller Dashboard at
https://www.backmarket.com/en-us/seller - Navigate to Account Settings then API
- Click Generate API Key or copy your existing API key
- Note the environment (Production vs Sandbox) for your credentials
Step 2: Connect in Odoo
- Navigate to Back Market Store Management > Configuration
- Create a new configuration and enter:
- API Key (
api_key) -- your Back Market seller API key - Seller Reference (
seller_reference) -- your Back Market seller identifier
- API Key (
The API key is sent as the raw Authorization header value with no scheme prefix. Do not prefix it
with Basic: a Basic-encoded value is rejected with 401 Unauthorized.
3. Click Test Connection to verify API access
4. Configure your default warehouse and company mapping
Step 3: Configure Sync Settings
Product Sync
- Choose sync direction: Back Market to Odoo, Odoo to Back Market, or bidirectional
- Set sync interval: scheduled (every 5, 15, or 60 minutes)
- Map product conditions to Back Market grading (Excellent, Good, Fair, Poor)
- Configure category and attribute mapping to Back Market taxonomy
Inventory Sync
- Map Odoo warehouses to Back Market seller locations
- Set buffer stock quantities per condition grade
- Enable real-time stock updates on inventory changes
Order Sync
- Enable automatic order import
- Map Back Market payment methods to Odoo payment journals
- Configure shipment tracking sync for fulfillment confirmation
Initial Sync
- Go to Back Market Store Management > Operations > Initial Import
- Select data types to import (Products, Customers, Orders)
- Set date range for historical orders
- Click Start Import and monitor progress in the sync log
API Details
| Field | Value |
|---|---|
| Auth method | API key sent as the raw Authorization header value, no scheme prefix |
| Production endpoint | https://www.backmarket.com/ws |
| Sandbox endpoint | https://preprod.backmarket.com/ws |
| Products endpoint | /api/products, /api/offers |
| Orders endpoint | /api/orders |
| Key config fields | api_key, api_base_url, seller_reference |
Public endpoints this module exposes
The connector serves one externally reachable endpoint, relative to your Odoo base URL
(web.base.url) -- for example https://erp.example.com/backmarket/webhook.
| Endpoint | Method | Auth | Purpose |
|---|---|---|---|
/backmarket/webhook | POST | Public (unauthenticated) | Reserved for Back Market notification deliveries. |
Back Market's seller API is poll-based and does not push events, so this handler only logs the
delivery's topic and answers {"status": "ok"}. It performs no signature validation and no
dispatch. Do not rely on it to move data, and do not read its ok response as proof that anything
was processed. Data reaches Odoo through the scheduled actions.
Dashboard
The built-in OWL 2 dashboard provides real-time visibility into your integration:
- 6 KPI cards -- Revenue, Orders, Customers, Products, Avg Order Value, and Sync Health -- each with period-over-period delta indicators
- Sales Trend chart (Chart.js line chart) with interactive date filtering
- Order Status breakdown (doughnut chart) showing distribution across statuses
- Period filters -- Today, 7 days, 30 days, 90 days, Year, or Custom date range
- Activity feed showing recent sync log entries with type indicators
- Quick action buttons for Products, Orders, Customers, Queue, Logs, and Settings
- Status footer with Queue Jobs, Errors, Out of Stock, and Sync Rate
- Auto-refresh every 60 seconds with dark mode support
Troubleshooting
| Issue | Solution |
|---|---|
| Connection failed | Verify API key; confirm you are using the correct environment (prod vs sandbox) |
| Sync not running | Check Odoo scheduled actions (cron jobs) are enabled |
| Product listing rejected | Verify product condition grading and required attribute completeness |
| Orders not importing | Verify order status filters and date range settings |
| 401 Unauthorized | Regenerate API key in the Back Market Seller Dashboard |
| Wrong country settings | Confirm the country code matches your seller account's primary market |
| Dispute not resolved | Access the Buyer Messages section for pending resolution items |