Relacionamiento con el Cliente
home
🛡️ cs-salesforce-crm-xapi
La API cs-salesforce-crm-xapi provee una solución integral para la integración de Salesforce CRM con servicios y módulos corporativos de Colmena Seguros, actuando como una capa de experiencia unificada para operaciones críticas del negocio.
Expone operaciones REST para:
- Gestión de archivos en Azure Storage
- Administración de casos y actividades en Senda Médico
- Procesamiento de reclamos e indemnizaciones
- Gestión de PQR (Peticiones, Quejas y Reclamos)
- Administración de sesiones de trabajo y órdenes de servicio
- Consulta de información de contratos, pólizas y acuerdos especiales
- Registro de accidentes laborales y autorización de datos personales
La API actúa como una Experience API (XAPI), gestionada desde MuleSoft Anypoint Platform.
🌐 Información Básica
- Nombre de la API: cs-salesforce-crm-xapi
- Versión: 1.0.0
- Plataforma: MuleSoft Anypoint Platform
- Runtime: Mule 4.x
- Tipo: Experience API
- URL Base QA:
https://cs-salesforce-crm-xapi-qa-v1.us-e1.cloudhub.io/api/ - URL Base PROD:
https://cs-salesforce-crm-xapi-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 el siguiente mecanismo de seguridad:
Client ID Enforcement
Headers requeridos:
client_idclient_secret
- Las credenciales son asignadas a la aplicación consumidora en MuleSoft Anypoint Platform.
🔒 Aviso de Seguridad
Las credenciales (client_id,client_secret) 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-salesforce-crm-xapi https://anypoint.mulesoft.com/exchange/portals/fundacion-grupo-social/
- 🔗 Portal Público FGS https://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 |
|---|---|---|
| POST | /azure/storage | Guardar archivo en Azure Storage |
| GET | /azure/storage | Obtener archivo de Azure Storage |
| POST | /senda/case | Crear o actualizar casos y tareas en Senda Médico |
| GET | /senda/consultants/{documentId} | Recuperar información de consultor por ID de documento |
| GET | /senda/customers/contracts/{contractId} | Obtener información del contrato del cliente |
| GET | /senda/customers/contracts/{contractId}/activities | Obtener actividades del contrato con filtro de estado opcional |
| POST | /senda/customers/activities | Crear nuevo registro de actividad en SENDA |
| PUT | /senda/customers/activities/{activityId}/status | Actualizar estado de una actividad de cliente |
| POST | /senda/customers/activities/{activityId}/history-reports | Crear reportes de historial de actividades |
| POST | /senda/customers/activities/{activityId}/service-orders | Crear órdenes de servicio para actividades |
| POST | /senda/customers/activities/{activityId}/working-sessions | Crear sesiones de trabajo para actividades |
| POST | /senda/customers/activities/{activityId}/working-sessions/approve-sessions | Aprobar sesiones de trabajo |
| PUT | /senda/customers/activities/{activityId}/working-sessions/status | Actualizar estado de sesión de trabajo |
| POST | /senda/customers/activities/working-sessions/supports | Agregar información de soporte a sesiones de trabajo |
| POST | /claims | Presentar reclamos de indemnización |
| POST | /claims/analytical-response | Entregar respuesta a analíticas |
| GET | /claims/obtain-files | Consultar documentos en Salesforce por contentVersionId |
| POST | /claims/reportAnalytics | Reportar reclamo a analíticas |
| POST | /attach-File | Adjuntar archivo a caso de Siebel |
| GET | /consult-Document/{fileId} | Consultar documento por ID de archivo |
| POST | /complete-PQR | Completar proceso PQR (Peticiones, Quejas, Reclamos) |
| GET | /pqr-Consult-Case | Obtener casos PQR dentro de un rango de fechas |
| POST | /create-appointment-scheduling | Crear programación de citas desde Mary |
| GET | /obtain-information-called-from-senda-medico | Obtener información de llamadas desde Senda Médico |
| POST | /consult-Attached-Documents | Consultar documentos adjuntos |
| GET | /retrievePolicyInformation | Recuperar información de póliza |
| GET | /token-omniout-salesforce | Obtener Token Omniout |
| POST | /upload-documents-starservices | Subir documentos a Star Services |
| GET | /cases/obtainCases | Obtener información del objeto caso de Salesforce |
| PUT | /cases/updateCases | Actualizar información en objeto caso de Salesforce |
| POST | /habeasData/dataProcessingAuthorization | Autorización para procesamiento de datos personales |
| POST | /post-create-work-accident | Crear registro de accidente laboral |
| GET | /obtain-special-agreements | Obtener acuerdos especiales por número de contrato |
| PUT | /update-at | Actualizar AT desde Senda |
⚠️ 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ó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
Correo electrónico: epalma@fgs.co
📅 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 Salesforce CRM.