Saltar para o conteúdo principal
Mirakl

O que o Mirakl Connector acrescenta a Artigos do Odoo: campos, botão e quando atua

O Mirakl Connector acrescenta à ficha de variante de artigo um contador de ligações, três campos só de leitura no grupo Marketplace Mirakl (Mirakl Marketplace) e o botão Publicar na Mirakl (Publish to Mirakl). Os campos consultam-se; o botão é o que trabalha sobre a variante quando o carrega.

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

O que acrescenta à ficha de variante de artigo

Esquema feito com código: a app standard Artigos e, por baixo, o que o módulo lhe acrescenta (o botão Publish to Mirakl, o campo Mirakl Bindings e os campos Last published to Mirakl, Mirakl import reference e Last Mirakl error)
Esquema feito com código a partir do código publicado do módulo, não é uma captura do Odoo. Os rótulos estão em inglês, o texto original do código.

O que acrescenta o Mirakl Connector a Artigos?

O módulo amplia o modelo standard de Artigos do Odoo. Na ficha de variante de artigo aparecem um campo contador, Ligações Mirakl (Mirakl Bindings), e um botão, Publicar na Mirakl (Publish to Mirakl). Há ainda um grupo, Marketplace Mirakl (Mirakl Marketplace), com três campos: Última publicação na Mirakl (Last published to Mirakl), Referência de importação Mirakl (Mirakl import reference) e Último erro Mirakl (Last Mirakl error).

O que conta Ligações Mirakl?

É um número inteiro que o Odoo calcula contando as ligações de artigo da Mirakl que apontam para essa variante; se não houver nenhuma, o valor é zero. Cada ligação reúne um marketplace e uma variante de artigo, e é a peça que o botão cria e consulta para cada marketplace, como verá mais abaixo.

Os três campos do grupo Marketplace Mirakl podem ser editados?

Não, os três são só de leitura. Última publicação na Mirakl é de data e hora, Referência de importação Mirakl é um texto curto e Último erro Mirakl é um texto longo. Estão na ficha de variante de artigo para serem consultados, não para se escrever neles.

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)

O botão Publicar na Mirakl

Quando é que o botão se vê?

Vê-se sempre na ficha de variante de artigo, sem qualquer condição, no Odoo 17, 18, 19 e 20.

Esquema com o texto do botão conforme o idioma do Odoo: Publicar en Mirakl em castelhano, Auf Mirakl veröffentlichen em alemão, Publier sur Mirakl em francês, Pubblica su Mirakl em italiano e Publicar na Mirakl em português
Esquema feito com código a partir das traduções publicadas do módulo, não é uma captura do Odoo: com o Odoo em português de Portugal, o botão chama-se Publicar na Mirakl.

O que faz ao carregar nele, por ordem?

Segundo o código do Odoo 20, trabalha sobre uma única variante. Primeiro verifica que marketplaces Mirakl estão criados. Se não houver nenhum, para com uma mensagem e não cria nada. Se houver, percorre cada marketplace: procura a ligação dessa variante com esse marketplace e, se não existir, cria-a. Depois tenta preencher automaticamente os dados de catálogo dessa ligação. Quando passou por todos os marketplaces, abre a oferta, ou a lista de ligações se forem várias.

Que mensagem aparece se ainda não houver nenhum marketplace?

Ao carregar em Publicar na Mirakl sem marketplaces criados, o módulo para com esta mensagem: Crie primeiro um marketplace Mirakl (Mirakl ▸ Configuração ▸ Marketplaces) e depois publique produtos nele. (Create a Mirakl marketplace first (Mirakl ▸ Configuration ▸ Marketplaces), then publish products to it.). É preciso criar antes um marketplace Mirakl; os campos dessa ficha são explicados neste artigo sobre a instância da Mirakl.

O que acontece se carregar no botão duas vezes sobre a mesma variante?

Para cada marketplace, o botão procura primeiro a ligação dessa variante e só cria uma se não existir. Ao carregar outra vez, reutiliza as ligações que já existem e cria apenas as que faltem, por exemplo se tiver registado outro marketplace entre um clique e o outro. A tentativa de preenchimento automático repete-se em cada clique.

Preenchimento automático e vários marketplaces

O que preenche o botão automaticamente e o que acontece se falhar?

A tentativa de preenchimento automático olha para três coisas em cada ligação: a marca, os URL de multimédia e os atributos de catálogo. A marca e os URL de multimédia só são preenchidos se estavam vazios e se o módulo encontrar um valor para propor. Os atributos de catálogo são escritos quando o módulo obtém atributos para guardar. Se o preenchimento automático der erro, o botão não para: a tentativa está protegida, segue-se em frente e a oferta abre-se na mesma, com o que houver.

O que abre o botão se tiver mais de um marketplace?

O botão cria, se faltarem, uma ligação por cada marketplace. Com uma única ligação, abre diretamente o seu formulário. Com mais do que uma, abre a lista de ligações dessa variante, com vistas de lista e de formulário, intitulada Publicar na Mirakl. O botão não publica nada por si só: deixa as ligações preparadas e abre a oferta, ou a lista, para que o vendedor a reveja sem ter de construir à mão uma linha de lista.

O que precisa para o usar

O Mirakl Connector está publicado no Odoo Apps para Odoo 17, 18, 19 e 20. É um 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. Com essa subscrição, a ligação passa pelo FlexigoTech Cloud, que guarda cifradas as credenciais, vigia a sincronização e avisa por e-mail se falhar. Sem subscrição, ou com o serviço suspenso, pára o que a subscrição dá; os dados ficam no seu Odoo. Pode vê-lo na ficha do Odoo Apps ou na página do módulo.

A FlexigoTech implementa Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida, caso precise de ajustar o fluxo de publicação ao seu catálogo.

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