@ekwo-ai/xaf

中文文档
0.25.2发布于 2026/11/13MITTypeScriptES Module零依赖构建来源已验证近 30 天下载 3209

在 TypeScript 中将 XML 审计文件财务(XAF, 第3.2和4.0版)——账户,当事人,期初余额和一年的每一笔交易——读入平方对象:金额为十进制字符串,文件本身的总和被检查,以及哪些不

中文使用文档
文档目录3 节
  1. 读什么
  2. 它的回报
  3. 来源

@ekwo-ai/xaf

读取一个 XML 审计文件财务 - 那个 XML 审计文件,美国宇航联合会, 当审计师或税务当局移交会计包时存档 要求一年的书——写入平面对象,在TypeScript中,没有 依赖性。 版本数 3.2 国家 财务报告和审定财务报表 4.0 (韩语) 读取,每个字由 其计划名称空间.

import { readXaf } from '@ekwo-ai/xaf';

const books = readXaf(bytes); // a string, or the bytes of the file

books.version;     // '4.0'
books.currency;    // 'EUR', from header/curCode
books.entries;     // [{ journal: 'VK', number: '2025001', date: '2025-01-15', lines: […] }, …]
books.opening;     // the obLine of the opening balance
books.openingDate; // opBalDate (3.2), or the first day of the year (4.0)
books.violations;  // a transaction that does not balance, totals the lines disagree with

读什么

书的一部分放在档案里
货币header/curCode
账户company/generalLedger/ledgerAccount数字 : accID, (中文(简体) ), accDesc, (中文(简体) ), accTp (单位:千美元)B, (中文(简体) ), P, (中文(简体) ), M,保留为书面)
缔约方company/customersSuppliers/customerSupplier数字 : custSupID, (中文(简体) ), custSupName, (中文(简体) ), eMail, (中文(简体) ), taxRegIdent, (中文(简体) ), commerceNr,第一个地址的国家
期初余额company/openingBalance/obLine数字 : accID, (中文(简体) ), amnt, (中文(简体) ), amntTp; 日期 opBalDate 在3.2中, header/startDate 在4.0中,无
条目company/transactions/journal (单位:千美元)jrnID, (中文(简体) ), desc(中文(简体) ) /transaction (单位:千美元)nr, (中文(简体) ), desc, (中文(简体) ), trDt(中文(简体) )
线条trLine数字 : accID, (中文(简体) ), desc, (中文(简体) ), amnt 财务报告和审定财务报表 amntTp (单位:千美元)D 或者说 C, (中文(简体) ), custSupID, (中文(简体) ), docRef (第一个是条目的参考文献), currency/curCode 财务报告和审定财务报表 curAmnt,并在3.2中 matchKeyID
  • 一个金额是 xsd:decimal;它的侧面是 amntTp。负数是 另一边.
  • 文件列出了自己的总数—— linesCount, (中文(简体) ), totalDebit, (中文(简体) ), totalCredit —— 说 期初余额和交易额,每笔交易均以 线条加起来是什么。 对自己有异议的文件或交易 这不能平衡, 回到书面, 有违章行为.
  • 编码是XML声明名称的编码——UTF-8或ISO-8859-1—— 和 UTF-8 当它命名为无时, 如 XML 提供 。 一个给别人取名的打电话者 拒绝而不是服从.
  • XML 由自己的严格阅读者阅读 : 没有 DOCTYPE , 没有实体 5 XML 预定义,大小、深度和元素计数的界限.

未读内容:3.2版的子编辑器(subledgers, (中文(简体) ), obSubledgers),其中按当事人重述了该行已说明的内容;增值税 代码和一行的税额; 期间; 变化的历史.

它的回报

所申报的形状 src/types.ts字段 字段,此寄存器中会计导出每个读取器的形状 自己宣布,加上 version 文件与文档 openingDate 联 合 国 其期初余额。 数量是十进制字符串,绝不是负数. 什么是没有 审计文件被丢弃为 BooksFileError 带有 code。 。 。 .

它不知道会计科目表: 电子操作系统 信件由 ekwo import xaf <file>。 。 。 .

来源

格式于2026年9月24日从荷兰税中读出 行政部门在其开发商门户网站上发表—— XmlAuditfileFinancieel3.2.xsd 财务报告和审定财务报表 XmlAuditfileFinancieel4.0.xsd时,保持 test/xsd/ 以及门户的网页: 审计文件Financieel(XAF)诉3.2.1, (中文(简体) ), XMLAuditfile Financieel (XAF) v 4.0.3 存档副本, (中文(简体) ), Achtergrond 信息学 XAF4.0。 。 。 .

这是针对审计档案写的 精确在线 出口作为它的帮助 中心在同一天描述: Xml- formaat (XAF) 出口商的审计文件 —— 说 进出口 > 导出 > 审计文件; 未处理的条目未在 档案. ekwo import exact-online <file> 与 ekwo import xaf。 。 。 .

固定装置 test/fixtures/,每个版本一个,用手写,拿着 没有真实数据, 并且通过校正其版本的图案 test/schema.test.ts。 。 。 .

麻省理工学院.

版本与发布记录

@ekwo-ai/xaf 共发布 25 个版本,首次发布于 2026/09/28;过去 12 个月发布了 25 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.25.2latest2026/11/13今天
0.25.02026/11/076 天前
0.24.12026/11/059 天前
0.24.02026/10/2816 天前
0.23.02026/10/2816 天前
0.22.02026/10/2816 天前

关于 @ekwo-ai/xaf 的常见问题

@ekwo-ai/xaf 是什么?

在 TypeScript 中将 XML 审计文件财务(XAF, 第3.2和4.0版)——账户,当事人,期初余额和一年的每一笔交易——读入平方对象:金额为十进制字符串,文件本身的总和被检查,以及哪些不

如何安装 @ekwo-ai/xaf?

在项目目录运行 npm install @ekwo-ai/xaf,或使用 pnpm add / yarn add / bun add。

@ekwo-ai/xaf 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@ekwo-ai/xaf 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@ekwo-ai/xaf 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@ekwo-ai/xaf 可以商用吗?

@ekwo-ai/xaf 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@ekwo-ai/xaf 的下载量有多少?

根据 npm 官方下载统计,@ekwo-ai/xaf 在 2026/10/13 – 2026/11/11 这 30 天内被下载 3,209 次,日均约 107 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@ekwo-ai/xaf 还在维护吗?

最新版本 0.25.2 发布于 2026/11/13(今天);至今共发布 25 个版本,其中过去 12 个月发布了 25 个;首次发布于 2026/09/28。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。