Saltar para o conteúdo principal
Shopee Marketplace Connector

Como funciona o Shopee Marketplace Connector (APAC) por dentro do Odoo

No Odoo 19 e 20, o Shopee Marketplace Connector (APAC) acrescenta ao Odoo cinco secções: contas, artigos, encomendas, análise e definições. Por baixo correm cinco tarefas agendadas, todas ativas: artigos e inventário a cada 5 minutos, encomendas a cada 30 minutos, uma verificação a cada hora e um resumo semanal às segundas-feiras às 09:00. Aqui fica onde está cada peça e um percurso pelos menus para saber o que observar.

FlexigoTech · Responsável: Víctor Gómez · Atualizado em 4 de novembro de 2026

O essencial

Versões
Odoo 17, 18, 19 e 20
Verificado
no código do módulo, versão 20.0 · nas fontes indicadas no fim
Leitura
4 min

Onde fica o conector dentro de Vendas

A página na Odoo Apps apresenta o módulo com o título Sell on Shopee from Odoo. No Odoo 19 e 20, tudo o que acrescenta está em Sales › E-Commerce Marketplaces e os menus ficam agrupados assim:

  • Sales › E-Commerce Marketplaces › Accounts.
  • Sales › E-Commerce Marketplaces › Products, com três submenus: Product Mappings, Category Mappings e Attribute Mappings.
  • Sales › E-Commerce Marketplaces › Orders, com quatro submenus: Sync Queue, Sync Logs, Sync Conflicts e Held Orders.
  • Sales › E-Commerce Marketplaces › Analytics, com Dashboard e Performance Report.
  • Sales › E-Commerce Marketplaces › Settings.
Lista de contas de marketplace com cinco registos e colunas de marketplace, empresa, armazém e tokens OAuth de teste
A lista do modelo marketplace.config com cinco contas de teste, com dados de demonstração

As tarefas agendadas e a frequência com que correm

O módulo traz cinco tarefas agendadas e as cinco aparecem como ativas. Esta é a lista com o nome literal e a frequência:

TarefaFrequência
Marketplace: Sync Products (every 5 min)a cada 5 minutos
Marketplace: Sync Inventory (every 5 min)a cada 5 minutos
Marketplace: Sync Orders (every 30 min)a cada 30 minutos
Marketplace: Check Stale Orders (every 1 hour)a cada hora
Marketplace: Weekly Reconciliation Digest (Mon 09:00)a cada semana (segunda-feira 09:00, segundo o nome)

Como ler a tabela: o nome de cada tarefa indica a que parte do conector se refere (artigos, inventário, encomendas, encomendas paradas e um resumo de reconciliação semanal). As de artigos e inventário são as que correm com mais frequência; a de encomendas, a cada 30 minutos; a de encomendas paradas, a cada hora. A semanal tem o dia e a hora no próprio nome.

Percurso pelos menus, passo a passo

