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 published as an XML or CSV feed that Fruugo collects from your own Odoo instance, while orders are imported through the Retailer API. Synchronize your catalog, process multi-currency orders, and manage fulfillment across Fruugo's 46+ country marketplace from Odoo.

Technical namefruugo_store_management
Odoo versions17.0, 18.0, 19.0 (Community or Enterprise)
Current shipped version17.0 → 17.0.2.6.0, 18.0 → 18.0.2.6.0, 19.0 → 19.0.2.6.0
Price$499 USD — one-time, per Odoo version
CategoryConnector

Key Features​

  • Fruugo Retailer API with HTTP Basic Auth
  • Product catalogue published as a feed Fruugo collects from your Odoo instance
  • Automatic order import and fulfillment tracking
  • Automatic inventory synchronization on a schedule
  • Multi-currency price blocks (Fruugo carries the currency per SKU)
  • Shipping carrier mapping
  • Returns and refund management
  • Automatic retry with exponential backoff
  • Performance reporting
  • Tax and VAT handling per country

Prerequisites​

  • Odoo 17, 18, or 19 (Community or Enterprise edition)
  • 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

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: Publish your catalogue and configure sync​

Product feed​

Turn on Publish Product Feed to have Fruugo collect your catalogue from /fruugo/feed/products.xml (or /fruugo/feed/products.csv). The feed stays a 404 until you switch it on. Set an optional Feed Token if you want the URL to require ?token=…, and watch Feed Last Fetched to confirm Fruugo is reading it. Full setup detail is on the Fruugo Store Management guide.

Inventory Sync​

  • Map Odoo warehouses to Fruugo stock
  • Set buffer stock quantities if needed
  • Inventory is pushed on the module's scheduled action

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 or CSV feed served by your Odoo instance for Fruugo to collect
Order/fulfillmentRetailer API
Retry policy3 retries, 0.5s backoff, on 429/500/502/503/504
Key config fieldsmerchant_id, api_password

Dashboard​

The built-in OWL 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
A product never appears on FruugoCheck the product data the feed requires (SKU, sales price, category mapping, image, VAT rate) -- the feed names any product it left out, with the reason
The feed URL answers 404Publish Product Feed is off, or the feed token in the URL does not match
Currency mismatchFruugo converts currencies automatically; verify base currency in Odoo

Support​

Last updated on