Sign in

v2

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

Enriquecer actividad económica para KYB bancario

Vista KYB (Know Your Business) para entidades financieras. Devuelve la clasificación IAE/CNAE del cliente, perfil fiscal completo (sector de riesgo, regímenes IVA/IRPF, retenciones, casillas Modelo 036) y obligaciones fiscales aplicables. Requiere plan Profesional o superior. Envía code (+ code_type opcional) O activity_text (2–200 caracteres), nunca ambos a la vez.

post/kyb/enrich

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.

company_namestring

Denominación social de la empresa a enriquecer con datos de constitución BORME. Debe enviarse junto con code o activity_text; en solitario devuelve 400.

provinciastring

Provincia de la empresa, para desambiguar homónimos en la búsqueda BORME. Opcional, solo válido junto a company_name.

nifstring

NIF/CIF español a validar en el censo VIES (IVA intracomunitario) de la Comisión Europea y a contrastar con la publicación oficial de deudores (art. 95 bis LGT) como señal dentro del expediente de diligencia debida. Debe enviarse junto con code o activity_text; en solitario devuelve 400. Un formato inválido (con o sin prefijo ES) también devuelve 400.

Example request

{
  "code": "5013",
  "code_type": "iae",
  "activity_text": "reformas de albañilería",
  "company_name": "Ejemplo Digital, S.L.",
  "provincia": "Madrid",
  "nif": "B12345678"
}

Response

Perfil fiscal completo para KYB

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"
    }
  },
  "fiscal_profile": {
    "sector_riesgo": "medio",
    "iva_regimen": "general",
    "irpf_regimen": "estimacion_directa",
    "retencion_irpf_pct": 15,
    "modelo_036_casillas_relevantes": [
      "601",
      "602"
    ]
  },
  "obligaciones": [
    {
      "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)"
  },
  "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,
    "importe_eur": 750000,
    "edicion": "13ª (30-jun-2026)"
  },
  "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"
    ],
    "data_version": "2026-06-01T10:00:00Z",
    "generated_at": "2026-06-12T10:00:00Z",
    "data_residency": "EU (eu-central-2)"
  },
  "_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
    }
  }
}