Shopee Connector configuration

Estimated reading: 4 minutes 50 views

Introduction

Odoo 18 offers seamless integration with Shopee, one of Southeast Asia’s leading e-commerce platforms. By configuring the Shopee Connector, businesses can automate the synchronization of orders, products, and inventory directly from their Shopee Seller accounts to Odoo. This article provides a comprehensive guide to setting up and configuring the Shopee Connector in Odoo 18.

Step-by-Step Instructions

  1. Prerequisites

Before starting the configuration process, ensure you meet the following requirements:

Shopee Seller Account: You must be a registered seller on Shopee (either as an Individual or a Business).

Shopee Open Platform Account: Registration on the Shopee Open Platform is required to obtain API credentials.

Regional Compliance: Requirements differ by country. Check your region’s eligibility and ensure your seller tier or order volume qualifies for API access.

 

  1. Setting Up a Shopee Open Platform Account

To register an Open Platform account:

Go to the Shopee Open Platform.

Click “Get Access (Now)” on the homepage.

Follow the Open Shopee Developer Guide for detailed registration steps.

Once registration is complete, proceed to obtain your Partner ID and Partner Key from the App Management section under App List.

Important: Keep your Partner Key confidential. Treat it like a password.

 

  1. Installing the Shopee Connector in Odoo 18

Navigate to Apps in Odoo.

Search for and install the Shopee Connector module (sale_shopee).

 

  1. Connecting Shopee to Odoo

Once installed, link your Shopee account:

Go to Sales app → Configuration → Shopee → Accounts.

Click New to create a new connection.

In the Credentials tab:

Select the appropriate API Endpoint (Production or Testing, depending on your use case).

Input your Partner ID and Partner Key.

 

Click Save and Authorize.

 

API Endpoint Selection Guidelines:

Region, Endpoint Type, Description

Singapore/APAC, Shopee Production (Singapore), Most commonly used

China, Shopee Production (China), For mainland China sellers only

Brazil, Shopee Production (Brazil), For Brazil-specific stores

Testing, Testing Endpoints, For development only; not for live use

 

Note: Using the wrong endpoint may result in failed synchronizations.

  1. Authorization Process

After saving credentials:

Odoo redirects you to Shopee for authentication.

Log in to your Shopee Seller account (if not already).

Grant permission to Odoo by authorizing access.

Upon successful authorization, you’ll be redirected back to Odoo with confirmation that your shop has been registered.

  1. Post-Synchronization Settings in Odoo

After connecting your Shopee account:

Rename the Shopee Account (optional): Give your shop a descriptive name.

Set Last Order Sync Date: Define the date from which Odoo should begin fetching orders.

Configure Inventory Sync: Enable automatic inventory updates between Odoo and Shopee.

Assign Sales Team: Link a sales team for reporting and workflow management.

  1. Managing Shopee Orders in Odoo

Synced Shopee orders appear in Odoo Sales as individual order lines.

Each product line corresponds to a Shopee item, identified via its Internal Reference (SKU).

To customize default products:

Enable Developer Mode

Go to Sales → Configuration → Settings

Under Connectors → Shopee Sync, modify default products.

  1. Product Tax Configuration

Taxes on Shopee orders in Odoo are governed by:

The product’s tax settings

Fiscal positions (if applicable)

Note: Discrepancies in tax amounts between Shopee and Odoo may occur due to platform differences. These can be adjusted manually during payment reconciliation.

 

 

  1. Adding a New Shopee Marketplace

To add and sync multiple Shopee shops:

Navigate to Sales → Configuration → Shopee Accounts.

Click New and:

Select the proper API Endpoint

Enter the same Partner ID and Partner Key

Name the new marketplace shop

Assign a sales team

Click Log in with another account to authorize a new seller shop.

Important: Each shop can only be connected once. Multiple connections for the same shop may lead to token conflicts and order synchronization errors.

 

  1. Automatic Marketplace Synchronization

Once authorized:

All eligible marketplaces linked to the Shopee account appear under the Shops button.

If a new shop doesn’t appear, it may be:

Not yet approved for API access

Incompatible with the Open Platform

In such cases, contact Shopee Developer Support or refer to their documentation.

  1. Financial Reconciliation (Optional)

While Odoo imports orders and product lines, Shopee-specific fees or shipping adjustments are not automatically reconciled.

Use Shopee Financial Reports (weekly/monthly) to handle:

Fee breakdowns

Shipping subsidies

Commission deductions

Import these reports into Odoo Accounting for complete reconciliation.

Conclusion

By integrating Shopee with Odoo 18, sellers gain powerful synchronization capabilities that streamline operations across sales, inventory, and accounting. Ensuring proper configuration and compliance with regional Shopee requirements is crucial for successful setup.

Related Articles

Sale Shopee Connector - Previous Shopee Connector Next - Sale Shopee Connector Shopee order management

Leave a Reply

Your email address will not be published. Required fields are marked *

Learn how we helped 100 top brands gain success