Cómo consultar el NSS con el CURP: Guía de integración API
Para consultar el NSS con el CURP de forma automatizada, utiliza una API que envíe el CURP al registro del IMSS y reciba el Número de Seguridad Social (NSS) asociado, junto con datos del trabajador. Esta guía explica la integración técnica, los casos de uso empresariales y las consideraciones de cumplimiento normativo para implementar esta consulta en tu sistema.
¿Qué es el NSS y cómo se relaciona con el CURP?
El NSS (Número de Seguridad Social) es un identificador único que el Instituto Mexicano del Seguro Social (IMSS) asigna a cada trabajador registrado. El CURP (Clave Única de Registro de Población) es el identificador de todas las personas en México, emitido por RENAPO. Ambos están vinculados porque el IMSS utiliza el CURP como base para generar el NSS. La consulta directa entre ambos permite a las empresas verificar la afiliación de un empleado sin depender de que el empleado recuerde su número de seguridad social.
Integración técnica de la API NSS
La API de consulta NSS acepta un CURP válido como entrada y devuelve el NSS correspondiente, nombre completo, estatus en el IMSS y fecha de registro. No inventes endpoints ni parámetros; consulta la documentación oficial para los detalles exactos. Los pasos conceptuales de una integración típica son:
- El usuario proporciona su CURP (por ejemplo, durante el onboarding).
- El sistema valida el formato del CURP (18 caracteres alfanuméricos).
- Se envía una solicitud REST a la API con el CURP.
- La API responde con el NSS, nombre completo y estatus.
- El sistema almacena el NSS en el expediente del empleado, con consentimiento y protección de datos.
| Componente | Descripción | Ejemplo de salida |
|---|---|---|
| Entrada | CURP en formato estándar | CURP123456HDFRRN01 |
| Salida principal | NSS asignado por el IMSS | 12345678901 |
| Datos adicionales | Nombre, CURP, estatus en IMSS, fecha de registro | Juan Pérez López, Activo |
Para pruebas, la API ofrece un sandbox con casos sintéticos que simulan respuestas de IMSS sin afectar datos reales.
Casos de uso empresariales para la consulta NSS-CURP
Verificación de empleados en agencias de staffing
Las agencias de staffing necesitan confirmar que un candidato tiene un NSS activo antes de registrarlo en el IMSS. Al consultar el NSS con el CURP, se agiliza el proceso de contratación y se evita duplicidad de registros.
Validación de elegibilidad en fintechs y microseguros
Las fintechs que ofrecen créditos o microseguros pueden verificar que el solicitante tiene historial laboral formal (NSS) como parte del análisis de riesgo. La consulta se integra en el flujo de debida diligencia (DD) del cliente.
Cumplimiento de debida diligencia (CDD) en instituciones financieras
Las instituciones reguladas por la CNBV utilizan la consulta NSS-CURP como parte de la debida diligencia del cliente (CDD). Combinada con listas AML (como la lista 69-B del SAT), permite una verificación de identidad más completa. Consulta la guía de compliance para más detalles.
Cumplimiento normativo y privacidad de datos
El NSS es un dato personal sensible según la Ley Federal de Protección de Datos Personales en Posesión de los Particulares (LFPDPPP). Toda consulta debe realizarse con el consentimiento explícito del titular y almacenar los resultados de forma segura, con cifrado y controles de acceso. Las entidades financieras supervisadas por la CNBV deben cumplir con las disposiciones de carácter general en materia de identificación y conocimiento del cliente.
API Pull ofrece respuestas firmadas con un hash de verificación para auditoría, permitiendo a las instituciones demostrar la trazabilidad de cada consulta ante el regulador. Esto es esencial para cumplir con los requisitos de la LFPDPPP y las normas de la CNBV.
Cuándo no es la herramienta adecuada
La consulta NSS-CURP no es el único método de verificación. Aquí algunos casos en los que conviene usar otra herramienta:
- Validación de CURP sin necesidad de NSS: Si solo necesitas confirmar que un CURP existe y es correcto, utiliza la API CURP directa contra RENAPO. Puedes consultar la guía de CURP API para más información.
- Verificación de identidad completa: Para un proceso KYC robusto, combina la consulta NSS con datos biométricos, validación de INE y listas de riesgos. La consulta NSS-CURP por sí sola no reemplaza un KYC integral.
- Obtención de datos actualizados de IMSS (salario, semanas cotizadas): El NSS no incluye información sobre el salario registrado o historial de cotización. Para eso se requiere otra API especializada.
Próximos pasos: Implementa la consulta NSS con CURP en tu flujo
¿Listo para automatizar la verificación de empleados? Crea una cuenta gratuita en API Pull y accede al sandbox con casos sintéticos. Prueba la API de forma segura, revisa la documentación completa y, si tienes dudas, contacta al equipo de soporte técnico. Comienza a consultar el NSS con el CURP de forma automatizada, segura y conforme a la normativa mexicana.
Preguntas frecuentes
¿Cómo puedo consultar el NSS de un empleado usando su CURP?
Envía el CURP a la API REST de consulta NSS. La API responderá con el NSS asociado, nombre completo y estatus en el IMSS. Es necesario contar con el consentimiento del empleado para procesar sus datos personales.
¿Qué datos necesito para hacer la consulta?
Solo necesitas el CURP del trabajador, que debe ser válido y estar registrado en RENAPO. No se requiere ningún otro documento adicional para la consulta automatizada.
¿Es legal consultar el NSS de otra persona?
Sí, siempre que tengas el consentimiento explícito del titular y cumplas con la LFPDPPP y las regulaciones de la CNBV. Las empresas deben implementar medidas de seguridad para proteger los datos obtenidos.
¿Cuánto tiempo tarda la consulta?
La respuesta de la API suele llegar en menos de 500 ms, dependiendo de la red y la disponibilidad del IMSS. El sandbox responde de forma inmediata para pruebas.
¿Puedo consultar el NSS sin CURP?
No. El CURP es la clave de búsqueda principal para obtener el NSS. Si no tienes el CURP, deberás obtenerlo primero a través de otros medios (por ejemplo, usando la INE del trabajador).