Saltar para o conteúdo principal
Mirakl

Os campos da instância Mirakl no Odoo: o que significa cada um e o que indicar

Na ficha de cada marketplace do Mirakl Connector decide-se como entra uma encomenda no Odoo: envio, desconto, comissão, idioma, fatura e ritmo de importação. Aqui tens cada campo segundo a sua própria ajuda e o que convém indicar.

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

Onde estão os campos e porque é que alguns não se veem

Esquema feito com código do menu de Marketplaces e da ficha da instância com os campos explicados abaixo
Esquema feito com código (não é uma captura do Odoo): o menu e os campos da ficha da instância

Onde se abrem estes campos?

No menu Mirakl › Configuração › Marketplaces abrem-se as fichas de Instâncias Mirakl. Estes campos estão no separador Encomendas e Devoluções, repartidos por grupos: Ponte de Vendas, Cliente e privacidade, Política de Sincronização e Windows. O módulo está publicado no Odoo Apps para Odoo 17, 18, 19 e 20.

Porque é que não vejo Linha de envio, Produto de Comissão nem Lançar automaticamente a fatura criada?

Porque se ocultam consoante outro campo e, com os valores por defeito, não se veem.

  • Linha de envio fica oculta enquanto a instância não tiver produto de envio.
  • Produto de Comissão só aparece quando Comissão na encomenda de venda está em Deduzir comissão (líquido que recebe).
  • Lançar automaticamente a fatura criada só aparece com Criar fatura automaticamente na validação da entrega ativado.
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)

Preço da encomenda: envio, desconto e comissão

Quando é que o módulo acrescenta a linha de envio à encomenda de venda?

Decide-o Linha de envio. A ajuda pede que se indique acima um produto de envio, seja qual for a opção escolhida. Com Só quando o marketplace cobrou o envio não há linha se o marketplace enviou gratuitamente. Com Sempre, mesmo quando o envio é gratuito (0.00) cria-se na mesma uma linha a 0.00, de modo que todas as encomendas têm a mesma estrutura e o desconto de marketplace também se aplica a essa linha. O valor por defeito é Só quando o marketplace cobrou o envio.

Esquema feito com código da opção Sempre, mesmo quando o envio é gratuito (0.00) em castelhano, alemão, francês, italiano e português
Esquema feito com código a partir das traduções publicadas, não é uma captura do Odoo: assim se vê essa opção consoante o idioma do Odoo

Para que serve Desconto de marketplace (%)?

O campo Desconto de marketplace (%) escreve uma percentagem na coluna Desc.% de cada linha importada, tanto nas de produto como na de envio. A ajuda propõe-no para quando o marketplace lhe compra com uma margem fixa sobre o preço que o comprador vê: assim o total da encomenda coincide com o que fatura ao operador. Exemplo da própria ajuda: total no Mirakl 100.00 com 20% de desconto, a linha do Odoo mostra 100.00 com Desc.% 20% e um subtotal de 80.00. Por defeito vale 0 e, com 0, os preços importam-se sem alterações.

Como reflete o Odoo a comissão do marketplace?

Depende de Comissão na encomenda de venda, cujo valor por defeito é sem comissão. A comissão é o que o marketplace lhe cobra a si e deduz do seu pagamento.

  • Sem comissão (total pago pelo cliente): o total é produto mais imposto, o que o cliente paga. A comissão só fica guardada na encomenda do Mirakl como dado informativo.
  • Deduzir comissão (líquido que recebe): acrescenta-se uma linha negativa com a comissão, usando o Produto de Comissão, um produto de serviço. O total é produto mais imposto menos comissão, o líquido que recebe.
  • Preço de compra do operador (o operador compra-lhe): para marketplaces em que o operador lhe compra a mercadoria e fatura ele próprio ao comprador (GACD, por exemplo). Cada linha toma o preço de compra que o Mirakl indica para ela e o Odoo acrescenta os impostos do produto, de modo que a encomenda coincide com a ordem de compra do operador. A estas linhas não se aplica o desconto de marketplace. Se o Mirakl não enviar preço de compra para uma linha, essa linha mantém o preço do comprador e o desconto, e fica uma nota na encomenda de venda e nos registos do Mirakl.

A escolha depende da cifra que quer ver na encomenda: o que paga o cliente, o que recebe líquido ou a ordem de compra do operador.

Que idioma se atribui aos clientes que o marketplace cria?

