# @ekwo-ai/xaf 中文文档

规范地址：https://npmcn.com/package/%40ekwo-ai/xaf/

版本：0\.25\.2
npm 元数据更新时间：2026-11-13T14:11:43.697Z
中文译文更新时间：2026-11-13T18:21:54.968Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40ekwo-ai/xaf
原文对照：https://npmcn.com/package/%40ekwo-ai/xaf/?lang=original
项目主页：https://github.com/Ekwo-ai/ekwo-os/tree/main/packages/formats/xaf#readme
源码仓库：https://github.com/Ekwo-ai/ekwo-os

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：79.5 kB，23 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=18
- 运行依赖：0 个
- 首次发布：2026-09-28T08:51:42.315Z
- 最新版本发布：2026-11-13T14:11:43.225Z
- 近 30 天下载量：3209（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：25（近 12 个月 25 个）

## 中文简介

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

## 安装

```sh
npm install @ekwo-ai/xaf
```

也可以使用：`pnpm add @ekwo-ai/xaf`、`yarn add @ekwo-ai/xaf`、`bun add @ekwo-ai/xaf`

## README

# `@ekwo-ai/xaf`

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

```ts
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`](https://npmcn.com/package/%40ekwo-ai/xaf/src/types.ts)字段 字段,此寄存器中会计导出每个读取器的形状 自己宣布,加上 `version` 文件与文档 `openingDate` 联 合 国 其期初余额。 数量是十进制字符串,绝不是负数. 什么是没有 审计文件被丢弃为 `BooksFileError` 带有 `code`。 。 。 .

它不知道会计科目表: [电子操作系统](https://github.com/Ekwo-ai/ekwo-os) 信件由 `ekwo import xaf <file>`。 。 。 .

## 来源

格式于2026年9月24日从荷兰税中读出 行政部门在其开发商门户网站上发表—— `XmlAuditfileFinancieel3.2.xsd` 财务报告和审定财务报表 `XmlAuditfileFinancieel4.0.xsd`时,保持 [`test/xsd/`](https://npmcn.com/package/%40ekwo-ai/xaf/test/xsd/README.md) 以及门户的网页: [审计文件Financieel(XAF)诉3.2.1](https://odb.belastingdienst.nl/auditfiles/auditfile-financieel-xaf-v-3-2-1/), (中文(简体) ), [XMLAuditfile Financieel (XAF) v 4.0.3 存档副本](https://odb.belastingdienst.nl/auditfiles/xmlauditfile-financieel-xaf-v-4-0-3/), (中文(简体) ), [Achtergrond 信息学 XAF4.0](https://odb.belastingdienst.nl/auditfiles/achtergrond-informatie-xaf4-0/)。 。 。 .

这是针对审计档案写的 **精确在线** 出口作为它的帮助 中心在同一天描述: [Xml- formaat (XAF) 出口商的审计文件](https://support.exactonline.com/community/s/article/All-All-HNO-Task-general-importexport-gen-impexp-auditt?language=nl_NL) —— 说 _进出口 > 导出 > 审计文件_; 未处理的条目未在 档案. `ekwo import exact-online <file>` 与 `ekwo import xaf`。 。 。 .

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

麻省理工学院.

## 常见问题

### @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 和提交记录判断。