Guia do Utilizador

Tudo o que precisa para instalar o Odoo–Shopify Order Check e ler o seu veredicto com confiança.

download Instalação

Pré-requisitos

  • Navegador: Google Chrome (ou qualquer navegador baseado em Chromium) com extensões ativadas.
  • Odoo: Odoo 14–19+, em Odoo Online (*.odoo.com) ou Odoo.sh, com uma conta de utilizador com a qual possa iniciar sessão.
  • Shopify: Uma loja Shopify ligada ao Odoo através de um conector suportado (atualmente Emipro).

Instalar a extensão

  1. Abra a página na Chrome Web Store
    Aceda à página do Odoo–Shopify Order Check na Chrome Web Store.
  2. Adicionar ao Chrome
    Clique em "Adicionar ao Chrome" e confirme o pedido. A extensão instala-se em poucos segundos.
  3. Fixar o ícone (opcional)
    Fixe a extensão na barra de ferramentas para que o popup de definições esteja sempre a um clique de distância.
  4. Iniciar sessão no Odoo
    Abra a sua instância Odoo no mesmo navegador e inicie sessão. É o único passo necessário antes de começar a comparar pedidos.
Só de leitura e seguro. A extensão nunca escreve no Odoo nem no Shopify. Apenas lê dados de pedidos para construir a comparação, pelo que é seguro executá-la em produção.

rocket_launch Primeiros Passos

Não há nada a configurar. Assim que a extensão estiver instalada e tiver sessão iniciada no Odoo, abra um pedido e a comparação aparece automaticamente.

  1. Iniciar sessão no Odoo
    Abra a sua instância Odoo e inicie sessão como habitualmente. A extensão lê a sua sessão ativa para detetar a instância e a base de dados — sem chave de API, sem URL a digitar.
  2. Abrir um pedido
    Abra qualquer pedido de venda no Odoo (ou o pedido correspondente no Shopify). A extensão deteta-o automaticamente e injeta um painel de comparação.
  3. Ler o veredicto
    O painel mostra um veredicto global de correspondência ou divergência e permite expandir o resumo campo a campo quando quiser.
Zero configuração. Não há instâncias a registar, chaves de API a colar nem página de opções. A instância e a base de dados vêm diretamente da sua sessão de navegador do Odoo, com prioridade para o cookie.
A rede funciona em segundo plano. Todos os pedidos de rede são executados no service worker da extensão. O token Admin do Shopify é lido a partir do Odoo através do conector, mantido apenas em memória e nunca persistido nem exposto à página.

verified Ler o Veredicto

O topo do painel apresenta um único veredicto imediato para o pedido:

  • Correspondência: O Odoo e o Shopify concordam sobre o pedido. Não foram encontradas discrepâncias nos campos comparados.
  • Divergência: Pelo menos um campo difere entre os dois sistemas. O resumo lista exatamente o quê e onde.
  • Não foi possível comparar: A extensão não conseguiu construir uma comparação — por exemplo, a sua sessão no Odoo expirou ou o pedido ainda não está associado ao Shopify. O painel indica o que fazer a seguir.

Expandir os detalhes

O veredicto é imediato; o resumo é apresentado a pedido. Expanda o painel para ver todos os campos comparados, o valor de cada lado e uma secção de contexto para tudo o que explique uma diferença sem ser um erro.

dashboard O Resumo de Discrepâncias

Quando há uma divergência, o resumo mostra campo a campo onde o Odoo e o Shopify discordam:

  • Totais: O total do pedido, comparado com o valor líquido faturado no Odoo (consulte a secção seguinte para perceber o porquê).
  • Impostos: Valores de imposto de cada lado. Em pedidos comparados com o total faturado, a base tributável e os impostos podem estar assinalados como não comparáveis nesta versão.
  • Quantidades: Quantidades por linha. A quantidade faturada no Odoo é tratada como referência face à quantidade atual do Shopify.
  • Linhas de artigo: Produtos associados por SKU, com artefactos do conector (como linhas de desconto ou oferta) excluídos para que não apareçam como diferenças fantasma.
  • Endereços: Endereços de entrega e faturação, comparados pelas partes relevantes (rua, localidade, código postal) em vez de um único nome de exibição.
Gravidade. Cada discrepância tem um peso, pelo que uma diferença ao nível do arredondamento não é lida da mesma forma que uma linha em falta ou um total errado. O veredicto reflete a diferença mais significativa encontrada.

swap_horiz Faturado vs. Atual

O veredicto económico compara o pedido atual do Shopify com o que foi efetivamente faturado no Odoo — não com o pedido de venda original.

Por que o valor líquido faturado?

