巴西企业税号 API

直接来自巴西联邦税务局的完整CNPJ数据API
通过 MCP 从您的 AI 代理使用此 API
支持 OpenClaw、Claude Code/Desktop、Cursor、Windsurf、Cline 以及任何兼容 MCP 的 AI 客户端。
文档和设置
通过封装此 MCP 创建技能: https://mcp.zylalabs.com/mcp?apikey=YOUR_ZYLA_API_KEY

API 文档

端点


“通过税号获取公司数据”端点旨在使用公司的唯一税务识别号(TIN)获取详细信息。该端点作为企业、金融机构和监管机构的重要工具,帮助验证公司基于其分配的税号的身份、法律地位和运营细节。成功调用后,它返回一个结构化的JSON响应,包含公司名称、地址、注册状态、行业分类和联系信息等基本数据字段。潜在的用例包括并购过程中的合规检查、欺诈检测、税务报告以及确保开票和金融交易的客户记录准确。



                                                                            
GET https://pr140-testing.zylalabs.com/api/12397/corporate+tax+id+brazil+api/23444/company+data+by+tax+id
                                                                            
                                                                        

测试端点

API 示例响应

       
                                                                                                        
                                                                                                                                                                                                                                                                                                                                        {"cnpj":"33000167000101","identificador_matriz_filial":"Matriz","razao_social":"PETROLEO BRASILEIRO S A PETROBRAS","nome_fantasia":"PETROBRAS - EDISE","situacao_cadastral":{"codigo":"02","descricao":"Ativa"},"data_situacao_cadastral":"2005-11-03","motivo_situacao_cadastral":{"codigo":"00","descricao":"SEM MOTIVO"},"data_inicio_atividade":"1966-09-28","natureza_juridica":{"codigo":"2038","descricao":"Sociedade de Economia Mista"},"qualificacao_responsavel":{"codigo":"10","descricao":"Diretor"},"capital_social":205431960490.52,"porte":{"codigo":"05","descricao":"Demais"},"ente_federativo":null,"cnae_fiscal_principal":{"codigo":"0600001","descricao":"Extração de petróleo e gás natural"},"cnaes_fiscais_secundarios":[{"codigo":"1921700","descricao":"Fabricação de produtos do refino de petróleo"},{"codigo":"3520401","descricao":"Produção de gás; processamento de gás natural"},{"codigo":"3520402","descricao":"Distribuição de combustíveis gasosos por redes urbanas"},{"codigo":"4681801","descricao":"Comércio atacadista de álcool carburante, biodiesel, gasolina e demais derivados de petróleo, exceto lubrificantes, não realizado por transportador re"},{"codigo":"8630599","descricao":"Atividades de atenção ambulatorial não especificadas anteriormente"}],"endereco":{"tipo_logradouro":"AVENIDA","logradouro":"REPUBLICA DO CHILE","numero":"65","complemento":null,"bairro":"CENTRO","cep":"20031170","uf":"RJ","municipio":{"codigo":"6001","descricao":"RIO DE JANEIRO"}},"nome_cidade_exterior":null,"pais":null,"telefones":[{"ddd":"21","numero":"21660000"}],"fax":{"ddd":"21","numero":"3224"},"correio_eletronico":"[email protected]","situacao_especial":null,"data_situacao_especial":null,"simples_nacional":null,"mei":null,"socios":[{"tipo":"Pessoa Física","nome":"CLAUDIO ROMEO SCHLOSSER","cpf_cnpj":"***077120**","qualificacao":{"codigo":"10","descricao":"Diretor"},"data_entrada":"2023-04-17","pais":null,"faixa_etaria":"61 a 70 anos","representante":null},{"tipo":"Pessoa Física","nome":"WILLIAM FRANCA DA SILVA","cpf_cnpj":"***487787**","qualificacao":{"codigo":"10","descricao":"Diretor"},"data_entrada":"2023-04-17","pais":null,"faixa_etaria":"61 a 70 anos","representante":null},{"tipo":"Pessoa Física","nome":"CLARICE COPPETTI","cpf_cnpj":"***995240**","qualificacao":{"codigo":"10","descricao":"Diretor"},"data_entrada":"2023-04-17","pais":null,"faixa_etaria":"61 a 70 anos","representante":null},{"tipo":"Pessoa Física","nome":"MAGDA MARIA DE REGINA CHAMBRIARD","cpf_cnpj":"***612937**","qualificacao":{"codigo":"16","descricao":"Presidente"},"data_entrada":"2024-06-07","pais":null,"faixa_etaria":"61 a 70 anos","representante":null},{"tipo":"Pessoa Física","nome":"FERNANDO SABBI MELGAREJO","cpf_cnpj":"***650110**","qualificacao":{"codigo":"10","descricao":"Diretor"},"data_entrada":"2024-07-17","pais":null,"faixa_etaria":"51 a 60 anos","representante":null},{"tipo":"Pessoa Física","nome":"SYLVIA MARIA COUTO DOS ANJOS","cpf_cnpj":"***701217**","qualificacao":{"codigo":"10","descricao":"Diretor"},"data_entrada":"2024-07-17","pais":null,"faixa_etaria":"61 a 70 anos","representante":null},{"tipo":"Pessoa Física","nome":"RENATA FARIA RODRIGUES BARUZZI LOPES","cpf_cnpj":"***944618**","qualificacao":{"codigo":"10","descricao":"Diretor"},"data_entrada":"2024-07-17","pais":null,"faixa_etaria":"51 a 60 anos","representante":null},{"tipo":"Pessoa Física","nome":"RICARDO WAGNER DE ARAUJO","cpf_cnpj":"***017831**","qualificacao":{"codigo":"10","descricao":"Diretor"},"data_entrada":"2025-04-25","pais":null,"faixa_etaria":"51 a 60 anos","representante":null},{"tipo":"Pessoa Física","nome":"ANGELICA GARCIA COBAS LAUREANO","cpf_cnpj":"***912137**","qualificacao":{"codigo":"10","descricao":"Diretor"},"data_entrada":"2025-07-29","pais":null,"faixa_etaria":"61 a 70 anos","representante":null}],"has_branches":true}
                                                                                                                                                                                                                    
                                                                                                    

