GloopIA · Salud — Playbook

Enrolamiento IHCE — paso a paso (cualquier IPS)

La ruta administrativa completa para que un prestador de servicios de salud quede habilitado ante el Ministerio y obtenga sus llaves de acceso. Genérico y reutilizable — con los errores reales que aparecen y cómo resolverlos.

Representante legal Delegado administrativo Ministerio de Salud
0Requisitos
1Autorizar delegado
2Delegado persona natural
3Registro en Hércules
4Crear contraseña
5Solicitar llaves
6Entregar al técnico
0

Requisitos previos

Rep. legal
✓
La IPS está habilitada en REPS
Registro Especial de Prestadores. Si la IPS opera, lo está.
✓
El representante legal está en Mi Seguridad Social
Registrado como persona natural y con la IPS registrada como persona jurídica. miseguridadsocial.gov.co
1

El rep. legal autoriza al delegado

Rep. legal
1
Entrar a miseguridadsocial.gov.co como rep. legal
2
Seleccionar rol → "Institución Prestadora de Servicio"
Elegir la unidad = la IPS correspondiente.
3
Buscar autorizados → "Administrar autorizados"
4
Agregar al delegado
Documento del delegado + su correo + nombre + Rol "Institución Prestadora de Servicio" + Perfil "Autorizado afiliación" + Sede. Guardar.
✓

El delegado aparece en la tabla asociado a la IPS. Esa fila es la autorización.

2

El delegado se registra como persona natural

Delegado
1
Entrar a miseguridadsocial.gov.co → "Registro"
Registrarse como persona natural con cédula y correo propios. Confirmar por correo.
!

Sin este paso, la autorización de la Fase 1 no cuaja y Hércules dirá "no está asociado". Debe existir (puede ir antes o después de la Fase 1).

3

Registro del delegado en Hércules

Delegado
1
Ir a Hércules → ícono IHCE
hercules.sispro.gov.co/…/RegistrarUsuario.aspx
2
Elegir "Delegado de IPS, EPS, Gestor farmacéutico"
NIT de la IPS (sin dígito de verificación) + tipo/número de documento del delegado + captcha + confidencialidad → Registrar.
!

Trampa clave: NO elegir "Otro tipo de usuario" — se completa pero no sirve para las llaves. Debe ser "Delegado de IPS".

✓

Registro satisfactorio → entrega un login (formato CC + número) y envía un correo con enlace para crear la contraseña. Anotar el login.

4

Crear la contraseña

Delegado
1
Abrir el enlace del correo con clic directo
No copiar/pegar la URL: el PIN es largo y si se corta queda inválido. Definir la contraseña ahí.
!

"Pin inválido…" = enlace vencido, usado o cortado → pedir uno nuevo con "¿Olvidó su contraseña?" y abrirlo de inmediato.

5

Solicitar y consultar las llaves

Delegado + MinSalud
1
Entrar a AdminTokens
ihcecol.sispro.gov.co/AdminTokens con login + contraseña + "No soy un robot".
2
"Inscripción Token" (primera vez)
Luego un funcionario del Ministerio asigna las llaves.
3
"Consultar Token" (👁) → copiar las llaves
ClientID, ClientSecret y Subscription-Key para preproducción (sandbox) y producción.
!

"Los datos de usuario no corresponden" = falta crear contraseña, se registró como "Otro tipo de usuario", o aún no sincroniza. Si tardó días → soporte.

6

Entregar las llaves al equipo técnico

Delegado → Integrador
1
Pasar ClientID / ClientSecret / Subscription-Key de forma segura
Nunca en texto plano. Van como secretos del conector.
✓

Con las llaves de sandbox, el conector FHIR empieza a enviar RDAs de prueba → certificación → producción.

Errores comunes (los que salen de verdad) y cómo resolverlos
"El delegado … no está asociado a la persona jurídica…"
Causa: falta la autorización (Fase 1) o que el delegado exista como persona natural (Fase 2), o no sincroniza. Fix: completar ambas y reintentar; si insiste, esperar o llamar.
"Usuario bloqueado y no enrolado por SAT…"
Causa: la cuenta/entidad existe pero está bloqueada en el SAT. Fix: actualizar datos / desbloquear en SAT, o soporte con NIT + cédula.
"Pin inválido para restablecer la contraseña"
Causa: enlace vencido, usado o cortado al copiar. Fix: "¿Olvidó su contraseña?" → abrir el nuevo enlace de inmediato.
"Los datos de usuario no corresponden" (AdminTokens)
Causa: registro como "Otro tipo de usuario", falta contraseña, o sincronización. Fix: registrar como Delegado de IPS + crear clave + esperar.
601 330 5043

Mesa de Ayuda del Ministerio (o 018000 960020). Lun–vie 7am–6pm, sáb 8am–1pm. Tener a mano el login, el NIT y la cédula. Para bloqueos de SAT y sincronizaciones que no se destraban solas, es la vía más rápida.