Saltar para o conteúdo principal
Shopify

O que o Shopify Connector acrescenta à encomenda de venda do Odoo

O Shopify Connector alarga a encomenda de venda da app Vendas (Sales) com um grupo Shopify (referência, instância, etiquetas e nota), o contador Reembolsos (Refunds) e uma coluna Estado de envio que se calcula a partir das quantidades entregues e das guias de remessa; aqui tens quando se vê cada coisa e como se decide cada estado.

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

O essencial

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

O que o módulo acrescenta à encomenda de venda, campo a campo

O Shopify Connector alarga a encomenda de venda padrão da app Vendas. Não cria um ecrã à parte: acrescenta campos à encomenda que já usas. No Odoo 20.0, o módulo acrescenta estes campos:

Esquema feito com código: em cima a app padrão Vendas e por baixo os campos que o módulo lhe acrescenta
Esquema gerado a partir do código publicado do módulo, não é uma captura do Odoo. Os rótulos estão em inglês, como no código.
CampoOnde se vêVisibilidadeDetalhe
Shopify Order RefFicha da encomenda, grupo ShopifyFica oculto quando está vazioSó de leitura
Instância Shopify (Shopify Instance)Ficha da encomenda, grupo ShopifyFica oculto quando Shopify Order Ref está vazioSó de leitura
Shopify TagsFicha da encomenda, grupo ShopifyFica oculto quando Shopify Order Ref está vazioA sua ajuda diz: «Tags from Shopify order.»
Shopify NoteFicha da encomenda, grupo ShopifyFica oculto quando Shopify Order Ref está vazioA sua ajuda diz: «Customer note from Shopify order.»
Reembolsos (Refunds)Ficha da encomendaFica oculto quando vale zeroNúmero inteiro
Estado de envioLista de encomendas de vendaVê-se na listaLista de seleção com os valores que vês mais abaixo

Com o Odoo em português de Portugal, o contador chama-se Reembolsos; o esquema seguinte mostra como se chama esse mesmo texto noutros idiomas: Erstattungen em alemão, Remboursements em francês, Rimborsi em italiano e Reembolsos em português.

Esquema feito com código: o texto Refunds tal como o vê o utilizador em castelhano, alemão, francês, italiano e português
Esquema gerado a partir dos ficheiros de tradução publicados do módulo, não é uma captura do Odoo.

O módulo também liga internamente a encomenda ao seu registo de encomenda do Shopify: procura o registo cujo identificador coincide com Shopify Order Ref e cuja instância é a de Instância Shopify, e fica com o primeiro que encontra. Se faltar qualquer um dos dois dados, não liga nada.

Your Odoo doesn't talk to Amazon, Temu or Shopify?
Vídeo: Your Odoo doesn't talk to Amazon, Temu or Shopify? (vídeo em inglês)

Encomenda normal face a encomenda com referência do Shopify

Com os valores por defeito, Shopify Order Ref está vazio, e por isso o grupo Shopify não se vê numa encomenda qualquer. Aparece assim que esse campo tem valor. Se o grupo não está, é porque a encomenda não tem referência do Shopify.

ElementoEncomenda sem referência do ShopifyEncomenda com referência do Shopify
Grupo ShopifyNão se vêVê-se, com referência, instância, etiquetas e nota
ReembolsosFica oculto enquanto vale zeroFica oculto enquanto vale zero: a sua condição não olha para a referência
Estado de envioEstá na listaEstá na lista: o cálculo não verifica se há referência

A terceira linha merece uma leitura atenta: o cálculo do estado de envio percorre as encomendas sem perguntar pela referência do Shopify, pelo que não é uma coluna exclusiva das encomendas que vêm da loja.

Como o módulo decide o Estado de envio

Primeiro, o módulo olha para o estado da encomenda. Depois reúne as linhas que contam para o envio: as que não são secções nem notas, têm produto, esse produto é de um dos tipos que o código considera enviáveis e a quantidade encomendada é maior que zero. Soma o encomendado e o entregue dessas linhas e compara.

Situação da encomendaEstado de envio
A encomenda está canceladaCancelado
Há linhas enviáveis e a quantidade entregue é zero ou menosNão validado (No Validado)
Há linhas enviáveis e o entregue iguala ou supera o encomendadoEnviado
Há linhas enviáveis e o entregue é positivo mas menor que o encomendadoParcialmente enviado (Parcialmente Enviado)

Se não houver nenhuma linha enviável, o módulo muda de método e percorre as guias de remessa da encomenda:

Guias de remessa da encomendaEstado de envio
Nenhuma, depois de descartadas as canceladasNão validado
Todas as que contam estão concluídasEnviado
Só algumas estão concluídasParcialmente enviado
Nenhuma está concluídaPronto para enviar (Listo para Enviar)

Um detalhe do percurso pelas guias de remessa: se o modelo de guia distingue o tipo de operação e a encomenda tem guias de saída, só contam essas.

O que tirar dessa lógica

  • Pronto para enviar só aparece no percurso pelas guias de remessa, ou seja, quando a encomenda não tem linhas enviáveis.
  • Uma encomenda cancelada fica em Cancelado mesmo que tenha quantidades entregues: é a primeira coisa que se verifica.
  • No primeiro método, Não validado equivale a quantidade entregue zero ou menos; o código não olha para as guias de remessa.

A referência do Shopify não se reescreve

O módulo também vigia a escrita de Shopify Order Ref. Se a encomenda já tem uma referência e alguém tenta guardar outra diferente (incluindo uma vazia), a ação é interrompida e não se guarda nada do que ia mudar. A regra não se aplica quando a escrita é feita com o modo de superutilizador do Odoo, e escrever o mesmo valor que já existe não a ativa. O comentário do código explica-o pela forma de trabalhar do conector: localiza a encomenda por essa referência.

Na ficha, além disso, Shopify Order Ref figura como só de leitura.

Custo e como a FlexigoTech te ajuda

O módulo custa 9 € por versão do Odoo, pagamento único e sem IVA, para 17, 18, 19 e 20 (podes vê-lo na ficha do Odoo Apps). O seu manifesto indica que precisa da subscrição do FlexigoTech Cloud: o plano Conector custa 49 €/mês ou 490 €/ano sem IVA.

A FlexigoTech implementa o Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. Se a tua encomenda de venda precisar de campos próprios ou de um fluxo diferente com a tua loja, pode propor-se como desenvolvimento à parte.

Continue a ler

O que faz o botão Pull Stock do Shopify Connector, passo a passoO que faz o botão Pull Stock do Shopify Connector no Odoo 20: quando aparece, o que verifica, que ajustes de inventário cria e que erros pode dar.
Verificado no código do conector (versão 20.0) e nas fontes indicadas

Fontes