
## 概述
这个工作流通过从MinhaReceita.org API获取全面的CNPJ信息,自动丰富巴西公司数据并更新您的Google Sheets电子表格。非常适合数据分析师、销售团队以及任何处理巴西商业数据库需要大规模丰富公司信息的用户。
## 功能说明
### 主要功能
– 从Google Sheets电子表格读取CNPJ号码
– 通过MinhaReceita.org API从巴西联邦税务局数据库获取完整的公司数据
– 使用包括地址、税务状态、合作伙伴等在内的全面业务信息更新您的电子表格
– 流程完成时发送Telegram通知
– 批量处理数据以高效处理大型数据集
### 关键特性
✅ **免费API** – 无需身份验证,完全免费使用
✅ **全面数据** – 47+个官方巴西公司信息字段
✅ **批量处理** – 自动处理每批最多100个CNPJ
✅ **智能过滤** – 仅处理尚未有数据的CNPJ
✅ **实时更新** – 在检索数据时更新您的电子表格
✅ **进度通知** – 完成时通过Telegram获得通知
## 设置要求
### Google Sheets结构
您的电子表格必须至少包含:
– `cnpj`列包含巴西CNPJ号码(仅数字,无格式)
– `razao_social`列(用于识别没有数据的记录)
### 所需凭证
– 在n8n中配置的Google Sheets OAuth2凭证
– Telegram Bot凭证用于通知(可选但推荐)
## 可用数据字段
该工作流可以使用巴西联邦税务局的以下任何或所有官方字段填充您的电子表格:
### 🏢 公司信息
cnpj, razao_social, nome_fantasia, capital_social
porte, codigo_porte, natureza_juridica, codigo_natureza_juridica
### 📍 地址和位置
uf, municipio, codigo_municipio, codigo_municipio_ibge
bairro, logradouro, descricao_tipo_de_logradouro
numero, complemento, cep
pais, codigo_pais, nome_cidade_no_exterior
### 📞 联系信息
email, ddd_telefone_1, ddd_telefone_2, ddd_fax
### 💼 业务分类
cnae_fiscal, cnae_fiscal_descricao, cnaes_secundarios
regime_tributario, qualificacao_do_responsavel
### 📋 注册状态
situacao_cadastral, descricao_situacao_cadastral
motivo_situacao_cadastral, descricao_motivo_situacao_cadastral
situacao_especial, identificador_matriz_filial, descricao_identificador_matriz_filial
ente_federativo_responsavel
### 📅 重要日期
data_inicio_atividade, data_situacao_cadastral, data_situacao_especial
### 🏛️ 税务制度信息
opcao_pelo_mei, data_opcao_pelo_mei, data_exclusao_do_mei
opcao_pelo_simples, data_opcao_pelo_simples, data_exclusao_do_simples
### 👥 合作伙伴和股东
qsa(公司合作伙伴和股东的完整结构化数据)
## 使用方法
1. 在cnpj列中准备包含CNPJ号码的电子表格
2. 在Settings节点中配置您的Telegram ID以接收通知
3. 在n8n中设置Google Sheets凭证
4. 将所需的数据列添加到您的电子表格(从上述列表中选择任意组合)
5. 运行工作流 – 它将自动处理所有没有现有数据的CNPJ
## 性能和限制
– **API限制**:无 – 来自MinhaReceita.org的完全免费API
– **数据准确性**:来自巴西联邦税务局官方数据
– **批量大小**:可配置(默认:每批100条记录)
## 使用案例
– **潜在客户丰富**:使用完整的公司信息增强潜在客户数据库
– **市场研究**:收集有关巴西公司的全面数据
– **合规性和尽职调查**:验证公司注册状态和详细信息
– **销售情报**:访问联系信息和公司分类数据
– **数据清理**:标准化和完成现有公司数据库
## 前提条件
– 具有Google Sheets集成的N8N实例
– 包含CNPJ数据的Google Sheets文档
– 对巴西CNPJ格式的基本了解(14位公司注册号码)
– Telegram机器人令牌(可选,用于通知)
## 重要说明
– CNPJ必须活跃并在巴西联邦税务局注册
– 工作流仅处理razao_social为空的CNPJ(避免重复)
– 所有数据均通过MinhaReceita.org来自官方政府来源
– 无需速率限制 – API专为批量请求设计
– 支持matriz(总部)和filial(分支机构)识别

评论(0)