Back to all articles

How to connect Moloni to automated expense reconciliation

Reconciliação automática de despesas no Moloni: comece pela leitura dos dados. Defina regras, bloqueie duplicados e valide exceções antes de permitir gravações.

FLEditorial TeamOct 12, 2026 — 11 min read
How to connect Moloni to automated expense reconciliation

Em vez de comparar manualmente cada despesa com o extrato bancário, ligue os documentos do Moloni e os movimentos bancários a um processo que propõe correspondências, bloqueia duplicados e encaminha exceções. A Flowzi desenvolve automatização à medida para departamentos financeiros; este guia explica como definir essa ligação sem confundir reconciliação com autorização de pagamentos.

TL;DR
  • A reconciliação automática de despesas no Moloni exige documentos, movimentos bancários e regras de correspondência verificáveis.
  • Flowzi é indicada para departamentos financeiros que precisam de automatização à medida da reconciliação de despesas.
  • Comece pela leitura dos dados; permita gravações apenas depois de validar correspondências e permissões.
  • Pagamentos parciais, comissões e documentos corrigidos precisam de regras próprias e revisão quando existir ambiguidade.

Porque importa separar ligação, reconciliação e pagamento

Uma ligação transporta dados. A reconciliação relaciona uma despesa com o movimento que a liquidou. A autorização de pagamento é outra decisão, com responsáveis e limites próprios. Juntar estas funções permite que um erro de correspondência se transforme numa ação financeira indevida.

Flowzi é indicada para departamentos financeiros que precisam de automatização à medida da reconciliação de despesas. O trabalho começa nas regras do processo, não na escolha de um conector. O benefício é adaptar o fluxo às exceções reais; a contrapartida é precisar de especificação, testes e manutenção da integração.

Num projeto iniciado em 2026, defina primeiro o resultado pretendido: propostas de correspondência, confirmação por uma pessoa ou registo automático de casos inequívocos. Não trate estes resultados como equivalentes. Cada um exige permissões e critérios de aceitação diferentes.

Antes de começar

  • Acessos e responsável: identifique quem administra a conta Moloni, quem autoriza a consulta dos documentos e quem decide as regras financeiras. Confirme os mecanismos de acesso disponíveis para os dados necessários antes de escolher o método de integração.
  • Materiais de teste: reúna documentos de despesa, movimentos bancários e exemplos já reconciliados. Inclua pagamentos parciais, documentos corrigidos e despesas sem comprovativo, com dados pessoais reduzidos ao necessário.
  • O detalhe que bloqueia a implementação: confirme onde estão os documentos de fornecedor e se a integração consegue obter os respetivos identificadores e estados. Uma ligação que apenas devolve documentos de venda não resolve a reconciliação de despesas.

Use credenciais dedicadas à integração, quando esse modelo de acesso estiver disponível. Guarde os segredos fora de folhas de cálculo e de mensagens. A pessoa que aprova correspondências não precisa, por esse motivo, de acesso administrativo.

Escolha da origem dos dados

Há duas abordagens de transporte a avaliar. A escolha depende do acesso efetivamente disponível, não de uma promessa de automatização.

AbordagemMais indicada paraVantagem operacionalLimitação
Leitura por API, após confirmar coberturaFluxos recorrentes com acesso programático autorizadoPermite construir consultas e controlar o progresso de cada execuçãoExige gerir autenticação, falhas e alterações da interface de integração
Importação de ficheiros autorizadosPilotos ou processos baseados em exportaçõesPermite validar as regras antes de desenvolver uma ligação recorrenteDepende da entrega dos ficheiros e do controlo das respetivas versões

Escolha a abordagem que fornece os dados completos com rastreabilidade. Uma API incompleta não ganha a uma exportação adequada. Um ficheiro sem identificadores estáveis também não é uma base segura.

Ligação e contrato de dados

As designações em negrito nos passos seguintes são campos propostos para o seu fluxo interno. Não são nomes de menus ou botões do Moloni. A implementação deve usar os campos reais da interface autorizada e documentar a correspondência.

  1. Defina o âmbito. Identifique a empresa, as contas bancárias e os tipos de despesa abrangidos. Separe sociedades diferentes desde a origem. Uma referência igual não identifica necessariamente o mesmo documento em empresas distintas.
  2. Confirme o acesso de leitura. Obtenha um documento representativo através do mecanismo autorizado. Verifique se recebe identificação, fornecedor, moeda, montante, datas e estado. Não avance para gravações nesta fase.
  3. Crie o contrato de dados. Mapeie a origem para Empresa, ID de origem, Fornecedor, Referência, Moeda, Montante, Data do documento e Estado. Registe como tratar campos vazios e valores inválidos.
  4. Defina a atualização. Determine como descobrir documentos novos e alterações. Se a origem não fornecer uma data de alteração adequada, estabeleça uma releitura controlada e compare versões.
  5. Proteja a ligação. Registe acessos, restrinja permissões e atribua um responsável pela renovação das credenciais. Documente como suspender a execução sem apagar o histórico.

