Referencia técnica de la API

{
  "code": "501.3",
  "cod_integro": "A5013",
  "slug": "albanileria-y-pequenos-trabajos-de-construccion-en-general",
  "seccion_label": "Actividades empresariales",
  "title": "Albañilería y pequeños trabajos de construcción en general",
  "description": "Comprende los trabajos de albañilería y pequeñas obras de construcción y reparación.",
  "category": "Construcción",
  "level": 3,
  "modulos_eligible": true,
  "keywords": ["albañilería", "construcción", "reformas"],
  "last_updated": "2026-01-15",
  "_meta": {
    "plan": "free",
    "remaining": 245
  }
}

{
  "code": "4321",
  "title": "Instalaciones eléctricas",
  "description": "Instalación de cableado y equipos eléctricos, sistemas de telecomunicaciones y calefacción eléctrica en edificios y otras obras.",
  "category": "Construcción",
  "level": 4,
  "keywords": ["electricidad", "instalaciones", "cableado"],
  "last_updated": "2026-01-15",
  "nace": {
    "code": "43.21",
    "revision": "NACE Rev. 2.1",
    "fuente": "https://www.ine.es/daco/daco42/clasificaciones/cnae25/Correspondencias_CNAE25_NACE_Rev_2_1.xlsx"
  },
  "_meta": {
    "plan": "free",
    "remaining": 244
  }
}

{
  "cnae_2009": "4321",
  "correspondences": [
    {
      "cod_cnae": "4321",
      "titulo_cnae": "Instalaciones eléctricas",
      "slug_cnae": "instalaciones-electricas",
      "categoria_cnae": "Construcción"
    }
  ],
  "_meta": {
    "plan": "profesional",
    "remaining": 1998
  }
}

{
  "query": "albañil",
  "type": "both",
  "count": 2,
  "results": [
    {
      "cod_iae": "501.3",
      "titulo_iae": "Albañilería y pequeños trabajos de construcción en general",
      "slug_iae": "albanileria-y-pequenos-trabajos-de-construccion-en-general",
      "relevance_score": 1.24,
      "type": "iae"
    },
    {
      "cod_cnae": "4321",
      "titulo_cnae": "Instalaciones eléctricas",
      "slug_cnae": "instalaciones-electricas",
      "relevance_score": 0.61,
      "type": "cnae"
    }
  ],
  "_meta": {
    "plan": "free",
    "remaining": 243
  }
}

{
  "type": "iae",
  "results": [
    {
      "code": "501.3",
      "found": true,
      "data": {
        "id_iae": 1234,
        "cod_iae": "501.3",
        "titulo_iae": "Albañilería y pequeños trabajos de construcción en general",
        "slug_iae": "albanileria-y-pequenos-trabajos-de-construccion-en-general",
        "categoria_iae": "Construcción",
        "modulos_eligible": true
      }
    },
    {
      "code": "999.99",
      "found": false
    }
  ],
  "total": 2,
  "found": 1,
  "_meta": {
    "plan": "profesional",
    "remaining": 1997
  }
}

{
  "code": "4321",
  "cnae_code": "4321",
  "ejercicio": 2026,
  "tipo_it": 3.15,
  "tipo_ims": 1.65,
  "tipo_total": 4.8,
  "descripcion": "Instalaciones eléctricas",
  "source_anchor": "cuadro-i",
  "resolved_via": "exact",
  "aplicacion": "cuenta_ajena",
  "nota_reta": "1.30",
  "_meta": {
    "plan": "profesional",
    "remaining": 1996
  }
}

{
  "fecha": "2026-04-18",
  "es_habil": false,
  "motivo": "sábado",
  "siguiente_habil": "2026-04-20",
  "fuente": "BOE-A-2025-23702 (art. 30 Ley 39/2015)",
  "cobertura": "calendario estatal 2026 (BOE-A-2025-23702)"
}

{
  "nif": "B12345674",
  "tipo": "cif",
  "valido": true,
  "tipo_entidad": "Sociedad de Responsabilidad Limitada",
  "provincia_registro": "Castellón",
  "nota": "Validación algorítmica del dígito de control; no confirma la existencia del NIF en el censo de la AEAT."
}

{
  "cnae": "4321",
  "subvenciones": [
    {
      "codigo_bdns": "812345",
      "titulo": "Ayudas a la digitalización de pymes del sector construcción",
      "organo": "Ministerio de Industria y Turismo",
      "nivel1": "Administración General del Estado",
      "cnae_seccion": "F",
      "url_oficial": "https://www.pap.hacienda.gob.es/bdnstrans/GE/es/convocatoria/812345",
      "importe": 5000000,
      "estado": "Abierto"
    }
  ],
  "total": 1,
  "_meta": {
    "plan": "free",
    "count": 1,
    "note": "Vista limitada a 5 resultados con campos básicos (sin filtros). El listado completo con filtros por región, estado e importe mínimo requiere plan Profesional o superior.",
    "remaining": 240
  }
}

