Generalidades HKA Facil RIPS
Generalidades - HKA Fácil RIPS
Historial de versiones
| Versión | Fecha lanzamiento | Descripción |
|---|---|---|
| 1.0.0 | 2025 | Versión inicial de la API REST HKA Fácil RIPS |
| 1.1.0 | 2025 | Mejoras en los códigos de negocio y documentación de respuestas |
Cómo obtener soporte
- Soporte de 1er nivel:
Soporte telefónico / email / chat o tele-conferencias en horario 5×8 para atención de consultas y fallas de usuario.
- Soporte de 2do nivel:
Soporte resolución remota de incidencias en el sistema en horario 5×8.
Escriba a [email protected]
Líneas de atención telefónica:
+57 (1) 311.3063
- Soporte Técnico → Opción 2
- Integración → Opción 5, luego Opción 1
Sesiones de Soporte
Dirigido a: Agencias Comerciales – Casas de Software Aliadas – Clientes Finales.
Horario: Martes y Jueves a partir de las 8:30 AM.
Sesiones Área Integración
Solución de casos de integración.
Dirigido a: Clientes que realicen desarrollos de software para integrarse con TFHKA, Casas de Software Aliadas.
Horario: Martes y Jueves a partir de las 8:30 AM.
Descripción general
¿Qué es HKA Fácil RIPS?
HKA Fácil RIPS es un servicio API REST (middleware) desarrollado por The Factory HKA Colombia que actúa como intermediario para la integración de los RIPS (Registro Individual de Prestación de Servicios) con el Ministerio de Salud y Protección Social de Colombia.
El servicio simplifica el proceso de generación, validación y envío de RIPS al Ministerio de Salud, ofreciendo un único punto de integración que maneja internamente la autenticación, la creación del paquete RIPS y la comunicación con el Ministerio.
¿Qué son los RIPS?
Los RIPS (Registro Individual de Prestación de Servicios de Salud) son el conjunto de datos mínimos que el Sistema General de Seguridad Social en Salud requiere para el procesamiento de las reclamaciones de los servicios de salud prestados.
Toda Institución Prestadora de Servicios de Salud (IPS) o entidad que preste servicios de salud está obligada a reportar los RIPS al Ministerio de Salud conforme a la normativa vigente.
Tipos de RIPS soportados
El campo tipoRips indica el tipo de documento RIPS a generar:
| Valor | Descripción |
|---|---|
01 |
RIPS con Factura Electrónica de Venta (FEV) |
02 |
RIPS sin Factura Electrónica de Venta (Sin FEV) |
03 |
RIPS con Nota Crédito |
04 |
RIPS con Nota Débito |
05 |
RIPS con documento de contingencia |
@IMPORTANTE: El valor del campo tipoRips debe ser uno de los valores listados anteriormente. Un valor inválido retornará el código de negocio 109.
Ambientes de integración
La API HKA Fácil RIPS está disponible en dos ambientes:
Ambiente Demo (Pruebas)
Ambiente en el cual las operaciones no son transmitidas al Ministerio de Salud. Úselo durante el desarrollo y las pruebas de su integración.
URL Base: https://demoapi-facilrips.thefactoryhka.com.co
Endpoints disponibles:
POST https://demoapi-facilrips.thefactoryhka.com.co/api/rips/enviarPOST https://demoapi-facilrips.thefactoryhka.com.co/api/rips/estado
Ambiente Productivo
Ambiente en el cual se realizan las operaciones reales que son transmitidas al Ministerio de Salud.
URL Base: https://api-facilrips.thefactoryhka.com.co
Endpoints disponibles:
POST https://api-facilrips.thefactoryhka.com.co/api/rips/enviarPOST https://api-facilrips.thefactoryhka.com.co/api/rips/estado
@IMPORTANTE: La URL del servicio en producción solo funciona bajo el protocolo HTTPS.
Autenticación
La API HKA Fácil RIPS utiliza un modelo de autenticación basado en tokens de empresa. Cada petición debe incluir los siguientes campos en el cuerpo del request (body):
| Campo | Tipo | Descripción |
|---|---|---|
tokenEmpresa |
string |
Token de identificación de la empresa. Debe tener exactamente 40 caracteres alfanuméricos. |
tokenPassword |
string |
Token contraseña de acceso. Debe tener exactamente 40 caracteres alfanuméricos. |
Estos tokens son proporcionados por el equipo de Integración de The Factory HKA Colombia al momento de la habilitación de la empresa en la plataforma.
@IMPORTANTE: Si alguno de los tokens no cumple con el formato requerido (40 caracteres alfanuméricos), el servicio retornará el código de negocio 111. Si las credenciales son incorrectas o inválidas, retornará el código de negocio 101.
Ejemplo de tokens (formato):
tokenEmpresa: abc123def456ghi789jkl012mno345pqr678stu9 tokenPassword: xyz987wvu654tsr321qpo098nml765kji432hgf1
Requerimientos técnicos
HKA Fácil RIPS es una plataforma tipo SaaS (Software as a Service). Los servicios, la información, el procesamiento y los resultados están alojados en los servidores de The Factory HKA Colombia.
Para integrarse con la API, el sistema de facturación o ERP del cliente debe tener:
- Capacidad de consumir servicios REST con peticiones HTTP/HTTPS tipo
POST. - Capacidad de enviar y recibir cuerpos en formato JSON.
- Capacidad de capturar y validar los datos de entrada antes del envío.
- Conexión a internet con acceso saliente a los puertos TCP 443 (HTTPS).
- Acceso habilitado a los dominios:
*.thefactoryhka.com.codemoapi-facilrips.thefactoryhka.com.co(Integración – Demo)api-facilrips.thefactoryhka.com.co(Integración – Producción)
No se requiere infraestructura adicional de procesamiento ni almacenamiento propio, ya que The Factory HKA Colombia se encarga del mantenimiento, operación, cambios normativos y soporte de la solución.