Facturolia

Leia e verifique e-faturas europeias (Factur-X, ZUGFeRD, XRechnung, UBL, CII) em conformidade com a EN 16931.

GitHubExperimente este MCPPatrocinado

Documentação

Servidor MCP Facturolia

tests

Permita que um assistente de IA leia e verifique faturas eletrónicas europeias.

Aponte o Claude (ou qualquer cliente compatível com MCP) para uma fatura .pdf ou .xml e ele responde com o conteúdo em linguagem simples, além de uma verificação de consistência em relação ao padrão europeu EN 16931.

Suporta Factur-X, ZUGFeRD, XRechnung, UBL e CII.

> Read ~/Downloads/invoice.pdf

Format: Factur-X / CII (EN 16931 (COMFORT) profile)
Invoice F-2026-0148 · issued 2026-07-15 · due 2026-08-14
Supplier: Studio Lumiere EURL
Customer: Cafe des Arts SARL
Total excl. VAT 1240.00 EUR · VAT 248.00 EUR · Total incl. VAT 1488.00 EUR

Lines (1):
  - Consulting : 2 x 620.00 EUR = 1240.00 EUR (VAT 20 %)

EN 16931 check: no anomalies found.

Por que isto existe

Uma fatura Factur-X é um PDF com dados estruturados escondidos no seu interior. A página que um humano lê e os dados que uma máquina importa são duas coisas diferentes, e nem sempre concordam. Este servidor expõe ambos, para que um assistente possa responder "o que está realmente neste ficheiro?" em vez de ler a página visível e esperar.

A França tornou a faturação eletrónica estruturada obrigatória para receção a 1 de setembro de 2026, por isso estes ficheiros estão agora a chegar às caixas de entrada normais.

Instalação

Sem dependências. Python 3.10 ou mais recente é tudo o que precisa.

  1. Descarregue facturolia_mcp.py.
  2. Obtenha uma chave de API gratuita em facturolia.fr/en/pricing.
  3. Adicione-a à configuração do seu cliente. Para o Claude Desktop, isso é claude_desktop_config.json:
{
  "mcpServers": {
    "facturolia": {
      "command": "python",
      "args": ["/absolute/path/to/facturolia_mcp.py"],
      "env": { "FACTUROLIA_API_KEY": "your-key" }
    }
  }
}

Reinicie o cliente. Duas ferramentas aparecem.

Ferramentas

FerramentaO que devolve
read_invoiceConteúdo completo: partes, datas, linhas, detalhe de IVA, totais, IBAN, além da verificação EN 16931
check_invoiceApenas o veredito de conformidade e anomalias, para "esta fatura está correta?"

Ambas aceitam um argumento, path, um caminho absoluto para um ficheiro .pdf ou .xml.

Configuração

VariávelPadrãoSignificado
FACTUROLIA_API_KEYobrigatórioA sua chave
FACTUROLIA_LANGenIdioma da resposta, en ou fr
FACTUROLIA_BASE_URLhttps://facturolia.frSubstituição para testes. Deve ser https:// (http:// simples apenas para localhost), caso contrário a chave não é enviada

Com FACTUROLIA_LANG=fr as respostas voltam em francês, com convenções de datas e rótulos francesas. As descrições das ferramentas permanecem em inglês para que todos os clientes as compreendam.

O que faz com o seu ficheiro

O ficheiro é enviado para a API Facturolia para ser analisado. É processado em memória e descartado imediatamente, nenhuma fatura é armazenada e o conteúdo não aparece nos registos técnicos. Os servidores estão na União Europeia.

Dito isto, isto não é processamento local. Se a sua política proíbe o envio de faturas para um serviço externo, use a API você mesmo dentro da sua própria rede em vez disso, ou não use este servidor.

Limites: 10 MB por ficheiro, apenas .pdf e .xml.

O que isto não é

Lê e verifica faturas. Não as emite, não as transmite, e não é uma solução de conformidade. Em França, o envio de uma fatura legalmente passa por uma plataforma acreditada (Plateforme Agréée). Esta ferramenta fica antes e depois desse passo, nunca no lugar dele.

Testes

Apenas biblioteca padrão, sem necessidade de rede:

python -m unittest discover -s tests

Ligações

Licença

MIT. Consulte LICENSE.