cs-apolo-sapi
cs-apolo-sapi brinda acceso integral a la base de datos APOLO, con endpoints para certificaciones de accidentes, gestión de trabajadores, afiliaciones, contratos e informes financieros, permitiendo interacción segura con datos de sedes y empleo.
home
🛡️ cs-apolo-sapi
La API cs-apolo-sapi provee acceso controlado a los datos del Sistema General de Riesgos Laborales desde la base de datos APOLO, permitiendo la gestión de trabajadores, empresas, contratos, afiliaciones y accidentalidad laboral.
Expone operaciones REST para:
- Gestión de trabajadores dependientes e independientes
- Administración de empresas y contratos laborales
- Procesamiento de afiliaciones al sistema de riesgos laborales
- Registro y consulta de accidentes de trabajo
- Generación de certificaciones y documentos oficiales
- Consulta de información geográfica y catálogos del sistema
- Gestión de centros de trabajo y sedes empresariales
- Integración con servicios Liferay (cursos, tarjetas, certificados)
La API actúa como una System API (SAPI), gestionada desde MuleSoft Anypoint Platform.
🌐 Información Básica
- Nombre de la API: cs-apolo-sapi
- Versión: 1.0.0
- Plataforma: MuleSoft Anypoint Platform
- Runtime: Mule 4.x
- Tipo: System API
- URL Base QA:
https://cs-apolo-sapi-qa-v1.us-e1.cloudhub.io/api/ - URL Base PROD:
https://cs-apolo-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:
Client ID Enforcement
Headers requeridos:
client_idclient_secret
- Las credenciales son asignadas a la aplicación consumidora en MuleSoft Anypoint Platform.
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:
- 🔗 MuleSoft Exchange – cs-apolo-sapihttps://anypoint.mulesoft.com/exchange/portals/fundacion-grupo-social/2b26d155-74f8-4cf2-aaea-ec3c05e8433a/cs-apolo-sapi/
- 🔗 Portal Público FGShttps://anypoint.mulesoft.com/exchange/portals/fundacion-grupo-social/
📋 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étodo | Endpoint | Descripción |
|---|---|---|
| GET | /accident/rate/certification | Obtener certificación de tasa de accidentalidad |
| POST | /accident/rate/certification/annual | Generar certificación anual de tasa de accidentalidad |
| GET | /accident/rate/certification/worker | Obtener certificación de tasa de accidentalidad por trabajador |
| POST | /accident/rate/certification/disability/worker | Certificación de incapacidad por accidente de trabajador |
| POST | /accidents | Obtener listado de accidentes |
| GET | /accidents/headquarters | Consultar accidentes por sede |
| POST | /affiliate/certification/letter/dependent | Carta de certificación de afiliado dependiente |
| POST | /affiliate/certification/letter/independent | Carta de certificación de afiliado independiente |
| POST | /affiliate/certification/annex/dependent | Anexo de certificación de afiliado dependiente |
| POST | /affiliate-certification-annex-independent | Anexo de certificación de afiliado independiente |
| GET | /affiliate/certification/abroad/dependent | Certificado de asistencia en el exterior para dependiente |
| POST | /affiliate/certification/special/dependent | Certificación especial de afiliación de dependiente |
| POST | /affiliate/certification/special/independent | Certificación especial de afiliación de independiente |
| POST | /affiliations-contracts | Crear contrato de afiliación |
| GET | /affiliate/ARP | Obtener información ARP del afiliado |
| GET | /at/employer/contracting/report | Reporte de contratación de empleador AT |
| DELETE | /appointment-scheduling | Cancelar cita programada |
| POST | /appointment-scheduling | Crear cita programada |
| POST | /cancellation-independent-withdrawal | Cancelación de retiro independiente |
| GET | /certificate-payment-return-contributions | Certificado de pago y devolución de aportes |
| GET | /cities | Listar ciudades por departamento |
| GET | /cities/contract/{idContract} | Obtener ciudades por contrato |
| POST | /collection-report-worker-o-mass | Reporte de recaudo por trabajador o masivo |
| GET | /company | Consultar empresa por identificación |
| GET | /companies/{id} | Consultar empresa por número de identificación |
| GET | /companies/policies | Obtener pólizas de empresas |
| GET | /companies/contracts/{id} | Obtener contratos por ID de empresa |
| POST | /companies/contracts/member-by-day-of-birth | Obtener miembro por fecha de nacimiento |
| GET | /companies/workers | Obtener trabajadores de empresas |
| POST | /companies/workers/contact-information | Crear información de contacto de trabajadores |
| PUT | /companies/workers/contact-information | Actualizar información de contacto de trabajadores |
| GET | /companies/headquarters/{contractConsecutive} | Consultar sedes de empresa por contrato |
| POST | /companies/headquarters/certification/current | Certificación actual de sede empresarial |
| GET | /contacts | Obtener contactos |
| GET | /contract-types | Obtener tipos de contrato |
| GET | /contracts/work-centers/{contractConsecutive} | Consultar centros de trabajo por contrato |
| GET | /contributor-types-worker-type | Tipos de cotizante por tipo de trabajador |
| POST | /create-dependent-worker | Crear trabajador dependiente |
| POST | /create-independent-worker | Crear trabajador independiente |
| GET | /create-new-change-Afp-independent | Cambiar AFP de trabajador independiente |
| GET | /create-new-change-independent-email | Cambiar email de trabajador independiente |
| POST | /create-new-change-independent-identification | Cambio de identificación de independiente |
| GET | /create-new-independent-IBC-change | Cambiar IBC de trabajador independiente |
| POST | /create-novelty-cancellation-entry-independent | Cancelación de ingreso de independiente |
| POST | /create-novelty-change-city-independent | Cambio de ciudad de independiente |
| GET | /create-novelty-change-independent-cellPhone | Cambiar celular de trabajador independiente |
| POST | /create-novelty-change-Eps-independent | Cambio de EPS de independiente |
| POST | /create/new/change/date/birth/independent | Cambio de fecha de nacimiento de independiente |
| POST | /current/dependent-worker | Certificación vigente de trabajador dependiente |
| POST | /current/independent-worker | Certificación vigente de trabajador independiente |
| GET | /current-legal-minimum-wage | Obtener salario mínimo legal vigente |
| GET | /customers | Obtener clientes |
| GET | /departments/contract/{idContract} | Obtener departamentos por contrato |
| POST | /dependent-work-accident | Crear accidente de trabajo dependiente |
| POST | /dependent-worker | Crear trabajador dependiente (contingencia Jotform) |
| POST | /dependent-worker/massive | Crear trabajador dependiente masivo (contingencia Jotform) |
| GET | /dependent-workers/{id} | Obtener datos de trabajador dependiente |
| GET | /dependent-workers-filter/{id} | Obtener datos filtrados de trabajador dependiente |
| GET | /economic/benefit/report | Reporte de beneficios económicos |
| POST | /extension/validity/independent | Extensión de validez de trabajador independiente |
| POST | /generation-certificate-payment-of-disabilities | Generación de certificado de pago de incapacidades |
| GET | /get-support-news | Obtener soporte de novedades |
| GET | /headquarters | Obtener sedes |
| GET | /headquarters/relationship | Obtener relación de sedes |
| GET | /history/news/dependent | Historial de novedades de dependiente |
| GET | /history/news/independent | Historial de novedades de independiente |
| POST | /independent-name-change | Cambio de nombre de trabajador independiente |
| POST | /independent-worker | Crear trabajador independiente (contingencia Jotform) |
| POST | /independent-worker/massive | Crear trabajador independiente masivo (contingencia Jotform) |
| GET | /independent-workers/{id} | Obtener datos de trabajador independiente |
| GET | /indemnities | Obtener indemnizaciones |
| GET | /info-financial-worker | Obtener información financiera del trabajador |
| PUT | /info-financial-worker | Actualizar información financiera del trabajador |
| GET | /load-types-modality | Obtener tipos de modalidad |
| GET | /news/companies | Obtener novedades de empresas |
| GET | /news/deltas/headquarters | Obtener novedades delta de sedes |
| GET | /news/earns-income/dependent | Novedades de ingresos de dependiente |
| GET | /news/earns-income/independent | Novedades de ingresos de independiente |
| GET | /news/headquarters | Obtener novedades de sedes |
| GET | /news/portal | Obtener novedades del portal |
| GET | /news/types/workers/independent/filter | Filtrar tipos de novedades de trabajadores independientes |
| GET | /obtain-accidents-by-location-report | Reporte de accidentes por ubicación |
| GET | /obtain-AFP-Types | Obtener tipos de AFP |
| GET | /obtain-all-cities | Obtener todas las ciudades |
| GET | /obtain-ARP-Types | Obtener tipos de ARP |
| GET | /obtain-case-at-client-portal | Obtener caso AT en portal cliente |
| GET | /obtain-case-ep-client-portal | Obtener caso EP en portal cliente |
| POST | /obtain-company-causal-status | Obtener estado causal de empresa |
| GET | /obtain-company-work-centers | Obtener centros de trabajo de empresa |
| GET | /obtain-Contracts-Per-Affiliate | Contratos por afiliado |
| GET | /obtain-day-type | Obtener tipo de día |
| GET | /obtain-departments | Obtener departamentos |
| POST | /obtain-dependent-workers-membership | Obtener membresía de trabajadores dependientes |
| GET | /obtain-disability-states-report-economic-benefits | Estados de incapacidad y beneficios económicos |
| GET | /obtain-economic-activities | Obtener actividades económicas |
| GET | /obtain-EPS-Types | Obtener tipos de EPS |
| POST | /obtain-events-per-worker | Obtener eventos por trabajador |
| GET | /obtain-Gender-Types | Obtener tipos de género |
| GET | /obtain-list-affiliation-independent | Obtener listado de afiliaciones independientes |
| GET | /obtain-occupational-disease-filings | Obtener radicaciones de enfermedad laboral |
| GET | /obtain-Work-Centers-Number-Of-Workers | Obtener centros de trabajo con número de trabajadores |
| GET | /obtain-zone-Types | Obtener tipos de zona |
| GET | /obtain/accident/report | Obtener reporte de accidente |
| GET | /obtain/cases | Obtener casos |
| GET | /obtain/certification/company/membership | Certificación de membresía de empresa |
| GET | /other/news/dependent | Otras novedades de dependiente |
| GET | /other/news/independent | Otras novedades de independiente |
| GET | /paid/returns | Obtener devoluciones pagadas |
| GET | /participants | Obtener participantes |
| POST | /pcc/file-worker-contact | Habeas Data - Términos y condiciones |
| GET | /policies | Obtener pólizas |
| GET | /providers | Obtener proveedores |
| POST | /pymes-affiliations | Crear afiliación PyME |
| GET | /pymes-affiliations/{affiliation_id} | Obtener afiliación PyME por ID |
| POST | /pymes-affiliations/{affiliation_id}/returns | Crear devolución de afiliación PyME |
| GET | /quotes/type | Obtener tipos de cotización |
| GET | /quoteTypesByWorkerType | Tipos de cotización por tipo de trabajador |
| GET | /report-disease-labor-no-qualified | Reporte de enfermedad laboral no calificada |
| POST | /retired-dependent-workers-cancelled | Retirar trabajadores dependientes cancelados |
| POST | /retired-independent-workers-cancelled | Retirar trabajadores independientes cancelados |
| GET | /service-liferay/admin-courses/courses/course | Obtener cursos |
| GET | /service-liferay/admin-courses/courses/courses-detail | Obtener detalle de cursos |
| GET | /service-liferay/admin-courses/courses/courses-economic-sector | Obtener cursos por sector económico |
| GET | /service-liferay/admin-courses/courses/platform | Obtener cursos por plataforma |
| GET | /service-liferay/affiliate/contracts/{idTypeIdentification}/{documentNumber} | Contratos de afiliado por identificación |
| GET | /service-liferay/affiliate/contracts/card/certificate/{idTypeIdentification}/{documentNumber} | Certificado de tarjeta de afiliado |
| GET | /service-liferay/affiliate/contracts/card/dependent/{idTypeIdentification}/{documentNumber} | Tarjeta de afiliado dependiente |
| GET | /service-liferay/affiliate/contracts/card/independent/{idTypeIdentification}/{documentNumber} | Tarjeta de afiliado independiente |
| POST | /service-liferay/enrollment/enroll-worker-in-course | Inscribir trabajador en curso |
| GET | /service-liferay/enrollment/general-enrollment-information/{idTypeIdentification}/{documentNumber} | Información general de inscripción |
| GET | /service-liferay/parametric/economic-sector | Obtener sectores económicos |
| GET | /service-liferay/parametric/platform | Obtener plataformas |
| GET | /special-agreement | Obtener convenio especial |
| GET | /subsidiary-arp/{id} | Obtener subsidiaria ARP |
| GET | /subtypes/contributor-type-worker | Subtipos de cotizante por tipo de trabajador |
| GET | /type-identificaction | Obtener tipos de identificación |
| GET | /types/affiliates | Tipos de afiliados |
| GET | /v2/companies/contracts/{id} | Obtener contratos por ID de empresa (v2) |
| POST | /v2/pymes-affiliations/{affiliation_id}/returns | Crear devolución de afiliación PyME (v2) |
| GET | /verify-disability-proof | Verificar comprobante de incapacidad |
| POST | /workers/dependen/affiliation | Afiliación de trabajador dependiente |
| POST | /workers/dependent/affiliation | Afiliación de trabajador dependiente |
| POST | /workers/dependent/affiliation/certificated | Certificación de afiliación dependiente |
| POST | /workers/dependent/certification/affiliation | Certificación de afiliación de trabajador dependiente |
| GET | /workers/dependent/coverage | Obtener cobertura de trabajador dependiente |
| GET | /workers/dependent/data | Datos de trabajadores dependientes |
| POST | /workers/independent/affiliation | Afiliación de trabajador independiente |
| POST | /workers/independent/certification/affiliation | Certificación de afiliación independiente |
| GET | /workers/independent/coverage | Cobertura de trabajador independiente |
| GET | /workplace | Obtener puestos de trabajo |
| GET | /workday | Obtener jornadas laborales |
⚠️ Manejo de Errores
La API utiliza códigos HTTP estándar para indicar el resultado del procesamiento de las solicitudes.
| Código | Estado | Descripción |
|---|---|---|
| 200 | OK | Solicitud procesada correctamente |
| 400 | Bad Request | Solicitud inválida o mal formada |
| 401 | Unauthorized | Credenciales inválidas o ausentes |
| 403 | Forbidden | Client ID sin permisos |
| 404 | Not Found | Recurso no encontrado |
| 405 | Method Not Allowed | Método HTTP no permitido |
| 415 | Unsupported Media Type | Tipo de contenido no soportado |
| 429 | Too Many Requests | Límite de solicitudes excedido |
| 500 | Internal Server Error | Error interno inesperado |
| 503 | Service Unavailable | Servicio temporalmente no disponible |
| 504 | Gateway Timeout | Tiempo 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 gestión del Sistema General de Riesgos Laborales desde la base de datos APOLO.