{
  "code": "5013",
  "slug": "albanileria-y-pequenos-trabajos-de-construccion-en-general",
  "titulo": "Albañilería y pequeños trabajos de construcción en general",
  "modulos_eligible": true,
  "regimen": {
    "actividad": { "epigrafe_iae": "501.3", "actividad_afecta": true },
    "modulos_irpf": [
      { "modulo": "Personal empleado", "unidad": "persona", "rendimiento_anual": 4685.84 }
    ],
    "modulos_iva": [
      { "modulo": "Personal empleado", "cuota_devengada_anual": 1350.48 }
    ],
    "umbrales_actividad": { "volumen_rendimientos_2026": 250000 },
    "umbrales_generales": { "volumen_compras_2026": 250000 },
    "intelligence": {
      "modulos_summary": "Actividad acogida al régimen de estimación objetiva sujeta a los límites de volumen de rendimientos.",
      "calculo_hints": {
        "primary_modulos": ["Personal empleado", "Potencia eléctrica"],
        "common_pitfalls": ["No superar el límite de volumen de rendimientos"]
      },
      "citations": [{ "orden": "HAC/1155/2025", "source_anchor": "anexo-ii", "ejercicio": 2026, "verified_at": null }]
    }
  },
  "citation": {
    "orden": "HAC/1155/2025",
    "source_anchor": "anexo-ii",
    "ejercicio": 2026,
    "verified_at": "2026-06-01T00:00:00.000Z"
  },
  "_meta": {
    "plan": "free",
    "remaining": 242
  }
}

{
  "code": "5013",
  "type": "iae",
  "obligaciones": [
    {
      "modelo_id": "130",
      "name": "Pago fraccionado IRPF (estimación directa)",
      "periodicidad": "trimestral",
      "confidence": 0.95,
      "reason": "Actividad empresarial en estimación directa",
      "fecha_proximo_plazo": "2026-10-20"
    },
    {
      "modelo_id": "303",
      "name": "IVA — Autoliquidación",
      "periodicidad": "trimestral",
      "confidence": 0.9,
      "reason": "Actividad sujeta y no exenta de IVA",
      "fecha_proximo_plazo": "2026-10-20"
    }
  ],
  "total": 2,
  "_meta": {
    "plan": "free",
    "remaining": 241
  }
}

BEGIN:VCALENDAR
VERSION:2.0
PRODID:-//Conversor IAE CNAE//Calendario Fiscal//ES
CALSCALE:GREGORIAN
METHOD:PUBLISH
X-WR-CALNAME:Calendario fiscal — IAE 5013
X-WR-TIMEZONE:Europe/Madrid
BEGIN:VEVENT
UID:[email protected]
DTSTAMP:20260703T120000Z
DTSTART;VALUE=DATE:20261001
DTEND;VALUE=DATE:20261021
SUMMARY:Modelo 130 — Pago fraccionado IRPF (3T)
URL:https://www.conversoriaecnae.es/modelo/130
STATUS:CONFIRMED
END:VEVENT
END:VCALENDAR

{
  "query": "módulos construcción",
  "consultas": [
    {
      "titulo_seo": "Tributación en módulos de una actividad de albañilería",
      "resumen": "La DGT analiza si la actividad de albañilería puede acogerse al régimen de estimación objetiva."
    }
  ],
  "total": 1,
  "_meta": {
    "plan": "free",
    "count": 1,
    "note": "Vista limitada a 3 resultados con título y resumen. La lista completa con ranking, referencia (número/slug), filtro por código IAE y paginación requiere plan Profesional o superior.",
    "remaining": 239
  }
}

{
  "numero": "V1234-26",
  "slug": "tributacion-modulos-albanileria",
  "tipo": "vinculante",
  "fecha": "2026-03-10",
  "organo": "SG de Impuestos sobre la Renta de las Personas Físicas",
  "titulo_seo": "Tributación en módulos de una actividad de albañilería",
  "resumen": "La DGT analiza si la actividad de albañilería puede acogerse al régimen de estimación objetiva.",
  "normativa": "Art. 31 LIRPF, Orden HAC/1155/2025",
  "_meta": {
    "plan": "free",
    "note": "Resumen de la consulta. El texto íntegro (hechos, cuestión planteada y contestación vinculante de la DGT) requiere plan Profesional o superior.",
    "remaining": 238
  }
}

