Pular para o conteúdo principal

Mercury

Disponível

Esta integração está disponível no Frihet. Configure-a em Settings → Integrações → Mercury.

Conecte sua conta Mercury ao Frihet para importar automaticamente as transações da sua conta bancária como despesas. Mercury é o banco preferido por startups e empresas de tecnologia, e com esta integração você pode manter suas despesas atualizadas no Frihet sem entrada manual.

Para que serve?

  • Importar transações como despesas — Os pagamentos e encargos realizados via Mercury são importados como despesas no Frihet com descrição, valor, data e moeda.
  • Somente débitos — São importadas unicamente as transações de débito (dinheiro que sai), não as receitas.
  • Controle de burn rate — Combinado com suas faturas no Frihet, você tem visibilidade completa de receitas vs despesas para controlar seu runway.
  • Deduplicação automática — As transações já importadas são identificadas por seu ID e não são duplicadas.

Requisitos

  • Conta ativa no Mercury
  • Plano Frihet Pro ou Business
  • API Token da Mercury

Como conectar

Passo 1: Obter seu API Token na Mercury

  1. Faça login em app.mercury.com
  2. Vá para Settings no menu lateral
  3. Selecione Developers ou API
  4. Clique em Generate Token (Gerar token)
  5. Dê um nome descritivo, por exemplo "Frihet ERP"
  6. Selecione as permissões de somente leitura (Read) para transações.
  7. Copie o token gerado. Guarde-o em um local seguro, pois ele é exibido apenas uma vez.

Passo 2: Configurar no Frihet

  1. No Frihet, vá para Settings → Integrações
  2. Procure por Mercury e clique no card.
  3. Cole seu API Token no campo correspondente.
  4. Clique em Testar conexão para verificar se as credenciais estão corretas.
  5. Se a conexão for bem-sucedida, você verá a confirmação com os dados da sua conta.
  6. Clique em Salvar.

Como funciona

O Frihet se conecta à API da Mercury usando seu API Token com autenticação Bearer. Ao iniciar uma importação, o Frihet consulta as transações de suas contas na Mercury e registra as transações de débito como despesas no Frihet.

A importação é sob demanda. Somente transações de débito concluídas são importadas — pagamentos a fornecedores, transferências de saída, assinaturas, etc. Depósitos e receitas não são importados.

Mapeamento de dados

Dado na MercuryCampo no Frihet
Descrição da transaçãoDescrição da despesa
Valor (débito)Valor da despesa
Data da transaçãoData da despesa
MoedaMoeda da despesa
Contrapartida / beneficiárioNotas da despesa

Casos de uso

Startup em fase seed

Você acabou de fechar uma rodada de investimento e precisa controlar o burn rate. Você importa as transações da Mercury para o Frihet toda semana para ver exatamente quanto está gastando e em quê. Combinado com suas receitas faturadas no Frihet, você tem uma imagem clara do seu runway.

SaaS com despesas recorrentes

Você paga infraestrutura (AWS, Vercel, Cloudflare), ferramentas SaaS e serviços profissionais via Mercury. Em vez de registrar cada encargo manualmente, você importa tudo para o Frihet e o categoriza para saber quanto custa operar seu produto.

Fundador com múltiplas contas

Você tem conta operacional e conta de reserva na Mercury. Você pode importar transações de ambas as contas para o Frihet para ter um registro unificado de todas as suas despesas.

Solução de problemas

Erro de conexão

  • Verifique se o API Token está correto e não foi revogado.
  • Verifique se o token tem permissões de leitura sobre transações.
  • Se você regenerou o token na Mercury, atualize-o no Frihet.

Não são importadas transações

  • Somente transações de débito concluídas são importadas.
  • As transações pendentes ou em processamento não aparecem até que a Mercury as confirme.
  • Verifique o intervalo de datas selecionado.

Algumas transações não aparecem

  • As transferências internas entre contas Mercury podem ter um tratamento distinto.
  • Verifique se a conta específica tem movimentações no período selecionado.

Próximos passos