Quando um pedido é faturado, o conector congela o pedido de venda. Comparar esse pedido congelado com um pedido do Shopify que entretanto mudou gera falsos positivos. Em vez disso, a extensão usa o valor líquido faturado do Odoo — faturas de cliente emitidas menos notas de crédito emitidas — que é o que corresponde genuinamente ao estado atual do Shopify.

Como cada lado é lido

  • Odoo: Total líquido faturado (soma das faturas de cliente emitidas menos as notas de crédito emitidas) e a quantidade faturada por linha como referência.
  • Shopify: O total atual do pedido e a quantidade atual por linha — a fonte de verdade em tempo real sobre o que o cliente tem efetivamente.
Ainda não faturado? Se o pedido não tiver faturas emitidas, a extensão recorre à comparação dos valores encomendados e assinala o veredicto como provisório, para que saiba que uma fatura o irá consolidar mais tarde.

history Reembolsos, Devoluções e Cancelamentos

Reembolsos, devoluções e edições de pedidos raramente significam que algo está errado — fazem parte do ciclo de vida normal de um pedido. A extensão apresenta-os como contexto, separados da lista de discrepâncias para não gerarem falsas divergências:

  • Reembolsos: O valor original, os reembolsos aplicados e o valor líquido faturado resultante são apresentados em conjunto para que a matemática seja transparente.
  • Devoluções: Uma devolução em curso é apresentada como contexto no eixo de entrega em vez de ser contada como discrepância de quantidade.
  • Edições de pedido: Quando um pedido do Shopify é editado, o histórico (original, reembolsos, edições) é mostrado para que uma alteração legítima não pareça um erro.

Pedidos cancelados

Quando um pedido é cancelado, o painel mostra um banner claro para que perceba imediatamente por que os números são os que são, em vez de ler o cancelamento como uma divergência.

Contexto, não discrepâncias. Tudo nesta secção é informativo. Explica diferenças; não contribui por si só para o veredicto de correspondência ou divergência.

business A Partir do Shopify

Também pode abrir a comparação a partir de um pedido do Shopify — não apenas a partir do Odoo. Para isso, a extensão precisa de saber a que instância do Odoo pertence a loja, e aprende esse mapeamento da primeira vez que compara o pedido a partir do Odoo.

Como funciona o mapeamento aprendido

  1. Inicie sessão no Odoo e abra o pedido lá uma vez. A extensão resolve a loja e memoriza a instância e base de dados do Odoo correspondentes.
  2. A partir daí, abrir o pedido correspondente no Shopify funciona diretamente — a extensão já sabe onde procurar.
  3. O mapeamento é guardado localmente no seu navegador; nada é enviado para lado nenhum.
Loja ainda não memorizada? Se abrir um pedido do Shopify de uma loja que a extensão ainda não viu a partir do Odoo, é-lhe pedido que abra primeiro o pedido no Odoo em vez de adivinhar. Assim que o mapeamento for aprendido, as comparações a partir do Shopify funcionam sem mais passos.

settings Definições

Um pequeno espaço de definições permite verificar o seu estado de acesso, gerir a licença e consultar alguns diagnósticos — sem sair da página em que se encontra.

Onde encontrar

  • Popup do ícone da extensão: Clique no ícone da extensão na barra de ferramentas para abrir as definições a partir de qualquer separador.
  • Engrenagem no painel: Abra a engrenagem ⚙ no painel de comparação para ver as mesmas definições no local, mesmo ao lado do pedido que está a analisar.

O que pode fazer

  • Ver o seu estado de acesso: Verifique se está no período de teste gratuito ou com uma licença ativa, e quantos dias de teste restam.
  • Ativar uma chave de licença: Cole uma chave de licença Polar para desbloquear a extensão em qualquer momento — durante o teste ou após o seu término.
  • Comprar um plano: Vá diretamente para o checkout para comprar um plano Starter, Growth ou Agency.
  • Gerir a sua subscrição: Abra o portal de cliente alojado do Polar para alterar ou cancelar a sua subscrição.

Diagnósticos só de leitura

O painel de diagnósticos é puramente informativo e mostra:

  • Dias de teste restantes.
  • O seu plano e nível.
  • A instância Odoo detetada.
  • A versão da extensão instalada.

credit_card Subscrição

O seu período de teste gratuito de 14 dias

Cada instalação começa com um período de teste gratuito de 14 dias que desbloqueia a extensão completa. O teste é registado localmente no seu dispositivo segundo um sistema de honra — sem registo e sem chamada de rede para o iniciar.

Planos

  • Starter: Cobre 1 instância Odoo e 1 loja Shopify.
  • Growth: Cobre 1 instância Odoo e lojas Shopify ilimitadas.
  • Agency: Cobre instâncias Odoo e lojas Shopify ilimitadas.

Como comprar

  1. Abra as definições a partir do popup do ícone da extensão ou da engrenagem ⚙ no painel.
  2. Escolha Comprar e selecione o plano Starter, Growth ou Agency.
  3. Conclua o checkout. Receberá uma chave de licença para ativar a extensão.

