cs-serlefin-sapi icon

cs-serlefin-sapi

1.0.x
(0 reviews)
Servicio de integración para operaciones financieras con Serlefin. Permite gestionar proveedores, autenticar usuarios y consultar servicios financieros mediante API REST segura con soporte para múltiples ambientes.

🛡️ cs-serlefin-sapi

Esta API proporciona servicios de integración para gestión de proveedores y servicios financieros de Serlefin. Incluye endpoints para:

  • Consulta y registro de proveedores de servicios financieros
  • Autenticación segura de usuarios proveedores
  • Gestión de usuarios asociados a proveedores
  • Consulta de catálogo de servicios disponibles
  • Búsqueda de servicios específicos por código
  • Integración con sistemas de cuentas médicas

Todos los servicios se exponen a través de una arquitectura RESTful con comunicación HTTPS y proporcionan acceso seguro a los sistemas backend de Serlefin y cuentas médicas con alta disponibilidad.

🌐 Información Base

  • Título de la API: cs-serlefin-sapi
  • Versión: 1.0.30
  • GroupId: com.colemena-seguros.mulesoft
  • Protocolo: REST
  • Formato de Datos: JSON
  • Seguridad: HTTPS con TLS/SSL
  • Puerto: 8081
  • Base Path: /api

🚀 Cómo Comenzar

  1. Autenticación: Configura el client_id y credenciales según el ambiente (DEV/QA/PROD)
  2. URL Base: Usa el endpoint base configurado más el path /api
  3. Encabezados: Agrega los siguientes headers en tus solicitudes:
Content-Type: application/json
Authorization: Bearer {token}
client_id: {client_id}

🚀 Cómo Consumir

Puedes acceder y consumir esta API a través de:

📍 Endpoints Disponibles

MétodoEndpointDescripción
POST/api/servicesConsultar catálogo completo de servicios financieros disponibles
POST/api/providersRegistrar nuevo proveedor de servicios financieros en el sistema
GET/api/providers-usersObtener listado de usuarios asociados a proveedores
POST/api/authenticate-providers-usersAutenticar usuarios proveedores con credenciales seguras
POST/api/services-by-codeBuscar servicios específicos mediante código identificador

⚠️ Manejo de Errores

Se utilizan códigos de estado HTTP estándar para el manejo de errores:

📊 Códigos de Respuesta

CódigoEstadoDescripciónCausa ComúnAcción Recomendada
200✅ OKLa solicitud fue exitosaOperación completada correctamenteContinuar con el procesamiento
400❌ Bad RequestParámetros faltantes o inválidosFormato de datos incorrectoRevisar estructura del JSON
401🔒 UnauthorizedAutenticación fallidaClient_id inválido o faltanteVerificar credenciales de autenticación
404🔍 Not FoundEndpoint o recurso no encontradoURL incorrectaVerificar la ruta del endpoint
405🚫 Method Not AllowedMétodo HTTP no permitidoUsar GET en lugar de POSTVerificar el método HTTP correcto
406⚠️ Not AcceptableFormato de respuesta no aceptableHeaders Accept incorrectosAjustar headers de aceptación
415📄 Unsupported Media TypeTipo de contenido no soportadoContent-Type incorrectoUsar application/json
500💥 Internal Server ErrorError inesperado en el servidorFallo interno del sistemaContactar soporte técnico
501🛠️ Not ImplementedFuncionalidad no implementadaEndpoint en desarrolloVerificar documentación actualizada
503🔧 Service UnavailableServicio temporalmente no disponibleSistema backend no disponibleReintentar más tarde

🔍 Formato de Errores

{
  "message": "Bad request",
  "errorDetail": {
    "description": "Campo requerido faltante",
    "detailedDescription": "El campo 'serviceCode' es obligatorio"
  }
}

📞 Soporte

Para asistencia, contacta al equipo de Coordinación de Servicios de Integración y Aplicaciones.

Correo electrónico: epalma@fgs.co

📅 Información Adicional

Documentación generada en Noviembre 2025 - API cs-serlefin-sapi v1.0.0

© 2025 Fundación Grupo Social - Colmena. Sistema de integración Serlefin

📋 Nota Importante: Esta documentación se actualiza continuamente. Para la versión más reciente consulta el Portal de Exchange oficial.

🔒 Aviso de Seguridad: Nunca compartas credenciales de API en repositorios públicos. Usa variables de entorno para información sensible y mantén actualizados los certificados de seguridad.

Reviews