DATEV EXTF

Valida y escribe archivos en formato DATEV (EXTF) localmente: Buchungsstapel y Debitoren/Kreditoren. Explica por qué DATEV rechaza una importación, línea por línea, en alemán o inglés, y crea lotes de contabilización que superan las comprobaciones.

GitHubPrueba este MCPPatrocinado

Documentación

datev-extf-mcp

Servidor MCP que valida y escribe archivos en formato DATEV (EXTF): Buchungsstapel (lotes de contabilización) y Debitoren/Kreditoren (datos maestros de clientes y proveedores). Pregúntale a tu asistente de IA por qué DATEV rechazó una importación, o haz que convierta una lista de contabilizaciones en un archivo que DATEV acepte.

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.

Solo local. El servidor se ejecuta en tu máquina y lee archivos del disco. Nada se sube, y no hay cuenta ni clave de API.
Construido sobre @seamless-engineering/datev-extf. Sus reglas provienen del material propio de DATEV: la Formatbeschreibung en developer.datev.de, el DATEV-Format Prüfprogramm y los mensajes de importación de #REW.
Cada archivo que produce el escritor pasa el validador.

¿Prefieres un navegador? Las mismas comprobaciones se ejecutan en el validador DATEV EXTF (English), también sin subir archivos.

Instalación

Requiere Node.js 20 o 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) y la mayoría de los demás clientes:

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

Claude Desktop, con un clic: descarga datev-extf-mcp.mcpb desde la última versión y ábrela. Constrúyela tú mismo con ./scripts/bundle.sh.

Las rutas de archivo relativas se resuelven contra el directorio de trabajo del servidor, por lo que las rutas absolutas son la opción más segura.

Herramientas

Herramienta	Qué hace
`validate_datev_extf`	Comprueba un archivo (`path`) o texto pegado (`content`). Devuelve datos de cabecera, recuentos de errores y advertencias, y cada hallazgo con línea, campo, valor y una explicación en alemán (`lang: "de"`, por defecto) o inglés (`"en"`). La codificación solo se comprueba para archivos.
`explain_datev_finding`	Explica un código de hallazgo como `amount-dot` o `bu-automatic`.
`write_buchungsstapel`	Construye un Buchungsstapel (versión de formato 13) a partir de una cabecera y filas de contabilización (importes en céntimos), lo valida y lo escribe como Windows-1252 en `outputPath` o devuelve el texto CSV.
`list_datev_columns`	Lista las 125 columnas de Buchungsstapel o las 254 de Debitoren/Kreditoren por posición.

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

Prompt: fix_datev_import valida un archivo y propone correcciones para la exportación que lo produjo.

Ejemplo

¿Por qué DATEV rechaza ~/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. …

No es asesoramiento fiscal

El servidor comprueba el formato, no la contabilidad. No puede decir si una cuenta o clave de impuestos es correcta para una transacción, y no las elige al escribir. Acuerda eso con tu asesor fiscal.

DATEV y DATEV-Format son marcas comerciales de DATEV eG. Este proyecto no está afiliado ni respaldado por DATEV.

Mantenimiento

Mantenido por seamless.engineering para nuestro propio uso en producción: gestionamos integraciones DATEV para tiendas, proveedores de pago y ERPs, totalmente alojadas en la UE. Issues y PRs bienvenidos, sin SLA.

Publicación

Incrementa version en package.json, ambas versiones en server.json y la de manifest.json, haz commit, luego etiqueta y empuja: git tag v0.1.1 && git push origin v0.1.1. El flujo de trabajo de publicación publica en npm con procedencia mediante trusted publishing, y luego al MCP Registry como engineering.seamless/datev-extf.

Licencia MIT.