Skip to main content

Hepsiburada Store Management

The ECOSIRE Hepsiburada Store Management module integrates your Hepsiburada merchant account with Odoo ERP. Hepsiburada is one of Turkey's largest and most trusted e-commerce platforms, serving tens of millions of customers with a wide range of product categories. This module uses the Hepsiburada Marketplace API to synchronize your product catalog, orders, and inventory between Hepsiburada and Odoo.

Compatibility: Odoo 17 / 18 / 19 Price: $249 (one-time) License: Up to 3 domain activations

Key Features​

  • Hepsiburada Marketplace API integration with Merchant ID and API key authentication
  • Bidirectional product synchronization (listings, variants, prices, images)
  • Automatic order import and fulfillment tracking
  • Real-time inventory synchronization
  • Category mapping to Hepsiburada taxonomy
  • Product listing approval status monitoring
  • Cargo and shipment management
  • Returns and claim processing
  • Multi-company record rules for isolated data management

Prerequisites​

  • Odoo 17, 18, or 19 (Community or Enterprise edition)
  • An active ECOSIRE license for this module
  • A Hepsiburada merchant account with API access
  • Merchant ID and API key from the Hepsiburada Merchant Center

Installation​

  1. Download the module ZIP from your ECOSIRE Dashboard
  2. Extract to your Odoo addons directory: 
    unzip ecosire-hepsiburada-*.zip -d /opt/odoo/addons/
  3. Restart the Odoo service: 
    sudo systemctl restart odoo
  4. Navigate to Apps, click Update Apps List
  5. Search for "ECOSIRE Hepsiburada Store Management" and click Install
  6. Enter your ECOSIRE license key when prompted

Configuration​

Step 1: Obtain Hepsiburada API Credentials​

  1. Log in to the Hepsiburada Merchant Center at https://merchant.hepsiburada.com
  2. Navigate to Settings then API Settings
  3. Note your Merchant ID (shown in your account profile)
  4. Generate or copy your API Key from the API settings page
  5. Contact Hepsiburada Merchant Support if API access needs to be activated for your account

Step 2: Connect in Odoo​

  1. Navigate to Hepsiburada Store Management > Configuration
  2. Create a new configuration and enter:
    • Merchant ID (merchant_id) -- your Hepsiburada merchant identifier
    • API Key (api_key) -- your Hepsiburada API key
  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: Hepsiburada to Odoo, Odoo to Hepsiburada, or bidirectional
  • Set sync interval: scheduled (every 5, 15, or 60 minutes)
  • Configure product field mapping and category mapping to Hepsiburada taxonomy
  • Monitor product listing approval status from within Odoo

Inventory Sync​

  • Map Odoo warehouses to Hepsiburada fulfillment settings
  • Set buffer stock quantities to prevent overselling
  • Enable real-time stock updates on inventory changes

Order Sync​

  • Enable automatic order import
  • Map Hepsiburada payment methods to Odoo payment journals
  • Configure cargo tracking sync for shipment confirmation

Initial Sync​

  1. Go to Hepsiburada Store Management > Operations > Initial Import
  2. Select data types to import (Products, Customers, Orders)
  3. Set date range for historical orders
  4. Click Start Import and monitor progress in the sync log

API Details​

FieldValue
Auth methodHTTP Basic Authentication (Merchant ID + API Key)
Base endpointhttps://listing-external.hepsiburada.com
Product listing endpoint/listings
Order endpointhttps://order-external.hepsiburada.com/orders
Inventory endpoint/listings/merchantid/{merchantId}/inventory-uploads
Key config fieldsmerchant_id, api_key

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​

IssueSolution
Connection failedVerify merchant ID and API key; contact Merchant Support to confirm API access
Sync not runningCheck Odoo scheduled actions (cron jobs) are enabled
Products not approvedCheck product data completeness and Hepsiburada listing requirements
Orders not importingVerify order status filters and date range settings
401 UnauthorizedRegenerate API key in the Hepsiburada Merchant Center
Merchant ID mismatchConfirm the numeric ID shown in your Merchant Center account profile
Cargo not updatingVerify cargo provider code and tracking number format
License not activeVerify your ECOSIRE license key at Settings > ECOSIRE License

Support​

Last updated on