Saltar al contenido principal
Shopee Marketplace Connector

Cómo funciona Shopee Marketplace Connector (APAC) en Odoo por dentro

En Odoo 19 y 20, Shopee Marketplace Connector (APAC) añade a Odoo cinco apartados: cuentas, productos, pedidos, analítica y ajustes. Por debajo corren cinco tareas programadas, todas activas: productos e inventario cada 5 minutos, pedidos cada 30 minutos, una revisión cada hora y un resumen semanal los lunes a las 09:00. Aquí tienes dónde está cada pieza y un recorrido por los menús para que sepas qué mirar.

FlexigoTech · Responsable: Víctor Gómez · Actualizado el 4 de noviembre de 2026

Lo esencial

Versiones
Odoo 17, 18, 19 y 20
Comprobado
en el código del módulo, versión 20.0 · en las fuentes enlazadas al final
Lectura
4 min

Dónde vive el conector dentro de Ventas

La ficha de Odoo Apps presenta el módulo con el titular Sell on Shopee from Odoo. En Odoo 19 y 20, todo lo que añade cuelga de Sales › E-Commerce Marketplaces, y los menús quedan agrupados así:

  • Sales › E-Commerce Marketplaces › Accounts.
  • Sales › E-Commerce Marketplaces › Products, con tres submenús: Product Mappings, Category Mappings y Attribute Mappings.
  • Sales › E-Commerce Marketplaces › Orders, con cuatro submenús: Sync Queue, Sync Logs, Sync Conflicts y Held Orders.
  • Sales › E-Commerce Marketplaces › Analytics, con Dashboard y Performance Report.
  • Sales › E-Commerce Marketplaces › Settings.
Lista de cuentas de marketplace con cinco registros y columnas de marketplace, empresa, almacén y tokens OAuth de prueba
La lista del modelo marketplace.config con cinco cuentas de prueba, con datos de demostración

Las tareas programadas y cada cuánto se ejecutan

El módulo trae cinco tareas programadas y las cinco figuran como activas. Esta es la lista con su nombre literal y su frecuencia:

TareaFrecuencia
Marketplace: Sync Products (every 5 min)cada 5 minutos
Marketplace: Sync Inventory (every 5 min)cada 5 minutos
Marketplace: Sync Orders (every 30 min)cada 30 minutos
Marketplace: Check Stale Orders (every 1 hour)cada hora
Marketplace: Weekly Reconciliation Digest (Mon 09:00)cada semana (lunes 09:00, según su nombre)

Cómo leer la tabla: el nombre de cada tarea indica a qué parte del conector se refiere (productos, inventario, pedidos, pedidos sin movimiento y un resumen de conciliación semanal). Las de productos e inventario son las que corren con más frecuencia; la de pedidos, cada 30 minutos; la de pedidos sin movimiento, cada hora. La semanal lleva el día y la hora en el propio nombre.

Recorrido por los menús, paso a paso

Este es un orden de lectura para conocer el módulo por dentro en Odoo 19 y 20, siguiendo los menús tal como aparecen. No es una secuencia que el módulo imponga: es una forma cómoda de ver qué guarda cada pantalla.

  1. Abre Sales › E-Commerce Marketplaces › Accounts. Las cuentas de marketplace se guardan en el modelo marketplace.config, que el código describe como Marketplace Account Configuration. En la lista de demostración se ven columnas de marketplace, empresa, almacén y tokens OAuth.
  2. Entra en Products › Product Mappings. Aquí está el modelo marketplace.product_mapping, descrito como Product ↔ Marketplace Product ID Mapping. En la captura de demostración la fila une una cuenta, una variante de Odoo, un ID de producto, un SKU y un estado.
  3. Pasa a Products › Category Mappings. El modelo es marketplace.category_mapping, descrito como Odoo Category → Marketplace Category Mapping.
  4. Sigue con Products › Attribute Mappings. El modelo es marketplace.attribute_mapping, descrito como Odoo Attribute → Marketplace Attribute Mapping. Su lista muestra las columnas Marketplace Account, Odoo Attribute, Marketplace Attribute Key y Created.
  5. Abre Orders › Sync Queue. Detrás está marketplace.sync_queue, descrito como Marketplace Sync Task Queue.
  6. Revisa Orders › Sync Logs. El modelo es marketplace.sync_log, descrito como Marketplace Sync Audit Trail.
  7. Mira Orders › Sync Conflicts. El modelo es marketplace.sync_conflict, descrito como Marketplace Sync Conflict.
  8. Entra en Orders › Held Orders. El modelo es marketplace.order.hold, descrito como Held marketplace order.
  9. Pasa a Analytics: Dashboard y Performance Report. En el código están los modelos marketplace.dashboard.overview (Marketplace Dashboard Overview), marketplace.performance.report (Marketplace Performance Report) y marketplace.performance.report.line (Marketplace Performance Report Line).
  10. Por último, abre Settings, el último apartado del menú.