公司数据按税号 - 代码片段


curl --location --request GET 'https://zylalabs.com/api/12397/corporate+tax+id+brazil+api/23444/company+data+by+tax+id&cnpj=Required' --header 'Authorization: Bearer YOUR_API_KEY' 


    

“列出分支机构”终端旨在检索与特定组织或网络相关的所有分支机构的综合列表。此终端的目的是让用户访问关键细节,例如办公室名称、位置、联系信息和运营状态,从而促进对各个地区组织存在的有效管理和监督。此终端的典型使用案例包括生成战略规划报告、支持与分支服务相关的客户查询,以及通过确保团队掌握所有运营分支的最新信息来提高服务交付。如果此终端返回空列表,则表示该公司没有分支机构。请参考“按税号查询公司数据”终端上的 has_branches 字段,以避免不必要的 API 调用。



                                                                            
GET https://pr140-testing.zylalabs.com/api/12397/corporate+tax+id+brazil+api/23462/list+branch+offices
                                                                            
                                                                        

列出分支机构 - 端点功能

对象 描述
page [必需] The page you wish to retrieve
cnpj [必需]
测试端点

API 示例响应

       
                                                                                                        
                                                                                                                                                                                                                                                                                                                                        {
  "cnpj_matriz": "33000167000101",
  "total_filiais": 3,
  "page": 1,
  "total_pages": 1,
  "filiais": [
    {
      "cnpj": "33000167000292",
      "nome_fantasia": "PETROBRAS",
      "situacao_cadastral": {
        "codigo": "02",
        "descricao": "Ativa"
      },
      "uf": "RJ",
      "municipio": {
        "codigo": "6001",
        "descricao": "RIO DE JANEIRO"
      }
    },
    {
      "cnpj": "33000167000373",
      "nome_fantasia": "PETROBRAS",
      "situacao_cadastral": {
        "codigo": "02",
        "descricao": "Ativa"
      },
      "uf": "RN",
      "municipio": {
        "codigo": "1687",
        "descricao": "GUAMARE"
      }
    },
    {
      "cnpj": "33000167000454",
      "nome_fantasia": "PETROBRAS",
      "situacao_cadastral": {
        "codigo": "02",
        "descricao": "Ativa"
      },
      "uf": "ES",
      "municipio": {
        "codigo": "5705",
        "descricao": "VITORIA"
      }
    }
  ]
}
                                                                                                                                                                                                                    
                                                                                                    

