Exporta as tuas faturas para Excel ou para o teu ERP via API — sem trocar de software

Exporta as tuas faturas para Excel ou para o teu ERP via API — sem trocar de software

Quase todas as propostas de automação de faturas acabam da mesma forma: muda-te para a nossa plataforma. Passa os fornecedores, forma a equipa, reimporta três anos de histórico e depois — finalmente — deixa de digitar faturas.

É pedir muito para um problema que é, na verdade, estreito. Não tens um problema de ERP. Tens um problema de introdução de dados entre um PDF e um campo de software que já pagas.

A solução é tratar a extração como um serviço, não como uma plataforma. Entra um documento, saem dados estruturados, e esses dados aterram onde a equipa já trabalha: uma folha de cálculo ou a API do teu ERP.

Porque migrar costuma ser a resposta errada

O custo do tratamento manual está bem documentado. Os benchmarks do setor situam o custo total de processar uma fatura entre 10 e 22 dólares em fluxos manuais, caindo para poucos dólares — ou menos de um — quando a captura e a conciliação estão automatizadas (benchmarks Ardent Partners, dados de custo por fatura).

Repara no que está ali a ser avaliado: captura e digitação, não contabilidade. O teu ERP contabiliza bem. Lança, concilia, entrega declarações. A única coisa que não sabe fazer é ler o PDF de um fornecedor.

Trocar de ERP para resolver um problema de captura é como remodelar a cozinha porque a torneira pinga. Custa meses, quebra a continuidade dos relatórios, e a pessoa que realmente percebe o teu plano de contas passa o verão na migração em vez de fechar o trimestre.

O que «dados estruturados» tem mesmo de significar

A extração só é útil se a saída for previsível. «Lê a fatura» não é uma especificação. Antes de ligares seja o que for, define a forma exata do dado que esperas em cada documento:

• Cabeçalho: nome do fornecedor, NIF, número da fatura, data de emissão, vencimento, moeda.
• Totais: base tributável, taxa(s) e valores de IVA, retenção na fonte se aplicável, total a pagar.
• Linhas: um array — código de artigo, descrição, quantidade, preço unitário, total da linha, taxa por linha.
• Referência à origem: um link ou ID para o ficheiro original, para abrir o PDF num clique.

As linhas são onde a maioria das ferramentas falha em silêncio. Muitos OCR devolvem um cabeçalho decente e depois esmagam a tabela num bloco de texto. Se o teu ERP espera detalhe ao nível da linha — ou se repartes custos por centros —, uma extração só de cabeçalho não elimina a digitação: desloca-a.

E um campo que importa mais do que se pensa: um sinal de confiança ou de conciliação. Se a ferramenta te disser «este total não bate certo com a soma das linhas», encaminhas esse documento para revisão humana em vez de reveres todos.

Dois caminhos: ficheiro ou API

Via A — Excel/CSV

A opção subvalorizada. Se o fluxo real do teu contabilista é um modelo de importação, o trabalho terminado é um ficheiro que encaixa nesse modelo, não um painel.

Funciona bem quando:

• O ERP tem importação em lote (quase todos têm: faturas de fornecedor, lançamentos, linhas de compra).
• O volume é periódico e não contínuo: processas por lotes semanais ou no fecho.
• Queres alguém a olhar para a folha antes de se lançar o que quer que seja.

A mecânica para obter tabelas limpas a partir de documentos está em Como converter PDF para Excel automaticamente com a IA da WhappScan. O princípio: constrói a folha igual ao modelo de importação — mesma ordem de colunas, mesmo formato de data, mesmo separador decimal — para que importar seja um não-acontecimento.

Via B — API

Usa a API quando a fatura deve chegar ao ERP sem ninguém tocar num ficheiro. O esquema típico:

1. Chega o documento (WhatsApp, reencaminhamento de email, upload).
2. A extração devolve um JSON com os campos acima.
3. Uma camada intermédia — um script, um Zap, um cenário Make, uma Lambda — mapeia esses campos para o payload do ERP e chama o endpoint.
4. O ERP devolve um ID, que guardas junto ao documento original.

Essa camada de mapeamento é onde está o trabalho a sério, e vale a pena ser honesto: costumam ser 100–300 linhas de código. Não é um projeto de fim de semana, mas também não é uma migração. É a única parte específica do *teu* ERP.

O mapeamento: cinco decisões a tomar à partida

1. Identidade do fornecedor. Faz o match pelo NIF, nunca pelo nome. «ACME, Lda.», «Acme Lda» e «ACME LDA» são o mesmo fornecedor e três strings diferentes. Decide o que acontece quando o NIF é desconhecido: criar ficha em rascunho ou estacionar a fatura?

