cs-senda-sapi icon

cs-senda-sapi

1.1.x
(0 reviews)
La API que tiene la integración directa con los sistemas de Senda, facilitando el acceso controlado a funcionalidades de gestión de autorizaciones médicas, diagnósticos, actividades de clientes, información y servicios especializados del sistema ARL.

🛡️ cs-senda-sapi

La API cs-senda-sapi provee una solución integral para la integración directa con los sistemas de Senda, facilitando el acceso controlado a funcionalidades de gestión de autorizaciones médicas, diagnósticos, actividades de clientes, catálogos de información y servicios especializados del sistema ARL.

Expone operaciones REST para:

  • Gestión de autorizaciones médicas y servicios de salud
  • Consulta de diagnósticos y catálogos médicos
  • Administración de actividades y casos de clientes
  • Verificación de coberturas y contratos
  • Procesamiento de accidentes laborales y enfermedades profesionales
  • Integración con servicios especializados de Senda y sistemas corporativos

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

🌐 Información Básica

  • Nombre de la API: cs-senda-sapi
  • Versión: 1.0.0
  • Plataforma: MuleSoft Anypoint Platform
  • Runtime: Mule 4.4.0
  • Tipo: System API
  • URL Base:https://cs-senda-sapi-{env}-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 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
GET/providers/urgentObtener proveedores urgentes
POST/authorizationCrear autorización médica
GET/authorization/{authorizationId}Obtener información de autorización
GET/authorization/{authorizationId}/services/{serviceId}Obtener servicios de autorización
POST/authorization/createNewAuthorizationCrear nueva autorización en Senda
GET/diagnoticsBuscar diagnósticos
GET/diagnotics/historicalsObtener históricos de diagnósticos
GET/consultants/{documentId}Consultar consultores por ID de documento
GET/customers/{customerId}/coverage-verificationVerificar cobertura de cliente específico
GET/customers/contracts/{contractId}Obtener información de contrato de cliente
GET/customers/contracts/{contractId}/activitiesObtener actividades de contrato de cliente
POST/customers/activitiesCrear actividades de clientes
GET/customers/activitiesConsultar actividades de clientes
POST/customers/activities/{activityCode}/service-ordersCrear órdenes de servicio por código de actividad
POST/customers/activities/{activityCode}/working-sessionsCrear sesiones de trabajo por código de actividad
POST/customers/activities/{activityCode}/working-sessions/ratify-sessionsRatificar sesiones por código de actividad
POST/customers/activities/{activityCode}/working-sessions/approve-sessionsAprobar sesiones por código de actividad
POST/customers/activities/{activityCode}/close-activityCerrar actividad por código de actividad
POST/customers/activities/{activityCode}/history-reportsCrear reportes históricos por código de actividad
POST/customers/activities/working-sessions/supportsCrear soportes de sesiones de trabajo
GET/catalog/document-listObtener lista completa de documentos
GET/catalog/document-list/{documentId}Obtener documento por ID
GET/catalog/departments-citiesObtener catálogo de departamentos y ciudades
GET/catalog/departmentsObtener departamentos comunes
GET/catalog/departments/{departmentCode}/citiesObtener ciudades comunes por departamento
GET/catalog/cities/{city}Obtener información de ciudad específica
GET/catalog/doctorsObtener lista de doctores
GET/catalog/severitiesObtener lista de severidades
GET/catalog/document-typesObtener tipos de documentos
GET/catalog/diagnostics-listObtener lista de diagnósticos
GET/catalog/accidentsObtener lista de accidentes
POST/work-accidentsCrear/notificar accidentes laborales
PUT/dependent-work-accidentsActualizar accidente laboral dependiente
GET/esat-casesObtener casos ESAT
GET/obtain/casesObtener casos
GET/accidentsConsultar accidentes por identificación
GET/workerConsultar información de trabajador
GET/users/permissionsConsultar permisos de usuarios
GET/company-informationObtener información de empresa
GET/ips-addressingObtener direccionamiento IPS
GET/sendaGCP/validate-DIS-UserValidar usuario DIS
GET/obtain-Ats-Without-Filing-IndependentlyObtener ATS sin radicación independiente
POST/filing/diseasesProceso de radicación de enfermedad laboral
GET/obtain-at-without-filing-dependentObtener AT sin radicación dependiente
GET/obtain-at-without-filing-independentObtener AT sin radicación independiente
POST/case/pqrCrear o actualizar caso y tarea PQR en Senda
GET/labor-capacity-lossObtener lista de pérdida de capacidad laboral
GET/labor-capacity-loss/{idLcp}Obtener pérdida de capacidad laboral por ID
POST/add-at-or-ep-supportAgregar soporte AT o EP
POST/independent-work-accidentCrear accidente laboral independiente
PUT/update-dependent-work-accidentActualizar accidente laboral dependiente
GET/cases/{numberAt}Consultar caso Colmena
GET/generate-pcl-by-documentGenerar PCL por documento
GET/obtain-company-dialing/{numberContractCoverage}Consultar códigos de convenios especiales
GET/client-coverage-verificationVerificación de cobertura de cliente
PUT/update-diagnosticActualizar diagnóstico
POST/post-create-work-accidentCrear accidente laboral
GET/obtain-special-agreementsObtener convenios especiales
POST/load-support-image-colmenaCargar imagen de soporte Colmena
GET/addressing-colmena/{codeService}/{nameService}/{numberAt}/{city}/{codeCallsignTypeService}/{timeCurrentRequest}/{dayCurrentRequest}Obtener direccionamiento Colmena
POST/authorizationsSolicitar autorización, crear una autorización
GET/authorizations/{numberAt}/{serviceCode}Obtener autorización por número AT y código de servicio
GET/authorizations/reports/{numberAt}Obtener reportes de autorizaciones por número AT
GET/consult-authorizationConsultar autorización
GET/obtain-information-atelObtener información ATEL
GET/account-payableObtener cuentas por pagar
GET/self-service-companyConsulta de autoservicio empresarial
GET/addressingObtener direccionamiento
GET/companies-by-disObtener empresas por DIS
POST/company-batchCrear empresas Salesforce por lotes
GET/company-managerObtener gerente de empresa
GET/survey-questionsObtener preguntas de encuesta
POST/covid-survey-responsesRespuestas de encuesta COVID
GET/list-accidentsObtener lista de accidentes

⚠️ 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
403ForbiddenClient ID sin permisos
404Not FoundRecurso no encontrado
405Method Not AllowedMétodo HTTP no permitido
415Unsupported Media TypeTipo de contenido no soportado
429Too Many RequestsLímite de solicitudes excedido
500Internal Server ErrorError interno inesperado
503Service UnavailableServicio temporalmente no disponible
504Gateway TimeoutTiempo de espera agotado

📞 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 Febrero 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 integración de sistemas Senda.

Reviews