@dojocoding/hacienda-shared

中文文档
0.13.0发布于 2026/11/01MITTypeScriptES Module构建来源已验证近 30 天下载 6353

Hacienda CR电子发票的共享类型、常数和注解

中文使用文档
文档目录6 节
  1. 目录
  2. 常数
  3. 类型
  4. 斯克马斯 (佐德)
  5. 安装
  6. 添加精确的 FE 普通计划

@dojocoding/hacienda-shared (英语)

哥斯达黎加电子发票的共享类型、常数、enums和Zod验证计划(Hacienda API v4.4).

此软件包由内部使用 @dojocoding/hacienda-sdk, (中文(简体) ), @dojocoding/hacienda-cli,以及 @dojocoding/hacienda-mcp。它通常不是由最终用户直接进口的.

目录

常数

  • 生成目录 (单位:千美元)shared/src/generated/) -- 提供代码目录 从 packages/sdk/schemas/codes.json 以 pnpm spec:generate文档 类型独立计数,例如 PaymentMethod, (中文(简体) ), SaleCondition, (中文(简体) ), TaxCode, (中文(简体) ), IvaRateCode, (中文(简体) ), IdentificationType, (中文(简体) ), ProvinceCode, (中文(简体) ), CURRENCY_CODES, (中文(简体) ), DISCOUNT_CODES, (中文(简体) ), OTHER_CHARGE_TYPES, (中文(简体) ), EXONERATION_INSTITUTIONS, (中文(简体) ), COMMERCIAL_CODE_TYPES 财务报告和审定财务报表 TRANSACTION_TYPES。每个文件以 NO EDITAR 标题: 永远 用手编辑它们(对等冻结测试和 pnpm verify 锁定 探测出漂移。 配对登记为: scripts/codes-generate/table-map.mjs。 。 。 .
  • 被诅咒的伙伴 -- 人可读 *_NAMES 地图, 派生子集 (单位:千美元)REP_*, (中文(简体) ), IVA_RATE_PERCENTAGES, (中文(简体) ), IDENTIFICATION_LENGTHS货币 和目录 没有精确 codes.json 配对 (单位:千美元)ExonerationType, (中文(简体) ), UNITS_OF_MEASURE, (中文(简体) ), DocumentTypeCode, (中文(简体) ), REFERENCE_*) -- -- 手写入 shared/src/constants/。 。 。 .
  • XAdES 政策 - 政策URI和SHA-1散列,供XAdES-EPES签署
  • 环境 URL 沙盒和生产 API/ IDP 端点

类型

  • FacturaElectronica - 完整的发票类型
  • Emisor 编号 : Receptor - 发证人和接收人类型
  • LineaDetalle - 发票行项目
  • Impuesto 编号 : Descuento 编号 : Exoneracion -- 税收、折扣、免责
  • SubmissionRequest 编号 : SubmissionResponse 编号 : StatusResponse -- API 请求/答复类型
  • ComprobantesListResponse 编号 : ComprobanteDetail 文件清单和细节类型

斯克马斯 (佐德)

  • FacturaElectronicaSchema - 验证发票投入
  • EmisorSchema 编号 : ReceptorSchema - 核证签发人/收款人
  • LineaDetalleSchema -- 验证行项目
  • IdentificacionSchema - 验证识别字段
  • ClaveSchema -- 验证50位数的空格格式
  • EnvironmentSchema -- 验证环境字符串

安装

npm install @dojocoding/hacienda-shared

应用程序可以直接导入其公共类型,enum和验证计划. 内部工作空间的依赖性在打包时会解决发布版本.

添加精确的 FE 普通计划

ExactFeInputSchema, (中文(简体) ), ExactFeCalculatedSchema, (中文(简体) ), ExactMoneySchema 财务报告和审定财务报表 ExactQuantitySchema 保留小数字符串并拒绝隐含的数字 强迫 它们属于明确的普通IVA13/全额支付案件,而不是a 替换现有的数字文档计划。 见 准确的FE合同。 。 。 .

版本与发布记录

@dojocoding/hacienda-shared 共发布 15 个版本,首次发布于 2026/02/23;过去 12 个月发布了 15 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.13.0latest2026/11/0112 天前
0.12.12026/10/2222 天前
0.12.02026/10/2222 天前
0.11.02026/10/2222 天前
0.10.02026/10/1826 天前
0.9.02026/10/1826 天前

关于 @dojocoding/hacienda-shared 的常见问题

@dojocoding/hacienda-shared 是什么?

Hacienda CR电子发票的共享类型、常数和注解

如何安装 @dojocoding/hacienda-shared?

在项目目录运行 npm install @dojocoding/hacienda-shared,或使用 pnpm add / yarn add / bun add。

@dojocoding/hacienda-shared 支持 TypeScript 吗?

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

@dojocoding/hacienda-shared 支持 ESM 还是 CommonJS?

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

@dojocoding/hacienda-shared 需要什么版本的 Node.js?

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

@dojocoding/hacienda-shared 可以商用吗?

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

@dojocoding/hacienda-shared 的下载量有多少?

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

@dojocoding/hacienda-shared 还在维护吗?

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