列出分支机构 - 代码片段


curl --location --request GET 'https://zylalabs.com/api/12397/corporate+tax+id+brazil+api/23462/list+branch+offices?page=Required&cnpj=Required' --header 'Authorization: Bearer YOUR_API_KEY' 


    

调用此端点以检查API是否处于活动状态并正常运行



                                                                            
GET https://pr140-testing.zylalabs.com/api/12397/corporate+tax+id+brazil+api/23445/status+check
                                                                            
                                                                        

测试端点

API 示例响应

       
                                                                                                        
                                                                                                                                                                                                                                                                                                                                        {"status":"ok","last_import":{"batch":"2026-04","status":"success","started_at":"2026-04-19T19:12:29.446800","finished_at":"2026-04-19T21:04:42.147052"}}
                                                                                                                                                                                                                    
                                                                                                    

状态审查 - 代码片段


curl --location --request GET 'https://zylalabs.com/api/12397/corporate+tax+id+brazil+api/23445/status+check' --header 'Authorization: Bearer YOUR_API_KEY' 


    

API 访问密钥和身份验证

注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 巴西企业税号 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。
标头
标头 描述
授权 [必需] 应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。

简单透明的定价

无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。

🚀 企业版

起价
$ 10,000/年


  • 自定义数量
  • 自定义速率限制
  • 专业客户支持
  • 实时 API 监控

客户喜爱的功能

  • ✔︎ 仅支付成功请求
  • ✔︎ 7 天免费试用
  • ✔︎ 多语言支持
  • ✔︎ 一个 API 密钥,所有 API。
  • ✔︎ 直观的仪表板
  • ✔︎ 全面的错误处理
  • ✔︎ 开发者友好的文档
  • ✔︎ Postman 集成
  • ✔︎ 安全的 HTTPS 连接
  • ✔︎ 可靠的正常运行时间

巴西企业税号 API FAQs

每个端点返回有关巴西法律实体的详细信息 “按税号获取公司数据”端点提供注册状态 公司名称 地址 联系信息和行业分类 “列出分支机构”端点返回有关分支机构的详细信息,包括名称 位置和运营状态

关键字段包括CNPJ,公司名称(razao_social),贸易名称(nome_fantasia),注册状态(situacao_cadastral),开业日期(data_inicio_atividade),法律性质(natureza_juridica)和联系信息。对于分支机构,字段包括分支CNPJ、名称和状态

响应数据以JSON格式结构化,每个字段都有键值对。例如“按税号获取企业数据”的响应包括嵌套对象用于注册状态和法律性质,便于分析和使用特定信息

“通过税号获取公司数据”端点提供了有关公司注册 状态和活动的全面信息 “列出分支机构”端点提供所有关联分支的信息 包括它们的运营状态和位置

数据直接来源于巴西联邦税务局(Receita Federal),确保高准确性和可靠性 定期进行更新和质量检查以维护通过API提供的信息的完整性

典型的使用案例包括并购的合规检查欺诈检测税务报告以及验证客户记录以便开具发票 企业还可以利用分支机构的数据进行战略规划和客户询问

用户可以通过指定CNPJ来定制请求以获取“通过税务ID获取企业数据”端点,或者在检索分支机构数据时根据特定标准过滤结果。这允许针对性的信息检索

