> ## 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 o registro médico preenchido produzido por uma sessão de scribe

Uma sessão de scribe pode produzir um ou mais documentos de registro médico — um por `purpose` (ex.: `primary` para o registro do médico, `rpa` para injeção no EMR). Cada documento é a saída preenchida dos templates de sessão.

## Listar os documentos

Use o mesmo `consultationInternalId` que você usou com o endpoint de sessão de scribe:

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

**Resposta:**

```json theme={null}
{
  "items": [
    {
      "id": "mrd-abc-123",
      "purpose": "primary",
      "specialty": "Cardiology",
      "language": "en",
      "medicalRecordSummary": "Paciente apresenta dor torácica.",
      "createdAt": "2026-02-20T10:30:00Z",
      "updatedAt": "2026-02-20T10:35:00Z",
      "medicalRecord": {
        "sections": []
      },
      "medicalRecordSummaryStructured": {
        "pastMedicalConditions": ["Hipertensão"],
        "pastMedicalConditionsCoded": [
          {
            "content": "Hipertensão",
            "code": {
              "code": "I10",
              "options": [{ "code": "I10", "score": 0.98 }]
            }
          }
        ],
        "vitalSigns": {
          "bloodPressure": "120/80"
        }
      },
      "diagnosisCodes": [
        {
          "code": "I10",
          "description": "Hipertensão essencial (primária)",
          "type": "primary"
        }
      ],
      "cdssAlerts": [
        {
          "id": "cfa_9cba9fa0…SKULL_XRAY",
          "elementId": "SKULL_XRAY",
          "reason": "Perda de consciência após suspeita de concussão; a radiografia de crânio não avalia adequadamente lesão intracraniana.",
          "action": "Substituir a radiografia de crânio por uma tomografia de crânio sem contraste.",
          "actionCategory": "replace",
          "type": "diagnostic_test",
          "issue": "not_pertinent",
          "element": "Radiografia de crânio",
          "severity": "red",
          "source": ["NICE Head Injury: Assessment and Early Management Guideline NG232, 2023"],
          "newPlanElement": {
            "type": "diagnostic_test",
            "element": "Tomografia de crânio sem contraste",
            "id": "HEAD_CT",
            "content": "Tomografia de crânio sem contraste",
            "laboratory": null
          },
          "previousTestDate": null,
          "guidelineIntervalDays": null,
          "status": "accepted"
        }
      ]
    }
  ],
  "total": 1
}
```

## Códigos de diagnóstico

Cada documento inclui seus `diagnosisCodes` — os códigos de diagnóstico ICD-10 (CIE-10 / CID-10), como o conjunto curado pelo médico (as sugestões do modelo mais os códigos que o médico adicionou, menos os que removeu). Cada entrada tem um `type` de `primary` ou `secondary`. A lista fica vazia quando a sessão não tem códigos de diagnóstico.

As condições médicas pregressas carregam seus próprios códigos resolvidos em `medicalRecordSummaryStructured.pastMedicalConditionsCoded`: cada entrada associa o `content` da condição a um objeto `code` contendo o `code` de melhor correspondência e as `options` com pontuação. É `null` até que a resolução de códigos tenha sido executada para o registro.

<Tip>
  Aguarde até que o `status` da sessão seja `completed` ou `completedWithErrors` (veja [Ciclo de vida da sessão](/pt-BR/scribe-api/scribe-sessions#ciclo-de-vida-da-sess-o)) antes de buscar seus documentos — eles só são produzidos depois que o pipeline de IA termina.
</Tip>

## Alertas de CDSS

Quando o suporte à decisão clínica está habilitado para a sessão, cada documento inclui seus `cdssAlerts` — alertas corretivos que sinalizam omissões, dosagens incorretas ou condutas não pertinentes no registro. Cada alerta tem um `id` opaco e estável (use-o como está; não faça parsing), o `elementId` clínico ao qual se refere, um `actionCategory` (`add` | `remove` | `replace` | `modify`), uma `severity` (`red` | `orange` | `yellow`) e um `status` que reflete a decisão do médico (`pending` | `accepted` | `rejected`). É `null` quando o CDSS está desabilitado para a sessão ou nenhum alerta foi gerado, e `[]` quando executou e não produziu nenhum.

Veja [Suporte à decisão clínica](/pt-BR/scribe-api/cdss-alerts) para o modelo completo do alerta.

## Filtrar por purpose

Passe `?purpose=primary` para obter apenas o documento do médico. Outros valores válidos incluem `rpa` (para injeção no EMR) e `emr`.

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

## Referência de campos

| Campo                                                       | Tipo              | Descrição                                                                                                                                                                    |
| ----------------------------------------------------------- | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`                                                        | string            | Identificador do documento                                                                                                                                                   |
| `purpose`                                                   | string            | `primary`, `rpa`, `emr`, … — identifica o registro quando uma sessão produziu vários                                                                                         |
| `specialty`                                                 | string \| null    | Especialidade médica associada ao registro                                                                                                                                   |
| `language`                                                  | string \| null    | Idioma do conteúdo                                                                                                                                                           |
| `medicalRecordSummary`                                      | string \| null    | Resumo em texto puro do registro                                                                                                                                             |
| `medicalRecord`                                             | object \| null    | Payload opaco `{ sections: [...] }` — a saída preenchida dos templates                                                                                                       |
| `medicalRecordSummaryStructured`                            | object \| null    | Resumo estruturado: `pastMedicalConditions`, `pastMedicalConditionsCoded`, `medication`, `recentLabsAndImaging`, `lastConsultation`, `vitalSigns`, `age`, `gender`           |
| `medicalRecordSummaryStructured.pastMedicalConditionsCoded` | array \| null     | Condições pregressas com códigos ICD-10 resolvidos — `content` mais um objeto `code` (`code`, `options` com pontuação). `null` até que a resolução de códigos seja executada |
| `createdAt`                                                 | string (ISO 8601) | Quando o documento foi criado                                                                                                                                                |
| `updatedAt`                                                 | string (ISO 8601) | Última atualização                                                                                                                                                           |
| `diagnosisCodes`                                            | array             | Códigos de diagnóstico ICD-10 do registro: `{ code, description, type }` com `type` = `primary` \| `secondary`. Vazio quando a sessão não tem nenhum                         |
| `cdssAlerts`                                                | array \| null     | Alertas corretivos de CDSS do registro — veja [Suporte à decisão clínica](/pt-BR/scribe-api/cdss-alerts). `null` quando o CDSS está desabilitado ou não foi gerado           |
