Skip to main content

Fruugo Store Management

Connect your Fruugo retailer account to Odoo through the Fruugo Retailer API. This module uses HTTP Basic Authentication (merchant_id:api_password) to communicate with www.fruugo.com/retailer/api. Product data is managed via XML feeds while orders are handled through the REST API. Synchronize your catalog, process multi-currency orders, and manage fulfillment across Fruugo's 46+ country marketplace from Odoo.

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

Key Features​

  • Fruugo Retailer API with HTTP Basic Auth
  • Product sync via XML feed submission
  • Automatic order import and fulfillment tracking
  • Real-time inventory synchronization
  • Multi-currency automatic conversion (Fruugo handles currency)
  • Multi-language listing support (46+ countries)
  • Shipping carrier mapping
  • Returns and refund management
  • Automatic retry with exponential backoff
  • Performance reporting
  • EAN/GTIN barcode management
  • Tax and VAT handling per country

Prerequisites​

  • Odoo 17, 18, or 19 (Community or Enterprise edition)
  • An active ECOSIRE license for this module
  • A Fruugo retailer account (retailer.fruugo.com)
  • Fruugo Merchant ID and API Password

Installation​

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

Configuration​

Step 1: Obtain Fruugo API Credentials​

  1. Log in to your Fruugo Retailer Portal
  2. Navigate to Account Settings > API Access
  3. Note your Merchant ID and API Password
  4. These credentials are used directly as HTTP Basic Auth (no OAuth required)

Step 2: Connect in Odoo​

  1. Navigate to Fruugo Store Management > Configuration
  2. Create a new configuration and enter:
    • Merchant ID (merchant_id) -- your Fruugo merchant identifier (used as HTTP username)
    • API Password (api_password) -- your Fruugo API password (used as HTTP password)
  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: Fruugo-to-Odoo, Odoo-to-Fruugo, or bidirectional
  • Set sync interval: scheduled (every 5, 15, or 60 minutes)
  • Products are submitted as XML feeds to Fruugo

Inventory Sync​

  • Map Odoo warehouses to Fruugo stock
  • Set buffer stock quantities if needed
  • Enable real-time stock updates on changes

Order Sync​

  • Enable automatic order import
  • Map Fruugo payment methods to Odoo payment journals
  • Configure fulfillment sync to push tracking numbers

Initial Sync​

  1. Go to Fruugo 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_password)
Base URLhttps://www.fruugo.com/retailer/api
Product feedXML format submission
Order/fulfillmentREST API (JSON)
Retry policy3 retries, 0.5s backoff, on 429/500/502/503/504
Key config fieldsmerchant_id, api_password

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 credentials; check network connectivity
Sync not runningCheck Odoo scheduled actions (cron jobs) are enabled
Duplicate productsReview product mapping; ensure SKU matching is configured
Orders not importingVerify order status filters and date range settings
401 UnauthorizedVerify Merchant ID and API Password in Fruugo Retailer Portal
XML feed rejectedCheck product data completeness (EAN, title, description, images)
Currency mismatchFruugo converts currencies automatically; verify base currency in Odoo
License not activeVerify your ECOSIRE license key at Settings > ECOSIRE License

Support​

Last updated on