Servicio de Intercomunicación del Infonavit: cómo integrarlo a un sistema de nómina

La intercomunicación del Infonavit permite que un sistema de nómina consulte directamente información sobre avisos de retención, modificación de factor y suspensión relacionados con los créditos de los trabajadores. El objetivo es reducir capturas manuales y ayudar a que los descuentos se calculen con la información vigente al momento de procesar la nómina.

¿Qué es la intercomunicación del Infonavit?

El Servicio de Intercomunicación de Avisos del Infonavit es un mecanismo electrónico que conecta los sistemas de control de nómina con las herramientas tecnológicas del Instituto.

A diferencia del Servicio de Descarga de Avisos, que permite al patrón consultar y exportar información desde el Portal Empresarial, este servicio está pensado para que el propio sistema de nómina realice la consulta.

El intercambio se realiza en formato JSON. De esta forma, el sistema puede recuperar masivamente datos de avisos de crédito y utilizar esa información en sus procesos de cálculo de amortizaciones.

El Infonavit señala entre los beneficios esperados la reducción de capturas manuales, una mayor oportunidad para aplicar retenciones o suspensiones y una mayor exactitud en los importes a retener.

¿Quién necesita certificarse?

Aquí conviene distinguir tres escenarios.

Si una empresa utiliza un sistema de nómina que ya está certificado ante el Infonavit, el patrón no tiene que desarrollar por su cuenta la integración. Debe generar sus credenciales y registrar una relación de confianza con el desarrollador certificado para que el sistema pueda consultar la información correspondiente.

Si una empresa desarrolla sistemas de nómina para terceros, debe obtener la certificación del Servicio de Intercomunicación de Avisos antes de utilizarlo en producción.

También puede ocurrir que el propio patrón tenga un sistema de nómina desarrollado internamente. En ese caso, el Infonavit permite que la misma empresa actúe como desarrollador, pero deberá realizar el proceso de certificación.

Por ello, implementar la intercomunicación del Infonavit no consiste únicamente en consumir un servicio web: primero debe definirse quién será el desarrollador responsable y si ya cuenta con la certificación requerida.

¿Qué requisitos debe cumplir el desarrollador?

Los lineamientos del Instituto establecen varios requisitos para solicitar la certificación. Entre ellos se encuentran:

  • Estar inscrito en el RFC
  • Contar con e.firma vigente
  • Estar registrado como patrón en el Portal Empresarial
  • Encontrarse al corriente en aportaciones y amortizaciones ante el Infonavit al momento de la solicitud
  • Tener un RFC válido registrado en los sistemas del Instituto;
  • Tener vinculados correctamente el RFC y los Números de Registro Patronal (NRP)
  • Mantener actualizados los datos de contacto.

Además, es necesario obtener una contraseña específica para los Servicios de Intercomunicación desde el Portal Empresarial.

La solicitud de certificación también se realiza desde este portal, dentro de Mis Trámites → Servicios de Intercomunicación → Certificación para desarrolladores. El proceso requiere aceptar y firmar electrónicamente los términos y condiciones.

¿Qué es una relación de confianza?

La relación de confianza vincula al patrón con el desarrollador certificado que utilizará el servicio para consultar su información.

El registro se realiza desde el Portal Empresarial y requiere aceptar y firmar electrónicamente los términos y condiciones. El patrón selecciona al desarrollador certificado y define la vigencia de esa relación.

Esto es importante desde el punto de vista de seguridad: utilizar un sistema certificado no significa entregar libremente la e.firma al proveedor de nómina. El servicio utiliza un mecanismo específico para establecer la relación entre ambas partes.

Si quieres profundizar en este punto, en Facturando ya explicamos cómo proteger tu e.firma cuando otra persona necesita realizar trámites y por qué conviene utilizar los mecanismos de autorización previstos para cada servicio en lugar de distribuir innecesariamente las credenciales.

¿Cómo se comunica el sistema de nómina con el Infonavit?

La documentación técnica vigente describe un flujo de autenticación antes de realizar las consultas.

Primero se genera un TOTP, un código numérico de ocho caracteres que tiene una vigencia de 60 segundos. Después se genera un TOKEN que vincula al desarrollador certificado con la empresa cuya información se quiere consultar; ese TOKEN tiene una vigencia de 24 horas.

