Automatize Seu Negócio: Frihet + Claude + n8n

O autônomo médio dedica 5-8 horas por mês a tarefas administrativas que um computador poderia fazer em segundos: enviar lembretes de cobrança, classificar despesas, gerar relatórios, criar faturas recorrentes. Não é que essas tarefas sejam difíceis. É que elas não deveriam exigir sua atenção.

Este tutorial ensina você a conectar três ferramentas — Frihet, Claude Code e n8n — para automatizar as partes do seu negócio que não precisam de um humano. Sem programar, sem consultores, sem pagar extra.

As três peças do quebra-cabeça

Frihet é o seu ERP. Onde vivem suas faturas, clientes, despesas e dados financeiros. O que o torna diferente é que ele tem:

• API REST aberta com documentação completa
• 14 eventos webhook que disparam ações automáticas
• Servidor MCP que permite às IAs interagir com sua conta

n8n é o seu automatizador. Uma ferramenta visual que conecta aplicativos e cria fluxos de trabalho. Se X acontece, então faça Y. Sem código. Pode ser instalado em seu próprio servidor ou usar sua nuvem.

Claude Code é o seu assistente de IA. Com o servidor MCP do Frihet, Claude pode consultar seu faturamento, criar documentos e analisar suas finanças diretamente do terminal.

Automação 1: Lembretes de cobrança automáticos

A automação mais rentável. Cada fatura não paga que fica sem lembrete é dinheiro que demora mais para chegar — ou que não chega.

Como funciona

1. Frihet envia um webhook quando uma fatura muda para o status “vencida”
2. n8n recebe o webhook e espera 3 dias (período de carência)
3. Se a fatura continuar não paga, n8n envia um e-mail ao cliente com os dados da fatura
4. Se após mais 7 dias continuar não paga, n8n envia um segundo lembrete com tom mais firme
5. Se após 15 dias continuar não paga, n8n avisa você por Telegram ou e-mail

Configuração no n8n

O fluxo tem 5 nós:

Nó 1 — Webhook Trigger: Recebe o evento invoice.overdue do Frihet. O payload inclui o ID da fatura, cliente, valor e data de vencimento.

Nó 2 — Wait (3 dias): Pausa o fluxo por 3 dias corridos.

Nó 3 — HTTP Request (verificar status): Chama a API do Frihet para verificar se a fatura continua não paga. Se já estiver cobrada, o fluxo é interrompido.

Nó 4 — Email Send: Envia um e-mail ao cliente com o assunto “Lembrete: Fatura [número] pendente de pagamento” e inclui o link de pagamento.

Nó 5 — If/Else → Segundo lembrete ou notificação: Se após mais 7 dias continuar não paga, envia segundo e-mail. Se após 15 dias continuar, notifica você.

Automação 2: Resumo financeiro semanal

Toda segunda-feira às 9

Como funciona

1. n8n executa o fluxo toda segunda-feira às 9
   (gatilho programado)
2. Chama a API do Frihet para obter: faturas emitidas nesta semana, recebimentos, despesas registradas, faturas pendentes de cobrança
3. Calcula os KPIs: faturamento semanal, recebido vs pendente, despesas vs receitas
4. Formata a mensagem e a envia por e-mail ou Telegram

Dados que você pode incluir

• Faturas emitidas esta semana (número e total)
• Recebimentos esta semana
• Total pendente de cobrança
• Despesas registradas esta semana
• Balanço líquido (recebido - despesas)
• Faturas que vencem esta semana (urgentes)

Este fluxo utiliza apenas endpoints GET da API do Frihet. Não modifica nada, apenas lê dados e os apresenta de forma útil.

Automação 3: Fatura automática via Stripe

Se você vende online e cobra com Stripe, pode gerar a fatura no Frihet automaticamente quando recebe um pagamento.

Como funciona

1. Stripe envia um webhook para n8n quando um pagamento é concluído (payment_intent.succeeded)
2. n8n extrai os dados do pagamento: cliente, valor, conceito, moeda
3. n8n busca o cliente no Frihet por e-mail. Se não existe, o cria
4. n8n gera a fatura no Frihet com os dados do pagamento
5. Frihet envia a fatura ao cliente por e-mail automaticamente

