Saltar al contenido principal
Shopee Marketplace Connector

Puesta en marcha de Shopee Marketplace Connector (APAC) en Odoo: campos, mapeos y primera semana

Para poner en marcha Shopee Marketplace Connector (APAC) creas en Odoo una cuenta de marketplace con su empresa, su almacén, el Partner ID / App Key, el Shop ID y la Partner Key de tu app de Shopee, eliges el entorno y fijas desde qué momento los pedidos se convierten en presupuestos. Después relacionas categorías y atributos de Odoo con los de Shopee y, la primera semana, revisas los registros de sincronización, los conflictos y la cola. Aquí tienes los pasos en orden y qué significa cada campo.

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
5 min

Qué tener preparado antes de abrir Odoo

La cuenta de marketplace del módulo pide datos que vienen de Shopee y datos que vienen de tu propia organización. Conviene tenerlos juntos antes de empezar:

  • El partner_id de tu app de Shopee y su partner key, que encuentras en Shopee Open Platform > App list.
  • El shop_id de la tienda que vas a conectar.
  • Si vas a probar primero, el partner ID y la clave de prueba de tu app y una tienda de prueba de Shopee.
  • La empresa de Odoo que va a ser dueña de la cuenta y el almacén desde el que vas a sincronizar inventario.
  • Las direcciones de correo que deben recibir los avisos.

El módulo se publica en Odoo Apps para 17, 18, 19 y 20 y, según la ficha de cada versión, es gratis en todas (pago único por versión, sin IVA). Lo tienes en la ficha de Odoo Apps y en la página del módulo.

Pasos para dar de alta la cuenta de Shopee

Cada paso corresponde a un campo de la cuenta de marketplace. Los nombres van tal como aparecen en el módulo.

  1. Escribe el Account Name, el nombre de la cuenta.
  2. Elige la Company. El módulo aísla las cuentas por empresa: cada empresa es dueña de sus configuraciones de marketplace.
  3. Indica el Default Fulfillment Warehouse. Es el almacén por defecto para la sincronización de inventario y se puede cambiar producto a producto.
  4. Selecciona el Shopee Environment. Con Sandbox se usan el partner ID y la clave de prueba de tu app y las tiendas de prueba de Shopee.
  5. Rellena Partner ID / App Key con el partner_id de Shopee y Shop ID con el shop_id de tu tienda.
  6. Pega en Partner Key la partner key de tu app. Según la descripción del campo, es la que firma cada llamada.
  7. Usa el enlace Connect Shopee shop. El módulo guarda en Authorization State un valor aleatorio del último enlace generado y lo comprueba cuando Shopee devuelve al vendedor. La cuenta tiene además los campos OAuth Access Token, OAuth Refresh Token y Access Token Expires.
  8. Fija Create Sales Orders From. Los pedidos hechos en Shopee antes de ese momento quedan retenidos (Held Orders) en lugar de convertirse en presupuestos.
  9. Ajusta Sync Frequency (minutes), el intervalo de consulta para pedidos e inventario, entre 5 y 60 minutos.
  10. Pon un Low Stock Threshold (units): por debajo de ese nivel el módulo lanza un aviso de stock bajo. Si además marcas Auto-Create PO on Low Stock, crea un borrador de pedido de compra cuando el stock cae por debajo del umbral.
  11. Escribe en Alert Email Recipients las direcciones separadas por comas que recibirán las alertas de sincronización, el resumen y las notificaciones de error.
  12. Elige la estrategia de Auto-Conflict Resolution para los conflictos detectados y el Conflict Detection Threshold (%), el porcentaje de diferencia a partir del cual se detecta un conflicto.
  13. Con todo lo anterior revisado, marca Enable Sync, que activa o desactiva todas las sincronizaciones de la cuenta.

El campo API Key aparece en la cuenta, pero su propia descripción indica que Shopee no lo usa.

Relacionar categorías, atributos y productos

La cuenta tiene tres relaciones entre Odoo y Shopee: Category Mappings, Attribute Mappings y Product Mappings.

Categorías

En Category Mappings relacionas una categoría de Odoo con una de Shopee. Cada línea lleva Marketplace Account, Odoo Category, Marketplace Category ID (el category_id de Shopee) y Marketplace Category Name, un nombre legible que el módulo guarda para mostrarlo en pantalla. La columna Created registra cuándo se creó la línea.

Lista de mapeos de categorías con columnas Marketplace Account, Odoo Category, Marketplace Category ID, Marketplace Category Name y Created
La lista de mapeos de categorías, aún sin registros, con el botón Nuevo y la barra de búsqueda.

Atributos

En Attribute Mappings relacionas un atributo de Odoo (Odoo Attribute, por ejemplo color, talla o marca) con la clave de atributo del marketplace en Marketplace Attribute Key. Cada línea también lleva su Marketplace Account y su fecha Created.

Productos

En Product Mappings quedan las relaciones entre cada producto de Odoo y su ID de producto en el marketplace. En la secuencia siguiente se ve un registro de ejemplo de la cuenta Shopee SG con estado Synced.

Lista de mapeos de producto con un registro de Shopee SG en estado Synced, lista de cuentas de marketplace y lista vacía de mapeos de atributos
Recorrido por el mapeo de producto de ejemplo, la lista de cuentas con datos de prueba y la lista de mapeos de atributos, aún sin registros.

Si quieres ver cómo encajan estas piezas por dentro, lo explicamos en cómo funciona el conector por dentro.

Qué revisar la primera semana

Con la sincronización activada, estos son los puntos de la cuenta que merece la pena mirar a diario al principio:

  • Sync Logs: el registro de auditoría de las interacciones con la API.
  • Sync Conflicts: los conflictos detectados que esperan resolución. Revisa los conflictos pendientes y ajusta la estrategia de Auto-Conflict Resolution o el Conflict Detection Threshold (%) si lo necesitas.
  • Sync Queue: la cola interna de tareas de sincronización asíncronas.
  • Pedidos retenidos: si ves pedidos en Held Orders, comprueba que la fecha de Create Sales Orders From es la que querías.
  • Token: revisa la fecha de Access Token Expires en la cuenta.
  • Stock bajo: si activaste Auto-Create PO on Low Stock, busca los borradores de pedido de compra y confirma que el Low Stock Threshold (units) tiene sentido para tus productos.
  • Correo: confirma que las direcciones de Alert Email Recipients están bien escritas y separadas por comas.

El módulo trae también listas de resumen y de informe de rendimiento. En las capturas aparecen todavía sin datos:

Lista de resumen del panel de marketplace con columnas Company, Total Reve…, Total Or…, Critical… y Major E…
La lista de resumen del panel, sin datos todavía.
Lista de informes de rendimiento con columnas Company, Marketplace, Product Category, Date From y Date To
La lista de informes de rendimiento, aún sin registros.

Si en esos días aparece un mensaje que no entiendes, tienes los textos literales y su arreglo en los mensajes de error del conector.

Cómo te ayuda FlexigoTech

En FlexigoTech implantamos Odoo 17, 18, 19 y 20 y desarrollamos conectores e integraciones a medida. Si quieres que revisemos la configuración de la cuenta de Shopee, los mapeos o una integración que el módulo no cubre, puedes escribirnos 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.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