Cumplimiento Normativo icon

Cumplimiento Normativo

1.0.x
(0 reviews)
Esta API proporciona acceso a los servicios de seguridad social, permitiendo la gestión de afiliaciones, aportes, empleadores, empleados, beneficios, prestadores de salud y pagos.

🛡️ cs-seguridad-social-sapi

Esta API proporciona acceso a servicios de seguridad social, incluyendo la gestión de:

  • Afiliaciones
  • Contribuciones
  • Empleadores y Empleados
  • Beneficios de Seguridad Social
  • Proveedores de Salud
  • Pagos

Todos los servicios se exponen a través de endpoints versionados (ej., v1) y ofrecen integración segura con sistemas internos.

🌐 Información Base

  • Título de la API: cs-seguridad-social-sapi
  • Versión: 1.0.0
  • Plataforma: MuleSoft Anypoint Platform
  • URL Base: https://cs-seguridad-social-sapi-qa-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 servicio corporativo de autenticación.
    • 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 y disponible para consumo a través de:

📌 El acceso está restringido a consumidores previamente autorizados en Anypoint Platform.

📋 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
GET/transferable-employerRecupera datos de empleadores transferibles
GET/moratorium-periodRecupera información sobre períodos de moratoria
GET/transferable-businessLista empresas elegibles para transferencia
GET/business-structureRetorna tipos de estructura empresarial disponibles
POST/health-service/employer/membership-ArlEnvía afiliación ARL para un empleador
POST/health-service/employer/retractionTransferOrEmployerAffiliationArlRetracta transferencia de empleador o afiliación a ARL
POST/health-service/employer/beginningEmploymentRelationshipRegistra el inicio de una relación laboral
POST/health-service/employer/terminationEmploymentRelationshipTermina una relación laboral
POST/health-service/headquarters/noveltyNotificationReporta eventos de novedad desde sedes
POST/health-service/workCenter/noveltiesEnvía novedades para un centro de trabajo
POST/health-service/workCenter/variationWorkCenterforDependentWorkersAndStudentsRegistra cambios para centro de trabajo de trabajadores dependientes y estudiantes
POST/health-service/arlEmployerTransfer/origin-ARLRegistra origen de transferencia ARL de empleador
POST/health-service/arlEmployerTransfer/destination-ARL/transferNotificationNotifica transferencia ARL a destino
POST/independentWorker/affiliationIntoARLRegistra afiliación ARL de trabajador independiente
POST/independentWorker/transferWorkersARLToAnotherTransfiere afiliación ARL a otra ARL
POST/independentWorker/retractionOfARLMembershipRetracta afiliación ARL de trabajador independiente
POST/independentWorker/retractionTransferOfARLCancela solicitud de transferencia ARL
POST/independentWorker/terminationMembershipOnARLTermina afiliación voluntaria ARL
POST/independentWorker/reportingLatePayments-non-complianceReporta pagos tardíos o incumplimientos
POST/independentWorker/suspensionOrActivationOfVoluntaryMembershipSuspende o reactiva afiliación voluntaria ARL
PUT/independentWorker/changeOccupationOrProfessionActualiza ocupación o profesión
PUT/independentWorker/correction-contributing-type-or-subtypeCorrige tipo o subtipo de contribución
GET/independentWorker/checkActiveAffiliationIntoOccupationalRiskSystemVerifica afiliaciones ARL activas
GET/independentWorker/checkDetailsOfMembershipInformationRecupera registros de detalles de afiliación
GET/independentWorker/arlTransferableWorkerConsultationObtiene información sobre trabajadores transferibles
GET/independentWorker/queryOfDefaultPeriodRecupera información sobre períodos de mora

⚠️ Manejo de Errores

La API utiliza códigos de estado HTTP estándar para indicar el resultado del procesamiento de cada solicitud.

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 RequestParámetros faltantes o inválidos
401UnauthorizedToken OAuth inválido o ausente
403ForbiddenClient ID sin autorización para el recurso
404Not FoundEndpoint o recurso no encontrado
500Internal Server ErrorError inesperado en el procesamiento

📞 Soporte

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

Coordinación de Servicios de Integración y Aplicaciones

📅 Información Adicional

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

© 2026 Fundación Grupo Social – Colmena

🔒 Aviso de Seguridad
Las credenciales (client_id, client_secret) y los tokens OAuth son información sensible y deben gestionarse mediante mecanismos seguros.

Reviews