O resultado

Seu cliente paga em seu site → recebe a fatura em seu e-mail em menos de um minuto → a fatura fica registrada em seu ERP com todos os dados fiscais corretos. Sem que você precise tocar em nada.

Esta automação é especialmente útil para:

• Lojas online (Shopify, WooCommerce com Stripe)
• SaaS com assinaturas recorrentes
• Cursos e produtos digitais
• Serviços com pagamento online

Claude Code + MCP: seu gestor de IA

O servidor MCP do Frihet permite que o Claude Code interaja diretamente com sua conta. Não é uma API genérica: é um protocolo projetado para que as IAs entendam e operem seu ERP.

O que Claude pode fazer com o MCP do Frihet

• Consultar seu faturamento do mês atual
• Listar faturas pendentes de cobrança
• Criar um orçamento para um cliente
• Buscar um cliente por nome ou NIF
• Ler as métricas do dashboard financeiro
• Gerar uma fatura a partir de uma descrição em linguagem natural

Exemplo real

Você abre o Claude Code e escreve:

"Crie uma fatura para Empresa ABC por 3 horas de consultoria a 80 EUR a hora, com 21% de IVA"

Claude usa o MCP do Frihet para:

1. Buscar o cliente “Empresa ABC” em seu banco de dados
2. Criar a fatura com 3 linhas de 80 EUR + 21% IVA
3. Calcular o total (290,40 EUR)
4. Confirmar os dados antes de emitir

Você não copia dados. Não abre o ERP. Não calcula IVA. Você diz o que precisa e a fatura é gerada.

Como instalar o MCP

O servidor MCP do Frihet está publicado no npm:

npx @frihet/mcp-server

Ele é configurado com sua chave de API do Frihet e fica disponível para o Claude Code automaticamente. A documentação completa está em docs.frihet.io/mcp.

Automação 4: Classificação automática de despesas

Quando você registra uma despesa no Frihet (por OCR ou manualmente), pode automatizar sua categorização:

1. Frihet envia um webhook quando uma nova despesa é criada
2. n8n recebe a despesa com os dados do OCR (fornecedor, valor, conceito)
3. n8n aplica regras: se o fornecedor é um posto de gasolina → categoria “transporte”; se é um restaurante → “refeições”; se é Amazon → “material de escritório”
4. n8n atualiza a categoria da despesa no Frihet via API

As regras são suas. Você pode torná-las tão simples (por fornecedor) ou tão complexas (por valor + fornecedor + dia da semana) quanto precisar.

Por que isso só funciona com Frihet

A automação requer três coisas que a maioria dos ERPs espanhóis não oferece:

API aberta em todos os planos. Anfix cobra 80 EUR/mês pela API. Quipu a limita ao plano Solution (25 EUR/mês). Holded a restringe a planos superiores. Frihet a inclui no plano gratuito.

Webhooks reais. 14 eventos que são disparados em tempo real: fatura criada, fatura paga, fatura vencida, despesa registrada, cliente criado, orçamento aceito, e mais. Sem webhooks, cada automação requer polling (perguntar constantemente se algo mudou), o que é ineficiente e lento.

Servidor MCP. Nenhum outro ERP espanhol tem MCP. Isso significa que Frihet é o único que pode interagir nativamente com assistentes de IA como Claude. Não é um plugin ou um hack: é um protocolo padrão projetado pela Anthropic para que as IAs e as ferramentas falem a mesma língua.

Comece com uma automação

Você não precisa montar tudo de uma vez. Escolha a automação que mais lhe economiza tempo — para a maioria dos autônomos são os lembretes de cobrança — e configure-a esta semana.

Uma vez que funciona, você adiciona a próxima. E a próxima. Em um mês, seu negócio administrativo é gerenciado 80% sozinho. E você dedica essas 5-8 horas mensais ao que realmente gera receita.