Automatizar Facturas e Fornecedores com o OpenClaw: Extracção PDF, OCR, Validação e Registo Automático
Toda a pequena empresa e freelancer conhece o ritual: receber uma factura em PDF, abrir, ler o número, o NIF, o valor, o IVA, digitar tudo na contabilidade, verificar se já foi registada, arquivar o ficheiro. São 5 minutos por factura — mas com 20 facturas por semana são quase 2 horas de trabalho repetitivo onde cabem erros de transcrição. Neste tutorial vais criar um agente OpenClaw que recebe facturas em PDF, extrai automaticamente os campos, valida os totais, detecta duplicados, regista tudo na tua contabilidade e arquiva o original — com revisão humana apenas para os casos duvidosos.
O Problema: Facturas que Consomem Horas
O processamento manual de facturas é um dos maiores desperdícios de tempo na gestão de uma pequena empresa. Não é só a introdução de dados — é a verificação cruzada, a detecção de duplicados, o arquivo, e o acompanhamento de prazos de pagamento. Ferramentas SaaS de contabilidade resolvem parte do problema, mas a um custo mensal por utilizador e com fluxos fechados que nem sempre se adaptam à realidade portuguesa.
Com o OpenClaw, controlas todo o processo: que campos extrair, como validar, onde registar, e quando pedir revisão humana. E como o agente corre localmente, as tuas facturas — com NIFs, valores e dados de fornecedores — não saem do teu computador.
O Fluxo Completo
Email ou pasta
Texto do PDF
Campos da factura
Totais e duplicados
Contabilidade
PDF organizado
Passo 1: Receber as Facturas
A primeira decisão é como as facturas chegam ao agente. Há duas opções principais, e podes usar ambas:
- Pasta vigiada: crias uma pasta (ex.:
~/Facturas/entrada) e pedes aos fornecedores para enviar os PDFs, ou descarregas os PDFs do portal do banco. O agente processa cada ficheiro novo que aparece na pasta. - Email: configuras um endereço dedicado (ex.:
[email protected]) e ligas o OpenClaw via IMAP. Cada email com um PDF em anexo é processado automaticamente. Esta opção é mais conveniente para os fornecedores, mas exige cuidado com segurança (ver secção de boas práticas).
openclaw skill install pdf-extract# Criar o agente com uma pasta vigiada:
openclaw agent create facturas --skill pdf-extract --watch ~/Facturas/entrada
Os nomes exactos das skills e opções podem variar consoante a versão do OpenClaw e a skill que escolheres no ClawHub. Antes de instalar, verifica a reputação do autor e o resultado da análise de segurança, como explicamos no artigo sobre o ClawHub e o VirusTotal.
Passo 2: Extrair o Texto do PDF
Nem todos os PDFs nascem iguais. Há uma diferença fundamental que determina tudo o que se segue:
| Tipo de PDF | Como tratar |
|---|---|
| PDF digital (gerado pelo software do fornecedor) | Extracção directa do texto incorporado — rápido e preciso |
| PDF digitalizado (scan de papel) | OCR necessário — mais lento, com possíveis erros |
A boa notícia: a maioria das facturas modernas são PDFs digitais, gerados directamente pelo software de faturação do fornecedor. Para estas, a extracção de texto é instantânea e precisa. Para os PDFs digitalizados — ainda comuns com fornecedores mais antigos — precisas de OCR.
O agente pode detectar automaticamente o tipo de PDF e aplicar o método correcto:
1. Tenta extrair texto directo do PDF.
2. Se o texto extraído tiver menos de 50 palavras,
assume que é um scan e corre OCR.
3. Se o OCR também falhar, marca como
"revisão manual necessária" e não registas.
por. Se precisares de maior precisão com scans de baixa qualidade, existem skills no ClawHub que usam modelos de visão mais avançados, mas consomem mais recursos.
Passo 3: Extrair os Campos Estruturados
Ter o texto da factura não é suficiente — precisas de estruturar a informação em campos. Aqui é onde o modelo de linguagem do OpenClaw mostra o seu valor: em vez de expressões regulares frágeis que partem com cada novo layout de factura, o agente compreende o texto e extrai os campos por semântica.
Define um schema claro dos campos que precisas. Para a maioria das facturas portuguesas:
{
"numero": "string",
"data": "YYYY-MM-DD",
"fornecedor": {
"nome": "string",
"nif": "string"
},
"itens": [
{ "descricao": "string", "quantidade": "number", "preco_unitario": "number", "total": "number" }
],
"subtotal": "number",
"iva_taxa": "number",
"iva_valor": "number",
"total": "number",
"moeda": "string",
"metodo_pagamento": "string | null",
"prazo_pagamento": "YYYY-MM-DD | null"
}
As instruções do agente devem ser explícitas sobre o que extrair e como formatar:
A partir do texto da factura, extrai os campos
definidos em schema-factura.json. Regras:
- Formata datas como YYYY-MM-DD.
- Converte valores para números (ponto como
separador decimal, sem símbolo de moeda).
- Se um campo não existir na factura, usa null.
- Não inventes valores. Se o NIF não estiver
visível, escreve null, não adivinhes.
- Para o IVA, indica a taxa (6%, 13%, 23%) e o valor.
- Lista cada item da factura separadamente.
A regra "não inventes valores" é tão importante aqui como no tutorial de reuniões: um NIF errado ou um total inventado causa problemas contabilísticos reais. O agente deve marcar campos em falta como null, e esses casos vão para revisão humana no passo 5.
Passo 4: Validar Totais e Detectar Duplicados
A extracção não é o fim — é o meio. Antes de registar a factura, o agente valida a coerência dos dados:
O agente produz um relatório de validação junto com os dados extraídos:
Factura: FT 2026/1234 — Lda. Tecnologia, Lda.
Subtotal: 1.000,00 € OK
IVA (23%): 230,00 € OK
Total: 1.230,00 € OK
Duplicado: Não OK
NIF: 501234567 OK
Status: VÁLIDA — registar automaticamente
Passo 5: Registar e Arquivar
Com os dados validados, o último passo é colocá-los onde já trabalhas:
| Destino | O que é enviado |
|---|---|
| Google Sheets / Excel | Uma linha por factura, com todos os campos extraídos |
| Software contabilístico (API) | Registo directo se o software tiver API (ex.: SAGE, PHC, Jasmin) |
| CSV para import | Ficheiro CSV formatado para importação manual no contabilístico |
| Notificação (Slack/Telegram) | Resumo: "Factura FT 2026/1234 registada — 1.230,00 €" |
O PDF original é arquivado automaticamente numa estrutura organizada:
2026/
10-Outubro/
Lda-Tecnologia_FT-2026-1234.pdf
Almeida-Servicos_FT-2026-567.pdf
Passo 6: Escalar para Revisão Humana
Nem todas as facturas são processáveis com confiança total. O agente deve identificar três categorias de casos e tratá-los de forma diferente:
Boas Práticas: Dados Financeiros e RGPD
Facturas contêm dados pessoais e financeiros — NIFs, valores, dados de fornecedores. O tratamento destes dados tem implicações legais que não podem ser ignoradas.
Atenção aos modelos em nuvem. Se usares um modelo Claude ou GPT via API, o texto extraído da factura — incluindo NIFs e valores — é enviado para o fornecedor. Para a maioria das empresas isto é aceitável dentro dos termos de uso, mas para dados sensíveis (RH, saúde), usa um modelo local via Ollama.
Em caso de dúvida, consulta as orientações da CNPD ou o responsável pela protecção de dados da tua organização.
Ideias para Ir Mais Longe
Com o fluxo básico a funcionar, há extensões naturais que poupam ainda mais tempo:
- Lembretes de pagamento: o agente acompanha os prazos e envia lembretes 3 dias antes do vencimento, por Telegram ou email.
- Conciliação com extrato bancárico: compara as facturas registadas com os débitos do extrato e marca as que já foram pagas.
- Relatório mensal de gastos: no fim de cada mês, o agente produz um resumo por fornecedor, por categoria e por taxa de IVA.
- Integração com CRM: as facturas de clientes são ligadas às fichas do CRM, como no tutorial de automação de CRM.
- Notas de crédito: extende o schema para tratar notas de crédito com valores negativos e validar a sua coerência com a factura original.
Conclusão: Menos Digitação, Mais Decisão
O processamento de facturas é um dos casos de uso com retorno mais directo e mensurável do OpenClaw. Cada factura processada automaticamente são 5 minutos poupados, e cada erro de transcrição evitado é um problema contabilístico que não chega a existir. Começa com um fornecedor, em modo de revisão total, e expande à medida que a confiança cresce. Em poucas semanas, a introdução manual de facturas torna-se uma excepção, não a regra.