Pacientes y privacidad

La API maneja datos de salud, que el RGPD considera una categoría especial (art. 9). Esta guía explica qué datos de los pacientes recibimos, cuáles te devolvemos y por qué la API está diseñada para devolver lo mínimo.

Cómo identificamos al paciente

Cada aviso es para un paciente. Para que el profesional que va al domicilio tenga su historia (alergias, visitas anteriores, tratamientos), intentamos reconocer si el paciente ya existe en Salud en Ruta:

• Con tipo y nº de documento (DNI, NIE o PASSPORT) y fecha de nacimiento, buscamos una ficha con exactamente esos tres datos. Si existe, el aviso se asocia a ella; si no, se crea una ficha nueva.
• Con documentType: "NONE" (menores sin DNI, o quien no lo aporta) no hay forma segura de saber si es la misma persona, así que siempre se crea una ficha nueva. Si más tarde la centralita detecta que era un paciente conocido, une las fichas internamente.
• El DNI y el NIE se validan (formato y letra de control) antes de buscar: un documento mal escrito responde 400 y no crea ninguna ficha.

Solo devolvemos lo que tú enviaste

Que un documento coincida con una ficha existente es un hecho interno: no te lo decimos, y la respuesta es idéntica exista o no el paciente. En concreto:

• patientName es el nombre tal y como lo enviaste en ese aviso, nunca el de nuestra ficha. Si envías un DNI que coincide con una ficha con otro nombre, verás tu nombre, y la centralita revisará el caso.
• No devolvemos la fecha de nacimiento, el documento, el teléfono ni la dirección completa de nuestra ficha. La dirección del aviso (address) sale sin piso, sin indicaciones de acceso y sin coordenadas.
• No hay ningún endpoint para buscar pacientes por documento ni para listar pacientes.

Así, la API no se puede usar para averiguar si una persona es paciente de Salud en Ruta ni para obtener datos que no tenías: con tu clave solo ves lo que tu organización ya sabía.

Qué no devolvemos nunca

Los webhooks son todavía más escuetos: no llevan ningún dato del paciente (ni el nombre), solo identificadores, estados, horas y tu externalRef. Ver la carga.

Datos de salud y RGPD

• Roles. Para los avisos que nos envías, tu organización y Salud en Ruta firmáis un acuerdo que fija quién es responsable de cada tratamiento. La API no cambia ese acuerdo; solo es el canal.
• Minimización. Envía solo lo necesario para la visita: identificación, contacto, domicilio y motivo. No envíes historias clínicas completas, pólizas ni datos de terceros en reason o accessNotes.
• Exactitud. Comprueba los datos antes de enviarlos: un teléfono o un piso equivocados retrasan la visita y obligan a la unidad a llamar.
• Seguridad en tu lado. Lo que recibas (sobre todo los informes) debe guardarse con las medidas que exige el RGPD para datos de salud: acceso restringido, cifrado y registro de accesos.
• Registro de accesos. En Salud en Ruta queda registrado cada acceso a datos clínicos, incluida cada descarga de informe por la API, con la clave que lo hizo.
• Entorno de pruebas. El sandbox es solo para datos ficticios. No envíes datos reales de pacientes a pruebas, aunque sea para reproducir un problema: si necesitas analizar un caso real, escríbenos con el código del aviso (AV-…) y lo miramos en producción.

Informes solo con consentimiento

El informe asistencial (lo que el profesional escribe y firma tras la visita) es el único dato clínico que puedes obtener por la API, y solo cuando se cumplen las tres condiciones:

1. El profesional ha firmado el informe.
2. Salud en Ruta lo ha compartido con tu organización.
3. El paciente ha consentido que se te envíe.

Si falta cualquiera, GET /visits/{id}/report responde 404 (/errors/provider/report-not-available), sin decir cuál de ellas falla. Cuando el informe está disponible recibes el webhook report.shared y reportAvailable pasa a true.

Cada descarga queda registrada. Descárgalo una vez, guárdalo en tu sistema documental y sírvelo desde allí; no lo pidas a la API cada vez que alguien lo consulte. Detalles técnicos en avisos.