Consulta de Agente Promotor - Portal Servicios Banamex

Información General

INFORMACIÓN

Propósito: Este documento describe el servicio REST para consultar la información de un agente promotor, utilizado en el proceso de autenticación y validación de agentes en el Portal de Servicios Banamex.

Este endpoint permite obtener la información completa de un agente promotor registrado en el sistema, incluyendo sus datos personales, CURP, fotografía y tipos de agente asociados.

Visión General

El servicio de consulta de agente promotor proporciona una interfaz para validar y obtener los datos completos de los agentes registrados en el sistema de Citibanamex Afore. Este servicio es fundamental en el proceso de autenticación inicial, permitiendo verificar la identidad y permisos del agente antes de proceder con operaciones del sistema.

Características Principales

• ✅ Consulta de datos del agente promotor
• ✅ Validación de afiliación a Citibanamex Afore
• ✅ Obtención de tipos de agente
• ✅ Respuesta en formato JSON

Servicio de Consulta de Agente

Entornos Disponibles

El servicio está disponible en dos entornos:

Desarrollo

POST http://lbint-devl.procesar.net/comunesPulssar/agentePromotor/consultarAgente

Preproduccin

POST http://192.168.1.61/comunesPulssar/agentePromotor/consultarAgente

Configuración General:

• Método: POST
• Protocolo: HTTP/REST
• Encoding: UTF-8
• Formato de respuesta: JSON

Descripción

Este servicio REST permite consultar la información completa de un agente promotor registrado en el sistema de Citibanamex Afore. El servicio valida la existencia del agente mediante su clave, AFORE y tipo, retornando todos sus datos personales y de configuración. Es utilizado en los procesos de autenticación y validación de permisos.

INFORMACIÓN

Nota Importante: Este servicio debe ser utilizado para validar la identidad del agente antes de permitir el acceso a funcionalidades críticas del sistema.

Request Body

El servicio requiere un JSON con la siguiente estructura:

{
  "claveAfore": "552",
  "claveAgente": "0602259186",
  "tipoAgente": "06"
}

CONSEJO

Datos Críticos: Las líneas resaltadas (2-4) contienen la información necesaria para la autenticación del agente. Verifica que estos datos sean correctos antes de enviar la solicitud.

Campos del Request

Campo	Tipo	Requerido	Descripción
claveAfore	String	Sí	Clave de la AFORE (552 = CITIBANAMEX AFORE)
claveAgente	String	Sí	Clave única del agente promotor
tipoAgente	String	Sí	Tipo de agente (ej. "06" para Agente Promotor estándar)

Respuesta

El servicio devuelve un JSON con la información completa del agente promotor:

Ejemplo de Respuesta

{
  "codigoOperacion": null,
  "datosAgente": {
    "claveAfore": "552",
    "claveAgente": "0602259186",
    "descripcionAfore": "CITIBANAMEX AFORE",
    "curpAgente": "OOCR750309MCSLNY00",
    "nombreAgente": "REYNA GISELA",
    "apePaternoAgente": "OLMOS",
    "apeMaternoAgente": "CANCINO",
    "fotoAgente": null,
    "tipoAgente": [
      "06"
    ]
  }
}

CONSEJO

Datos principales: Las líneas resaltadas (3-7) contienen la información básica del agente. Estos son los campos más utilizados en las validaciones.

Campos de Respuesta

Datos Principales

Campo	Tipo	Descripción
datosAgente.claveAfore	String	Clave de la AFORE (552 = CITIBANAMEX AFORE)
datosAgente.claveAgente	String	Clave única del agente promotor
datosAgente.descripcionAfore	String	Nombre descriptivo de la AFORE
datosAgente.curpAgente	String	CURP del agente promotor
datosAgente.nombreAgente	String	Nombre(s) del agente
datosAgente.apePaternoAgente	String	Apellido paterno del agente
datosAgente.apeMaternoAgente	String	Apellido materno del agente

Datos Adicionales

Campo	Tipo	Descripción
datosAgente.fotoAgente	String/Null	Fotografía del agente en Base64 (null si no existe)
datosAgente.tipoAgente	Array[String]	Lista de tipos de agente asignados

Metadatos de Operación

Campo	Tipo	Descripción
codigoOperacion	String/Null	Código de operación (null en respuesta exitosa)

Ejemplos de Solicitud

Desarrollo

POST http://lbint-devl.procesar.net/comunesPulssar/agentePromotor/consultarAgente
Content-Type: application/json

{
  "claveAfore": "552",
  "claveAgente": "0602259186",
  "tipoAgente": "06"
}

Preproduccin

POST http://192.168.1.61/comunesPulssar/agentePromotor/consultarAgente
Content-Type: application/json

{
  "claveAfore": "552",
  "claveAgente": "0602259186",
  "tipoAgente": "06"
}

Ejemplo con cURL

curl -X POST http://lbint-devl.procesar.net/comunesPulssar/agentePromotor/consultarAgente \
  -H "Content-Type: application/json" \
  -d '{
    "claveAfore": "552",
    "claveAgente": "0602259186",
    "tipoAgente": "06"
  }'

Ejemplo de Respuesta Exitosa

{
  "codigoOperacion": null,
  "datosAgente": {
    "claveAfore": "552",
    "claveAgente": "0602259186",
    "descripcionAfore": "CITIBANAMEX AFORE",
    "curpAgente": "OOCR750309MCSLNY00",
    "nombreAgente": "REYNA GISELA",
    "apePaternoAgente": "OLMOS",
    "apeMaternoAgente": "CANCINO",
    "fotoAgente": null,
    "tipoAgente": ["06"]
  }
}

Códigos de Error

Código	Descripción	Acción
200	Operación exitosa	Continuar flujo normal
400	Solicitud incorrecta (parámetros faltantes o inválidos)	Verificar estructura del request
404	Agente no encontrado	Verificar datos del agente
500	Error interno del servidor	Reintentar o contactar soporte

Consideraciones de Implementación

ADVERTENCIA

Autenticación y Seguridad

• Implementar autenticación mediante tokens o certificados
• Utilizar HTTPS en producción
• Implementar rate limiting para prevenir abusos
• Registrar logs de consultas para auditoría

PELIGRO

Manejo de Errores

• Implementar manejo de errores HTTP (4xx, 5xx)
• Reintentar automáticamente para errores temporales
• Mostrar mensajes de error amigables al usuario
• Registrar errores para monitoreo y análisis

INFORMACIÓN

Validación de Datos

• Validar formato de clave de agente antes de enviar la petición
• Verificar que la clave de AFORE sea válida
• Validar que el tipo de agente corresponda con los permisos necesarios
• Implementar validación de tipos de datos recibidos

Notas Importantes

ADVERTENCIA

Validación de Datos

• La clave de la AFORE debe ser válida (552 para CITIBANAMEX AFORE)
• La clave del agente debe estar registrada en el sistema
• El tipo de agente debe corresponder con los permisos del agente
• El campo fotoAgente puede ser null si no se ha cargado una fotografía
• Los campos de nombre y apellidos pueden contener espacios en blanco adicionales

CONSEJO

Tipos de Agente

El campo tipoAgente en el request y response puede contener diferentes valores:

• "06": Agente Promotor estándar
• Otros códigos según la clasificación interna de la AFORE

En el response, tipoAgente es un array que puede contener múltiples valores.

Referencias

• Portal Servicios Banamex - Visión General
• Modificación de Datos
• Retiros Parciales Desempleo IMSS