Skip to main content

Catch Store Management

Connect your Catch.com.au seller account to Odoo through the Catch Marketplace API. This module uses API Key authentication via the X-Api-Key header to synchronize products, import orders, and manage inventory on Australia's leading online marketplace. Built-in retry logic (3 retries with exponential backoff) ensures reliable operation, and the OWL 2 dashboard gives you real-time visibility into all sync activity.

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

Key Features​

  • Catch Marketplace API integration with API Key auth
  • Bidirectional product synchronization
  • Automatic order import and fulfillment tracking
  • Real-time inventory synchronization
  • Category mapping between Catch and Odoo
  • Shipping template management
  • Automatic retry with exponential backoff (3 retries)
  • Rate-limit-aware request handling (429 retry)
  • Seller performance monitoring
  • Returns and refund processing
  • Multi-warehouse support
  • Barcode and EAN management

Prerequisites​

  • Odoo 17, 18, or 19 (Community or Enterprise edition)
  • An active ECOSIRE license for this module
  • A Catch.com.au seller account with API access
  • Catch API Key from the Seller Portal

Installation​

  1. Download the module ZIP from your ECOSIRE Dashboard
  2. Extract to your Odoo addons directory: 
    unzip ecosire-catch-*.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 Catch API Credentials​

  1. Log in to your Catch Seller Portal
  2. Navigate to Settings > API Access
  3. Generate a new API Key
  4. Note your Seller ID from the account settings page

Step 2: Connect in Odoo​

  1. Navigate to Catch Store Management > Configuration
  2. Create a new configuration and enter:
    • API Key (api_key) -- your Catch marketplace API key
    • Seller ID (seller_id) -- your Catch seller identifier
  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: Catch-to-Odoo, Odoo-to-Catch, or bidirectional
  • Set sync interval: scheduled (every 5, 15, or 60 minutes)
  • Configure product field mapping and category mapping

Inventory Sync​

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

Order Sync​

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

Initial Sync​

  1. Go to Catch 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 via X-Api-Key header
Base URLhttps://api.catch.com.au/v1
Content-Typeapplication/json
Retry policy3 retries, 0.5s backoff, on 429/500/502/503/504
Key config fieldsapi_key, seller_id

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
429 Too Many RequestsModule auto-retries; reduce sync frequency if persistent
Invalid API KeyRegenerate the API key in Catch Seller Portal
Product rejectedVerify required fields (EAN, images, category) are populated
License not activeVerify your ECOSIRE license key at Settings > ECOSIRE License

Support​

Last updated on