Saltar para o conteúdo principal
Shopee Marketplace Connector

Arranque do Shopee Marketplace Connector (APAC) no Odoo: campos, mapeamentos e primeira semana

Para pôr a funcionar o Shopee Marketplace Connector (APAC), cria no Odoo uma conta de marketplace com a respetiva empresa, armazém, o Partner ID / App Key, o Shop ID e a Partner Key da app da Shopee, escolhe o ambiente e define a partir de que momento as encomendas passam a orçamentos. Depois, relaciona categorias e atributos do Odoo com os da Shopee e, na primeira semana, revê os registos de sincronização, os conflitos e a fila. Aqui ficam os passos por ordem e o significado de cada campo.

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

O que ter preparado antes de abrir o Odoo

A conta de marketplace do módulo pede dados que vêm da Shopee e dados que vêm da sua própria organização. Convém reuni-los antes de começar:

  • O partner_id da app da Shopee e a respetiva partner key, que encontra em Shopee Open Platform > App list.
  • O shop_id da loja que vai ligar.
  • Se quiser testar primeiro, o partner ID e a chave de teste da app e uma loja de teste da Shopee.
  • A empresa do Odoo que vai ser dona da conta e o armazém a partir do qual vai sincronizar o inventário.
  • Os endereços de e-mail que devem receber os avisos.

O módulo está publicado na Odoo Apps para as versões 17, 18, 19 e 20 e, segundo a ficha de cada versão, é gratuito em todas (pagamento único por versão, sem IVA). Encontra-o na ficha da Odoo Apps e na página do módulo.

Passos para criar a conta da Shopee

Cada passo corresponde a um campo da conta de marketplace. Os nomes aparecem tal como surgem no módulo.

  1. Escreva o Account Name, o nome da conta.
  2. Escolha a Company. O módulo isola as contas por empresa: cada empresa é dona das suas configurações de marketplace.
  3. Indique o Default Fulfillment Warehouse. É o armazém predefinido para a sincronização do inventário e pode ser alterado produto a produto.
  4. Selecione o Shopee Environment. Com Sandbox usam-se o partner ID e a chave de teste da app e as lojas de teste da Shopee.
  5. Preencha Partner ID / App Key com o partner_id da Shopee e Shop ID com o shop_id da sua loja.
  6. Cole em Partner Key a partner key da app. Segundo a descrição do campo, é a que assina cada chamada.
  7. Use a ligação Connect Shopee shop. O módulo guarda em Authorization State um valor aleatório da última ligação gerada e verifica-o quando a Shopee devolve o vendedor. A conta tem ainda os campos OAuth Access Token, OAuth Refresh Token e Access Token Expires.
  8. Defina Create Sales Orders From. As encomendas feitas na Shopee antes desse momento ficam retidas (Held Orders) em vez de passarem a orçamentos.
  9. Ajuste Sync Frequency (minutes), o intervalo de consulta para encomendas e inventário, entre 5 e 60 minutos.
  10. Defina um Low Stock Threshold (units): abaixo desse nível o módulo emite um aviso de stock baixo. Se marcar também Auto-Create PO on Low Stock, cria um rascunho de ordem de compra quando o stock desce abaixo do limite.
  11. Escreva em Alert Email Recipients os endereços, separados por vírgulas, que vão receber os alertas de sincronização, o resumo e as notificações de erro.
  12. Escolha a estratégia de Auto-Conflict Resolution para os conflitos detetados e o Conflict Detection Threshold (%), a percentagem de diferença a partir da qual se deteta um conflito.
  13. Com tudo o que foi indicado revisto, marque Enable Sync, que ativa ou desativa todas as sincronizações da conta.

O campo API Key aparece na conta, mas a sua própria descrição indica que a Shopee não o usa.

Relacionar categorias, atributos e artigos

A conta tem três relações entre o Odoo e a Shopee: Category Mappings, Attribute Mappings e Product Mappings.

Categorias

Em Category Mappings relaciona uma categoria do Odoo com uma da Shopee. Cada linha tem Marketplace Account, Odoo Category, Marketplace Category ID (o category_id da Shopee) e Marketplace Category Name, um nome legível que o módulo guarda para mostrar no ecrã. A coluna Created regista quando a linha foi criada.

Lista de mapeamentos de categorias com as colunas Marketplace Account, Odoo Category, Marketplace Category ID, Marketplace Category Name e Created
A lista de mapeamentos de categorias, ainda sem registos, com o botão Novo e a barra de pesquisa.

Atributos

Em Attribute Mappings relaciona um atributo do Odoo (Odoo Attribute, por exemplo cor, tamanho ou marca) com a chave de atributo do marketplace em Marketplace Attribute Key. Cada linha tem também a respetiva Marketplace Account e a data Created.

Artigos

Em Product Mappings ficam as relações entre cada produto do Odoo e o respetivo ID de produto no marketplace. Na sequência seguinte vê-se um registo de exemplo da conta Shopee SG com o estado Synced.

Lista de mapeamentos de produto com um registo da Shopee SG no estado Synced, lista de contas de marketplace e lista vazia de mapeamentos de atributos
Percurso pelo mapeamento de produto de exemplo, pela lista de contas com dados de teste e pela lista de mapeamentos de atributos, ainda sem registos.

Se quiser ver como estas peças encaixam por dentro, explicamos em como funciona o conector por dentro.

O que rever na primeira semana

Com a sincronização ativada, estes são os pontos da conta que vale a pena ver diariamente no início:

  • Sync Logs: o registo de auditoria das interações com a API.
  • Sync Conflicts: os conflitos detetados que aguardam resolução. Reveja os conflitos pendentes e ajuste a estratégia de Auto-Conflict Resolution ou o Conflict Detection Threshold (%) se for preciso.
  • Sync Queue: a fila interna de tarefas de sincronização assíncronas.
  • Encomendas retidas: se vir encomendas em Held Orders, confirme que a data de Create Sales Orders From é a pretendida.
  • Token: verifique a data de Access Token Expires na conta.
  • Stock baixo: se ativou Auto-Create PO on Low Stock, procure os rascunhos de ordem de compra e confirme que o Low Stock Threshold (units) faz sentido para os seus artigos.
  • E-mail: confirme que os endereços de Alert Email Recipients estão bem escritos e separados por vírgulas.

O módulo inclui também listas de resumo e de relatório de desempenho. Nas capturas aparecem ainda sem dados:

Lista de resumo do painel de marketplace com as colunas Company, Total Reve…, Total Or…, Critical… e Major E…
A lista de resumo do painel, ainda sem dados.
Lista de relatórios de desempenho com as colunas Company, Marketplace, Product Category, Date From e Date To
A lista de relatórios de desempenho, ainda sem registos.

Se nesses dias aparecer uma mensagem que não percebe, tem os textos literais e a forma de os resolver em as mensagens de erro do conector.

Como a FlexigoTech o pode ajudar

Na FlexigoTech implementamos Odoo 17, 18, 19 e 20 e desenvolvemos conectores e integrações à medida. Se quiser que revejamos a configuração da conta da Shopee, os mapeamentos ou uma integração que o módulo não cobre, pode contactar-nos a partir 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.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