{
  "q": "módulos estimación objetiva",
  "resultados": [
    {
      "boe_id": "BOE-A-2006-20764",
      "articulo_norm": "31",
      "bloque_titulo": "Artículo 31. Estimación objetiva",
      "snippet": "El método de estimación objetiva de rendimientos para determinadas actividades económicas se aplicará…"
    }
  ],
  "total": 1,
  "_meta": {
    "plan": "free",
    "count": 1,
    "note": "Vista limitada a 3 resultados con fragmento de texto (sin filtro por norma ni paginación). La búsqueda completa con filtro `boe_id` y paginación requiere plan Profesional o superior.",
    "remaining": 237
  }
}

{
  "boe_id": "BOE-A-2006-20764",
  "articulo_texto": {
    "bloque_id": "BOE-A-2006-20764_a31",
    "bloque_titulo": "Artículo 31. Estimación objetiva",
    "articulo_norm": "31",
    "version_idx": 4,
    "fecha_vigencia": "2025-01-01",
    "valid_to": null,
    "es_vigente": true,
    "texto_html": "<p>1. El método de estimación objetiva de rendimientos para determinadas actividades económicas…</p>",
    "id_norma_modificadora": null
  },
  "_meta": {
    "plan": "free",
    "count": 1,
    "remaining": 236
  }
}

{
  "cnae": "4321",
  "firmographics": {
    "code": "4321",
    "total_count": 8452,
    "capital_avg": 4200.5,
    "capital_median": 3000,
    "first_published": "2015-01-12",
    "last_published": "2026-06-30",
    "monthly": [
      { "month": "2026-05", "count": 61 },
      { "month": "2026-06", "count": 58 }
    ],
    "top_provincias": [
      { "provincia": "Madrid", "count": 1420 },
      { "provincia": "Barcelona", "count": 1105 }
    ],
    "recent": [
      {
        "denominacion": "INSTALACIONES ELECTRICAS GARCIA SL",
        "provincia": "Madrid",
        "capital_eur": 3000,
        "published_at": "2026-06-30",
        "cnae_primary": "4321",
        "anuncio": {
          "identificador_borme": "BORME-A-2026-150-12",
          "anio": 2026,
          "numero_boletin": 150,
          "codigo_provincia": 12,
          "pdf_url": "https://www.boe.es/borme/dias/2026/06/30/pdfs/BORME-A-2026-150-12.pdf"
        },
        "datos_registrales": {
          "tomo": "1234",
          "folio": "56",
          "seccion": "8",
          "hoja": "M-853607",
          "inscripcion": "1",
          "fecha": "22.05.25"
        }
      }
    ]
  },
  "_meta": {
    "plan": "profesional",
    "count": 1,
    "offset": 0,
    "remaining": 1998
  }
}

{
  "match": {
    "confidence": 0.92,
    "method": "semantic",
    "ambiguous": false,
    "section": { "cod_integro": "A5013", "label": "Empresarial" },
    "alternatives": []
  },
  "classification": {
    "iae": { "code": "501.3", "codeNormalized": "5013", "titulo": "Albañilería y pequeños trabajos de construcción en general" },
    "cnae2025": { "code": "4321", "codeNormalized": "4321", "titulo": "Instalaciones eléctricas" }
  },
  "fiscal_profile": {
    "sector_riesgo": "medio",
    "iva_regimen": "general",
    "irpf_regimen": "estimacion_directa_simplificada",
    "retencion_irpf_pct": null,
    "modelo_036_casillas_relevantes": ["111", "419"],
    "source": "aeat_info_censal",
    "verified": true
  },
  "obligaciones": [
    { "modelo_id": "130", "name": "Pago fraccionado IRPF (estimación directa)", "periodicidad": "trimestral", "confidence": 0.95, "reason": "Actividad empresarial en estimación directa", "fecha_proximo_plazo": "2026-10-20" }
  ],
  "subvenciones": {
    "seccion": "F",
    "abiertas_count": 12,
    "para_actividad_economica_count": 5,
    "destacadas": [
      { "codigo_bdns": "812345", "titulo": "Ayudas a la digitalización de pymes del sector construcción", "organo": "Ministerio de Industria y Turismo", "importe": 5000000, "url_oficial": "https://www.pap.hacienda.gob.es/bdnstrans/GE/es/convocatoria/812345" }
    ],
    "fuente": "BDNS / SNPSAP (IGAE)"
  },
  "registro": {
    "denominacion": "Ejemplo Digital, S.L.",
    "provincia": "Madrid",
    "capital_eur": 3000,
    "objeto_social": "Desarrollo de software a medida",
    "cnae_registral": "62.01",
    "cnae_confidence": 0.91,
    "fecha_constitucion": "2026-03-10",
    "match_quality": "exact",
    "fuente": "BORME",
    "cobertura": "constituciones desde 2026-01"
  },
  "vies": {
    "consultado": true,
    "valido": true,
    "fecha_consulta": "2026-07-23T10:00:00.000Z",
    "nota": "Dato meramente informativo (VIES, Comisión Europea)."
  },
  "deudores_aeat": {
    "comprobado": true,
    "aparece": false,
    "edicion": "13ª (30-jun-2026)",
    "fuente": "AEAT art. 95 bis LGT"
  },
  "estado_registral": {
    "estado": "activa",
    "ultimo_acto": "cambio_domicilio",
    "fecha_ultimo_acto": "2026-06-02",
    "senales_drift": [
      { "tipo": "cambio_domicilio", "fecha": "2026-06-02" }
    ],
    "hoja": "M-123456",
    "match_quality": "exact",
    "fuente": "BORME (Registro Mercantil)",
    "cobertura": "actos BORME desde 2026-01 (cobertura parcial del historial registral)"
  },
  "riesgo_resumen": {
    "nivel": "ambar",
    "motivos": [
      "Se han detectado 1 cambio(s) registral(es) (objeto social, denominación o domicilio) — señal de re-verificación (art. 10.2 RD 304/2014)."
    ],
    "senales_evaluadas": 4
  },
  "audit": {
    "source": "conversoriaecnae.es",
    "sources_oficiales": ["AEAT", "BOE", "INE", "BORME", "VIES", "AEAT (art. 95 bis)"],
    "data_version": "2026-06-01T00:00:00.000Z",
    "generated_at": "2026-07-03T10:00:00.000Z",
    "data_residency": "CH (eu-central-2, Zürich; EU adequacy decision)"
  },
  "_meta": {
    "plan": "empresa",
    "remaining": 9987
  }
}