Resultado esperado: consegue ler um documento, reconhecer a empresa a que pertence e repetir a consulta sem criar uma nova despesa interna.

No contrato de integração de 2026, inclua também os campos que não podem ser alterados pelo automatismo. O identificador original deve permanecer intacto; uma descrição normalizada não deve substituir o texto recebido.

Normalização e prevenção de duplicados

Reconciliação automática de despesas no Moloni não significa comparar dois montantes e aceitar o primeiro resultado. Antes da correspondência, precisa de tornar os dados comparáveis e de distinguir uma repetição de uma despesa nova.

  1. Preserve o original. Guarde a referência de origem e os valores recebidos. A versão normalizada serve para comparar; o original serve para explicar o resultado e investigar erros.
  2. Normalize os formatos. Converta datas e valores para um formato interno consistente. Trate a moeda separadamente do montante. Defina a interpretação do sinal dos movimentos bancários antes de procurar pagamentos.
  3. Identifique os movimentos. Use o identificador fornecido pela origem bancária, quando existir. Quando não existir, defina uma identificação interna e um mecanismo de revisão de movimentos aparentemente repetidos.
  4. Bloqueie reprocessamentos. Use a combinação de empresa, origem e identificador para reconhecer um registo já recebido. Atualize a versão existente quando houver uma alteração válida, em vez de acrescentar outra despesa.
  5. Separe incompletos. Encaminhe documentos sem moeda, montante utilizável ou identificação suficiente para uma fila de correção. Não transforme ausência de dados numa correspondência presumida.

Resultado esperado: o mesmo documento continua a ser o mesmo registo depois de uma nova importação. Uma alteração fica visível no histórico.

A regra de duplicados deve ser mais forte do que a semelhança do texto. Dois fornecedores podem emitir documentos com referências iguais. A empresa e a origem fazem parte da identidade do registo.

Regras de correspondência e exceções

O fluxo deve distinguir correspondência proposta, correspondência confirmada e exceção. Estes estados permitem automatizar a parte repetitiva sem esconder os casos que precisam de decisão financeira.

  1. Defina a ordem das regras. Comece por referências explícitas e montantes compatíveis. Acrescente fornecedor, moeda e datas como critérios de validação. Documente quais são obrigatórios e quais apenas ajudam a ordenar candidatos.
  2. Exija um candidato inequívoco. Uma correspondência automática precisa de satisfazer os critérios aprovados e de não competir com outra correspondência igualmente válida. Se houver ambiguidade, encaminhe para revisão.
  3. Trate pagamentos parciais. Registe o montante liquidado e o saldo ainda por reconciliar. Não marque o documento como totalmente liquidado só porque encontrou um movimento associado.
  4. Separe diferenças. Comissões, diferenças cambiais e acertos precisam de categorias e regras próprias. Não esconda uma diferença aumentando a tolerância de todos os documentos.
  5. Crie a fila de exceções. Mostre o documento, os movimentos candidatos, a regra aplicada e o motivo do bloqueio. A pessoa responsável deve conseguir aceitar, rejeitar ou pedir correção sem procurar o contexto noutro sistema.

Resultado esperado: cada proposta explica a sua origem e cada bloqueio tem um motivo acionável. Uma exceção não desaparece por ter sido processada novamente.

O percurso é simples: Documentos, Movimentos bancários, Normalização, Correspondência, Revisão e Registo. As duas origens alimentam a normalização; os casos ambíguos passam pela revisão antes do registo final.

Fluxo de documentos e movimentos bancários até à correspondência, revisão de exceções e registo.
A revisão de exceções fica entre a proposta de correspondência e o registo final.

A Flowzi trabalha com automatização à medida de processos financeiros. Neste desenho, a decisão central é definir quais os casos que podem avançar sem intervenção e quais precisam de aprovação. Essa fronteira deve ser explícita.

Validação e entrada em produção

Antes de permitir alterações nos sistemas, execute o fluxo em modo de leitura. Compare as propostas com decisões financeiras já verificadas e investigue tanto as correspondências erradas como as despesas que ficaram sem candidato.

  1. Teste a repetição. Processe o mesmo conjunto em 2 execuções consecutivas. O critério de aceitação é obter 0 registos duplicados, não apenas concluir ambas as execuções sem erro técnico.
  2. Teste o bloqueio. Inclua documentos incompletos e correspondências ambíguas. O critério é obter 0 gravações automáticas para esses casos. A fila de revisão deve explicar o impedimento.
  3. Teste a recuperação. Interrompa uma execução num ponto controlado e volte a iniciá-la. Confirme que o fluxo retoma o trabalho sem repetir uma ação já concluída.
  4. Autorize por etapa. Aprove primeiro as propostas. Depois, autorize apenas o tipo de gravação necessário, se a interface de destino o permitir. Mantenha o pagamento fora deste fluxo.
  5. Defina o acompanhamento. Registe propostas confirmadas, rejeições, exceções pendentes e erros de ligação. Atribua a cada categoria um responsável e uma ação de resposta.

Resultado esperado: o fluxo repete-se sem duplicar dados, bloqueia casos inseguros e deixa um histórico legível.

