Conversor IAE CNAE API

Look up any IAE or CNAE code and get the AEAT modelos, IRPF/IVA módulos, and deadlines it triggers. Free tier, open dataset, MCP tools.

原始信息汇总

数据集概述：Conversor IAE CNAE API

简介
该API专门用于处理西班牙商业活动税务代码（IAE）与国家经济活动分类（CNAE）之间的转换与查询。它能够将IAE或CNAE代码转换为相关的税务局（AEAT）税表（modelos）、IRPF/IVA模块（módulos）以及相应的税务日历截止日期，所有信息均标注来源（AEAT、INE或BOE）及数据新鲜度。

核心功能与端点

• 代码查询
  • GET /iae/{code}：查询IAE税码详情及对应的CNAE代码。
  • GET /cnae/{code}：查询CNAE 2025代码详情及对应的IAE代码。
  • GET /cnae-2009/{code}：查询CNAE 2009旧代码并映射至2025版本。
  • POST /bulk：单次调用最多查询50个代码。
• 搜索
  • GET /search?q=：跨所有目录进行混合词法与语义搜索。
• 税务信息
  • GET /modulos/{code}：返回该代码是否适用IRPF/IVA估算对象模块（módulos）。
  • GET /obligaciones/{code_type}/{code}：返回该代码触发的AEAT税表（modelos）及置信度和截止日期。
  • GET /calendario/{code_type}/{code}：生成可下载的.ics格式税务日历。
• 账户与集成
  • POST /signup、POST /subscribe、GET /usage：账户管理与使用量查询。
  • 提供MCP服务器（含6个免费工具）供AI代理调用。

数据覆盖范围

• 1,187个IAE税码。
• 1,060个CNAE 2025代码。
• 1,010个CNAE 2009代码（可映射至2025版）。

使用方式

• 通过X-API-Key请求头进行身份验证。
• 示例请求：
  curl -H "X-API-Key: cvr_YOUR_KEY" "https://www.conversoriaecnae.es/api/v1/iae/501.3"

速率限制

• 按套餐设定突发速率（10/30/100 请求/分钟）。
• 每日配额在00:00（欧洲/马德里时间）重置。

定价套餐

• 免费：0欧元/月，250次请求/天，10次请求/分钟，无需信用卡。
• Profesional：29欧元/月（热门），2,000次请求/天，30次请求/分钟。
• Empresa：79欧元/月，10,000次请求/天，100次请求/分钟。
• Enterprise：自定义价格（联系提供商）。
• 年付优惠：Profesional 290欧元/年，Empresa 790欧元/年（相当于两个月免费）。

更多资源

• OpenAPI 3.0规范：https://www.conversoriaecnae.es/openapi.json
• 完整文档：https://www.conversoriaecnae.es/api/v1/docs
• MCP服务器（AI代理用）：https://www.conversoriaecnae.es/api/mcp/mcp
• 产品网站：https://www.conversoriaecnae.es