DATEV EXTF

datev-extf-mcp

Servidor MCP que valida e escreve arquivos no formato DATEV (EXTF): Buchungsstapel (lotes de lançamentos) e Debitoren/Kreditoren (dados mestre de clientes e fornecedores). Pergunte ao seu assistente de IA por que o DATEV rejeitou uma importação, ou peça para transformar uma lista de lançamentos em um arquivo que o DATEV aceita.

Deutsch: MCP-Server, der Dateien im DATEV-Format (EXTF) prüft und schreibt. Fragen Sie Ihren KI-Assistenten, warum DATEV einen Import ablehnt: Er bekommt jeden Fehler mit Zeile, Feld und einer verständlichen Erklärung, etwa Punkt statt Komma im Umsatz, fehlende führende Null im Belegdatum oder BU-Schlüssel auf Automatikkonten.

• Somente local. O servidor roda na sua máquina e lê arquivos do disco. Nada é enviado, e não há conta ou chave de API.
• Construído sobre @seamless-engineering/datev-extf. Suas regras vêm do material oficial do DATEV: a Formatbeschreibung em developer.datev.de, o DATEV-Format Prüfprogramm e as mensagens de importação do #REW.
• Todo arquivo gerado pelo escritor passa no validador.

Prefere um navegador? As mesmas verificações rodam no validador DATEV EXTF (Inglês), também sem upload.

Instalação

Requer Node.js 20 ou posterior.

Claude Code

claude mcp add datev-extf -- npx -y @seamless-engineering/datev-extf-mcp

Claude Desktop (claude_desktop_config.json), Cursor (.cursor/mcp.json) e a maioria dos outros clientes:

{
  "mcpServers": {
    "datev-extf": {
      "command": "npx",
      "args": ["-y", "@seamless-engineering/datev-extf-mcp"]
    }
  }
}

Claude Desktop, com um clique: baixe o datev-extf-mcp.mcpb da última versão e abra-o. Compile você mesmo com ./scripts/bundle.sh.

Caminhos de arquivo relativos são resolvidos em relação ao diretório de trabalho do servidor, então caminhos absolutos são a opção mais segura.

Ferramentas

Ferramenta	O que faz
validate_datev_extf	Verifica um arquivo (path) ou texto colado (content). Retorna dados do cabeçalho, contagens de erros e avisos, e cada ocorrência com linha, campo, valor e uma explicação em alemão (lang: "de", padrão) ou inglês ("en"). A codificação é verificada apenas para arquivos.
explain_datev_finding	Explica um código de ocorrência como amount-dot ou bu-automatic.
write_buchungsstapel	Constrói um Buchungsstapel (versão de formato 13) a partir de um cabeçalho e linhas de lançamentos (valores em centavos), valida e grava como Windows-1252 em outputPath ou retorna o texto CSV.
list_datev_columns	Lista as 125 colunas de Buchungsstapel ou 254 colunas de Debitoren/Kreditoren por posição.

Recursos: datev-extf://columns/buchungsstapel, datev-extf://columns/debkred, datev-extf://findings/de e datev-extf://findings/en.

Prompt: fix_datev_import valida um arquivo e propõe correções para a exportação que o gerou.

Exemplo

Por que o DATEV rejeita ~/Downloads/EXTF_Buchungsstapel.csv?

2 errors, 1 warning in 214 data rows (category buchungsstapel, encoding utf-8).
- warning [utf8-without-bom]: The file is UTF-8 without a byte order mark. DATEV then reads it as Windows-1252 and umlauts turn into garbage …
- error line 4 [amount-dot]: Amount “49.90” uses a dot as the decimal separator. DATEV expects a comma: 12.50 becomes 12,50.
- error line 9 [date-leading-zero]: Document date “506” has only three digits: the leading zero is gone. …

Não é aconselhamento fiscal

O servidor verifica o formato, não a contabilidade. Ele não consegue dizer se uma conta ou chave de imposto é correta para uma transação, e não as escolhe ao escrever. Combine isso com seu consultor tributário.

DATEV e DATEV-Format são marcas registradas da DATEV eG. Este projeto não é afiliado ou endossado pela DATEV.

Manutenção

Mantido pela seamless.engineering para nosso próprio uso em produção: executamos integrações DATEV gerenciadas para lojas, provedores de pagamento e ERPs, totalmente hospedados na UE. Issues e PRs são bem-vindos, sem SLA.

Lançamento

Atualize o version em package.json, ambas as versões em server.json e a em manifest.json, faça commit, depois crie a tag e envie: git tag v0.1.1 && git push origin v0.1.1. O fluxo de lançamento publica no npm com proveniência via trusted publishing e depois no MCP Registry como engineering.seamless/datev-extf.

Licença MIT.