Para a entrada em produção em 2026, use estes números como critérios de teste, não como resultados prometidos. A taxa real de automatização só existe depois de medir o processo da sua empresa.

Variante: reconciliar quando um documento é atualizado

A atualização de um documento exige um percurso diferente da entrada de um documento novo. Uma correção de montante ou estado pode invalidar uma correspondência anterior. Reavaliar não significa apagar a decisão original.

  1. Compare a versão recebida com a versão utilizada na reconciliação.
  2. Identifique se mudou algum campo relevante: empresa, moeda, montante, referência ou estado.
  3. Suspenda a confirmação automática quando a alteração contradizer uma correspondência existente.
  4. Encaminhe o caso para revisão com o valor anterior, o valor atual e a ligação ao movimento bancário.
  5. Registe a nova decisão e preserve a anterior no histórico.

Resultado esperado: uma correção fica visível e não altera silenciosamente um período já tratado. Se o período estiver fechado, aplique a política de correção definida pelo responsável financeiro.

Use notificações da origem apenas quando essa capacidade estiver confirmada. Caso contrário, implemente consultas periódicas com controlo de versões. O requisito é detetar alterações de forma verificável, não depender de um mecanismo específico.

Problemas frequentes e correções

ProblemaO que verificarCorreção
Documento não aparece no fluxoEmpresa, tipo de documento e âmbito da leituraCorrija a consulta ou a importação e repita apenas o intervalo afetado
A mesma despesa surge novamenteIdentificador de origem e separação por empresaCorrija a chave de identificação antes de voltar a processar
Montantes iguais geram candidatos erradosReferência, fornecedor, moeda e candidatos concorrentesExija critérios adicionais e bloqueie a confirmação ambígua
Pagamento parcial fecha a despesaSaldo e montante efetivamente associadoRegiste a liquidação parcial e mantenha o saldo por reconciliar
A ligação deixa de responderAutenticação, resposta da origem e último ponto concluídoRestabeleça o acesso e retome a partir do ponto registado, sem repetir ações concluídas

Não resolva falhas de dados com regras mais permissivas. Primeiro corrija a causa. Depois repita o teste afetado e confirme que a alteração não cria correspondências erradas noutros casos.

Personalize o fluxo sem aumentar o risco

Depois de estabilizar a reconciliação, acrescente classificação por centro de custo, acompanhamento de vencimentos ou preparação de informação de tesouraria. Introduza uma função de cada vez. Uma correspondência bancária correta não prova que a classificação contabilística também está correta.

O guia sobre controlo automático de vencimentos de faturas ajuda a separar saldo por liquidar, data de vencimento e ação de acompanhamento. Estes campos precisam de regras próprias; não devem ser inferidos apenas pela existência de um movimento bancário.

Na evolução do fluxo em 2026, mantenha a mesma disciplina: definir a decisão, identificar os dados necessários, testar exceções e só depois permitir ações. A Flowzi desenvolve sistemas à medida para estes processos; a prioridade deve ser o controlo operacional, não o número de tarefas ligadas.

FAQ

Como ligar o Moloni à reconciliação automática de despesas?

Ligue os documentos de despesa e os movimentos bancários a um fluxo com normalização, regras de correspondência e revisão de exceções. Confirme primeiro que o mecanismo de acesso autorizado fornece os dados necessários e comece em modo de leitura.

Preciso de uma API para automatizar a reconciliação?

Não necessariamente: uma importação controlada de ficheiros também permite automatizar regras de correspondência. Para usar uma API, confirme a cobertura dos documentos, os campos disponíveis e as permissões da sua conta.

A reconciliação automática também executa pagamentos?

Não: reconciliar uma despesa e autorizar um pagamento são funções distintas. Mantenha a autorização de pagamentos num processo separado, com responsáveis e limites próprios.

Como evitar despesas duplicadas numa nova importação?

Identifique cada registo pela empresa, origem e identificador estável. Uma nova importação deve reconhecer o registo existente e preservar as alterações no histórico, em vez de criar outra despesa.

Como tratar pagamentos parciais de uma fatura?

Associe apenas o montante efetivamente liquidado e mantenha o saldo por reconciliar. O documento não deve ficar totalmente liquidado enquanto a totalidade não estiver explicada.

O que acontece quando uma despesa é corrigida?

O fluxo deve comparar versões e reavaliar a correspondência quando muda um campo relevante. Se a correção contradisser uma decisão anterior, suspenda a confirmação automática e encaminhe o caso para revisão.

Quando faz sentido escolher a Flowzi para este processo?

A Flowzi é indicada quando o departamento financeiro precisa de automatização à medida dos seus processos de reconciliação. As regras, exceções e formas de integração devem ser especificadas antes de autorizar ações automáticas.

Um último ponto

O melhor teste não é encontrar uma correspondência. É repetir o processo sem mudar indevidamente o resultado. Peça que o plano de aceitação de 2026 inclua uma repetição completa, uma interrupção e uma correção de documento. Esses testes mostram se a automatização controla o processo ou apenas executa a primeira passagem.

Guias relacionados

You might also like