Ativar a sua chave de licença

  1. Abra as definições e localize o campo de chave de licença.
  2. Cole a chave recebida após o checkout.
  3. Ative. A extensão completa é desbloqueada de imediato para toda a sua equipa.
Subscrição para toda a empresa. Uma subscrição cobre toda a sua empresa — a mesma chave de licença funciona em toda a equipa, sem limite por utilizador. Os planos diferem apenas no âmbito: quantas instâncias Odoo e lojas Shopify cobrem.

Gerir ou cancelar a sua subscrição

Faturação, alterações de plano e cancelamento são geridos no portal de cliente alojado do Polar — a extensão apenas o redireciona para lá.

  1. Abra as definições a partir do popup ou da engrenagem no painel.
  2. Escolha Gerir subscrição para abrir o portal de cliente do Polar.
  3. Atualize o plano, os dados de pagamento ou cancele a partir daí.

A extensão nunca armazena os seus dados de pagamento. Toda a faturação vive no portal do Polar.

help Resolução de Problemas

Sessão do Odoo não detetada

Se não tiver sessão iniciada no Odoo, a extensão não consegue detetar a sua instância e mostra uma mensagem acionável "inicie sessão no Odoo" em vez de adivinhar.

  1. Abra a sua instância Odoo no mesmo navegador.
  2. Inicie sessão como habitualmente.
  3. Volte ao pedido — o painel retoma a sua sessão automaticamente.

Pedido não associado ao Shopify

  • Não é um pedido Shopify: Se o pedido não tiver contrapartida no Shopify, não há nada a comparar e o painel retira-se silenciosamente.
  • Abra primeiro a partir do Odoo: Ao iniciar a partir de uma loja Shopify que a extensão ainda não viu, abra o pedido no Odoo uma vez para que possa aprender o mapeamento loja-para-instância.

Instância não detetada

  • Sessão expirada: Se a sua sessão do Odoo tiver expirado, inicie sessão novamente e reabra o pedido.
  • Alojamento não suportado: A deteção automática abrange o Odoo Online (*.odoo.com) e o Odoo.sh nesta versão. O Odoo num domínio completamente personalizado ainda não é suportado.

O painel não aparece

  1. Recarregar a página: Atualize o separador do pedido para que o content script seja executado novamente e detete o pedido.
  2. Verificar se a extensão está ativa: Abra chrome://extensions e confirme que o Odoo–Shopify Order Check está ativado.
Ainda com problemas? Os diagnósticos nas definições mostram a instância Odoo detetada e a versão da extensão — detalhes úteis a incluir quando contactar o suporte.

quiz Perguntas Frequentes

Geral

O que faz o Odoo–Shopify Order Check?

Quando abre um pedido no Odoo ou no Shopify, a extensão compara os dois sistemas campo a campo — totais, impostos, quantidades, linhas de artigo e endereços — e mostra um veredicto global de correspondência ou divergência com um resumo das discrepâncias.

Altera alguma coisa no Odoo ou no Shopify?

Não. A extensão é estritamente só de leitura. Nunca cria, edita nem elimina dados em nenhum dos sistemas — apenas lê, pelo que é seguro executá-la em produção.

Preciso de configurar alguma coisa?

Não. A extensão deteta automaticamente a sua instância e base de dados do Odoo a partir da sessão ativa. Não há instâncias a registar, chaves de API nem página de opções.

Subscrição

Há um período de teste gratuito?

Sim. Cada instalação inclui um período de teste gratuito de 14 dias com funcionalidade completa. Após o teste, os planos Starter, Growth e Agency estão disponíveis — cada um cobre toda a sua equipa e é definido por quantas instâncias Odoo e lojas Shopify inclui.

Como cancelo?

Abra as definições, escolha Gerir subscrição e cancele a partir do portal de cliente alojado do Polar. A extensão apenas o redireciona para lá; nunca armazena dados de pagamento.

Privacidade e Segurança

De onde vem o token do Shopify?

É lido a partir do Odoo através do conector e mantido apenas em memória dentro do service worker da extensão. Nunca é persistido em disco nem exposto à página que está a visualizar.

Os meus dados de pedidos saem do navegador?

Não há backend. A extensão lê o Odoo e o Shopify diretamente a partir do seu navegador para construir a comparação, e o mapeamento aprendido de loja-para-instância é guardado localmente no seu dispositivo.

support Obter Ajuda

Contactar o suporte

Se algo não estiver a funcionar ou tiver alguma dúvida, contacte-nos e ajudamos:

  • E-mail: odoointegrations.team@gmail.com
  • Inclua a versão da sua extensão (visível nos diagnósticos das definições).
  • Capturas de ecrã do painel e do pedido aceleram muito a resolução.