# @ekwo-ai/vd 中文文档

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

版本：0\.25\.2
npm 元数据更新时间：2026-11-13T14:09:58.273Z
中文译文更新时间：2026-11-14T03:03:13.304Z
软件包许可：MIT

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

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

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

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

## 中文简介

在TypeScript中,爱沙尼亚语形式为VD- uhendusesese kaibe aruanne:从平面语句行起的XML即为e-MTA载荷. 零从属.

## 安装

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

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

## README

# `@ekwo-ai/vd`

爱沙尼亚人 **窗体 VD** —— 说 _uhendusesese käibe 阿鲁安_报告 欧洲联盟营业额——以TypeScript为单位,不依赖.

给它复述语句的行, 它给你的XML e-MTA载荷,取名取出,并列出无法放入的.

```ts
import { generateVd } from '@ekwo-ai/vd';

const { file, filename, violations } = generateVd(rows, {
  registryCode: '19999999',
  year: 2026,
  month: 2,
});
```

`StatementRow` 是行形状 `ec_sales_list(company, from, to)` 函数 [电子操作系统](https://github.com/Ekwo-ai/ekwo-os),在此声明 没有进口的东西。 任何能够制作的簿记系统 这些列可以使用此软件包; 它没有读取数据库, 知道否 会计.

## 每个获得者一行,而不是自然界一行

此等事事先知后事. 表格 VD 每行打印一行 旁边有三分钱的客户 所以有个买家被提供 商品和服务 **一次**,有两个金额。 指示说 以无数字表示: _不得在 栏_,加载器按行号拒绝重复.

在欧洲,所有其他的复述声明都是相反的——比利时人 列出同一编号的3次,并附有3个操作代码。 所以这个 软件包将它给定的行合并,另一个格式的软件包不得合并.

| 栏 | 它所持有的 | 元素 |
| --- | --- | --- |
| 1个 | 收购人的国家代码 | `riik`,属性 `kmkrKood` |
| 2个 | 增值税号码, **没有国家前缀** | 案文 `kmkrKood` |
| 3个 | 货物应纳税价值 | `kaup` |
| 页:1 | 三角交易的价值 | `kolmnurktehing` |
| 页:1 | 服务的应纳税价值 | `teenusteMyyk` |

此套件执行的三笔金额中至少有一笔 留下一个收购者, 他的每笔钱都是白费的.

## 此规格来自

| 什麽 | 何处 |
| --- | --- |
| 技术科 携带他们全部 | [https://www.emta.ee/ariklient/e-teen-used-koolitused/e-teenuste-kasutamine/teenuste-tehniline-info#vd-aruanne 互联网档案馆的存檔,存档日期2013-12-21](https://www.emta.ee/ariklient/e-teenused-koolitused/e-teenuste-kasutamine/teenuste-tehniline-info#vd-aruanne) |
| 计划,服务于 `.xml` 扩展 | [https://www.emta.ee/sites/default/files/documents/2021-06/vorm vd xsd 2011.xml 互联网档案馆的存檔,存档日期2011-12-10](https://www.emta.ee/sites/default/files/documents/2021-06/vorm_vd_xsd_2011.xml) |
| XML 文件描述 | [https://www.emta.ee/sites/default/files/documents/2021-06/vorm vd xml kirjeldus 2011%281%29.tf](https://www.emta.ee/sites/default/files/documents/2021-06/vorm_vd_xml_kirjeldus_2011%281%29.rtf) |
| 一个完整的例子 | [https://www.emta.ee/sites/default/files/documents/2023-04/vorm vd xml 2011.xml](https://www.emta.ee/sites/default/files/documents/2023-04/vorm_vd_xml_2011.xml) |
| 装入器给出的错误信息 | [https://www.emta.ee/sites/default/files/documents/2023-01/vd vdp veateated 12012023.xlsx 互联网档案馆的存檔,存档日期2013-12-02](https://www.emta.ee/sites/default/files/documents/2023-01/vd_vdp_veateated_12012023.xlsx) |
| 表格背后的条例得到巩固 | [页:1](https://www.riigiteataja.ee/akt/107012021006) |

此软件包的输出已与该图案核对 `xmllint` 之前,它被承诺。 计划不是在这里运送的,而是属于 管理与它移动——因此测试套房证明了 文档而不是其有效性.

这两份文件值得了解:

-   **规格只见爱沙尼亚页.** 英文技术 页面中根本没有VD部分;其增值税页点取而代之的是KMD.
-   **`elementFormDefault` 实值 `unqualified`**,所以只有根带 名称空间前缀及其子孙为赤色。 公布的例子表明, 这个包裹就是这么写的.

## 数额

**整欧元**中,四舍五入,无小数 分隔器——表格上写着 `täiseurodes` 在每栏下,计划类型为: 三为 `xs:integer`,加载器拒绝 `1.5` 以名为相. **负值 允许**: 注销的发票或信用证在VD表格上报告,用于 以减号表示.

## 它拒绝什么,它报告什么

一个例外,因为它会让整个文件变得毫无意义: 一个月外 1至12,或登记代码长于计划持有的11个字符.

违反规定,因为一行错误,其余文件不是: 无论制片人标注什么, `unknown_nature`, (中文(简体) ), `wrong_currency`, (中文(简体) ), `no_vat_number`, (中文(简体) ), `country_code_length`, (中文(简体) ), `vat_number_is_the_declarer`, (中文(简体) ), `vat_number_shape` - 计划允许十二个字母,数字, `+` 财务报告和审定财务报表 `*` - 和 `nil_amounts`。 。 。 .

装载机还对照会员国验证每个数字的结构 它声称,但本套件没有: 每个国家形状表是 与表一起发布,属于谁想要支票,而不是文件 作者将持有一份会员国名单.

## 文件名称

**行政部门没有规定.** 技术说明没有规定 常规:e-MTA检查文件的页眉——申报码,年份, 月份——对照它正在被载入的报告,没有别的. `vdFileName` 我们的名字,一个打电话的人可以选择另一个.

## 装了两件东西

-   **一个负载取代报告中已经包含的所有内容**,是否装入 在未确认的报告上工作.
-   **没有零报告.** 没有欧盟供应的,以VD形式 未存档.

## 出乎意料的东西

-   **表格VDP,更正.** 它的存在,它被描述,它已经 **没有 文件格式**: e- MTA 提供从文件装入 VD 且仅是手动 用于 VDP 。 这里的任何内容都无法写在定义上 不存在.
-   **库存**,表格中的第6栏。 它是一个单独的计划 有自己的 命名空间, `VD_NV_toimingud`,它报告库存流动,而不是 供应.
-   **档案.** 此软件包会写字节; 电子 MTA 屏幕会让它们转动 并证实它是不可逆转的.

麻省理工学院.

## 常见问题

### @ekwo-ai/vd 是什么？

在TypeScript中,爱沙尼亚语形式为VD- uhendusesese kaibe aruanne:从平面语句行起的XML即为e-MTA载荷\. 零从属\.

### 如何安装 @ekwo-ai/vd？

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

### @ekwo-ai/vd 支持 TypeScript 吗？

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

### @ekwo-ai/vd 支持 ESM 还是 CommonJS？

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

### @ekwo-ai/vd 需要什么版本的 Node\.js？

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

### @ekwo-ai/vd 可以商用吗？

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

### @ekwo-ai/vd 的下载量有多少？

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

### @ekwo-ai/vd 还在维护吗？

最新版本 0\.25\.2 发布于 2026/11/13（今天）；至今共发布 31 个版本，其中过去 12 个月发布了 31 个；首次发布于 2026/09/19。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。