Saltar para o conteúdo principal
Mirakl

O que o Mirakl Connector acrescenta à encomenda de venda do Odoo (Vendas)

O Mirakl Connector acrescenta à encomenda de venda um separador Mirakl com a instância, a encomenda, o seu estado, a última sincronização e os dados de envio e contacto, e só se vê quando a encomenda traz uma Encomenda Mirakl. Além disso, altera o que acontece ao apagar a encomenda, ao guardar alterações nas suas moradas e ao faturá-la.

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

O essencial

Módulo
Mirakl
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 toca em Vendas

O módulo amplia a encomenda de venda padrão da app Vendas (Sales) do Odoo. O que acrescenta são campos na ficha, um deles também na lista de encomendas, e ajustes de comportamento no código da encomenda. Eis o que convém saber antes de abrir a primeira encomenda que chegue de um marketplace.

Esquema feito com código: a app Vendas em cima e, por baixo, os campos que o Mirakl Connector lhe acrescenta
Esquema gerado a partir do código do módulo, não é um ecrã do Odoo. Os rótulos estão em inglês, o texto original do código.
Same stock on every Mirakl marketplace, sent from Odoo
Vídeo: Same stock on every Mirakl marketplace, sent from Odoo (vídeo em inglês)

Detalhes que não se veem na ficha

Os campos não aparecem até a encomenda ter Encomenda Mirakl

Os campos do módulo estão na ficha da encomenda de venda, no separador Mirakl, repartidos em dois grupos: Marketplace e Envio e contacto (Shipping & Contact). Todos ficam ocultos enquanto Encomenda Mirakl (Mirakl Order) estiver vazio, pelo que numa encomenda sem esse valor não verá nada disto.

No grupo Marketplace estão Instância Mirakl (Mirakl Instance), Encomenda Mirakl, Estado da Encomenda Mirakl (Mirakl Order State) e Última Sincronização Mirakl Em (Mirakl Last Sync At). Os quatro são só de leitura: consultam-se, não se editam.

Esquema feito com código com o texto do grupo Marketplace noutros idiomas: Marktplatz, Place de marché e Marktplaats
Esquema gerado a partir das traduções do módulo, não é um ecrã do Odoo. Com o Odoo em alemão o grupo vê-se como Marktplatz, em francês como Place de marché e em neerlandês como Marktplaats.

O e-mail do cliente pode ser um relé anonimizado

Email do cliente Mirakl (Mirakl Customer Email) está no grupo Envio e contacto e é só de leitura. Segundo a sua ajuda, nem sempre guarda o e-mail real do comprador: quando existe, guarda o relé anonimizado que o Mirakl cria para cada encomenda, e o que se envia para aí chega ao comprador. Se não houver relé, guarda o e-mail do cliente que vem na encomenda.

O telefone e a pessoa de contacto têm a sua própria lógica

Telefone do cliente Mirakl (Mirakl Customer Phone) recolhe o telefone que o comprador indicou no marketplace, para o ter à mão na própria encomenda. Segundo a sua ajuda, também é guardado no contacto de entrega. É só de leitura.

Pessoa de contacto Mirakl (Mirakl Contact Person) tem uma condição a mais. Só se vê se a encomenda tiver Encomenda Mirakl e, além disso, o próprio campo tiver valor. A sua ajuda diz que contém a pessoa que fez a encomenda quando o marketplace envia também um nome de empresa, e que nesse caso a empresa é usada como nome do contacto de entrega. Se não o vir, o campo está vazio nessa encomenda.

O método de envio também aparece na lista de encomendas

Método de envio Mirakl (Mirakl Shipping Method) está em Envio e contacto e, ao contrário dos restantes, aparece também na lista de encomendas de venda. A sua ajuda diz que é o método de envio que o comprador escolheu no marketplace (por exemplo, Standard ou Dia seguinte) e que fica vazio quando o operador não o envia.

Um campo vazio aqui, portanto, não indica uma falha: é o que acontece quando o operador não manda esse dado.

Apagar uma encomenda Mirakl deixa-a apagada

O módulo altera o que acontece ao eliminar uma encomenda de venda. Segundo o código do Odoo 20, antes de a apagar procura as encomendas Mirakl ligadas a ela. Se a encomenda de venda tiver Encomenda Mirakl, procura também a encomenda Mirakl com esse identificador na mesma instância, o que cobre um orçamento que nunca chegou a ser ligado. Depois de apagar, marca essas encomendas Mirakl como apagadas.

A razão está num comentário do próprio código: uma encomenda de venda apagada deve continuar apagada, porque a encomenda Mirakl lembra-se disso e uma nova sincronização não a cria nem a confirma automaticamente outra vez.

Alterar o cliente ou as moradas numa encomenda Mirakl

No Odoo 20, quando guarda alterações no cliente, na morada de entrega ou na morada de faturação de uma encomenda com Encomenda Mirakl, o módulo faz esse registo de forma diferente da padrão. Em encomendas sem Encomenda Mirakl, o registo é o padrão.

A fatura pode sair simplificada ou completa consoante a instância

Ao preparar a fatura a partir da encomenda, o módulo consulta a definição do tipo de fatura espanhola da instância Mirakl da encomenda (código do Odoo 20). Essa definição vive na instância, não na encomenda; está explicada em Os campos de Instância Mirakl no Mirakl Connector.

  • Se a encomenda não tem instância, ou a definição está em automático, a fatura é preparada como no Odoo padrão.
  • Se a localização espanhola do Odoo não está instalada (as faturas não têm o campo de fatura simplificada), também não se toca em nada.
  • Se a definição é simplificada, a fatura é marcada como simplificada. Se é completa, é marcada como não simplificada.

Como se encaixa com o resto e quanto custa

O módulo é de pagamento único por versão e precisa da subscrição do FlexigoTech Cloud: plano Conector, 49 €/mês ou 490 €/ano sem IVA. A ligação passa pelo FlexigoTech Cloud, que guarda cifradas as credenciais, vigia a sincronização e avisa por e-mail se falhar. Está publicado para Odoo 17, 18, 19 e 20; na Odoo App Store cada versão compra-se lá. Mais detalhe na ficha do Odoo Apps e na página do módulo.

Se quiser que revejamos como fica o fluxo de encomendas no seu Odoo, a FlexigoTech implementa Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida.

Continue a ler

Checklist da instância do Mirakl Connector, campo a campoChecklist para preencher a instância do Mirakl Connector no Odoo: ligação, contas de liquidação e opções, com o que diz a ajuda de cada campo.Campos da Instância Mirakl no Mirakl Connector: o que significam e o que pôrGuia comparado dos campos da ficha Instâncias Mirakl no Mirakl Connector para Odoo: o que diz cada ajuda, o valor por defeito e o que preencher.
Verificado no código do conector (versão 20.0) e nas fontes indicadas

Fontes