Saltar para o conteúdo principal
Mirakl

Mirakl Connector: o aviso das contas de Finanças ao lançar na Contabilidade

O aviso aparece ao clicar em Lançar na Contabilidade (Post to Accounting) numa liquidação Mirakl quando a instância tem vazia pelo menos uma das suas três contas de Finanças. Resolve-se configurando nessa instância as contas que a própria mensagem enumera depois de Em falta: e voltando a clicar no botão.

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

Onde aparece e o que diz

As liquidações abrem-se a partir do menu Mirakl › Finanças › Liquidações e Faturas (Mirakl › Finances › Settlements & Invoices). Na sua ficha está o botão Lançar na Contabilidade (Post to Accounting). Fica oculto quando a liquidação já tem preenchido o campo Lançamento contabilístico (Journal Entry); com os valores por defeito, está visível. Ao clicar nele pode aparecer esta mensagem, que interrompe a ação:

Configure as contas de Finanças na instância Mirakl '…' antes de lançar as liquidações. Em falta: … (Configure the Finance accounts on the Mirakl instance '…' before posting settlements. Missing: …)

Esquema feito com código do menu de liquidações, do botão de lançar na contabilidade e da mensagem das contas de Finanças
Esquema feito com código a partir do código publicado do módulo (não é uma captura de ecrã do Odoo): o menu, o botão e a mensagem, com os rótulos em inglês do código, para Odoo 17, 18, 19 e 20.
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 que não lhe contam sobre este aviso

A condição é só uma: alguma das três contas está vazia

O código reúne três contas da instância Mirakl: Conta Transitória do Marketplace (Marketplace Clearing Account), Conta de Despesa de Comissão (Commission Expense Account) e Conta de Pagamento / Suspensão Bancária (Payout / Bank Suspense Account). Se qualquer uma delas estiver vazia, o módulo interrompe a ação com o aviso. Com as três preenchidas, esta mensagem não aparece.

A mensagem já lhe diz o que configurar

Depois de Faltan: o módulo escreve o nome de cada conta vazia, separados por vírgulas e pela ordem em que foram citadas acima. Entre aspas simples aparece o nome da instância, para saber qual abrir se gere mais do que uma.

Por exemplo, se estivessem vazias a conta transitória do marketplace e a de despesas de comissões, o final da mensagem seria Faltan: Cuenta puente del marketplace, Cuenta de gastos de comisiones.

Com o Odoo em português de Portugal vê-a como no ponto anterior. Este esquema reúne o mesmo texto noutros idiomas:

Esquema feito com código da mesma mensagem em castelhano, alemão, francês, italiano e português
Esquema feito com código a partir das traduções publicadas do módulo (não é uma captura de ecrã do Odoo): o texto do aviso consoante o idioma do Odoo.

É verificado antes de calcular qualquer montante

No código do Odoo 20, a verificação das contas vem antes de construir as linhas do lançamento. O aviso não depende, portanto, dos montantes da liquidação. Além disso, o módulo exige as três contas mesmo que depois deixe de fora uma linha do lançamento quando o seu montante é zero.

Cada conta alimenta uma linha concreta do lançamento

Quando as três contas estão preenchidas, o código do Odoo 20 distribui-as assim:

  • Conta de Pagamento / Suspensão Bancária: a linha Pagamento Mirakl (líquido) (Mirakl payout (net)).
  • Conta de Despesa de Comissão: a linha Comissão e taxas Mirakl (Mirakl commission & fees) e também a linha Outras taxas / taxas de subscrição Mirakl (Mirakl other / subscription fees), que recolhe o resíduo que faz o lançamento fechar.
  • Conta Transitória do Marketplace: a linha Conta transitória de marketplace Mirakl (Mirakl marketplace clearing).

Cada uma destas linhas só é adicionada se o seu montante não for zero. Se a instância tiver uma conta analítica configurada, o código aplica-a às duas linhas que vão para a conta de despesas de comissões.

Como fica o lançamento quando as contas estão completas

No Odoo 20, o código prepara um lançamento do tipo lançamento contabilístico com a referência Liquidação Mirakl … (Mirakl settlement …) e o nome da liquidação. Vai para o diário de liquidações da instância: se a instância não tiver nenhum, o módulo procura ou cria um com o código MRKL. A data do lançamento é a da transação de pagamento da liquidação; se esta faltar, usa a data de criação e, se também não existir, a de hoje. Se a liquidação estiver numa moeda diferente da da empresa, as linhas são convertidas para a moeda da empresa e mantêm o montante original.

O que fazer, por ordem

  1. Repare no nome da instância entre aspas e nas contas que aparecem a seguir a Faltan:.
  2. Abra essa instância Mirakl e configure essas contas de Finanças.
  3. Volte à liquidação, a partir de Mirakl › Finanças › Liquidações e Faturas, e clique de novo em Lançar na Contabilidade.
  4. Se a liquidação continuar sem Lançamento contabilístico, o botão continua visível.

A mensagem existe no código publicado do Odoo 17, 18, 19 e 20. Para outros avisos do conector, veja o que faz o botão Testar ligação.

Como a FlexigoTech ajuda

O Mirakl Connector é um módulo de pagamento único por versão do Odoo, publicado para Odoo 17, 18, 19 e 20, e precisa da subscrição do FlexigoTech Cloud: a ligação passa por esse serviço, que guarda cifradas as credenciais, vigia a sincronização e avisa por e-mail se falhar. O plano Conector custa 49 €/mês ou 490 €/ano sem IVA. A FlexigoTech implementa Odoo e desenvolve conectores e integrações à medida; pode ver a ficha no Odoo Apps ou a página do módulo.

Continue a ler

Mirakl Connector: «Defina a chave de API do Mirakl antes de testar a ligação»Quando surge o erro de chave de API vazia no Mirakl Connector para Odoo, que condição o provoca e como o resolver ao clicar em Testar Ligação.Mirakl Connector: «Esta ligação não tem nenhuma instância Mirakl configurada.»Quando aparece no Mirakl Connector o aviso de ligação sem instância Mirakl configurada, que condição o provoca e o que fazer quando surge.O que faz o botão Testar Ligação do Mirakl Connector, passo a passoO que faz o botão Testar Ligação do Mirakl Connector no Odoo: quando aparece, o que verifica, o que guarda na ficha e que erros pode dar.
Verificado no código do conector (versão 20.0) e nas fontes indicadas

Fontes