Skip to main content
Shopee Marketplace Connector

How Shopee Marketplace Connector (APAC) works inside Odoo

In Odoo 19 and 20, Shopee Marketplace Connector (APAC) adds five sections to Odoo: accounts, products, orders, analytics and settings. Underneath, five scheduled tasks run, all active: products and inventory every 5 minutes, orders every 30 minutes, a check every hour and a weekly digest on Mondays at 09:00. Here is where each piece sits and a walk through the menus so you know what to look at.

FlexigoTech · Editor in charge: Víctor Gómez · Updated 4 November 2026

Key facts

Versions
Odoo 17, 18, 19 and 20
Checked
in the module's source code, version 20.0 · against the sources linked at the end
Reading time
4 min

Where the connector lives inside Sales

The Odoo Apps listing introduces the module with the heading Sell on Shopee from Odoo. In Odoo 19 and 20, everything it adds hangs off Sales › E-Commerce Marketplaces, and the menus are grouped like this:

  • Sales › E-Commerce Marketplaces › Accounts.
  • Sales › E-Commerce Marketplaces › Products, with three submenus: Product Mappings, Category Mappings and Attribute Mappings.
  • Sales › E-Commerce Marketplaces › Orders, with four submenus: Sync Queue, Sync Logs, Sync Conflicts and Held Orders.
  • Sales › E-Commerce Marketplaces › Analytics, with Dashboard and Performance Report.
  • Sales › E-Commerce Marketplaces › Settings.
List of marketplace accounts with five records and columns for marketplace, company, warehouse and test OAuth tokens
The marketplace.config list with five test accounts, using demo data

The scheduled tasks and how often they run

The module ships with five scheduled tasks and all five are listed as active. Here they are with their literal names and frequency:

TaskFrequency
Marketplace: Sync Products (every 5 min)every 5 minutes
Marketplace: Sync Inventory (every 5 min)every 5 minutes
Marketplace: Sync Orders (every 30 min)every 30 minutes
Marketplace: Check Stale Orders (every 1 hour)every hour
Marketplace: Weekly Reconciliation Digest (Mon 09:00)every week (Monday 09:00, according to its name)

How to read the table: each task's name tells you which part of the connector it relates to (products, inventory, orders, stale orders and a weekly reconciliation digest). The product and inventory tasks run most often; the orders task runs every 30 minutes; the stale orders check, every hour. The weekly one carries its day and time in its own name.

A walk through the menus, step by step

This is a reading order for getting to know the module from the inside in Odoo 19 and 20, following the menus as they appear. It is not a sequence the module enforces: it is simply a handy way to see what each screen holds.

  1. Open Sales › E-Commerce Marketplaces › Accounts. Marketplace accounts are stored in the marketplace.config model, which the code describes as Marketplace Account Configuration. The demo list shows columns for marketplace, company, warehouse and OAuth tokens.
  2. Go to Products › Product Mappings. This is the marketplace.product_mapping model, described as Product ↔ Marketplace Product ID Mapping. In the demo screenshot the row links an account, an Odoo variant, a product ID, a SKU and a status.
  3. Move on to Products › Category Mappings. The model is marketplace.category_mapping, described as Odoo Category → Marketplace Category Mapping.
  4. Carry on with Products › Attribute Mappings. The model is marketplace.attribute_mapping, described as Odoo Attribute → Marketplace Attribute Mapping. Its list shows the columns Marketplace Account, Odoo Attribute, Marketplace Attribute Key and Created.
  5. Open Orders › Sync Queue. Behind it sits marketplace.sync_queue, described as Marketplace Sync Task Queue.
  6. Check Orders › Sync Logs. The model is marketplace.sync_log, described as Marketplace Sync Audit Trail.
  7. Look at Orders › Sync Conflicts. The model is marketplace.sync_conflict, described as Marketplace Sync Conflict.
  8. Go into Orders › Held Orders. The model is marketplace.order.hold, described as Held marketplace order.
  9. Move to Analytics: Dashboard and Performance Report. The code contains the models marketplace.dashboard.overview (Marketplace Dashboard Overview), marketplace.performance.report (Marketplace Performance Report) and marketplace.performance.report.line (Marketplace Performance Report Line).
  10. Finally, open Settings, the last section of the menu.
