Integración TrustCare

📘
Estado: propuesta (v0.1)
Este contrato está en revisión con OSIGU y todavía no está desplegado. Las rutas y los campos pueden cambiar antes de la v1.

TrustCare conecta pacientes con clínicas y especialistas para procedimientos quirúrgicos. Esta integración permite que OSIGU y TrustCare compartan tres cosas:

Necesidad	Sentido	Cómo
Ficha técnica del paciente	TrustCare → OSIGU	TrustCare usa la API de OSIGU: alta del paciente en el EHR, búsqueda de beneficiario y solicitud de autorización con diagnósticos CIE-10 e indicación en PDF. Fase con datos sensibles: se habilita junto a la integración HIS. Ver Ficha del paciente.
Ficha técnica del procedimiento	OSIGU consulta	`GET /procedures` y `GET /procedures/{code}` de esta API. Ver Catálogo y disponibilidad.
Disponibilidad de agenda	OSIGU consulta	`GET /availability/days` y `GET /availability/slots`. Ver Catálogo y disponibilidad.
Estado del paciente en la clínica	TrustCare → OSIGU	Webhook firmado en cada cambio de estado del caso. Ver Webhook de estado del caso.

Entornos

Entorno	URL base	Conecta con
Pruebas (stage)	`https://api-integrations.stg.trustcaremed.co/osigu/v1`	Sandbox de OSIGU (`https://sandbox.osigu.com`)
Producción	`https://api-integrations.trustcaremed.co/osigu/v1`	Producción de OSIGU (`https://api.osigu.com`)

Convenciones

Fechas y horas: ISO 8601 con zona horaria. Los días van como YYYY-MM-DD, en la zona de la clínica (por ejemplo America/Bogota).
Errores: cuerpo { "code": "…", "message": "…" }. El code es estable y es lo que se debe comparar, no el mensaje.
Idioma: los nombres y descripciones del catálogo aceptan lang=es o lang=en.
Límite de peticiones: al superarlo, la API responde 429 con la cabecera Retry-After.
Datos personales: el catálogo y la agenda no contienen datos de pacientes. El estado de un caso y el webhook solo llevan datos comerciales (paquete, estado y fecha estimada), sin nombre, documento ni historia clínica. Los datos sensibles solo se habilitan con la integración con el HIS de cada clínica. Ver Ciclo de vida y tratamiento de los datos.

Por dónde empezar

Autenticación: pide tu cliente y obtén un token.
Catálogo y disponibilidad: consulta procedimientos y agenda.
Webhook de estado del caso: registra tu URL y verifica la firma. Los identificadores de OSIGU llegan en case.partnerRefs (osiguBeneficiaryId, osiguAuthorizationId).
Pendientes por definir: lo que necesitamos confirmar con OSIGU.