Recorrido por la lista de mapeos de producto, la lista de cuentas, de nuevo los mapeos de producto y la lista vacía de mapeos de atributos
Secuencia de pantallas del módulo con datos de demostración; la última lista, la de mapeos de atributos, aún sin registros

Qué te dicen los nombres de cada pantalla

Al hacer el recorrido verás que el módulo separa tres bloques. El de Products reúne los mapeos: producto, categoría y atributo, cada uno en su modelo. El de Orders reúne la cola (Sync Queue), el registro de auditoría (Sync Logs), los conflictos (Sync Conflicts) y los pedidos retenidos (Held Orders). El de Analytics reúne el panel y el informe de rendimiento con sus líneas.

En la captura de demostración del mapeo de producto la fila aparece con el estado Synced. Si quieres ver qué estados recorre cada registro y qué campos hay que rellenar al arrancar, lo tienes en la puesta en marcha del conector. Y si en alguna de estas pantallas te aparece un aviso, la guía de mensajes de error recoge los textos literales y qué hacer con cada uno.

Lista de mapeos de producto con la cuenta Shopee SG, una variante, un ID de producto de ejemplo, un SKU y estado Synced, con botón Nuevo y buscador
El mapeo de producto en estado Synced, con datos de demostración

Versiones de Odoo y precio

El módulo está publicado en Odoo Apps para Odoo 17, 18, 19 y 20. En las cuatro fichas figura como gratis. Puedes verlo en la ficha de Odoo Apps o en la página del módulo en flexigotech.com.

Cómo te ayuda FlexigoTech

En FlexigoTech implantamos Odoo 17, 18, 19 y 20 y desarrollamos conectores e integraciones a medida. Si el conector te encaja pero necesitas adaptarlo a tu forma de trabajar, o quieres que alguien revise contigo las cuentas, los mapeos y las tareas programadas antes de empezar a vender en Shopee, cuéntanos tu caso desde la página del módulo.

Sigue leyendo

Errores de Shopee Marketplace Connector (APAC): cuándo sale cada mensaje y qué hacerQué significa cada mensaje de error de Shopee Marketplace Connector (APAC) en Odoo, cuándo sale y qué hacer, con un caso inventado y los textos literales.Puesta en marcha de Shopee Marketplace Connector (APAC) en Odoo: campos, mapeos y primera semanaGuía para poner en marcha Shopee Marketplace Connector (APAC) en Odoo: campos de la cuenta, mapeos de categorías y atributos y qué revisar la primera semana.Cómo funciona Leroy Merlin Connector en Odoo: menús, tareas programadas y recorridoQué menús añade Leroy Merlin Connector en Odoo, qué diez tareas programadas corren y cada cuánto, y qué pasa por FlexigoTech Cloud.
Comprobado en el código del módulo (versión 20.0) y en las fuentes enlazadas

Fuentes

  • Código del módulo: flexigo_apac_e_commerce_marketplaces_bundle 20.0 (2cbf6b48): views/menus.xml
  • Código del módulo: flexigo_apac_e_commerce_marketplaces_bundle 20.0 (2cbf6b48): data/cron_jobs.xml
  • Código del módulo: flexigo_apac_e_commerce_marketplaces_bundle 20.0 (2cbf6b48): static/description/index.html
  • Código del módulo: flexigo_apac_e_commerce_marketplaces_bundle 20.0 (2cbf6b48): models/marketplace_attribute_mapping.py
  • Código del módulo: flexigo_apac_e_commerce_marketplaces_bundle 20.0 (2cbf6b48): models/marketplace_category_mapping.py
  • Código del módulo: flexigo_apac_e_commerce_marketplaces_bundle 20.0 (2cbf6b48): models/marketplace_config.py
  • Código del módulo: flexigo_apac_e_commerce_marketplaces_bundle 20.0 (2cbf6b48): models/marketplace_dashboard.py
  • Código del módulo: flexigo_apac_e_commerce_marketplaces_bundle 20.0 (2cbf6b48): models/marketplace_order_hold.py
  • Código del módulo: flexigo_apac_e_commerce_marketplaces_bundle 20.0 (2cbf6b48): models/marketplace_product_mapping.py
  • Código del módulo: flexigo_apac_e_commerce_marketplaces_bundle 20.0 (2cbf6b48): models/marketplace_sync_conflict.py
  • Código del módulo: flexigo_apac_e_commerce_marketplaces_bundle 20.0 (2cbf6b48): models/marketplace_sync_log.py
  • Código del módulo: 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