# @ekwo-ai/vat-consignment 中文文档

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

版本：0\.25\.2
npm 元数据更新时间：2026-11-13T14:11:45.214Z
中文译文更新时间：2026-11-14T02:17:18.174Z
软件包许可：MIT

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

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

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

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

## 中文简介

比利时定期在TypeScript中为Intervat(VATCondignment XML,schema NewTVA-in v0.9)缴纳增值税,从数字上看,已申报。 零从属.

## 安装

```sh
npm install @ekwo-ai/vat-consignment
```

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

## README

# `@ekwo-ai/vat-consignment`

比利时人 **增值税定期收益** - XML Intervat 按月计算 或季度声明 – 在 TypeScript 中,没有依赖性.

给它数字 一个申报 并给你的文件,a 名称,以及无法放入的列表.

```ts
import { generateVatConsignment } from '@ekwo-ai/vat-consignment';

const { file, filename, violations } = generateVatConsignment(boxes, {
  declarant: { vatNumber: '0999999999', name: 'Demo', countryCode: 'BE' },
  period: { year: 2026, quarter: 4 },
});
```

`boxes` 是电网,电网持有的电网, 和数量:

```ts
[
  { box: '03', kind: 'base', amount: '10000.00' },
  { box: '54', kind: 'tax', amount: '2100.00' },
  { box: '71', kind: 'total', amount: '2100.00' },
]
```

的行形状 `tax_filing_boxes` 内 [电子操作系统](https://github.com/Ekwo-ai/ekwo-os) 数字 **就像他们曾经一样 备案时被冻结**。这就是对目的的投入:交存的必须是 申报内容 以及从分类账中重算的文件 不同于它要携带的档案.

## 它会做什么

-   写一个 `VATConsignment` 持有一个 `VATDeclaration` (单位:千美元)`generateVatConsignment`)或给予多少 (单位:千美元)`generateVatConsignments`, (中文(简体) ), **行政部门对计划的有效性 发表** ——本包本身的测试中逐一检查.
-   写下 **代表** 他为报应者而备案 一个 计划重复 `VATDeclaration` 数起他们 `VATDeclarationsNbr`:它是为了让公司将所有的回报存入 其客户在一个文件中,以自己的名义。 块是可选的 **每个 需要其中的字段**,所以代表完全被命名,或者 - 既未完成也未撤销,因为文件 其代表被派到另一个当局,而不是 一个是本意。 发布其识别特征的国家是 `ISSUERS`, (中文(简体) ), 计划本身的列表而不是ISO的列表: 希腊是 `EL` 在这里.
-   除非另有说明,否则按位置对运出的货物进行编号, 拒绝两个不到一个号码, 并说每一次违反 它返回是 进去.
-   每个网格的数字有两位数字: `3` 财务报告和审定财务报表 `03` 是同一个网格,和 表格写出第二个.
-   零点留下一个网格 缺失的网格读取为 0,返回为 写出它的三十个空盒子是没人会看的.
-   写入 a **无返回作为返回**。计划要求 `Data` 和至少 一个 `Amount` 在大地上,你绝不要说出什么,故你应当说出一个空虚的时期 说它必须说的一件事—— 什么都不欠—— 在网格71,即 带着欠下的电网 此软件包的选择, 由 计划( 而不是它所指定的)`NIL_GRID`) (中文(简体) ).
-   总是写 `ClientListingNihil`因为计划要求每一次 返回,并默认为 `NO` - 没有索赔,而不是声称 将会有一个列表.
-   命名它取代的声明, 在 `ReplacedVATDeclaration`当它是一个 更正:通过 `replacedDeclaration` intervat提供了第一个 一个.
-   写出两个小数和一个分数。 法语网页 行政部门以逗号显示示例; 计划没有 验证员拒绝 .
-   为未给予的字段写出任何内容 。 一个电话号码发明到 满足验证人作为电话号码前往行政部门的要求 计划,它发现, 不要求一个.

## 何谓是违规

其余文件仍然有效,因为一个拒绝存在的返回 一个无法读取的人物对任何人都没有帮助。 每一个都是一种计划 已经拒绝 —— 测试将每个都放回文件并观看验证 失败——这就是为什么他们违反这种形式,而不是对 这个包裹.