Una vez autenticado, el sistema envía el TOKEN y los criterios de búsqueda necesarios. El Infonavit devuelve masivamente la información en formato JSON.

La guía contempla dos tipos de respuesta:

  • una con los campos mínimos necesarios para realizar el cálculo de amortización o suspensión;
  • otra con los datos contenidos en la representación del aviso de crédito.

La documentación también aclara un punto importante: determinados datos necesarios para realizar correctamente los cálculos provienen del propio sistema de nómina y no son proporcionados por el servicio.

La integración no termina cuando el sistema recibe un JSON

Este es uno de los aspectos más importantes del proceso.

La certificación no valida únicamente que el software pueda conectarse y descargar información. El Infonavit también comprueba que los datos sean consumidos correctamente y que los cálculos de las retenciones de amortización se implementen conforme a los casos previstos.

El proceso utiliza un ambiente de pruebas y el Instituto entrega al desarrollador un set de pruebas en Excel.

Primero se realizan validaciones sobre el consumo de información: el sistema debe enviar parámetros consistentes y recuperar y almacenar correctamente los datos devueltos por el servicio.

Para avanzar a las pruebas de cálculo de amortizaciones, el desarrollador debe aprobar completamente esa primera etapa.

Después debe demostrar cómo su sistema realiza los cálculos. Entre las evidencias solicitadas por los lineamientos aparecen:

  • Resultados de las pruebas
  • Archivos JSON obtenidos del servicio
  • Capturas del sistema de nómina
  • Evidencia del cálculo de amortización
  • XML de CFDI de nómina sin timbrar correspondientes a determinados casos de prueba.

La intercomunicación del Infonavit, por tanto, implica dos trabajos distintos: integrar técnicamente el servicio y adaptar correctamente la lógica de nómina.

¿Qué sucede cuando se aprueba la certificación?

Una vez integradas las evidencias, el desarrollador debe cargarlas en el Portal Empresarial para continuar con la certificación.

Los lineamientos señalan que el Instituto cuenta con cinco días hábiles para evaluar los resultados y emitir una respuesta después de recibir las evidencias.

Si existen inconsistencias, el desarrollador debe corregirlas. Cuando las pruebas son aprobadas, el Infonavit concede la certificación y permite el acceso al ambiente productivo, después de firmar electrónicamente los términos y condiciones correspondientes.

La certificación tiene vigencia indefinida, aunque el Instituto puede suspender o cancelar el uso del servicio cuando se incumplen las obligaciones previstas en los lineamientos.

La responsabilidad tampoco termina con la certificación. Entre otras obligaciones, el desarrollador debe proteger las credenciales, mantener la confidencialidad de los datos personales, validar periódicamente los cálculos y atender las observaciones que pueda realizar el Instituto.

¿Vale la pena integrar este servicio?

Para un desarrollador de software de nómina, la principal ventaja es eliminar parte del proceso manual que existe entre la generación de un aviso y su incorporación al cálculo.

La intercomunicación del Infonavit permite que el sistema consulte cambios de forma masiva, reciba datos estructurados y los incorpore a procesos automatizados. Pero no debe tratarse como una simple conexión a una API: el Infonavit exige certificación y valida tanto el consumo de información como los cálculos derivados de ella.

Antes de implementar la intercomunicación del Infonavit, conviene revisar si el sistema será utilizado por un solo patrón, por varios clientes o por un proveedor comercial de nómina, porque esa decisión afecta quién deberá certificarse y cómo se establecerá la relación de confianza.

Para un patrón que ya utiliza un sistema certificado, el camino es distinto: no necesita desarrollar esta integración. Debe establecer la relación de confianza correspondiente y utilizar las funciones que su proveedor haya implementado.

Antes de iniciar un desarrollo propio, conviene revisar la documentación vigente del Infonavit, confirmar los requisitos de certificación y trabajar desde el principio con el ambiente de pruebas.

Continúa aprendiendo sobre nómina e Infonavit

Los servicios electrónicos del Infonavit abren nuevas posibilidades para automatizar procesos que tradicionalmente dependen de consultas y capturas manuales. Entender cómo funcionan ayuda a evitar implementaciones improvisadas y a mantener los procesos de nómina alineados con la información del Instituto.

En el canal de YouTube de Facturando publicamos contenidos sobre nómina, CFDI, SAT, IMSS e Infonavit. Suscríbete para recibir nuestras próximas explicaciones y actualizaciones.