# @fayz-ai/plugin-fiscal-br 中文文档

规范地址：https://npmcn.com/package/%40fayz-ai/plugin-fiscal-br/

版本：0\.17\.3
npm 元数据更新时间：2026-11-11T14:53:33.775Z
中文译文更新时间：2026-11-14T12:09:16.501Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40fayz-ai/plugin-fiscal-br
原文对照：https://npmcn.com/package/%40fayz-ai/plugin-fiscal-br/?lang=original

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

- 包体积（解压后）：2.5 MB，123 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：5 个
- peer 依赖：react ^18\.0\.0 \|\| ^19\.0\.0，react-dom ^18\.0\.0 \|\| ^19\.0\.0，lucide-react \>=0\.400\.0 \<1\.0\.0
- 首次发布：2026-09-10T21:08:34.233Z
- 最新版本发布：2026-11-11T14:53:33.493Z
- 近 30 天下载量：10569（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：78（近 12 个月 78 个）

## 中文简介

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

## 安装

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

也可以使用：`pnpm add @fayz-ai/plugin-fiscal-br`、`yarn add @fayz-ai/plugin-fiscal-br`、`bun add @fayz-ai/plugin-fiscal-br`

## README

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

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

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

```bash
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 密钥仍然是服务器唯一的部署密钥. 这里没有输入秘密值; 清单中只包含这样部署的名称 和诊断可以报告缺失的配置.

## 运行时间合同

```tsx
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`](https://npmcn.com/package/docs/integrations/PLUGNOTAS-NFCE.md)。 。 。 .

## 常见问题

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