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

La API cs-serlefin-sapi provee una solución integral para la gestión de proveedores y servicios financieros del sistema Serlefin, permitiendo la integración controlada con sistemas de cuentas médicas y servicios corporativos internos.

Expone operaciones REST para:

  • Consulta y gestión de catálogo de servicios financieros
  • Registro y consulta de proveedores de servicios
  • Autenticación y gestión de usuarios proveedores
  • Búsqueda de servicios por código identificador
  • Integración con sistemas backend de Serlefin y cuentas médicas

La API actúa como una System API (SAPI), gestionada desde MuleSoft Anypoint Platform.

🌐 Información Básica

  • Nombre de la API: cs-serlefin-sapi
  • Plataforma: MuleSoft Anypoint Platform
  • Tipo: System API
  • URL Base QA:https://cs-serlefin-sapi-qa-v1.us-e1.cloudhub.io/api/
  • URL Base PROD:https://cs-serlefin-sapi-prod-v1.us-e1.cloudhub.io/api/
  • Protocolo: HTTPS / REST
  • Formato de Datos: JSON

🔐 Autenticación

Para consumir esta API, el consumidor debe enviar obligatoriamente en cada solicitud los siguientes mecanismos de seguridad:

  1. Client ID Enforcement

    • Headers requeridos:
      • client_id
      • client_secret
    • Las credenciales son asignadas a la aplicación consumidora en MuleSoft Anypoint Platform.

  2. Bearer Token (OAuth 2.0)

    • Header requerido:
      • Authorization: Bearer <access_token>
    • El token debe ser obtenido desde el Mule OAuth Provider corporativo.
    • El token debe estar vigente al momento de la solicitud.

Ambos mecanismos son requeridos para que la solicitud sea aceptada por la plataforma.

🔒 Aviso de Seguridad
Las credenciales (client_id, client_secret) y los tokens OAuth son información sensible y no deben compartirse ni almacenarse en repositorios públicos.

🚀 Cómo Consumir

La API se encuentra publicada en las siguientes plataformas:

📋 Para consultar detalles de cada método:

  1. Navegar en el menú izquierdo de la documentación

  2. Expandir la sección "Summary"

  3. Seleccionar el método específico que requiere consultar

📍 Endpoints Disponibles

MétodoEndpointDescripción**Enlace
POST/servicesEjecutar operaciones sobre catálogo de servicios (consulta por código, filtros o nombre)Ver detalles
POST/providersEjecutar operaciones sobre proveedores (consulta por código, filtros o texto)Ver detalles
GET/providers-usersObtener listado de usuarios asociados a proveedoresVer detalles
POST/authenticate-providers-usersAutenticar usuarios proveedores con credenciales segurasVer detalles

⚠️ Manejo de Errores

La API utiliza códigos HTTP estándar para indicar el resultado del procesamiento de las solicitudes.

Estos códigos representan condiciones de autenticación, autorización, formato o disponibilidad del servicio, y no validaciones funcionales propias del negocio.

CódigoEstadoDescripción
200OKSolicitud procesada correctamente
400Bad RequestSolicitud inválida o mal formada
401UnauthorizedCredenciales inválidas o ausentes
404Not FoundRecurso no encontrado
405Method Not AllowedMétodo HTTP no permitido
406Not AcceptableFormato de respuesta no aceptable
415Unsupported Media TypeTipo de contenido no soportado
500Internal Server ErrorError interno inesperado
501Not ImplementedFuncionalidad no implementada
503Service UnavailableServicio temporalmente no disponible

📞 Soporte

Para soporte técnico o incidencias relacionadas con la integración:

Coordinación de Servicios de Integración y Aplicaciones

Correo electrónico: epalma@fgs.co

📅 Información Adicional

Documentación creada en Enero 2026 – Fundación Grupo Social – Colmena

© 2026 Fundación Grupo Social – Colmena

Esta documentación se mantiene actualizada conforme se incorporan nuevos servicios o endpoints relacionados con la gestión de servicios financieros Serlefin.

Reviews