Ficha del paciente

La ficha técnica del paciente viaja de TrustCare a OSIGU usando la API de OSIGU. Esta página explica cómo lo haremos, para que OSIGU sepa qué recibirá y qué configuración necesitamos de su lado.

🚧
Fase con datos sensibles: todavía no está habilitada
Este flujo envía datos personales y datos sensibles del paciente (diagnósticos e indicación médica). Por eso no forma parte de la fase actual, en la que TrustCare solo comparte datos comerciales con sus socios. Se habilitará en la misma fase que la integración con el HIS de cada clínica, y solo cuando se cumplan las condiciones de «Cuándo se habilita», más abajo.

Qué datos viajan a OSIGU

Paso	Datos	Clasificación
Alta en el EHR	Nombre, fecha de nacimiento, sexo, documento, correo y teléfono	Datos personales
Búsqueda de beneficiario	Los campos del formulario de la aseguradora, normalmente tipo y número de documento	Datos personales
Solicitud de autorización	Médico tratante, diagnósticos CIE-10 y procedimiento	Datos sensibles (salud)
Indicación en PDF	Indicación médica firmada por el especialista	Datos sensibles (salud)

Secuencia

Alta del paciente en el EHR de OSIGU. POST /ehr/v1/patients/bulk bajo el registro médico del especialista. Enviamos datos demográficos y de contacto, y en external_patient_id el id del paciente en TrustCare. Seguimos el proceso con GET /ehr/v1/patients/bulk/{id} hasta COMPLETED; ALREADY_EXISTS cuenta como éxito.
Búsqueda de beneficiario. POST /beneficiary-lookup/v1/sponsors/{sponsor_slug}/search con el formulario de la aseguradora. Guardamos el beneficiary_id en el caso.
Solicitud de autorización. POST /arc/v1/authorization-requests/ con:
- el beneficiario y el sponsor_slug;
- el médico (nombre, registro y especialidad);
- los diagnósticos CIE-10;
- el procedimiento (product_type_slug: medical-procedure, provider_product_code).
Indicación en PDF. Se adjunta cuando la aseguradora la exige, generada desde la ficha del paciente y firmada por el especialista.
Resultado. Llega por la URL de seguimiento de OSIGU o por sus eventos de autorización (AUTHORIZATION_CREATED, AUTHORIZATION_VOIDED). Queda en el caso de la clínica.

Cuándo se habilita

El flujo se activa para una clínica solo cuando se cumplen las cuatro condiciones:

Autorización expresa del paciente para compartir sus datos sensibles con la aseguradora a través de OSIGU (Ley 1581 de 2012, artículo 6). Es facultativa y separada de las demás autorizaciones.
Acuerdo de tratamiento de datos firmado entre TrustCare, la clínica y OSIGU, que fije roles, finalidad, plazos de conservación y la transferencia internacional si la hay.
Especificación técnica acordada con OSIGU: campos mínimos por aseguradora, cifrado y canal.
Revisión de seguridad de la integración por parte de TrustCare y de OSIGU.

Cuándo se envía

Una vez habilitado, se envía cuando la clínica programa el caso (CASE_SCHEDULED) de un paciente asegurado que ya firmó la autorización. Sin autorización firmada no se envía nada, ni siquiera el alta en el EHR.

Solo se envían los campos que exige cada aseguradora. Si el paciente revoca la autorización, no se envía nada más y se avisa a OSIGU para que borre los datos recibidos, salvo los que deba conservar por ley.

Lo que TrustCare necesita de OSIGU

Credenciales de sandbox y de producción para TrustCare como prestador, y el provider_slug de cada clínica.
El registro de nuestros especialistas como médicos en OSIGU. Sin él, la carga de pacientes responde 404 025-0300.
Los sponsor_slug de las aseguradoras activas y sus formularios de búsqueda.
La tabla de equivalencias entre nuestros códigos de procedimiento (PROC_*, PKG_*) y los de cada aseguradora.
Que nos registren como receptores de los eventos de autorización de nuestras clínicas, si es posible.