1.2 Requisitos previos: llaves de la IHCE, módulo activo y permisos
Lo que hay que tener listo antes de configurar: las llaves de la IHCE, el módulo activo, los permisos y el mapa de datos obligatorios.
Antes de tocar el sistema hay cuatro cosas que dependen de la IPS o de Goujana, no de quien usa el software. Si falta alguna, el curso se puede seguir hasta la generación, pero no habrá emisión.
1. Las llaves de la IHCE (trámite de la IPS)
La solicitud la inicia el representante legal del prestador en la plataforma HERCULES / SISPRO del Ministerio de Salud. Al terminar el trámite se obtiene:
- La llave de suscripción de la plataforma IHCE.
- El identificador del tenant (directorio) de autenticación.
- El id de cliente, el secreto de cliente y el alcance (scope) de la aplicación registrada, uno por cada ambiente: Prueba y Producción.
El trámite y sus tiempos dependen exclusivamente del Ministerio: ni la IPS ni Goujana pueden acelerarlo. El procedimiento oficial está en el manual de gestión de llaves de la IHCE que publica el Ministerio de Salud.
2. El módulo RDA activo en la cuenta
El RDA es un módulo que se activa por cuenta. Si al abrir el menú RDA o cualquiera de sus listados aparece el mensaje «Necesitas permiso», el módulo no está activo: pide a Goujana que lo active. Además, la integración solo se ofrece cuando el país de la sesión es Colombia.
3. Permisos
- Integraciones (donde se configura el RDA) solo lo ve un usuario administrador.
- Para revisar y reenviar documentos, el grupo de la persona necesita permiso sobre los cuatro listados RDA: consulta externa, urgencias, hospitalización y paciente.
- La acción Generar y emitir RDA aparece en los listados de Evoluciones, Urgencias, Hospitalización y Facturas de venta, y solo después de guardar la configuración de la integración.
4. Los datos que el RDA exige
El sistema no genera un RDA si falta alguno de estos datos, y te dice exactamente cuál. Conviene tenerlos completos desde el principio:
| De quién | Dato obligatorio | Dónde se registra |
|---|---|---|
| Paciente | País, con código numérico ISO | Ficha del paciente |
| Sexo biológico (masculino, femenino o intersexual) | Ficha del paciente | |
| Tipo de documento reconocido por el RDA | Ficha del paciente | |
| Zona de residencia (urbana o rural) | Ficha del paciente → Seguro Médico | |
| Profesional | Ocupación RETHUS y tipo de documento reconocido | Persona → sección RDA |
| IPS | Código de habilitación de la sucursal (el sistema no lo valida antes: si falta, lo rechaza la IHCE) | Sucursal |
| Atención | Consulta externa: servicio de salud (código del servicio) | Evolución |
| Urgencias y hospitalización: fecha de egreso y al menos un diagnóstico codificado; el asegurador del paciente debe tener código | Urgencia u hospitalización |
Los medicamentos son opcionales: si el producto tiene su código DCI de MIPRES y la fórmula trae la posología estructurada (dosis, frecuencia, días y vía), viajan en el RDA; si están incompletos, simplemente se omiten.