> ## 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.

# Documentos de Registro Médico

> Recuperar el registro médico completo producido por una sesión de scribe

Una sesión de scribe puede producir uno o más documentos de registro médico — uno por `purpose` (p.ej. `primary` para el registro del médico, `rpa` para inyección en el EMR). Cada documento es la salida completa de las plantillas de sesión.

## Listar los documentos

Use el mismo `consultationInternalId` que usó con el endpoint de sesión de scribe:

```bash theme={null}
curl https://scribe-api.telepatia.ai/v1/scribe-sessions/CONSULT-12345/medical-record-documents \
  -H "Authorization: Bearer SU_CLAVE_API"
```

**Respuesta:**

```json theme={null}
{
  "items": [
    {
      "id": "mrd-abc-123",
      "purpose": "primary",
      "specialty": "Cardiology",
      "language": "en",
      "medicalRecordSummary": "Paciente presenta dolor torácico.",
      "createdAt": "2026-02-20T10:30:00Z",
      "updatedAt": "2026-02-20T10:35:00Z",
      "medicalRecord": {
        "sections": []
      },
      "medicalRecordSummaryStructured": {
        "pastMedicalConditions": ["Hipertensión"],
        "pastMedicalConditionsCoded": [
          {
            "content": "Hipertensión",
            "code": {
              "code": "I10",
              "options": [{ "code": "I10", "score": 0.98 }]
            }
          }
        ],
        "vitalSigns": {
          "bloodPressure": "120/80"
        }
      },
      "diagnosisCodes": [
        {
          "code": "I10",
          "description": "Hipertensión esencial (primaria)",
          "type": "primary"
        }
      ],
      "cdssAlerts": [
        {
          "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"
        }
      ]
    }
  ],
  "total": 1
}
```

## Códigos de diagnóstico

Cada documento incluye sus `diagnosisCodes` — los códigos de diagnóstico ICD-10 (CIE-10 / CID-10), como el conjunto curado por el médico (las sugerencias del modelo más los códigos que el médico agregó, menos los que eliminó). Cada entrada tiene un `type` de `primary` o `secondary`. La lista está vacía cuando la sesión no tiene códigos de diagnóstico.

Las condiciones médicas previas llevan sus propios códigos resueltos en `medicalRecordSummaryStructured.pastMedicalConditionsCoded`: cada entrada asocia el `content` de la condición con un objeto `code` que contiene el `code` de mejor coincidencia y las `options` con puntaje. Es `null` hasta que se haya ejecutado la resolución de códigos para el registro.

<Tip>
  Espere a que el `status` de la sesión sea `completed` o `completedWithErrors` (vea [Ciclo de vida de la sesión](/es/scribe-api/scribe-sessions#ciclo-de-vida-de-la-sesi-n)) antes de obtener sus documentos — solo se producen una vez que el pipeline de IA termina.
</Tip>

## Alertas de CDSS

Cuando el soporte a la decisión clínica está habilitado para la sesión, cada documento incluye sus `cdssAlerts` — alertas correctivas que señalan omisiones, dosis incorrectas u órdenes no pertinentes en el registro. Cada alerta tiene un `id` opaco y estable (úselo tal cual; no lo parsee), el `elementId` clínico al que se refiere, un `actionCategory` (`add` | `remove` | `replace` | `modify`), una `severity` (`red` | `orange` | `yellow`) y un `status` que refleja la decisión del médico (`pending` | `accepted` | `rejected`). Es `null` cuando CDSS está deshabilitado para la sesión o no se generaron alertas, y `[]` cuando se ejecutó y no produjo ninguna.

Vea [Soporte a la decisión clínica](/es/scribe-api/cdss-alerts) para el modelo completo de la alerta.

## Filtrar por purpose

Pase `?purpose=primary` para obtener solo el documento del médico. Otros valores válidos incluyen `rpa` (para inyección en el EMR) y `emr`.

```bash theme={null}
curl "https://scribe-api.telepatia.ai/v1/scribe-sessions/CONSULT-12345/medical-record-documents?purpose=primary" \
  -H "Authorization: Bearer SU_CLAVE_API"
```

## Referencia de campos

| Campo                                                       | Tipo              | Descripción                                                                                                                                                             |
| ----------------------------------------------------------- | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`                                                        | string            | Identificador del documento                                                                                                                                             |
| `purpose`                                                   | string            | `primary`, `rpa`, `emr`, … — identifica el registro cuando una sesión produjo varios                                                                                    |
| `specialty`                                                 | string \| null    | Especialidad médica asociada al registro                                                                                                                                |
| `language`                                                  | string \| null    | Idioma del contenido                                                                                                                                                    |
| `medicalRecordSummary`                                      | string \| null    | Resumen en texto plano del registro                                                                                                                                     |
| `medicalRecord`                                             | object \| null    | Payload opaco `{ sections: [...] }` — la salida completa de las plantillas                                                                                              |
| `medicalRecordSummaryStructured`                            | object \| null    | Resumen estructurado: `pastMedicalConditions`, `pastMedicalConditionsCoded`, `medication`, `recentLabsAndImaging`, `lastConsultation`, `vitalSigns`, `age`, `gender`    |
| `medicalRecordSummaryStructured.pastMedicalConditionsCoded` | array \| null     | Condiciones previas con códigos ICD-10 resueltos — `content` más un objeto `code` (`code`, `options` con puntaje). `null` hasta que se ejecute la resolución de códigos |
| `createdAt`                                                 | string (ISO 8601) | Fecha de creación del documento                                                                                                                                         |
| `updatedAt`                                                 | string (ISO 8601) | Última actualización                                                                                                                                                    |
| `diagnosisCodes`                                            | array             | Códigos de diagnóstico ICD-10 del registro: `{ code, description, type }` con `type` = `primary` \| `secondary`. Vacío cuando la sesión no tiene ninguno                |
| `cdssAlerts`                                                | array \| null     | Alertas correctivas de CDSS del registro — vea [Soporte a la decisión clínica](/es/scribe-api/cdss-alerts). `null` cuando CDSS está deshabilitado o no se generó        |