用户可以期待一致的 JSON 响应和结构化数据。例如 "situacao_cadastral" 字段将始终指示注册状态,而 "cnae_fiscal_principal" 将提供主要行业分类,方便数据解释

此端点提供有关公司的详细信息,包括其CNPJ、公司名称、商业名称、注册状态、开业日期、法律性质、注册资本和行业分类(CNAE)这使用户能够验证实体的身份和法律状态

此端点返回与公司相关的分支机构列表,包括每个分支机构的CNPJ、商业名称、注册状态、位置(州和市)以及分支机构总数。这对于管理组织的区域存在很有帮助

API的响应为JSON格式,组织为键值对。例如,在“按税号获取企业数据”中,注册状态和法律性质的数据是嵌套的,这使得信息的解释和使用更加方便

用户可以在“按税号获取公司数据”的端点中指定CNPJ作为参数。要“列出分支机构”,可以通过母公司的CNPJ进行过滤,以获取有关其分支机构的特定信息

数据直接来自巴西联邦税务局确保其准确性此外还实施质量控制和定期更新以维护信息的完整性

这些字段中的代码代表特定类别。例如,在“situacao_cadastral”中的代码“02”表示公司处于活动状态,而在“natureza_juridica”中的代码“2062”指的是“有限责任公司”这允许标准化分类

如果请求没有返回结果,用户应检查提供的CNPJ的有效性。如果有部分结果,建议检查搜索参数或考虑该公司没有注册分支机构的可能性

数据通常用于并购中的合规性检查、欺诈检测、税务报告和客户记录验证。它们对于战略规划和在不同地区的分支管理也很有用

“列出分支机构”端点提供了与公司相关的分支机构的全面列表,包括每个分支的CNPJ、商业名称、注册状态、位置(州和市)以及分支总数。这些数据对于了解组织的区域存在非常重要

您可以通过使用“按税号查询公司数据”端点来验证公司的运营状态,其中包含“situacao_cadastral”字段。该字段指示公司是活跃还是非活跃,为合规和验证流程提供了重要信息

字段“qualificacao_responsavel”指的是公司负责人资格,例如“Sócio-Administrador”(合伙人-管理者)这有助于识别参与公司管理和决策的关键人员

是的,当使用“列出分支机构”端点时,您可以根据母公司的CNPJ过滤结果。这使您能够检索特定组织的分支信息,提高数据与您需求的相关性

“capital_social”字段代表公司的股本,这对于理解其财务基础至关重要。这些信息可以用于财务评估、投资决策以及评估公司的规模和稳定性

“data_inicio_atividade”字段指示公司开始运营的时间 此信息对于评估公司的市场经验 评估其增长潜力以及进行合规性或投资目的的历史分析非常有用

“motivo_situacao_cadastral”字段提供了一个代码和描述,解释公司的注册状态原因。例如,“00”代码表示“SEM MOTIVO”(无理由),这可以帮助用户理解公司当前状态的背景

为了确保CNPJ值有效,请检查CNPJ格式是否正确(14位数字)并且是否对应于一个存在的实体如果请求没有返回结果,请再次核实CNPJ以获取更高的准确性或考虑该实体可能未在联邦税务局数据库中注册

一般常见问题

Zyla API Hub 就像一个大型 API 商店,您可以在一个地方找到数千个 API。我们还为所有 API 提供专门支持和实时监控。注册后,您可以选择要使用的 API。请记住,每个 API 都需要自己的订阅。但如果您订阅多个 API,您将为所有这些 API 使用相同的密钥,使事情变得更简单。

价格以 USD(美元)、EUR(欧元)、CAD(加元)、AUD(澳元)和 GBP(英镑)列出。我们接受所有主要的借记卡和信用卡。我们的支付系统使用最新的安全技术,由 Stripe 提供支持,Stripe 是世界上最可靠的支付公司之一。如果您在使用卡片付款时遇到任何问题,请通过 [email protected]


