# @contaazul/n8n-nodes-contaazul 中文文档 规范地址：https://npmcn.com/package/%40contaazul/n8n-nodes-contaazul/ 版本：0\.3\.28 npm 元数据更新时间：2026-11-05T18:23:56.718Z 中文译文更新时间：2026-11-10T16:16:59.069Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40contaazul/n8n-nodes-contaazul 原文对照：https://npmcn.com/package/%40contaazul/n8n-nodes-contaazul/?lang=original 项目主页：https://github.com/ContaAzul/n8n-nodes-contaazul 源码仓库：https://github.com/ContaAzul/n8n-nodes-contaazul ## 关键信息（来自 npm 元数据） - 包体积（解压后）：440 kB，39 个文件 - 模块格式：CommonJS - TypeScript 类型：包内自带 - Node.js 要求：\>=20\.15 - 运行依赖：0 个 - peer 依赖：n8n-workflow \* - 首次发布：2025-07-17T18:23:10.668Z - 最新版本发布：2026-11-05T18:23:56.278Z - 近 30 天下载量：14277（2026-10-11 至 2026-11-09，npm 官方下载统计） - 已发布版本数：25（近 12 个月 14 个） ## 中文简介 N8n 与 Conta Azul API 整合的节点 ## 安装 ```sh npm install @contaazul/n8n-nodes-contaazul ``` 也可以使用：`pnpm add @contaazul/n8n-nodes-contaazul`、`yarn add @contaazul/n8n-nodes-contaazul`、`bun add @contaazul/n8n-nodes-contaazul` ## README # n8n-节点-相干 这是一个 n8n 社区节点,允许与 Conta Azul API 在您的工作流程中集成 . Conta Azul是一个商业管理平台,为财务控制,销售,产品,服务和客户管理提供解决方案. 此节点允许您实现销售搜索,产品创建,客户管理和财务查询等操作自动化. [无 8n](https://n8n.io/) 是一个工作流程自动化平台,使用 [公平码许可证](https://docs.n8n.io/reference/license/)。 。 。 . [安装](https://npmcn.com/package/%40contaazul/n8n-nodes-contaazul/#readme-installation) [业务](https://npmcn.com/package/%40contaazul/n8n-nodes-contaazul/#readme-operations) [全权证书](https://npmcn.com/package/%40contaazul/n8n-nodes-contaazul/#readme-credentials) [兼容性](https://npmcn.com/package/%40contaazul/n8n-nodes-contaazul/#readme-compatibility) [使用量](https://npmcn.com/package/%40contaazul/n8n-nodes-contaazul/#readme-usage) [资源](https://npmcn.com/package/%40contaazul/n8n-nodes-contaazul/#readme-resources) [版本历史](https://npmcn.com/package/%40contaazul/n8n-nodes-contaazul/#readme-version-history) ## 安装 跟着 [安装指南](https://docs.n8n.io/integrations/community-nodes/installation/) 在n8n社区节点文档中. ## 业务 ### 服务 - **通过过滤器搜索服务**: 列出带有文本搜索过滤器和页码的服务 - **以 ID 搜索服务**: 获取特定服务的细节 - **创建服务**: 创建新服务 ### 销售 - **通过过滤器搜索销售**: 列出带有文本搜索过滤器和页码的销售情况 - **以ID进行搜索销售**:获得特定销售的细节 - **创建销售**: 用物品、客户和支付方法创建新的销售方式 ### 人-客户/供应者 - **通过过滤搜索人员**: 列出有搜索过滤器的客户/供应商 - **身份证明搜索人**: 获得特定个人的详细信息 - **创建人物**: 创建新的客户/供应商 ### 产品 - **通过过滤器搜索产品**: 列出带有搜索过滤器的产品 - **由 id 搜索产品** :获取特定产品的细节 - **创建产品**: 创建新产品 ### 财务 - **搜索财务账户**: 列出所有财务账户 - **通过过滤搜索收入**: 列出带有过滤器的收入 - **过滤器搜索费用**: 列出带有过滤器的支出 - **通过 ID 搜索分期**: 获得具体分期付款的细节 - **搜索类别**: 列出所有可用的类别 - **搜索费用中心**:列出所有成本中心 ## 全权证书 要使用此节点, 您需要一个 Conta Azul 账户并配置 OAuth2 证书 . ### 先决条件 1. 拥有活跃的 Conta Azul 账户 2. 访问 Conta Azul 开发者面板 3. 创建获取客户端身份和客户端秘密的应用程序 ### 证书配置 1. 在n8n,去吗 **设置** > 翻译: **全权证书** 2. 点击 **添加证书** 3. 选择 **孔塔·阿祖尔 OAuth2 API** 4. 填入字段 : - **客户身份**: 您的 Conta Azul 客户端 ID - **客户端机密**: 您的 Conta Azul 客户端秘密 - **范围**数字 : `openid profile aws.cognito.signin.user.admin` (默认) - **认证 URL**数字 : `https://api-v2.contaazul.com/oauth/authorize` (默认) - **访问托肯 URL**数字 : `https://api-v2.contaazul.com/oauth/token` (默认) 5. 点击 **保存** 并授权申请 ## 兼容性 - **最小的 n8n 版本**: 1.0.0 (中文(简体) ) - **测试过的版本**: 1.0.0, 1.1.0, 1.2.0 (中文(简体) ) - **节点.js**页:1 ## 使用量 ### 示例:搜索最近销售 1. 添加数据 **康塔·阿苏尔** 工作流程的节点 2. 配置证书 3. 选择 **通过过滤器搜索销售** 操作 4. 配置搜索参数( 可选) 5. 执行工作流程 ### 示例:创建新销售 1. 添加数据 **康塔·阿苏尔** 工作流程的节点 2. 配置证书 3. 选择 **创建销售** 操作 4. 填写所需数据: - 客户身份 - 付款方法 - 销售项目 5. 执行工作流程 ### 示例:同步产品 1. 使用 **康塔·阿苏尔** 节点为 **通过过滤器搜索产品** 操作 2. 连接到其它节点处理数据 3. 使用 Webhoks 自动同步 ## 资源 - [n8n 社区节点文档](https://docs.n8n.io/integrations/#community-nodes) - [Conta Azul API 文档](https://developers.contaazul.com/guide) - [Conta Azul 开发者门户网站](https://developers-portal.contaazul.com/) - [尝试 n8n](https://docs.n8n.io/try-it-out/) ## 版本历史 ### 页:1 - 固定 n8n 工作流程依赖配置 - 删除了邮站脚本 - 已删除的决议和更改 - 更新到最新的 n8n 工作流程版本 ### 页:1 - 节点的初始实施 - 支持基本业务:搜索服务、销售、人员、产品、类别、成本中心和财务 - 与 Conta Azul OAuth2 合并 ## 常见问题 ### @contaazul/n8n-nodes-contaazul 是什么？ N8n 与 Conta Azul API 整合的节点 ### 如何安装 @contaazul/n8n-nodes-contaazul？ 在项目目录运行 npm install @contaazul/n8n-nodes-contaazul，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：n8n-workflow（\*）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。 ### @contaazul/n8n-nodes-contaazul 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @contaazul/n8n-nodes-contaazul 支持 ESM 还是 CommonJS？ 以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。 ### @contaazul/n8n-nodes-contaazul 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=20\.15。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @contaazul/n8n-nodes-contaazul 可以商用吗？ @contaazul/n8n-nodes-contaazul 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @contaazul/n8n-nodes-contaazul 的下载量有多少？ 根据 npm 官方下载统计，@contaazul/n8n-nodes-contaazul 在 2026/10/11 – 2026/11/09 这 30 天内被下载 14,277 次，日均约 476 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @contaazul/n8n-nodes-contaazul 还在维护吗？ 最新版本 0\.3\.28 发布于 2026/11/06（4 天前）；至今共发布 25 个版本，其中过去 12 个月发布了 14 个；首次发布于 2025/07/18。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。