@fayz-ai/plugin-fiscal-br

中文文档
0.17.3发布于 2026/11/11MITTypeScriptES Module近 30 天下载 1.1万

[回顾]巴西通过插管同步排放NFC-e的财政附加

中文使用文档
文档目录5 节
  1. 所有权边界
  2. 为什么命令是持久的
  3. 证书和证书边界
  4. 运行时间合同
  5. 这份草案没有授权

@fayz-ai/plugin-fiscal-br (英语)

状态 : 预览。 沙盒和SEFAZ同位素;生产排放为 故意不 暴露在这个包.

plugin-fiscal-br 是巴西的财政附加,由 @fayz-ai/plugin-financial其第一个供应商是TecnoSpeed Plugnotas及其公司 第一个文件行程是NFC-e(型号65),用于完成的餐厅订单.

npm install @fayz-ai/plugin-fiscal-br

所有权边界

  • plugin-financial 拥有 plg_financial_nfe, 向 操作员。 没有第二个Plugnotas发票表.
  • plugin-fiscal-br 拥有供应商连接合同,持久命令, 重试/回收线索、网络验收和发件人索赔.
  • 应用程序拥有边缘函数执行和设置面板,因为它 拥有部署、来源和产品特定成分.
  • packages/db 拥有 connections, (中文(简体) ), orders 财务报告和审定财务报表 items添加剂消耗 无法重新创造 plg_connections 或者说 order_items 从预析执行.

为什么命令是持久的

发送NFC-e和丢失 HTTP 响应是模糊的: 提供者可能 已接受该文件, 即使呼叫者已超时 。 不断重复 POST 无需首先咨询提供者,就可以产生重复的财政效应.

因此,移徙造成了 plg_fiscalbr_nfce_jobs 在任何提供者之前 电话 这份工作保存有被冻结的订单快照和稳定的一等钥匙. A 类 超时移动到 waiting一个康复工作者声称 SKIP LOCKED, (中文(简体) ), 询问 Plugnotas , 并且仅在使用相同的整合 ID 时重试 提供者确认第一个请求不存在。 Webhoks 和恢复更新 同样的工作,同样的 plg_financial_nfe 排队.

证书和证书边界

浏览器不存储 Plugnotas API 密钥、 A1 字节、 A1 密码、 CSC 代码或 CSC 符号 。 设置表将 A1 及其密码上传到应用程序所属服务器 边界的边界 提供和抛弃他们. connections.settings 仅接受准备状态和 非机密元数据,如过期和可选指纹.

CSC属于发射体. 必须在租户成立期间收取 发送到服务器边界 。 这不是一个全池 PLUGNOTAS_CSC_CONFIG_JSON 不可在租户之间分享。 此软件包被故意删除 旧合同草案.

Plugnotas 软件之家 API 密钥仍然是服务器唯一的部署密钥. 这里没有输入秘密值; 清单中只包含这样部署的名称 和诊断可以报告缺失的配置.

运行时间合同

import { createFinancialPlugin } from '@fayz-ai/plugin-financial'
import {
  createPlugNotasFinancialProvider,
  createPlugNotasPlugin,
} from '@fayz-ai/plugin-fiscal-br'

const fiscalProvider = createPlugNotasFinancialProvider({
  base: financialProvider,
  gateway: appOwnedPlugNotasGateway,
})

const plugins = [
  createFinancialPlugin({
    dataProvider: fiscalProvider,
    fiscalProvider: {
      label: 'PlugNotas',
      models: ['nfce'],
      requiresOrder: true,
    },
  }),
  createPlugNotasPlugin({ SetupPanel: AppOwnedSetupPanel }),
]

装饰者从不相信一个瞬间提供者的反应作为分类账. 问题, 刷新并取消后总是返回从数据库读取的文档 服务器操作。 XML, DANFCE 和取消 XML 使用短寿命的 URL 根据要求解决,而不是储存在财政行上的持久签名的URL.

这份草案没有授权

  • 它不向Supabase项目迁移.
  • 它没有部署边缘函数.
  • 它不创建或旋转任何秘密.
  • 它无法产生排放.
  • 它不主张通过同化;这需要真正的排放者A1、CSC和 观测到的问题/状况/艺术/外出旅行.

同伴NeoChef PR提供应用程序Edge函数和组成. 完整所有权地图和推出大门在以下文件中有记载: docs/integrations/PLUGNOTAS-NFCE.md。 。 。 .

版本与发布记录

@fayz-ai/plugin-fiscal-br 共发布 78 个版本,首次发布于 2026/09/11;过去 12 个月发布了 78 个版本。

版本发布日期距今
0.17.3latest2026/11/112 天前
0.17.22026/11/113 天前
0.17.12026/11/113 天前
0.17.02026/11/067 天前
0.16.52026/11/068 天前
0.16.42026/11/068 天前

其他发布通道:canary → 0.15.10-canary.20261028153856。

关于 @fayz-ai/plugin-fiscal-br 的常见问题

@fayz-ai/plugin-fiscal-br 是什么?

[回顾]巴西通过插管同步排放NFC-e的财政附加

如何安装 @fayz-ai/plugin-fiscal-br?

在项目目录运行 npm install @fayz-ai/plugin-fiscal-br,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(^18.0.0 || ^19.0.0)、react-dom(^18.0.0 || ^19.0.0)、lucide-react(>=0.400.0 <1.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@fayz-ai/plugin-fiscal-br 支持 TypeScript 吗?

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

@fayz-ai/plugin-fiscal-br 支持 ESM 还是 CommonJS?

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

@fayz-ai/plugin-fiscal-br 可以商用吗?

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

@fayz-ai/plugin-fiscal-br 的下载量有多少?

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

@fayz-ai/plugin-fiscal-br 还在维护吗?

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