FEC Checker (French accounting file pre-audit)

fec-lint

English · Français

技术检查，不提供税务建议。 fec-lint 根据已发布的 FEC 格式检查文件结构。它不会认证文件，也不能替代会计师的审核。

Contrôle technique, pas un conseil fiscal. fec-lint vérifie la structure d'un fichier au regard du format FEC publié. Il ne certifie pas un fichier et ne remplace pas la revue d'un expert-comptable.

---

English

用于法国 FEC 文件（Fichier des Écritures Comptables，LPF 第 A47 A-1 条）的免费结构检查工具，支持命令行和 MCP 服务。

它检查什么文件？

由会计软件导出的 FEC（在年末菜单中查找「FEC」或「Export DGFiP」）；无需手动创建。它是一个名为 SIRENFECAAAAMMJJ.txt（SIREN、FEC、结账日期）的文本文件，以制表符或竖线分隔，包含以下表头和每个会计分录一行：

JournalCode|JournalLib|EcritureNum|EcritureDate|CompteNum|CompteLib|CompAuxNum|CompAuxLib|PieceRef|PieceDate|EcritureLib|Debit|Credit|EcritureLet|DateLet|ValidDate|Montantdevise|Idevise
VE|Ventes|000039|20250610|411000|Clients|CLI001|Atelier Durand|F2025-06|20250610|Facture F2025-06 Atelier Durand|3960,00|0,00|||20250610||

日期格式为 AAAAMMJJ；金额使用小数逗号，不使用千位分隔符。CompAuxNum/CompAuxLib、EcritureLet/DateLet 和 Montantdevise/Idevise 可以为空，但必须成对为空；其他所有字段均为必填项。FEC Checker 页面提供完整的逐列表格。虚构示例见 tests/fixtures/。

安装

pipx install fec-lint

命令行

fec-lint 123456782FEC20251231.txt

123456782FEC20251231.txt: FAILED (encoding utf-8, separator pipe, lines 214)
  error date_invalid x3: Non-existent date in EcritureDate. - line(s) 21, 22, 23
  error date_format x3: Wrong date format in EcritureDate (expected AAAAMMJJ). - line(s) 64, 65, 66
Structure has errors. Full pre-audit (balance, numbering, risk signals): https://apify.com/highfiddle/fec-checker

• --json 输出完整结果：{ok, file, errors[], warnings[], stats}。
• --name 123456782FEC20251231.txt 设置要与 SIRENFECAAAAMMJJ.txt 比对的名称。
• --quiet 隐藏最后一行。
• 退出代码：结构正确时为 0，存在错误时为 1，无法读取文件时为 2。可以一次提供多个文件。
• 包含且仅包含一个 .txt FEC 的 .zip 文件会先解压。

MCP 服务

将其添加到 MCP 客户端（Claude Desktop、Claude Code、Cursor 等）：

{
    "mcpServers": {
        "fec-lint": {
            "command": "uvx",
            "args": ["--from", "fec-lint", "fec-lint-mcp"]
        }
    }
}

如果不使用 uv，请通过 pipx install fec-lint 安装，并使用 "command": "fec-lint-mcp"。该服务提供一个工具 lint_fec(path)，接收本地文件路径，并返回与 --json 相同的 JSON。

通过托管 MCP 服务进行完整预审。 付费版 FEC Checker（余额、编号、风险信号、AI 修复清单）运行在 Apify 上，可通过 MCP 访问。用户使用 Apify OAuth 登录；Agent 可以通过添加 &payment=x402 使用 x402 付款：

claude mcp add --transport http fec-checker "https://mcp.apify.com/?tools=highfiddle/fec-checker"

免费版与完整预审

检查项	fec-lint（免费）	Apify 上的 FEC Checker
文件名 SIRENFECAAAAMMJJ.txt、SIREN 密钥	✅	✅
编码、分隔符、18 个表头	✅	✅
字段格式：日期、金额、必填字段、成对字段	✅	✅
每笔分录及整个文件的余额	—	✅
EcritureNum 缺失与重复、ValidDate 时序	—	✅
风险信号：周末、节假日、整数金额、Benford、现金 53x、暂记账户 471、年末后	—	✅
判定结果、0-100 分、AI 编写的修复清单（法语/英语）	—	✅
运行位置	本地运行，不会有数据离开你的设备	在 Apify 上运行，按文件付费

---

Français

Linter structurel gratuit pour les FEC (Fichier des Écritures Comptables, art. A47 A-1 LPF), en ligne de commande et en serveur MCP.

Quel fichier contrôle-t-il ?

Le FEC exporté par votre logiciel comptable (cherchez « FEC » ou « Export DGFiP » dans le menu de clôture) ; vous ne le construisez pas à la main. C'est un fichier texte nommé SIRENFECAAAAMMJJ.txt (SIREN, FEC, date de clôture), séparé par tabulations ou barres verticales, avec l'en-tête et le type de ligne montrés plus haut.

Les dates sont au format AAAAMMJJ ; les montants utilisent la virgule décimale, sans séparateur de milliers. CompAuxNum/CompAuxLib, EcritureLet/DateLet et Montantdevise/Idevise peuvent être vides, mais seulement par paires ; tous les autres champs sont obligatoires. La page FEC Checker détaille chaque colonne. Des exemples fictifs sont dans tests/fixtures/.

Installation

pipx install fec-lint

命令行

fec-lint 123456782FEC20251231.txt

• --json 显示完整结果：{ok, file, errors[], warnings[], stats}。
• --name 123456782FEC20251231.txt 指定要根据 SIRENFECAAAAMMJJ.txt 检查的文件名。
• --quiet 隐藏最后一行。
• 退出代码：结构正确时为 0，出错时为 1，文件无法读取时为 2。可以一次传入多个文件。
• 首先会解压包含单个 FEC .txt 文件的 .zip。

消息为英文；规则代码（date_invalid、header_missing 等）保持稳定。

MCP 服务

使用上述配置将其添加到 MCP 客户端（Claude Desktop、Claude Code、Cursor 等）。工具 lint_fec(path) 接收本地文件路径，并返回与 --json 相同的 JSON。

通过托管 MCP 服务进行完整预审。 付费的 FEC Checker（余额、编号、风险信号、AI 修正方案）运行于 Apify，可通过 MCP 使用：https://mcp.apify.com/?tools=highfiddle/fec-checker（通过 Apify OAuth 登录；Agent 可使用 &payment=x402 通过 x402 付费）。

免费检查与完整预审

检查项	fec-lint（免费）	Apify 上的 FEC Checker
文件名 SIRENFECAAAAMMJJ.txt，SIREN 校验键	✅	✅
编码、分隔符、18 列	✅	✅
格式：日期、金额、必填字段、字段组合	✅	✅
按分录及整个文件检查余额	—	✅
EcritureNum 中断与重复、ValidDate 时间顺序	—	✅
风险信号：周末、节假日、整数金额、Benford、现金账户 53x、待处理账户 471、结账后记录	—	✅
判定结果、0-100 评分、AI 撰写的修正方案（FR/EN）	—	✅
执行方式	在本地运行，不会有任何内容离开您的计算机	在 Apify 上运行，按文件付费

---

开发

python -m venv .venv
.venv/bin/pip install -e ".[test]"   # Windows: .venv\Scripts\pip
pytest

tests/fixtures/ 中的样例文件是合成 FEC 文件（虚构的 SIREN 123456782）。MIT 许可证。