Acceso a la Información del Listado de AFP mediante API

¿Qué es el Listado Público de Afiliados a AFP?

El listado público de afiliados que cumplen con los requisitos para pensionarse, en adelante, Listado Público, tiene por objeto dar a conocer en forma transparente y en iguales condiciones, la identificación de los potenciales pensionables, asegurando las mismas oportunidades a todos los actores que intervienen en las pensiones.

Este listado se enmarca en las directrices establecidas en el Libro III, Título XI, Instrucciones para emitir listado público de potenciales pensionados y solicitantes de pensión, Artículo 72 bis del D.L.

Tendrán acceso a este Listado, las Administradoras de Fondos de Pensiones (AFP) y las Compañías de Seguros de Vida que hayan informado a la Superintendencia de Valores y Seguros que comercializarán Rentas Vitalicias del D.L.

Asimismo, la AFP deberá facilitar las instancias para que los afiliados manifiesten, en cualquier momento y formalmente, su voluntad de ser excluidos de dicho Listado o de modificar la opción manifestada originalmente, independientemente si cumplen o no los requisitos para ser notificados. Para ello deberá utilizar los sitios web, los diferentes formularios que deben suscribir los afiliados para diferentes trámites en la Administradora u otra forma que estime pertinente.

Infografía: Flujo de acceso y gestión del listado público de afiliados a AFP

Integración de Datos Previsionales vía API

Las soluciones de API permiten conectar sistemas a las fuentes de datos necesarias para operar eficientemente en Chile. En el ámbito previsional, se puede acceder a los indicadores oficiales del sistema chileno directamente desde Previred.

Actualmente, se está expandiendo la integración para incluir datos más completos que requieren autenticación, facilitando así un acceso más amplio a información relevante.

Uso de APIs para la Consulta de Información

Para interactuar con cualquiera de los endpoints que no estén presentes en la sección Pública de una API, es necesario ser cliente activo de plataformas como Gael Cloud y contar con una ApiKey. La API de GAEL utiliza ApiKeys para conceder acceso a los diferentes endpoints ofrecidos por la API, garantizando la seguridad y control de acceso a la información.

Es importante destacar que los endpoints referentes a la sección Pública están protegidos con rate limiting, lo que significa que el número de solicitudes está limitado. Si tu IP queda baneada, deberás esperar hasta que el bloqueo sea levantado.

Para facilitar la integración, se ofrecen ejemplos en distintos lenguajes de programación, como Shell, Python y JavaScript. Existen 3 formas diferentes de consultar un endpoint.

Parámetros Comunes en Consultas API

Al realizar consultas a la API, algunos parámetros importantes que se pueden utilizar incluyen:

  • El parámetro cedible, que admite los valores 0, 1 o 2.
  • El parámetro tipo_papel, que admite los valores 0 o 1.
  • El parámetro tipo_libro, que admite los valores 0 o 1.
  • El parámetro certificado, que admite los valores 0 o 1.

Adicionalmente, la cadena de caracteres en base64 es utilizada en ciertos contextos específicos de la API, por ejemplo, para codificar datos complejos o binarios.

Gestión de Errores

En el proceso de integración con APIs, es común encontrar mensajes de error que indican problemas en la solicitud o el servidor. Algunos de los errores más frecuentes son:

  • Internal Server Error: Indica un error interno del servidor.
  • Service Unavailable: Señala que la API está temporalmente fuera de servicio.
Diagrama de flujo de interacción con una API, incluyendo manejo de errores comunes

Beneficios de una Plataforma API Gateway

Una plataforma como API Gateway va más allá de ser una simple API; es una solución integral que simplifica y asegura las integraciones. Por ejemplo, mantener una integración con servicios externos no es solo construirla, sino también asegurarse de que siga funcionando de manera continua y eficiente. Con API Gateway, esa responsabilidad y trabajo recaen en la plataforma.

Usuarios satisfechos expresan su conformidad: "Estoy más que conforme. Cada vez que alguien me pida una recomendación los recomendaré."

Modelo de Precios Flexible

Una ventaja significativa de las plataformas API Gateway es su modelo de precios flexible, donde se paga solo por lo que se usa:

  • Al crear una cuenta, se reciben créditos de bienvenida para realizar las primeras consultas.
  • Los usuarios compran créditos por adelantado y los usan para consultar datos según sus necesidades.
  • No hay permanencia ni mínimos de compra, ofreciendo total flexibilidad.
  • Los créditos que no se usan quedan disponibles en la cuenta sin fecha de vencimiento, lo que permite gestionarlos a conveniencia.
  • Es posible registrarse gratis y empezar a explorar la API con los créditos de bienvenida.
  • Para aquellos que desean planificar, la plataforma ofrece herramientas para estimar cuántos créditos se necesitan antes de realizar una compra.

APIs | ¿Cómo usa las APIs el sector fintech? | Banlinea

tags: #api #para #obtener #listado #de #afp