此外,如果您已经以这些货币中的任何一种(USD、EUR、CAD、AUD、GBP)拥有有效订阅,该货币将保留用于后续订阅。只要您没有任何有效订阅,您可以随时更改货币。

定价页面上显示的本地货币基于您 IP 地址的国家/地区,仅供参考。实际价格以 USD(美元)为单位。当您付款时,即使您在我们的网站上看到以本地货币显示的等值金额,您的卡片对账单上也会以美元显示费用。这意味着您不能直接使用本地货币付款。

有时,银行可能会因其欺诈保护设置而拒绝收费。我们建议您首先联系您的银行,检查他们是否阻止了我们的收费。此外,您可以访问账单门户并更改关联的卡片以进行付款。如果这些方法不起作用并且您需要进一步帮助,请通过 [email protected]

价格由月度或年度订阅决定,具体取决于所选计划。

API 调用根据成功请求从您的计划中扣除。每个计划都包含您每月可以进行的特定数量的调用。只有成功的调用(由状态 200 响应指示)才会计入您的总数。这确保失败或不完整的请求不会影响您的月度配额。

Zyla API Hub 采用月度订阅系统。您的计费周期将从您购买付费计划的那一天开始,并在下个月的同一日期续订。因此,如果您想避免未来的费用,请提前取消订阅。

要升级您当前的订阅计划,只需转到 API 的定价页面并选择您要升级到的计划。升级将立即生效,让您立即享受新计划的功能。请注意,您之前计划中的任何剩余调用都不会转移到新计划,因此在升级时请注意这一点。您将被收取新计划的全部金额。

要检查您本月剩余多少 API 调用,请参考响应标头中的 "X-Zyla-API-Calls-Monthly-Remaining" 字段。例如,如果您的计划允许每月 1,000 个请求,而您已使用 100 个,则响应标头中的此字段将显示 900 个剩余调用。

要查看您的计划允许的最大 API 请求数,请检查 "X-Zyla-RateLimit-Limit" 响应标头。例如,如果您的计划包括每月 1,000 个请求,此标头将显示 1,000。

"X-Zyla-RateLimit-Reset" 标头显示您的速率限制重置之前的秒数。这告诉您何时您的请求计数将重新开始。例如,如果它显示 3,600,则意味着还有 3,600 秒直到限制重置。

是的,您可以随时通过访问您的账户并在账单页面上选择取消选项来取消您的计划。请注意,升级、降级和取消会立即生效。此外,取消后,您将不再有权访问该服务,即使您的配额中还有剩余调用。

您可以通过我们的聊天渠道联系我们以获得即时帮助。我们始终在线,时间为上午 8 点至下午 5 点(EST)。如果您在该时间之后联系我们,我们将尽快回复您。此外,您可以通过 [email protected]

为了让您有机会在没有任何承诺的情况下体验我们的 API,我们提供 7 天免费试用,允许您免费进行最多 50 次 API 调用。此试用只能使用一次,因此我们建议将其应用于您最感兴趣的 API。虽然我们的大多数 API 都提供免费试用,但有些可能不提供。试用在 7 天后或您进行了 50 次请求后结束,以先发生者为准。如果您在试用期间达到 50 次请求限制,您需要"开始您的付费计划"以继续发出请求。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。或者,如果您在第 7 天之前不取消订阅,您的免费试用将结束,您的计划将自动计费,授予您访问计划中指定的所有 API 调用的权限。请记住这一点以避免不必要的费用。

7 天后,您将被收取试用期间订阅的计划的全额费用。因此,在试用期结束前取消很重要。因忘记及时取消而提出的退款请求不被接受。

当您订阅 API 免费试用时,您可以进行最多 50 次 API 调用。如果您希望超出此限制进行额外的 API 调用,API 将提示您执行"开始您的付费计划"。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。

付款订单在每月 20 日至 30 日之间处理。如果您在 20 日之前提交请求,您的付款将在此时间范围内处理。


相关 API


您可能还喜欢