Saltar para o conteúdo principal
Mirakl

Checklist da instância do Mirakl Connector, campo a campo

A ficha de instância da Mirakl reúne a ligação, as contas de liquidação e algumas opções; aqui tens, campo a campo, o que significa cada um segundo a sua ajuda e o que convém preencher.

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

As fichas abrem-se a partir do menu Mirakl › Configuração › Marketplaces, na lista Instâncias Mirakl.

Esquema com o menu Mirakl, Configuração, Marketplaces e os campos da ficha de instância
Esquema feito com código a partir do código publicado do módulo (não é uma captura do Odoo): o menu e os campos da ficha.

Antes de mexer na ficha

  • Permissão. Para ver a chave é preciso ser Mirakl Manager: a ajuda de Chave da API diz que só os Mirakl Managers a podem ver ou alterar, e a Chave de API da Mirakl (FlexigoTech Cloud) só é vista pelos utilizadores com essa permissão.
  • Conta de vendedor do marketplace. Abre-a noutro separador: é daí que saem o host do operador e a chave de API, segundo a ajuda desses campos.
  • Subscrição. O módulo precisa da subscrição da FlexigoTech Cloud (plano Conector). O preço está no final.
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)

Perfil do marketplace

  • Código do Fornecedor. Vê-se na ficha e também na lista de Instâncias Mirakl. É o perfil de marketplace/fornecedor que a instância utiliza; segundo a sua ajuda, ao instalar os complementos de fornecedor aparecem perfis específicos do operador, como a Leroy Merlin. O valor por defeito é Mirakl Genérico.

Separador Ligação, grupo Acesso

Estes campos estão no separador Ligação, grupo Acesso.

  • Ligação à Mirakl. É só de leitura e vale FlexigoTech Cloud por defeito. A sua ajuda diz que os marketplaces novos se ligam através da FlexigoTech Cloud e que Direta (chave de API guardada no Odoo) só se mantém para os que já existiam antes desta versão, que continuam a funcionar tal como foram comprados. Não há nada a preencher: basta verificar que via tem a tua instância.
  • Chave de API da Mirakl (FlexigoTech Cloud). Está no grupo FlexigoTech Cloud. Com os valores por defeito é visível, e fica oculta se a ligação não for a da FlexigoTech Cloud. A sua ajuda diz que é enviada uma única vez, cifrada, para a FlexigoTech Cloud e que nunca é guardada no Odoo.
  • URL Base. É o host real do operador. A sua ajuda avisa de que a Mirakl não fornece um host universal partilhado por todos os marketplaces. Para operadores conhecidos preenche-se sozinha; caso contrário, introdu-la a partir da tua conta de vendedor. Exemplo da ajuda: https://adeo-marketplace.mirakl.net. É obrigatória antes de poder testar a ligação ou sincronizar.
  • URL Base da API. É a URL base real da API para o operador escolhido. A sua ajuda diz que normalmente é a URL base mais /api, com este exemplo: https://adeo-marketplace.mirakl.net/api.
  • Chave da API. Com os valores por defeito não se vê: fica oculta quando a ligação é FlexigoTech Cloud, por isso aparece nas instâncias com ligação Directa. É a chave de API de vendedor (Settings > API key na tua conta de vendedor) e é necessária antes de poder usar Testar Ligação ou sincronizar.
  • Loja. Vê-se na ficha e neste grupo. É um identificador opcional para ambientes multiloja. Segundo a sua ajuda, Testar Ligação preenche-o automaticamente quando a Mirakl expõe a loja do vendedor.

Separador Finanças

Aqui está a contabilidade das liquidações. No separador Finanças há dois grupos.

Grupo Contabilidade de Liquidações

  • Diário de Liquidações. Um diário, entre vários, para contabilizar os lançamentos de liquidação da Mirakl. Se o deixares vazio, é criado um diário dedicado, Liquidações Mirakl, na primeira utilização. Escolhe um teu se preferires que esse não seja criado.
  • Conta Transitória do Marketplace. Uma conta transitória do balanço que representa o que o marketplace te deve pelas encomendas: é debitada pelas vendas e creditada quando a liquidação efetua o pagamento.
  • Conta de Despesa de Comissão. A conta de despesas para a comissão e as taxas do marketplace.
  • Conta de Pagamento / Suspensão Bancária. É debitada com o pagamento líquido que te transferem e depois é reconciliada com a entrada bancária real: manualmente na Community, com sincronização bancária na Enterprise, segundo a sua ajuda.

Grupo Opções

  • Conta Analítica. Opcional. Serve para que as liquidações deste marketplace alimentem um P&L por canal nos relatórios analíticos do Odoo. Preenche-a se quiseres essa leitura por canal.
  • Lançar liquidações automaticamente. Cria automaticamente o lançamento contabilístico quando se importa uma liquidação. Vem desativada por defeito: assinala-a apenas se quiseres esse lançamento ao importar.

Separador IA (opcional)

  • Ativar insights de IA. Está no separador IA (opcional) e vem desativada. Com o Odoo em português de Portugal, a sua ajuda diz Opcional. O conector funciona totalmente sem IA. Se não ativar isto / não definir uma chave, nunca é feita qualquer chamada de IA e nada muda. Se não precisares dela, deixa-a como está.
Esquema com o texto de ajuda do campo de análise de IA em cinco idiomas
Esquema feito com código a partir das traduções publicadas do módulo (não é uma captura do Odoo): a ajuda de Ativar insights de IA em castelhano, alemão, francês, italiano e português.

Revisão antes de dar a instância por boa

  • Verifica que URL Base e URL Base da API apontam para o mesmo operador; normalmente a segunda é a primeira mais /api, como nos exemplos da ajuda.
  • Se a tua instância usar a ligação Directa, confirma que URL Base e Chave da API estão preenchidas antes de tentar testar a ligação ou sincronizar.
  • Depois de testar a ligação, vê Loja: a sua ajuda diz que se preenche sozinha quando a Mirakl expõe a loja do vendedor.
  • Revê com o teu contabilista as contas do grupo Contabilidade de Liquidações.

Preço e ajuda com a colocação em funcionamento

O módulo é de pagamento único por versão do Odoo e está publicado no Odoo Apps para as versões 17, 18, 19 e 20 (consulta a ficha do Odoo Apps ou a página do módulo). Precisa da subscrição da FlexigoTech Cloud, plano Conector: 49 € por mês ou 490 € por ano, sem IVA, até 3 contas da plataforma. A ligação passa pela FlexigoTech Cloud, que guarda as credenciais cifradas, vigia a sincronização e avisa por e-mail se falhar. Com a subscrição, o módulo para as versões novas do Odoo vai incluído se o compraste em flexigotech.com; na Odoo App Store, cada versão do Odoo compra-se lá.

A FlexigoTech implementa o Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. Se quiseres que revejamos contigo a ficha da tua instância, escreve-nos.

Continue a ler

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.Os campos da instância Mirakl no Odoo: o que significa cada um e o que indicarGuia dos campos da instância do Mirakl Connector para Odoo: envio, desconto, comissão, idioma, faturas e sincronização, segundo a sua própria ajuda.
Verificado no código do conector (versão 20.0) e nas fontes indicadas

Fontes