La conversación suele empezar igual: alguien de la clínica quiere que la web muestre los huecos libres, o que la herramienta de facturas de la gestoría reciba los datos sola. La respuesta técnica es que se puede. La respuesta útil es otra: depende de si el ahorro compensa la pieza nueva que hay que mantener y de qué datos van a salir del sistema.
¿Qué es exactamente una API para software de clínica?
Es una puerta de entrada acotada para que otro programa pida o entregue datos concretos sin que una persona los copie a mano. En vez de exportar un fichero, revisarlo y volver a subirlo, el otro sistema pregunta y recibe la respuesta. La puerta no es general: cada credencial lleva escrito qué puede pedir y qué no, y ese límite es lo que separa una integración razonable de un agujero.
Conviene distinguirla de dos cosas que se le parecen. Una importación de datos es un movimiento puntual, con revisión previa, que se hace una vez al cambiar de programa. Una automatización interna dispara acciones dentro del mismo sistema cuando ocurre algo. La integración por clave es lo tercero: una conversación continua entre dos programas distintos que siguen siendo dos programas.
¿Cuándo compensa integrar y cuándo no?
- Compensa si el dato viaja a diarioPublicar la disponibilidad de la agenda en tu web o alimentar un panel externo con datos agregados son tareas que se repiten cada día y donde el trabajo manual no tiene sentido.
- Compensa si evita teclear dos vecesCuando un mismo dato se introduce en dos sistemas, la pregunta no es si aparecerá una discrepancia, sino cuándo, y quién la va a descubrir.
- No compensa para un volcado puntualTraer el histórico al cambiar de programa es una migración con validación y simulación previa, no una integración permanente.
- No compensa sin alguien que la mantengaUna conexión sin responsable técnico deja de funcionar en silencio el día que cambia algo al otro lado, y nadie se entera hasta que falta un dato.
Lo que nunca debería poder salir por una clave
Aquí es donde una integración mal planteada se convierte en un problema de protección de datos. La historia clínica y la identidad del paciente son datos de categoría especial, y una credencial técnica que puede leerlos amplía la superficie de exposición mucho más de lo que suele calcularse cuando se pide la conexión.
En Sanagest ese riesgo no se deja a la configuración. El catálogo de ámbitos que una clave puede recibir excluye por diseño la identidad del paciente y la historia clínica: no son permisos que alguien pueda marcar por error, es que no existen como opción. La agenda se puede consultar para saber qué tramos están ocupados, nunca de quién. Cada credencial se autentica por sí misma, no por la sesión de un miembro del personal, tiene cuota diaria propia y se puede rotar o revocar sin coordinar un cambio de contraseña con nadie.
Tres preguntas antes de pedir una clave
Qué datos concretos necesita leer o escribir el otro sistema, quién responde si la conexión deja de funcionar un martes por la tarde, y qué pasa con esa clave cuando el proveedor que la usa deja de trabajar contigo. Si las tres no tienen respuesta escrita, la integración todavía no está lista para montarse, por muy sencilla que parezca en la demostración.
Mira primero lo que ya está resuelto
Antes de conectar dos sistemas, comprueba si la pregunta que quieres responder ya la contesta el tuyo: los indicadores de la semana salen del mismo dato, sin exportar nada a ninguna parte.
Cómo montar la primera integración sin liarla
Empieza por el caso más pequeño que tenga valor y déjalo funcionando una temporada antes de añadir el segundo. Una clave por integración, con su propio ámbito y su propia cuota, evita que un fallo en la web tumbe la conexión de la gestoría. Documenta en dos líneas qué hace cada clave y quién la pidió, porque dentro de un año nadie lo recordará y la tentación será dejarla viva por si acaso.
Y trata la rotación como mantenimiento normal, no como una emergencia. Cambiar la credencial de forma periódica obliga a saber dónde está usada, que es exactamente la información que falta cuando de verdad hace falta revocarla deprisa.
Preguntas frecuentes sobre integrar el software de una clínica
¿Puede una integración leer la historia clínica de un paciente?
En Sanagest, no. Esos dos ámbitos, identidad del paciente e historia clínica, están vetados en el catálogo de permisos concedibles a una clave, sin excepción configurable. Una integración puede consultar la ocupación de la agenda, pero solo los tramos ocupados, nunca a quién corresponden. Al pedir presupuesto a cualquier proveedor conviene preguntar esto por escrito.
¿Cuántas integraciones necesita una clínica pequeña?
Muchas no necesitan ninguna. Si la agenda, la historia, la facturación y las comunicaciones viven en el mismo programa, no hay nada que conectar. La necesidad aparece cuando existe una herramienta externa que no se puede sustituir: la contabilidad de una gestoría concreta, un equipo de diagnóstico o una web hecha a medida con su propio calendario.
¿Qué pasa si el otro programa cambia y la conexión se rompe?
Deja de traer datos, y ese es el riesgo real de cualquier integración: falla en silencio. Por eso conviene que cada conexión tenga un responsable identificado y una comprobación periódica, aunque sea manual. Un dato que deja de llegar es más difícil de detectar que un error visible en pantalla, porque no molesta a nadie hasta que hace falta.
¿Cuántos endpoints públicos ofrece Sanagest por clave?
Siete, cada uno accesible solo si la clave tiene concedido su ámbito correspondiente. Cada credencial lleva además su propia cuota diaria, de forma que dos claves distintas no pueden agotarse el límite entre ellas. Si tu integración necesita algo que no está en esa lista, la vía correcta es preguntarlo antes de diseñar el proyecto alrededor de una suposición.
Sigue por el lado del dinero
La integración más pedida suele ser la de cobros. Antes de conectarla, mira cómo se sostiene el pago a plazos dentro del propio sistema.