IMSS-FINDER

Extracción de Datos Laborales del IMSS

Extrae historial IMSS, SBC, patrón activo y vigencia laboral de manera asíncrona vía Webhooks. Arquitectura tolerante a latencias con procesamiento batch.

Capacidades

Fuente oficial: IMSS

1

Semanas cotizadas y vigencia de derechos

2

Salario Base de Cotización (SBC) actual

3

Patrón activo y razón social del empleador

4

Historial de movimientos afiliatorios

5

Procesamiento batch para consultas masivas

Qué recibes

Una respuesta estructurada y descifrada por tu SDK, lista para integrar a tus flujos.

Datos personales y vigencia de derechos

Nombre, fecha de nacimiento, edad, género y documentos (CURP, NSS, RFC), junto con el estatus de vigencia: seguro activo, prestaciones y fecha de validez.

Historial laboral y semanas cotizadas

Total de semanas cotizadas (descontadas y reintegradas) y el detalle por patrón: razón social, salario mensual, salario base de cotización, días cotizados, modalidad y fechas de alta/baja.

Afiliación y unidad médica

Tipo de registro, identificadores de afiliación y patrón, tipo de pensión, además de la Unidad Médica Familiar (UMF) asignada con consultorio, turno y delegación.

Domicilio y contacto registrados

Calle, colonia, municipio/estado inferido y código postal, junto con los correos y teléfonos asociados al derechohabiente.

Beneficiarios registrados

Lista de beneficiarios, cada uno con sus propios datos personales, afiliación, unidad médica y domicilio.

Contrato API (Request / Response JSON)

Patrón de integración: POST /extract  ·  GET /find/{extractionId}

// Request (payload descifrado)
{
  "curp": "GODE880512HDFRRL09",
  "email": "[email protected]",
  "express": false
}

// Response (objeto detail descifrado en GET /find/{extractionId})
{
  "issueDate": "2026-11-07",
  "personalData": {
    "name": "EDUARDO",
    "firstLastName": "GOMEZ",
    "secondLastName": "DELGADO",
    "birthDate": "1988-05-12",
    "age": 38,
    "gender": "HOMBRE",
    "documents": [
      { "type": "NSS", "id": "11088814259" },
      { "type": "CURP", "id": "GODE880512HDFRRL09" },
      { "type": "RFC", "id": "GODE880512K4A" }
    ],
    "entitlements": {
      "status": "VIGENTE",
      "insurance": true,
      "benefits": true,
      "validUntil": "2026-11-07"
    }
  },
  "affiliationInfo": {
    "registrationType": "ASEGURADO",
    "affiliationId": "11088814259",
    "employerId": "Y648291010",
    "pensionType": ""
  },
  "medicalUnitInfo": {
    "medicalUnit": "UMF 028 DEL VALLE",
    "consultingRoom": "14",
    "shift": "MATUTINO",
    "delegation": "DF SUR"
  },
  "addressInfo": {
    "street": "AV INSURGENTES SUR 1450",
    "neighborhood": "DEL VALLE",
    "city": "BENITO JUAREZ",
    "state": "CIUDAD DE MEXICO",
    "zipCode": "03100",
    "emails": ["[email protected]"],
    "phones": []
  },
  "beneficiaries": [],
  "laboralData": {
    "detailsWeeksContributed": {
      "totalWeeksContributed": "642",
      "discountedWeeks": "0",
      "reintegratedWeeks": "0"
    },
    "employmentRecords": [
      {
        "patternName": "TECNOLOGIA FINANCIERA ALPHA SA DE CV",
        "employerRegistration": "Y648291010",
        "federalEntity": "CIUDAD DE MEXICO",
        "currency": "MXN",
        "monthlySalary": 56255.20,
        "lastContributionBaseSalary": {
          "value": 1850.50,
          "frequency": "DIARIO"
        },
        "daysContributed": 1710,
        "modality": "10",
        "startDate": "2022-03-01",
        "endDate": "Vigente"
      }
    ]
  }
}

Casos de uso

