Soporte a la Decisión Clínica

El CDSS correctivo (“soporte a la decisión clínica”) revisa una consulta finalizada contra guías clínicas y señala problemas accionables en el registro — una medicación omitida, una dosis incorrecta, una orden no pertinente. Cada hallazgo es una alerta. Las alertas están asociadas al registro médico: léalas desde el campo cdssAlerts en el endpoint de documentos de registro médico. cdssAlerts es null cuando el soporte a la decisión clínica está deshabilitado para la sesión o no se generaron alertas, y [] cuando se ejecutó y no produjo ninguna.

El modelo de la alerta

{
  "id": "cfa_9cba9fa0…SKULL_XRAY",
  "elementId": "SKULL_XRAY",
  "reason": "Pérdida de consciencia tras una sospecha de concusión; una radiografía de cráneo no evalúa adecuadamente una lesión intracraneal.",
  "action": "Reemplazar la radiografía de cráneo por una tomografía de cráneo sin contraste.",
  "actionCategory": "replace",
  "type": "diagnostic_test",
  "issue": "not_pertinent",
  "element": "Radiografía de cráneo",
  "severity": "red",
  "source": ["NICE Head Injury: Assessment and Early Management Guideline NG232, 2023"],
  "newPlanElement": {
    "type": "diagnostic_test",
    "element": "Tomografía de cráneo sin contraste",
    "id": "HEAD_CT",
    "content": "Tomografía de cráneo sin contraste",
    "laboratory": null
  },
  "previousTestDate": null,
  "guidelineIntervalDays": null,
  "status": "accepted"
}

Use id como identificador de la alerta — es un token estable y opaco. elementId es la clave del elemento clínico (p.ej. ASPIRIN); es legible pero puede repetirse entre documentos, así que nunca lo use como identificador.

Referencia de campos

Campo	Tipo	Descripción
`id`	string	Identificador de alerta estable y opaco. Úselo tal cual; no lo parsee
`elementId`	string	Clave del elemento clínico (p.ej. `ASPIRIN`). Legible, no único entre documentos
`reason`	string	Por qué se generó la alerta
`action`	string	La acción recomendada
`actionCategory`	string	`add` \| `remove` \| `replace` \| `modify`
`type`	string	Tipo de orden: `medication`, `diagnostic_test`, `interconsultation`, `referral`, `follow_up`, `general_order`, `non_pharmacological`, `warning_signs`
`issue`	string	`incorrect_dosage` \| `omission` \| `not_pertinent`
`element`	string	El elemento del plan al que se refiere la alerta
`severity`	string	`red` \| `orange` \| `yellow`
`source`	array	Citas de guías que respaldan la alerta
`newPlanElement`	object \| null	El elemento que propone la alerta (en `add`/`replace`/`modify`): `{ type, element, id, content, laboratory }`. La forma de `content` varía según la plantilla del registro
`previousTestDate`	string \| null	Para recomendaciones de exámenes, la fecha del examen anterior
`guidelineIntervalDays`	number \| null	Para recomendaciones de exámenes, el intervalo de la guía en días
`status`	string	La decisión del médico: `pending` \| `accepted` \| `rejected`

Actuar sobre una alerta

Registre la decisión del médico con el id de la alerta. Aceptar una alerta aplica el cambio propuesto al registro médico; rechazarla deja el registro sin cambios. Ambas requieren una clave de API con scribe:write o scribe:cdss.

curl -X POST https://scribe-api.telepatia.ai/v1/cdss/alerts/ALERT_ID/accept \
  -H "Authorization: Bearer SU_CLAVE_API"

Respuesta:

{
  "id": "cfa_bXJkLWFiYy0xMjMfSUJVUFJPRkVO",
  "elementId": "IBUPROFEN",
  "status": "accepted"
}

Use la misma petición contra /reject para rechazar la alerta.

Una respuesta exitosa significa que la decisión fue registrada. Una alerta aceptada se aplica al registro médico en segundo plano, así que releer el registro inmediatamente después puede mostrar aún su contenido anterior. El status de la alerta se actualiza de inmediato.

Registrar la misma decisión dos veces es seguro — la decisión se almacena por alerta, así que un reintento produce el mismo resultado.

Varias alertas a la vez

Envíe una petición por revisión de consulta en lugar de una por alerta. Cada alerta se valida antes de registrar cualquier decisión, así que un lote que contenga una alerta sobre la que no puede actuar no registra nada.

curl -X POST https://scribe-api.telepatia.ai/v1/cdss/decisions \
  -H "Authorization: Bearer SU_CLAVE_API" \
  -H "Content-Type: application/json" \
  -d '{"decisions":[{"id":"ALERT_ID","decision":"accepted"}]}'

Respuesta:

{
  "decisions": [
    {
      "id": "cfa_bXJkLWFiYy0xMjMfSUJVUFJPRkVO",
      "elementId": "IBUPROFEN",
      "status": "accepted"
    }
  ]
}

Cada decision es accepted o rejected. La respuesta lista una entrada por alerta enviada, en el orden recibido. Una alerta solo puede aparecer una vez por petición.

Errores

Estado	Código	Cuándo
400	`parameter_invalid`	`alertId` no es un identificador de alerta válido, o el lote repite una alerta
403	`permission_denied`	la clave de API no tiene `scribe:write` ni `scribe:cdss`
404	`resource_not_found`	la alerta no existe o no está disponible para esta clave de API
409	`resource_not_active`	el soporte a la decisión clínica no está activo para la consulta

Primeros Pasos

Consultas

Sesiones de Scribe

Webhooks

Smart Templates

Plantillas de Sesión

Cuentas

Pacientes

Referencia

Soporte a la Decisión Clínica

El modelo de la alerta

Referencia de campos

Actuar sobre una alerta

Varias alertas a la vez

Errores

​El modelo de la alerta

​Referencia de campos

​Actuar sobre una alerta

​Varias alertas a la vez

​Errores

El modelo de la alerta

Referencia de campos

Actuar sobre una alerta

Varias alertas a la vez

Errores