Walk through the product mapping list, the accounts list, the product mappings again and the empty attribute mapping list
Sequence of module screens with demo data; the last one, the attribute mapping list, has no records yet

What the screen names tell you

As you go through the menus you will see the module splits into three blocks. Products brings together the mappings: product, category and attribute, each in its own model. Orders brings together the queue (Sync Queue), the audit trail (Sync Logs), conflicts (Sync Conflicts) and held orders (Held Orders). Analytics brings together the dashboard and the performance report with its lines.

In the demo screenshot of the product mapping, the row shows the status Synced. If you want to see which statuses each record goes through and which fields to fill in when you start, it is covered in the connector set-up guide. And if one of these screens shows you a warning, the error messages guide lists the literal texts and what to do about each one.

Product mapping list with the Shopee SG account, a variant, a sample product ID, a SKU and status Synced, with a New button and search box
The product mapping in Synced status, using demo data

Odoo versions and price

The module is published on Odoo Apps for Odoo 17, 18, 19 and 20. All four listings show it as free. You can see it on the Odoo Apps listing or on the module page at flexigotech.com.

How FlexigoTech can help

At FlexigoTech we implement Odoo 17, 18, 19 and 20 and build bespoke connectors and integrations. If the connector fits but you need it adapted to the way you work, or you would like someone to go through the accounts, mappings and scheduled tasks with you before you start selling on Shopee, tell us about your case via the module page.

Keep reading

Shopee Marketplace Connector (APAC) errors: when each message appears and what to doWhat each Shopee Marketplace Connector (APAC) error message in Odoo means, when it appears and what to do, with a made-up case and the literal texts.Setting up Shopee Marketplace Connector (APAC) in Odoo: fields, mappings and the first weekHow to set up Shopee Marketplace Connector (APAC) in Odoo: account fields, category and attribute mappings, and what to check during the first week.How Leroy Merlin Connector works in Odoo: menus, scheduled actions and a walkthroughThe menus Leroy Merlin Connector adds to Odoo, the ten scheduled actions it runs and how often, and what goes through FlexigoTech Cloud.
Checked in the module's source code (version 20.0) and the linked sources

Sources

  • Module source code: flexigo_apac_e_commerce_marketplaces_bundle 20.0 (2cbf6b48): views/menus.xml
  • Module source code: flexigo_apac_e_commerce_marketplaces_bundle 20.0 (2cbf6b48): data/cron_jobs.xml
  • Module source code: flexigo_apac_e_commerce_marketplaces_bundle 20.0 (2cbf6b48): static/description/index.html
  • Module source code: flexigo_apac_e_commerce_marketplaces_bundle 20.0 (2cbf6b48): models/marketplace_attribute_mapping.py
  • Module source code: flexigo_apac_e_commerce_marketplaces_bundle 20.0 (2cbf6b48): models/marketplace_category_mapping.py
  • Module source code: flexigo_apac_e_commerce_marketplaces_bundle 20.0 (2cbf6b48): models/marketplace_config.py
  • Module source code: flexigo_apac_e_commerce_marketplaces_bundle 20.0 (2cbf6b48): models/marketplace_dashboard.py
  • Module source code: flexigo_apac_e_commerce_marketplaces_bundle 20.0 (2cbf6b48): models/marketplace_order_hold.py
  • Module source code: flexigo_apac_e_commerce_marketplaces_bundle 20.0 (2cbf6b48): models/marketplace_product_mapping.py
  • Module source code: flexigo_apac_e_commerce_marketplaces_bundle 20.0 (2cbf6b48): models/marketplace_sync_conflict.py
  • Module source code: flexigo_apac_e_commerce_marketplaces_bundle 20.0 (2cbf6b48): models/marketplace_sync_log.py
  • Module source code: flexigo_apac_e_commerce_marketplaces_bundle 20.0 (2cbf6b48): models/marketplace_sync_queue.py
  • apps.odoo.com/apps/modules/20.0/flexigo_apac_e_commerce_marketplaces_bundle
  • apps.odoo.com/apps/modules/17.0/flexigo_apac_e_commerce_marketplaces_bundle
  • apps.odoo.com/apps/modules/18.0/flexigo_apac_e_commerce_marketplaces_bundle
  • apps.odoo.com/apps/modules/19.0/flexigo_apac_e_commerce_marketplaces_bundle
  • flexigotech.com/en/services.html