> ## Documentation Index
> Fetch the complete documentation index at: https://docs.telepatia.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Soporte a la Decisión Clínica
> Alertas correctivas de CDSS en un registro médico y cómo leerlas
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](/es/scribe-api/medical-record-documents). `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
```json theme={null}
{
"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`.
```bash theme={null}
curl -X POST https://scribe-api.telepatia.ai/v1/cdss/alerts/ALERT_ID/accept \
-H "Authorization: Bearer SU_CLAVE_API"
```
**Respuesta:**
```json theme={null}
{
"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.
```bash theme={null}
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:**
```json theme={null}
{
"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 |