Skip to main content

Falabella Store Management

The ECOSIRE Falabella Store Management module integrates your Falabella Marketplace seller account with Odoo ERP. Falabella is Latin America's largest retailer, operating a marketplace in Chile, Colombia, Peru, Argentina, and Brazil. With over 30 million monthly visits across its platforms, Falabella.com is an essential marketplace for reaching Latin American consumers. This module uses the Falabella Marketplace API to synchronize your product catalog, orders, and inventory.

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

Key Features​

  • Falabella Marketplace API integration with API key and Seller ID authentication
  • Bidirectional product synchronization (listings, variants, prices, images)
  • Automatic order import and fulfillment tracking
  • Real-time inventory synchronization
  • Multi-country support (CL, CO, PE, AR, BR)
  • Category mapping to Falabella taxonomy per country
  • Shipping and logistics tracking
  • Returns and claim processing
  • Seller performance metrics monitoring
  • 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 Falabella Marketplace seller account with API access
  • API key and Seller ID from the Falabella Seller Center

Installation​

  1. Download the module ZIP from your ECOSIRE Dashboard
  2. Extract to your Odoo addons directory: 
    unzip ecosire-falabella-*.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 Falabella Store Management" and click Install
  6. Enter your ECOSIRE license key when prompted

Configuration​

Step 1: Obtain Falabella API Credentials​

  1. Log in to the Falabella Seller Center for your country (e.g., https://sellercenter.falabella.com for Chile)
  2. Navigate to Settings then API Access or Integrations
  3. Note your Seller ID and generate or copy your API Key
  4. If selling in multiple countries, note that each country has a separate Seller Center and credentials

Step 2: Connect in Odoo​

  1. Navigate to Falabella Store Management > Configuration
  2. Create a new configuration and enter:
    • API Key (api_key) -- your Falabella Marketplace API key
    • Seller ID (seller_id) -- your Falabella seller identifier
    • Country (country) -- target market (CL, CO, PE, AR, BR)
  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: Falabella to Odoo, Odoo to Falabella, or bidirectional
  • Set sync interval: scheduled (every 5, 15, or 60 minutes)
  • Configure product field mapping and category mapping per country

Inventory Sync​

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

Order Sync​

  • Enable automatic order import
  • Map Falabella payment methods to Odoo payment journals
  • Configure shipping confirmation and tracking sync

Initial Sync​

  1. Go to Falabella 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 methodAPI Key + Seller ID (HMAC-SHA256 or header-based, per country)
CL endpointhttps://sellercenter-api.falabella.com
CO endpointhttps://sellercenter-api.falabella.com.co
PE endpointhttps://sellercenter-api.falabella.com.pe
Key config fieldsapi_key, seller_id, country

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 API key and seller ID; confirm you are using the correct country endpoint
Sync not runningCheck Odoo scheduled actions (cron jobs) are enabled
Products not publishedReview product data completeness and country-specific category requirements
Orders not importingVerify order status filters and date range settings
401 UnauthorizedRegenerate API key in the Falabella Seller Center
Wrong country endpointConfirm the country code matches your Seller Center account
Shipping not trackingVerify carrier code and tracking number format
License not activeVerify your ECOSIRE license key at Settings > ECOSIRE License

Support​

Last updated on