DATEV EXTF

Name: DATEV EXTF
Author: seamless.engineering

本地服务

seamless.engineering金融数据05 周前更新

代码仓库访问官网

关于 DATEV EXTF

DATEV EXTF 是面向会计流程的本地 MCP 服务，可检查并生成 Buchungsstapel 与 Debitoren/Kreditoren 文件。它按行和字段说明错误，并提供德语或英语结果。

主要功能

01校验 EXTF 文件或文本
02定位并解释错误与警告
03生成并校验 Buchungsstapel
04列出 DATEV 字段及说明
05提供修复导入的提示词

适用场景

01查明 DATEV 拒绝导入的原因
02将预订记录写入 EXTF 文件

MCP 相关

它向 MCP 客户端提供校验、错误解释、文件生成和列信息工具，并提供列与错误代码资源及修复提示词。服务在本机读取文件，不上传数据。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

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

启动命令npx -y @seamless-engineering/datev-extf-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@seamless-engineering/datev-extf-mcp0.1.0stdio

工具

收录的工具列表 · 更新于 3 周前

参数	类型	必填	说明
lang	enum	否	消息语言：de（默认）或 en。de \| en
path	string	否	此计算机上 CSV 文件的路径。相对路径将基于服务端的工作目录解析。
content	string	否	文件不存在时，作为文本传入文件内容。通过此方式无法检查编码。

详细介绍

datev-extf-mcp

用于校验和写入 DATEV-Format (EXTF) 文件的 MCP 服务：包括 Buchungsstapel（记账批次）和 Debitoren/Kreditoren（客户与供应商主数据）。询问 AI 助手 DATEV 为什么拒绝导入，或让它把一份记账清单转换成 DATEV 可接受的文件。

Deutsch: 一个用于检查和写入 DATEV-Format（EXTF）文件的 MCP 服务。询问您的 AI 助手 DATEV 为什么拒绝导入：它会列出每个错误的行、字段和通俗易懂的解释，例如 Umsatz 中用句点代替逗号、Belegdatum 缺少前导零，或在自动科目上使用了 BU-Schlüssel。

仅在本地运行。 服务在您的计算机上运行，并读取磁盘上的文件。不会上传任何内容，也无需账户或 API 密钥。
基于 @seamless-engineering/datev-extf 构建。其规则来自 DATEV 自有资料：developer.datev.de 上的 Formatbeschreibung、DATEV-Format Prüfprogramm 和 #REW 导入消息。
写入器生成的每个文件都能通过校验器检查。

更喜欢在浏览器中使用？同样的检查也可在 DATEV EXTF validator（英文版）中运行，而且同样无需上传。

安装

需要 Node.js 20 或更高版本。

Claude Code

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

Claude Desktop（claude_desktop_config.json）、Cursor（.cursor/mcp.json）及大多数其他客户端：

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

Claude Desktop，一键安装： 从最新版本下载 datev-extf-mcp.mcpb 并打开。也可以使用 ./scripts/bundle.sh 自行构建。

相对文件路径会相对于服务的工作目录解析，因此建议使用绝对路径。

工具

工具	功能
`validate_datev_extf`	检查文件（`path`）或粘贴的文本（`content`）。返回标头数据、错误与警告数量，以及每条发现的问题，包括行、字段、值和德语（`lang: "de"`，默认）或英语（`"en"`）说明。仅对文件检查编码。
`explain_datev_finding`	解释问题代码，例如 `amount-dot` 或 `bu-automatic`。
`write_buchungsstapel`	根据标头和记账行（金额以分为单位）构建 Buchungsstapel（Formatversion 13），进行校验，并将其以 Windows-1252 编码写入 `outputPath`，或返回 CSV 文本。
`list_datev_columns`	按位置列出 125 个 Buchungsstapel 列或 254 个 Debitoren/Kreditoren 列。

资源：datev-extf://columns/buchungsstapel、datev-extf://columns/debkred、datev-extf://findings/de 和 datev-extf://findings/en。

提示词：fix_datev_import 可校验文件，并针对生成该文件的导出提出修复建议。

示例

DATEV 为什么拒绝 ~/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. …

非税务建议

此服务检查的是格式，而非记账。它无法判断某笔交易的科目或税务代码是否正确，写入时也不会为其选择科目或税务代码。请与您的税务顾问商定。

DATEV 和 DATEV-Format 是 DATEV eG 的商标。本项目与 DATEV 无关联，也未获得 DATEV 的认可。

维护

由 seamless.engineering 为我们自己的生产环境维护：我们为商店、支付服务商和 ERP 提供托管式 DATEV 集成，服务完全托管于欧盟。欢迎提交问题和 PR，但不提供 SLA。

发布

在 package.json 中递增 version，在 server.json 中递增两个版本号，并在 manifest.json 中递增一个版本号，然后提交、更改标签并推送：git tag v0.1.1 && git push origin v0.1.1。发布工作流会通过可信发布机制将软件包发布到 npm（附带来源证明），随后将其发布到 MCP 注册表，名称为 engineering.seamless/datev-extf。

MIT 许可证。

支持 Markdown

登录后评论