Esta é uma ordem de leitura para conhecer o módulo por dentro no Odoo 19 e 20, seguindo os menus tal como aparecem. Não é uma sequência imposta pelo módulo: é apenas uma forma prática de ver o que guarda cada ecrã.

  1. Abra Sales › E-Commerce Marketplaces › Accounts. As contas de marketplace são guardadas no modelo marketplace.config, que o código descreve como Marketplace Account Configuration. Na lista de demonstração veem-se colunas de marketplace, empresa, armazém e tokens OAuth.
  2. Entre em Products › Product Mappings. Aqui está o modelo marketplace.product_mapping, descrito como Product ↔ Marketplace Product ID Mapping. Na captura de demonstração, a linha associa uma conta, uma variante do Odoo, um ID de artigo, um SKU e um estado.
  3. Passe para Products › Category Mappings. O modelo é marketplace.category_mapping, descrito como Odoo Category → Marketplace Category Mapping.
  4. Continue com Products › Attribute Mappings. O modelo é marketplace.attribute_mapping, descrito como Odoo Attribute → Marketplace Attribute Mapping. A lista mostra as colunas Marketplace Account, Odoo Attribute, Marketplace Attribute Key e Created.
  5. Abra Orders › Sync Queue. Por trás está marketplace.sync_queue, descrito como Marketplace Sync Task Queue.
  6. Reveja Orders › Sync Logs. O modelo é marketplace.sync_log, descrito como Marketplace Sync Audit Trail.
  7. Veja Orders › Sync Conflicts. O modelo é marketplace.sync_conflict, descrito como Marketplace Sync Conflict.
  8. Entre em Orders › Held Orders. O modelo é marketplace.order.hold, descrito como Held marketplace order.
  9. Passe para Analytics: Dashboard e Performance Report. No código estão os modelos marketplace.dashboard.overview (Marketplace Dashboard Overview), marketplace.performance.report (Marketplace Performance Report) e marketplace.performance.report.line (Marketplace Performance Report Line).
  10. Por fim, abra Settings, a última secção do menu.
Percurso pela lista de mapeamentos de artigo, a lista de contas, novamente os mapeamentos de artigo e a lista vazia de mapeamentos de atributos
Sequência de ecrãs do módulo com dados de demonstração; a última lista, a de mapeamentos de atributos, ainda sem registos

O que dizem os nomes de cada ecrã

Ao fazer o percurso, verá que o módulo se divide em três blocos. O de Products reúne os mapeamentos: artigo, categoria e atributo, cada um no seu modelo. O de Orders reúne a fila (Sync Queue), o registo de auditoria (Sync Logs), os conflitos (Sync Conflicts) e as encomendas retidas (Held Orders). O de Analytics reúne o painel e o relatório de desempenho com as suas linhas.

Na captura de demonstração do mapeamento de artigo, a linha aparece com o estado Synced. Se quiser ver por que estados passa cada registo e que campos preencher no arranque, tem tudo na configuração inicial do conector. E se num destes ecrãs lhe aparecer um aviso, o guia de mensagens de erro reúne os textos literais e o que fazer em cada caso.

Lista de mapeamentos de artigo com a conta Shopee SG, uma variante, um ID de artigo de exemplo, um SKU e estado Synced, com botão Novo e caixa de pesquisa
O mapeamento de artigo em estado Synced, com dados de demonstração

Versões do Odoo e preço

O módulo está publicado na Odoo Apps para Odoo 17, 18, 19 e 20. Nas quatro páginas aparece como gratuito. Pode vê-lo na página da Odoo Apps ou na página do módulo em flexigotech.com.

Como a FlexigoTech pode ajudar

Na FlexigoTech implementamos Odoo 17, 18, 19 e 20 e desenvolvemos conectores e integrações à medida. Se o conector lhe serve mas precisa de o adaptar à sua forma de trabalhar, ou quer que alguém reveja consigo as contas, os mapeamentos e as tarefas agendadas antes de começar a vender na Shopee, conte-nos o seu caso através da página do módulo.

Continue a ler

Erros do Shopee Marketplace Connector (APAC): quando aparece cada mensagem e o que fazerO que significa cada mensagem de erro do Shopee Marketplace Connector (APAC) no Odoo, quando aparece e o que fazer, com um caso inventado e os textos literais.Arranque do Shopee Marketplace Connector (APAC) no Odoo: campos, mapeamentos e primeira semanaGuia para pôr a funcionar o Shopee Marketplace Connector (APAC) no Odoo: campos da conta, mapeamentos de categorias e atributos e o que rever na primeira semana.Como funciona o Leroy Merlin Connector no Odoo: menus, ações agendadas e percursoQue menus o Leroy Merlin Connector acrescenta ao Odoo, que dez ações agendadas corre e com que frequência, e o que passa pela FlexigoTech Cloud.
Verificado no código do módulo (versão 20.0) e nas fontes indicadas

Fontes

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