2. Códigos de artigo. Se lanças ao nível da linha, precisas de uma regra estável que converta o código do fornecedor no teu. Alguns imprimem dois códigos por linha — a referência deles e a do fabricante — e escolher o errado duplica-te o catálogo sem aviso.

3. Arredondamentos e impostos. Define a regra de conciliação e aplica-a: base + IVA − retenção = total, com um ou dois cêntimos de tolerância. O que não bater vai para revisão. Este único teste apanha mais erros reais do que qualquer percentagem de precisão no site de um fornecedor.

4. Duplicados. Chave: NIF do fornecedor + número da fatura. As pessoas reencaminham o mesmo PDF duas vezes; assume que vai acontecer todas as semanas.

5. Comportamento em caso de falha. E se o ERP devolver um 500? Retry com espera crescente, e operação idempotente para que a repetição não lance a fatura duas vezes.

Porque a IA ganha aos templates por fornecedor

O OCR clássico quer um template por fornecedor: coordenadas na página, uma zona para o total, outra para a data. Funciona lindamente até o fornecedor redesenhar a fatura, acrescentar uma segunda página ou alguém enviar uma foto torta — e aí falha em silêncio, o que é pior do que falhar com estrondo.

A extração baseada em modelos lê o documento como uma pessoa lê, por isso uma mudança de layout não a parte. Detalhámos isto em Porque é que os templates OCR por fornecedor se partem. Num projeto de integração isto pesa imenso: manter uma pipeline com templates é um imposto permanente, e cai sobre quem menos pode recusá-lo.

Onde entra o WhatsApp

A parte que toda a gente subestima é a recolha. Uma API de extração não serve de nada se as faturas continuam espalhadas por quatro caixas de correio, um grupo de WhatsApp e uma pasta no ambiente de trabalho de alguém.

O WhatsApp resolve isto porque já é onde estão os fornecedores, os encarregados de obra e o pessoal no terreno. Alguém fotografa a fatura, envia para um número, e a extração acontece à chegada: sem app para instalar, sem palavra-passe para memorizar, sem formação. A montagem prática está em Como automatizar a extração de faturas com WhatsApp e IA.

É a combinação que faz isto pegar: WhatsApp como entrada, API como saída, e o teu software atual intacto no meio.

O que aí vem — e porque a captura importa mais, não menos

É tentador assumir que a faturação eletrónica estruturada tornará tudo isto obsoleto. Não vai, e não tão cedo.

Na UE, o pacote IVA na Era Digital foi adotado a 11 de março de 2025 e entrou em vigor a 14 de abril de 2025, mas os requisitos de reporte digital para operações B2B transfronteiriças só se aplicam a partir de 1 de julho de 2030, com os sistemas nacionais a alinharem-se com a norma europeia até 1 de janeiro de 2035 (Comissão Europeia).

Em Espanha, o calendário do Verifactu foi adiado: os sistemas têm de estar adaptados antes de 1 de janeiro de 2027 para sociedades sujeitas a IRC e antes de 1 de julho de 2027 para os restantes (Agencia Tributaria). Se também operas em Espanha, vê o que o Verifactu muda mesmo na gestão de faturas.

Repara no que ambos regulam: como as faturas são emitidas, não como chegam as que recebes. Durante anos vais continuar a receber uma mistura de ficheiros estruturados, PDF e fotografias — e alguém tem de transformar as três coisas em linhas.

Um arranque realista

• Semana 1 — Escolhe os dez fornecedores com mais volume. Define a lista exata de campos. Passa essas faturas pela extração e compara com o que foi digitado à mão.
• Semana 2 — Constrói primeiro a exportação para Excel, mesmo que o objetivo seja a API. Torna as discrepâncias visíveis de imediato.
• Semana 3 — Liga a API para um único fornecedor, com tudo a entrar como rascunho no ERP. Ainda nada é lançado sozinho.
• Semana 4 — Acrescenta o teste de conciliação e a chave de duplicados. Os documentos limpos são lançados automaticamente; os restantes vão para revisão.

Ao fim de um mês vais saber a tua taxa real de processamento sem toque humano, e não terás mudado nada no software que a equipa usa todos os dias.

A WhappScan trata da metade da extração: os documentos chegam por WhatsApp, email ou upload e voltam como dados estruturados que podes levar para Excel ou empurrar para o teu ERP via API. Experimenta grátis em https://whappscan.com.