Sign in

v2

latestOpenAPI 3.0.3CC-BY-4.02026-07-262256119.8 KB
B2B

Configurar actividad para onboarding SaaS / facturación

Vista de onboarding para SaaS de facturación y ERPs. Dado un código IAE/CNAE o texto de actividad libre, devuelve toda la configuración fiscal necesaria para pre-rellenar un alta de autónomo o empresa: epígrafe IAE, casillas Modelo 036, tipo y régimen de IVA, retención IRPF (tipo general y tipo inicio de actividad), régimen recomendado y próximos plazos fiscales. Requiere plan Profesional o superior. Envía code (+ code_type opcional) O activity_text (2–200 caracteres), nunca ambos a la vez.

post/onboarding/activity

Request body

codestring

Epígrafe IAE con o sin puntos (solo alfanuméricos y puntos, máx. 20 caracteres). Mutuamente excluyente con activity_text. Úsalo siempre junto a code_type:"iae" (o sin code_type); code_type:"cnae" devuelve 400 en estos endpoints.

code_type'iae' | 'cnae'

Tipo de catálogo del código. Opcional; por defecto "iae". Solo se admite "iae" en estos endpoints — enviar "cnae" devuelve 400. Para buscar por actividad sin conocer el epígrafe IAE, usa activity_text en su lugar.

activity_textstring

Descripción libre de la actividad económica (2–200 caracteres). Mutuamente excluyente con code.

Example request

{
  "code": "5013",
  "code_type": "iae",
  "activity_text": "reformas de albañilería"
}

Response

Configuración fiscal para onboarding

Example response

{
  "match": {
    "confidence": 0.97,
    "method": "semantic",
    "alternatives": [
      {
        "code": "504.1",
        "titulo": "Instalaciones eléctricas en general",
        "type": "iae",
        "score": 0.71
      }
    ]
  },
  "classification": {
    "iae": {
      "code": "501.3",
      "codeNormalized": "5013",
      "titulo": "Albañilería y pequeños trabajos de construcción"
    },
    "cnae2025": {
      "code": "43.99",
      "codeNormalized": "4399",
      "titulo": "Otras actividades de construcción especializada"
    }
  },
  "alta_036": {
    "epigrafe_iae": "501.3",
    "casillas_relevantes": [
      "601",
      "602"
    ]
  },
  "facturacion": {
    "iva_regimen": "general",
    "retencion_irpf": {
      "tipo": 15,
      "tipo_inicio_actividad": 7
    },
    "verified": true
  },
  "regimen_recomendado": {
    "modulos_summary": "No apto para módulos",
    "verified": true
  },
  "calendario": [
    {
      "modelo_id": "303",
      "name": "IVA — Autoliquidación trimestral",
      "periodicidad": "trimestral",
      "confidence": 0.95,
      "reason": "Actividad sujeta a IVA",
      "fecha_proximo_plazo": "2026-07-20"
    }
  ],
  "subvenciones": {
    "seccion": "G",
    "abiertas_count": 42,
    "para_actividad_economica_count": 17,
    "destacadas": [
      {
        "codigo_bdns": "800123",
        "titulo": "Ayudas a la digitalización de pymes",
        "organo": "Red.es",
        "importe": 250000
      }
    ],
    "fuente": "BDNS / SNPSAP (IGAE)"
  },
  "reta": {
    "tarifa_plana_eur_mes": 80,
    "base_minima_aplica": true,
    "nota": "Cuota de partida (tarifa plana): punto de partida del alta. La cuota definitiva depende del rendimiento neto anual."
  },
  "_meta": {
    "plan": "free",
    "remaining": 248,
    "upgrade_hint": "Has usado más del 80% de tu cuota diaria. Mejora a Profesional por 29€/mes para 2000 consultas/día: https://www.conversoriaecnae.es/precios",
    "upgrade": {
      "url": "https://www.conversoriaecnae.es/precios",
      "current_plan": "free",
      "recommended_plan": {
        "id": "profesional",
        "label": "Profesional",
        "daily_limit": 2000,
        "monthly_price_eur": 29
      },
      "daily_limit_after": 2000,
      "price_eur_monthly": 29
    }
  }
}