{
  "match": {
    "confidence": 0.92,
    "method": "semantic",
    "ambiguous": false,
    "section": { "cod_integro": "A5013", "label": "Empresarial" },
    "alternatives": []
  },
  "classification": {
    "iae": { "code": "501.3", "codeNormalized": "5013", "titulo": "Albañilería y pequeños trabajos de construcción en general" },
    "cnae2025": { "code": "4321", "codeNormalized": "4321", "titulo": "Instalaciones eléctricas" }
  },
  "alta_036": {
    "epigrafe_iae": "501.3",
    "casillas_relevantes": ["111", "419"],
    "modelos_irpf": ["130"]
  },
  "facturacion": {
    "iva_tipo": 21,
    "iva_regimen": "general",
    "irpf_regimen": "estimacion_directa_simplificada",
    "retencion_irpf": { "tipo": null, "tipo_inicio_actividad": null },
    "verified": true,
    "source": "aeat_info_censal"
  },
  "regimen_recomendado": {
    "modulos_elegible": true,
    "modulos_summary": "Actividad acogida al régimen de estimación objetiva sujeta a los límites de volumen de rendimientos.",
    "calculo_hints": { "primary_modulos": ["Personal empleado", "Potencia eléctrica"] },
    "verified": true
  },
  "calendario": [
    { "modelo_id": "130", "name": "Pago fraccionado IRPF (estimación directa)", "periodicidad": "trimestral", "confidence": 0.95, "reason": "Actividad empresarial en estimación directa", "fecha_proximo_plazo": "2026-10-20" }
  ],
  "subvenciones": {
    "seccion": "F",
    "abiertas_count": 12,
    "para_actividad_economica_count": 5,
    "destacadas": [],
    "fuente": "BDNS / SNPSAP (IGAE)"
  },
  "reta": {
    "tarifa_plana_eur_mes": 87,
    "base_minima_aplica": true,
    "nota": "Tarifa plana durante los primeros 12 meses de alta (art. 38.4 LGSS).",
    "mei_eur_mes": 9.67,
    "total_primer_periodo_eur_mes": 96.67,
    "source_anchor": "reta_constants_2026"
  },
  "_meta": {
    "plan": "empresa",
    "remaining": 9986
  }
}

{
  "success": true,
  "message": "Te hemos enviado tu API key por email. Revisa tu correo (y la carpeta de spam si no la ves en unos minutos). Te enviaremos emails sobre tu clave y, si te corresponde, tu prueba de 14 días. Puedes darte de baja en cualquier momento desde cualquier email."
}

{
  "success": true,
  "url": "https://checkout.stripe.com/c/pay/cs_test_a1b2c3d4e5f6g7h8i9j0"
}

{
  "success": true,
  "data": {
    "plan": "profesional",
    "requests_used_today": 812,
    "rate_limit_per_day": 2000,
    "remaining_today": 1188,
    "is_active": true,
    "created_at": "2026-05-10T09:12:00.000Z",
    "last_used_at": "2026-07-03T08:45:12.000Z",
    "top_endpoints": [
      { "endpoint": "/api/v1/iae/5013", "count": 340 },
      { "endpoint": "/api/v1/search", "count": 220 }
    ]
  }
}

{
  "success": true,
  "api_key": "cvr_z9y8x7w6v5u4t3s2r1q0p9o8n7m6l5k4",
  "message": "Clave rotada. Guárdala: no se vuelve a mostrar."
}