🏠 Inicio - 🛡️cs-senda-sapi
Esta API ofrece servicios integrales para la gestión de proveedores, autorizaciones, diagnósticos, clientes, accidentes laborales y más. Incluye endpoints para:
- Consultas de proveedores urgentes
- Gestión de autorizaciones y servicios
- Manejo de diagnósticos y registros históricos
- Gestión de contratos y actividades de clientes
- Administración de accidentes laborales
- Verificación de cobertura de clientes
- Catalogación de documentos, departamentos y ciudades
- Servicios integrados con Senda
Todos los servicios se exponen a través de una estructura organizada y proporcionan acceso seguro a validaciones de backend.
- Título de la API: cs-senda-sapi
- Versión: 1.0.0
- URL Base:
https://senda-api-prod.us-e1.cloudhub.io/api
🚀 Cómo Comenzar
- Autenticación: Asegúrate de tener el
client_id
requerido para acceso seguro. - URL Base: Usa la URL Base proporcionada como prefijo para todos los endpoints de la API.
- Encabezados: Agrega los siguientes encabezados en tus solicitudes de API:-H "client_id: TU_CLIENT_ID"
🚀 Cómo Consumir
Puedes acceder y consumir esta API a través de las siguientes plataformas:
📍 Endpoints Disponibles
📌 Resumen de Endpoints
Método | Endpoint | Descripción | Enlace Exchange |
---|
GET | /providers/urgent | Obtener proveedores urgentes | Ver detalles |
POST | /authorization | Crear autorización | Ver detalles |
GET | /authorization/{authorizarionId} | Obtener autorización por ID | Ver detalles |
GET | /authorization/{authorizarionId}/services/{serviceId} | Obtener autorización con ID y ID de servicio | Ver detalles |
POST | /authorization/createNewAuthorization | Crear nueva autorización en Senda | Ver detalles |
🔍 Diagnósticos y Consultores
Método | Endpoint | Descripción | Enlace Exchange |
---|
GET | /diagnotics | Obtener diagnósticos | Ver detalles |
GET | /diagnotics/historicals | Obtener históricos de diagnósticos | Ver detalles |
GET | /consultants/{documentId} | Consultores por ID de documento | Ver detalles |
PUT | /update-diagnostic | Actualizar diagnóstico | Ver detalles |
👥 Clientes y Contratos
Método | Endpoint | Descripción | Enlace Exchange |
---|
GET | /customers/{customerId}/coverage-verification | Obtener verificación de cobertura de cliente | Ver detalles |
GET | /customers/contracts/{contractId} | Obtener contrato de cliente por ID | Ver detalles |
GET | /customers/contracts/{contractId}/activities | Obtener actividades del contrato | Ver detalles |
GET | /client-coverage-verification | Verificación de cobertura de cliente | Ver detalles |
📋 Actividades de Clientes
Método | Endpoint | Descripción | Enlace Exchange |
---|
POST | /customers/activities | Crear actividades de cliente | Ver detalles |
GET | /customers/activities | Obtener actividades de cliente | Ver detalles |
POST | /customers/activities/{activityCode}/service-orders | Crear órdenes de servicio | Ver detalles |
POST | /customers/activities/{activityCode}/working-sessions | Crear sesiones de trabajo | Ver detalles |
POST | /customers/activities/{activityCode}/working-sessions/ratify-sessions | Ratificar sesiones de trabajo | Ver detalles |
POST | /customers/activities/{activityCode}/working-sessions/approve-sessions | Aprobar sesiones de trabajo | Ver detalles |
POST | /customers/activities/{activityCode}/close-activity | Cerrar actividad | Ver detalles |
POST | /customers/activities/{activityCode}/history-reports | Crear reportes históricos | Ver detalles |
POST | /customers/activities/working-sessions/supports | Crear soportes de sesión | Ver detalles |
📚 Catálogo
Método | Endpoint | Descripción | Enlace Exchange |
---|
GET | /catalog/document-list | Obtener lista completa de documentos | Ver detalles |
GET | /catalog/document-list/{documentId} | Obtener documento por ID | Ver detalles |
GET | /catalog/departments-cities | Obtener departamentos comunes | Ver detalles |
GET | /catalog/departments | Obtener departamentos | Ver detalles |
GET | /catalog/departments/{departmentCode}/cities | Obtener ciudades | Ver detalles |
GET | /catalog/cities/{city} | Obtener ciudad específica | Ver detalles |
GET | /catalog/doctors | Obtener lista de doctores | Ver detalles |
GET | /catalog/severities | Obtener lista de severidades | Ver detalles |
GET | /catalog/document-types | Obtener tipos de documento | Ver detalles |
GET | /catalog/diagnostics-list | Obtener lista de diagnósticos | Ver detalles |
GET | /catalog/accidents | Obtener lista de accidentes | Ver detalles |
🔄 Accidentes Laborales
Método | Endpoint | Descripción | Enlace Exchange |
---|
POST | /work-accidents | Crear/Notificar accidentes laborales | Ver detalles |
PUT | /dependent-work-accidents | Actualizar accidente laboral dependiente | Ver detalles |
GET | /accidents | Obtener lista de accidentes | Ver detalles |
POST | /independent-work-accident | Crear accidente laboral independiente | Ver detalles |
PUT | /update-dependent-work-accident | Actualizar accidente laboral dependiente | Ver detalles |
POST | /post-create-work-accident | Crear accidente laboral | Ver detalles |
🗂️ Casos y Archivado
Método | Endpoint | Descripción | Enlace Exchange |
---|
GET | /esat-cases | Obtener casos ESAT | Ver detalles |
GET | /obtain/cases | Obtener casos | Ver detalles |
GET | /obtain-Ats-Without-Filing-Independently | Obtener lista de ATS sin archivar de un trabajador independiente | Ver detalles |
POST | /filing/diseases | Proceso de archivado de enfermedad ocupacional | Ver detalles |
GET | /obtain-at-without-filing-dependent | Obtener AT sin archivado dependiente | Ver detalles |
GET | /obtain-at-without-filing-independent | Obtener AT sin archivado independiente | Ver detalles |
POST | /case/pqr | Crear o actualizar caso y tarea de PQR en Senda | Ver detalles |
GET | /cases/{numberAt} | Obtener consulta de caso Colmena | Ver detalles |
👷♂️ Capacidad Laboral y Trabajadores
Método | Endpoint | Descripción | Enlace Exchange |
---|
GET | /labor-capacity-loss | Obtener lista de pérdida de capacidad laboral | Ver detalles |
GET | /labor-capacity-loss/{idLcp} | Obtener pérdida de capacidad laboral por ID | Ver detalles |
GET | /worker | Obtener información de trabajador | Ver detalles |
GET | /generate-pcl-by-document | Generar PCL por documento | Ver detalles |
🏢 Empresas y Direccionamiento
Método | Endpoint | Descripción | Enlace Exchange |
---|
GET | /users/permissions | Obtener permisos de usuario | Ver detalles |
GET | /company-information | Obtener información de empresa | Ver detalles |
GET | /ips-addressing | Obtener direccionamiento IPS | Ver detalles |
GET | /sendaGCP/validate-DIS-User | Validar usuario DIS | Ver detalles |
GET | /obtain-company-dialing/{numberContractCoverage} | Obtener marcación de empresa | Ver detalles |
GET | /obtain-special-agreements | Obtener acuerdos especiales | Ver detalles |
GET | /addressing-colmena/{codeService}/{nameService}/{numberAt}/{city}/{codeCallsignTypeService}/{timeCurrentRequest}/{dayCurrentRequest} | Obtener direccionamiento Colmena | Ver detalles |
GET | /addressing | Solicitar autorización, crear una autorización | Ver detalles |
GET | /companies-by-dis | Servicio DIS y proyecto de cultura de prevención de contratos | Ver detalles |
POST | /company-batch | Crear empresas en Salesforce | Ver detalles |
📋 Soporte y Gestión
Método | Endpoint | Descripción | Enlace Exchange |
---|
POST | /add-at-or-ep-support | Agregar soporte AT o EP | Ver detalles |
POST | /load-support-image-colmena | Cargar imagen de soporte Colmena | Ver detalles |
POST | /authorizations | Solicitar autorización, crear una autorización | Ver detalles |
GET | /authorizations/{numberAt}/{serviceCode} | Obtener autorizaciones con numberAt y serviceCode | Ver detalles |
GET | /authorizations/reports/{numberAt} | Consultar reportes de autorización por número AT | Ver detalles |
GET | /consult-authorization | Consultar autorización | Ver detalles |
GET | /obtain-information-atel | Obtener información ATEL | Ver detalles |
GET | /account-payable | Obtener información contable | Ver detalles |
GET | /self-service-company | Consulta de empresa de autoservicio | Ver detalles |
📤 Ejemplo de Solicitud (Genérico)
curl -X GET "https://senda-api-prod.us-e1.cloudhub.io/api/providers/urgent?filter=providerName" \
-H "client_id: TU_CLIENT_ID"
Reemplaza los parámetros basándote en el método específico.
⚠️ Manejo de Errores
Esta API sigue códigos de estado HTTP estándar para todas las respuestas:
200 OK
– La solicitud fue procesada exitosamente400 Bad Request
– Parámetros inválidos o faltantes401 Unauthorized
– Autenticación fallida404 Not Found
– El endpoint o recurso especificado no existe500 Internal Server Error
– Error inesperado del lado del servidor
📞 Soporte
Para asistencia, contacta al equipo de Coordinación de Servicios de Integración y Aplicaciones.
Correo electrónico: epalma@fgs.co
Documentación actualizada en Agosto 2025 por epalma@fgs.co - Edna Nayibe Palma
© 2025 Fundación Grupo Social - Colmena. Archivo generado para la API cs-senda-sapi