Flipkart Store Management

Connect your Flipkart seller account to Odoo through the Flipkart Seller API. This module uses OAuth 2.0 with Basic Auth token exchange (Base64-encoded app_id:app_secret) to authenticate against api.flipkart.net. Synchronize products, import orders, manage inventory, and track fulfillment on India's largest e-commerce platform from within your Odoo ERP.

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

Key Features

• Flipkart Seller API integration with OAuth 2.0
• Bidirectional product synchronization
• Automatic order import with Flipkart Assured support
• Real-time inventory synchronization
• Category and vertical mapping
• Product listing quality scoring
• Flipkart Fulfilled (FF) and Non-Fulfilled (NF) support
• Sandbox environment for testing
• Returns and reverse logistics management
• Pricing and discount management
• Brand approval tracking
• Performance dashboard with seller metrics

Prerequisites

• Odoo 17, 18, or 19 (Community or Enterprise edition)
• An active ECOSIRE license for this module
• A Flipkart seller account (seller.flipkart.com)
• Flipkart Seller API credentials (App ID + App Secret)

Installation

1. Download the module ZIP from your ECOSIRE Dashboard
2. Extract to your Odoo addons directory:

   unzip ecosire-flipkart-*.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 Flipkart API Credentials

1. Log in to Flipkart Seller Hub
2. Navigate to API Integration settings
3. Request API access and note your App ID and App Secret
4. Complete the OAuth flow to obtain an Access Token and Refresh Token
5. Tokens auto-refresh via the module (24-hour expiry by default)

Step 2: Connect in Odoo

1. Navigate to Flipkart Store Management > Configuration
2. Create a new configuration and enter:
   • App ID (app_id) -- Flipkart application ID
   • App Secret (app_secret) -- Flipkart application secret
   • Access Token (access_token) -- OAuth access token
   • Refresh Token (refresh_token) -- for automatic renewal
   • Sandbox Mode -- toggle for testing against sandbox-api.flipkart.net
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: Flipkart-to-Odoo, Odoo-to-Flipkart, 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 Flipkart fulfillment locations
• Set buffer stock quantities if needed
• Enable real-time stock updates on changes

Order Sync

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

Initial Sync

1. Go to Flipkart 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

Field	Value
Auth method	OAuth 2.0 (Basic Auth token exchange)
Production API	https://api.flipkart.net/sellers
Sandbox API	https://sandbox-api.flipkart.net/sellers
Token URL	https://api.flipkart.net/oauth-service/oauth/token
Token grant	grant_type=refresh_token with scope=Seller_Api
Key config fields	app_id, app_secret, access_token, refresh_token

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

Issue	Solution
Connection failed	Verify API credentials; check network connectivity
Sync not running	Check Odoo scheduled actions (cron jobs) are enabled
Duplicate products	Review product mapping; ensure SKU matching is configured
Orders not importing	Verify order status filters and date range settings
Token expired	Module auto-refreshes; check if refresh_token is still valid
Listing quality low	Review Flipkart's required attributes per category vertical
Sandbox vs production	Verify Sandbox Mode toggle matches your API credentials
Brand approval pending	Brand must be approved by Flipkart before listings go live
License not active	Verify your ECOSIRE license key at Settings > ECOSIRE License

Support

• General Troubleshooting
• Email: [email protected]
• Support Portal