Citas Medicas

Citas Medicas es la plataforma MagnoSoft que reemplaza las capacidades de pacientes, profesionales, disponibilidad y reservas antes atribuidas a SISMA en el flujo SAH.

Responsabilidades

• Mantener los identificadores canonicos de pacientes y profesionales.
• Proteger PII mediante cifrado e indices ciegos.
• Configurar agendas, reglas, festivos, bloqueos y capacidad.
• Emitir opciones de disponibilidad opacas y de corta duracion.
• Crear citas de forma transaccional e idempotente.
• Evolucionar hacia elegibilidad, cancelacion, reprogramacion, copagos, documentos y lista de espera.

Limite de integracion

Las integraciones deben usar exclusivamente la API externa versionada. Los componentes que soportan el producto no forman parte del contrato publico.

Aplicacion externa -> /api/external/v1

Coleccion de Postman

Descargue la coleccion completa para probar los casos de uso publicados. Incluye las 91 operaciones de pacientes, cobertura, agenda, gestion complementaria y configuracion, organizadas en 21 carpetas.

Descargar coleccion PostmanTodos los casos de uso, solicitudes y respuestas de ejemplo.Descargar ambiente PostmanVariables baseUrl y accessToken, sin credenciales.

Como usarla

1. Descargue e importe en Postman la coleccion y el ambiente.
2. Seleccione el ambiente Citas Medicas External API - Template.
3. Abra las variables del ambiente y pegue manualmente su token en accessToken, sin agregar el prefijo Bearer.
4. Abra la carpeta del caso de uso que desea probar.
5. Reemplace los valores sinteticos como <uuid> o <string> y ajuste el cuerpo de la solicitud.
6. Envie la solicitud. Todas las operaciones usan automaticamente el accessToken del ambiente.

Para el flujo principal use este orden:

Paciente -> Disponibilidad -> Reserva -> Consulta -> Reprogramacion/Cancelacion

Seguridad y operaciones preview

El token no se incluye en las descargas. No comparta ni exporte el ambiente despues de agregarlo. Revise la descripcion de cada operacion antes de usarla: las operaciones marcadas como preview no deben integrarse en produccion.

Estado documental

La API para aplicaciones externas esta en diseno. La API operativa actual y la futura API estable se documentan por separado para evitar que un consumidor tome dependencias accidentales.