Cómo lo aprovechan equipos de riesgo, RR. HH. y cumplimiento.

Onboarding y verificación de identidad (KYC)

Confirma que el derechohabiente existe y que sus documentos (CURP, NSS, RFC) son consistentes al dar de alta clientes o empleados, reduciendo el alta de identidades falsas.

Scoring de crédito y comprobación de ingresos

Usa el salario base de cotización, el patrón activo y el historial de semanas cotizadas como señal de estabilidad laboral e ingresos para originación de crédito.

Verificación de empleo y background check

Valida la trayectoria laboral declarada por un candidato contra los movimientos afiliatorios oficiales y confirma la vigencia de derechos antes de contratar.

Integración y seguridad

Integración asíncrona: lanzas la consulta con un POST extract y recibes el resultado por webhook o consultando GET find, sin bloquear tus procesos.

Cifrado de extremo a extremo con AES-256-GCM + RSA-4096-OAEP: el dato viaja protegido y solo tu llave privada puede descifrarlo.

Cada petición se firma con RSA-PSS, garantizando integridad y autenticidad frente a alteraciones o suplantación.

Opción sin retención de PII (Zero-Retention): el resultado se procesa y entrega sin conservarse tras la consulta.

Disponibilidad respaldada por un SLA del 99.2%.

Preguntas Frecuentes sobre IMSS-FINDER

Respuestas directas sobre alcance funcional, casos de uso ideales y arquitectura de seguridad.

¿Qué es IMSS-FINDER y qué datos oficiales valida en México?

IMSS-FINDER es un motor de la suite de AlphaTech conectado con IMSS. Extrae historial IMSS, SBC, patrón activo y vigencia laboral de manera asíncrona vía Webhooks. Arquitectura tolerante a latencias con procesamiento batch. Entre sus capacidades principales destacan: Semanas cotizadas y vigencia de derechos; Salario Base de Cotización (SBC) actual; Patrón activo y razón social del empleador.

¿Para quién es ideal IMSS-FINDER y en qué casos de uso se aplica?

IMSS-FINDER es ideal para instituciones financieras (Bancos, SOFOMes, Fintechs), aseguradoras, áreas de Cumplimiento (PLD/FT), equipos legales, Recursos Humanos y corporativos en México que buscan automatizar el onboarding, prevenir el fraude de identidad o documental y tomar decisiones de riesgo en tiempo real con información verificada ante IMSS.

¿Por qué elegir IMSS-FINDER de AlphaTech frente a consultas manuales o desarrollos internos?

A diferencia de la revisión manual en portales (que toma de 15 a 45 minutos por expediente y es propensa a errores) o de construir conectores internos que requieren meses de mantenimiento, IMSS-FINDER entrega respuestas estructuradas en JSON bajo un mismo contrato unificado de +40 APIs, con SLA del 99.2%, tolerancia a latencias y soporte para procesamiento masivo (Batch CSV) o Workflows condicionales.

¿Cómo se integra IMSS-FINDER y qué medidas de seguridad incluye?

Se integra en menos de 2 horas mediante API REST (con SDKs oficiales en Python, Node.js vía pnpm y nodo para n8n), Portal Web No-Code, Batch CSV, Workflows o Servidor MCP (atsis-mcp). Todas las peticiones viajan bajo arquitectura Zero-Trust con cifrado híbrido de extremo a extremo (AES-256-GCM + RSA-4096-OAEP), firma digital RSA-PSS y operación sin retención de datos personales (LFPDPPP).

Combínalo en un Workflow con estas APIs

Orquesta múltiples validaciones en una sola llamada con lógica condicional o desde nuestro Servidor MCP:

INFONAVIT-FINDER →Subcuenta SAR97 y SIANSS-FINDER →Localización NSSINCOME-FINDER →Ingresos y Nómina SATPREDICTIVE ALPHASCORE →Score Crediticio IA

¿Listo para integrar IMSS-FINDER?

Documentación OpenAPI 3.0, SDKs en Python, Node y Java. Integración en minutos.

Solicitar Acceso API