O de Idioma dos contactos importados. Aplica-se aos clientes e contactos de entrega que este marketplace cria no Odoo e define o idioma dos seus orçamentos, faturas e e-mails. Se o deixar vazio, usa-se o predefinido do Odoo. Só aparecem os idiomas instalados: instale primeiro o que falta em Ajustes ▸ Traducciones ▸ Idiomas.

Faturas e ritmo de importação

O que escolho em Tipo de fatura (Espanha)?

O campo Tipo de fatura (Espanha) define como se classifica a fatura gerada a partir de encomendas do Mirakl quando o l10n_es (TicketBAI, VeriFACTU) está instalado.

  • Automático (o Odoo decide): com NIF sai uma F1 completa e sem NIF uma F2 simplificada. É o valor por defeito.
  • Simplificada com NIF (F2 TicketBAI/VeriFACTU): emite-se simplificada mesmo que o comprador tenha NIF. A ajuda dá-a por válida para B2C no País Basco (TicketBAI) ou quando o seu consultor fiscal indicar que a F2 é suficiente.
  • Completa (F1 TicketBAI/VeriFACTU): emite-se completa mesmo que o comprador não tenha NIF, por exemplo clientes estrangeiros que a exijam.

Se tiver dúvidas, consulte o seu consultor fiscal.

Convém criar, lançar e enviar a fatura ao Mirakl automaticamente?

São campos separados e cada um tem a sua própria ajuda.

  • Criar fatura automaticamente na validação da entrega: está desativado por defeito. Se o ativar, ao validar uma entrega de uma encomenda do Mirakl cria-se a fatura de cliente a partir da respetiva encomenda de venda. Respeita a política de faturação (encomenda ou entregue) e nunca bloqueia a entrega se a faturação falhar.
  • Lançar automaticamente a fatura criada: a ajuda recomenda deixá-lo desativado com TicketBAI, VeriFACTU ou SII, porque lançar é irreversível e envia a fatura eletrónica à administração tributária. As faturas não positivas ficam em rascunho.
  • Enviar fatura para o Mirakl: com Manual (com um botão) não se carrega nada sozinho, e a ajuda assinala-o como recomendado, por exemplo para a carregar depois de editar cliente ou NIF. Com Automático (na validação da entrega) carrega-se ao validar a entrega, apenas se a fatura estiver lançada, e requer que o operador tenha ativado o carregamento de faturas. Reenviar substitui o documento anterior no Mirakl, sem duplicados.

Quando altero Tipo de documento de fatura Mirakl e Relatório PDF da fatura?

O primeiro traz CUSTOMER_INVOICE e a ajuda diz para o alterar apenas se o seu operador definir um código personalizado. O segundo é o nome técnico (XML id) do relatório que gera o PDF e vem com account.account_invoices.

De quanto em quanto tempo importa encomendas e como evito que se percam mudanças de estado?

Governam-no estes campos.

  • Sincronização de Encomendas Ativada, em Política de Sincronização e também na lista de instâncias: ativa a importação agendada de encomendas para essa instância. Por defeito está desativada.
  • Frequência de sincronização de encomendas (minutos), no grupo Windows: é o tempo mínimo entre duas importações desse marketplace. A ação agendada Mirakl - Sincronizar Encomendas desperta a cada 10 minutos e processa a instância quando esses minutos já passaram. Com 0 importa em cada despertar e com 60, de hora a hora.
  • Filtrar sincronizações pela última atualização: pede ao Mirakl o que mudou desde a última sincronização, não o que foi criado. A ajuda diz para o deixar ativado, porque com o filtro por data de criação uma encomenda criada de manhã e enviada à tarde fica de fora e o seu novo estado não chega ao Odoo. Desative-o apenas se a API do seu operador ignorar esse filtro. A importação inicial usa sempre a data de criação.

O que acontece com a subscrição e como o ajudamos

O Mirakl Connector é de pagamento único por versão do Odoo e precisa da subscrição do FlexigoTech Cloud, plano Conector: 49 €/mês ou 490 €/ano sem IVA, com até 3 contas da plataforma. A ligação passa por esse serviço, que guarda as credenciais cifradas e avisa por e-mail se a sincronização falhar. Sem subscrição pára o que esta oferece, e os dados ficam no seu Odoo. Pode ver o módulo na ficha do Odoo Apps ou na página do módulo.

Se está a implementar o Odoo e quer rever consigo estes campos antes de ativar a sincronização, a FlexigoTech implementa o 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