| 代码 | 何时 |
| --- | --- |
| `unknown_grid` | 盒子不是29个网格 计划列表(`GRIDS`(中文(简体) ) |
| `grid_twice` | 同样的网格被给予两次,作为基地和税收 |
| `negative_amount` | 数值低于零:每个网格是a `PositiveAmount_Type` |
| `amount_out_of_range` | 数量超过计划所能持有的数量 |
| `invalid_amount` | 金额不是数字 |
| `reference_too_long` | 声明者的参考文献有十四个以上字符—— 遗漏 |
| `invalid_phone` | 电话号码与20个数字不相配 |

`grid_twice` 这种格式不能坚持的一件事:它给每个网格一个 单值。 印出基数和同一行税的表格——法国人 CA3在08号线上确实没有代表 该文件,而不是数字的缺陷.

`negative_amount` 也值得一试 此表单绝不让网格下行 零:减少数字的方法有其自身的网格——48个和49个信用票据 61和62,用于规范化。 达到此包的负数字 意思是书把表里想要的东西抹了.

三件事被例外地拒绝 因为他们做了整个档案 毫无意义:一个既非一月又非一季度的时期,一个申报数字 计划无法维持, 并纠正它所取代的东西 形状但Intervat使用.

## 它不会做的

-   **它不存任何东西.** 上传文件需要证书, a 已验证的会话和待命人员; 这是操作的侧面 计划而不是图书馆.
-   **它不决定要求什么.** `Restitution` 财务报告和审定财务报表 `Payment` 为: 向行政部门提出的要求,而不是数字的后果,因此 默认为否,而呼叫者则说相反.
-   **它不声称有关年度客户名单的任何信息.** 要件 需要的,是写作的; `NO` 除非打电话的人另有说法.
-   **它不知道该代表是否拥有授权** 每个 宣说者. 这是行政部门的记录,而不是档案; 在那里,不在这里,没有一件货物就被拒绝.
-   **它计算什么.** 没有得出总数, 也没有从另一个网格填充 : 数字被冻结了,没有改变.

## 来源

-   [间歇](https://finances.belgium.be/fr/E-services/intervat) 服务 档案存放于SPF财务处及其技术文件处 并发布 XSD 计划.
-   司马 `NewTVA-in_v0_9.xsd`名称空间 `http://www.minfin.fgov.be/VATConsignment` 财务报告和审定财务报表 `http://www.minfin.fgov.be/InputCommon`。 。 。 .
-   1992年9月29日皇家第1号判决 税费税费税, **第18条** ——形式及其 帧; **第18条第1款** ——于该月20日提交 接下来.
-   代号为TVA, **第53条第1款,alinéa 第1款,2°** ——申报义务.

## 何为已核实,何为未核实

**已验证**: 这个软件包的每个形状的文件都写着—— 一个完整的回放, 一个最小的 一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一 代表,一名持有若干申报人的返回——验证 反对 `NewTVA-in_v0_9.xsd` 和它进口的四种计划 `test/schema.test.ts`,没有网络和系统工具。 网格列表为 将来源与计数计数比对, 因此,它不能从中漂移 代表身份标识。 显示缺少一个字段的代表 成为计划拒绝的 计划没有修改 `test/xsd/`, (中文(简体) ), 每个人从哪里来,包裹里没有他们.

这个砖头的第一版是用生产档案写的 说 这里没有读到计划。 看它发现四个缺陷一样 天数 : `Data` 财务报告和审定财务报表 `ClientListingNihil` 每笔金额都是正数 1,电网是关闭列表.

**未核实**: Intervat检查的内容 _外加_ 计划。 门户适用 商业控制——网格之间的算术,警告以说明理由 这些是形式规则,而不是档案规则。 回来 这在这里是有效的. `Justification` 财务报告和审定财务报表 `FileAttachment`,计划允许的,不是由 这个包裹还没有.

## 许可证

麻省理工学院. 见 [`LICENSE`](https://npmcn.com/package/%40ekwo-ai/vat-consignment/LICENSE)。 。 。 .

## 常见问题

### @ekwo-ai/vat-consignment 是什么？

比利时定期在TypeScript中为Intervat\(VATCondignment XML,schema NewTVA-in v0\.9\)缴纳增值税,从数字上看,已申报。 零从属\.

### 如何安装 @ekwo-ai/vat-consignment？

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

### @ekwo-ai/vat-consignment 支持 TypeScript 吗？

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

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

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

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

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

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

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

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

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

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

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