Papeleo médico entra. Datos clínicos estructurados salen.

{ "jobId": "job_8Kd2", "status": "QUEUED" }

{
  "type": "document.processing_completed",
  "data": {
    "documentId": "doc_3Fq9",
    "documentType": "LAB_REPORT",
    "processingStatus": "PROCESSED"
  }
}

{
  "display": "Hemoglobin",
  "coding": { "system": "LOINC", "code": "718-7" },
  "valueNumeric": 13.5, "unit": "g/dL",
  "interpretation": "LOW",
  "confidence": 0.93,
  "provenance": { "documentId": "doc_3Fq9",
                  "method": "AI_TEXT" }
}

La abstracción manual no escala

Enfermeras revisoras y peritos reescriben valores en formularios. El rendimiento queda limitado por la plantilla, y el coste por archivo no baja nunca.

El OCR en bruto no es una respuesta

Un volcado de texto todavía hay que clasificarlo, codificarlo y normalizarle las unidades antes de que un motor de reglas o un modelo pueda usarlo.

Una extracción sin origen es inservible

Si un revisor no puede rastrear un valor hasta la página de la que salió, no sostiene una decisión que haya que defender.

Construirlo en casa es un desvío

OCR, detección de plantillas, versionado de prompts, validación de esquema, reintentos idempotentes, trazas de auditoría. Meses de trabajo que no son tu producto.

curl -sX POST "$ZUREE_BASE_URL/v1/patients" \
  -H "Authorization: Bearer $ZUREE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pseudonym":"ext-user-42"}'

# → {"id":"<patientId>",
#     "pseudonym":"ext-user-42",
#     "createdAt":"2026-07-01T09:12:04.000Z"}

import { ZureeClient } from '@zuree/sdk';

const zuree = new ZureeClient({
  apiKey: process.env.ZUREE_API_KEY!,
  baseUrl: process.env.ZUREE_BASE_URL!,
});

const patient = await zuree.patients.create({
  pseudonym: 'ext-user-42',
});

CONTENT=$(base64 -i lab-report.pdf)

curl -sX POST "$ZUREE_BASE_URL/v1/documents" \
  -H "Authorization: Bearer $ZUREE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d "{\"patientId\":\"$PATIENT_ID\",
       \"filename\":\"lab-report.pdf\",
       \"mimeType\":\"application/pdf\",
       \"content\":\"$CONTENT\"}"

# → {"document":{"id":"<documentId>",
#                "status":"SECURITY_CHECKED"},
#     "duplicate":false}

import { readFile } from 'node:fs/promises';
import { randomUUID } from 'node:crypto';

const bytes = await readFile('lab-report.pdf');

const { document } = await zuree.documents.create(
  {
    patientId: patient.id,
    filename: 'lab-report.pdf',
    mimeType: 'application/pdf',
    content: bytes.toString('base64'),
  },
  { idempotencyKey: randomUUID() },
);

curl -sX POST \
  "$ZUREE_BASE_URL/v1/documents/$DOCUMENT_ID/process" \
  -H "Authorization: Bearer $ZUREE_API_KEY"

# → 202 {"jobId":"<jobId>",
#          "status":"QUEUED",
#          "attempts":0}

await zuree.documents.process(document.id);

let s = await zuree.documents.status(document.id);
while (s.status === 'PROCESSING') {
  await new Promise((r) => setTimeout(r, 2000));
  s = await zuree.documents.status(document.id);
}

curl -sX POST "$ZUREE_BASE_URL/v1/webhooks" \
  -H "Authorization: Bearer $ZUREE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://your-app.example/hooks/zuree",
       "events":["document.processing_completed",
                 "document.processing_failed"]}'

# → {"id":"whe_…","secret":"whsec_…"}

import { verifyWebhookSignature } from '@zuree/sdk';

app.post('/hooks/zuree', async (req, res) => {
  const raw = await readRawBody(req);
  const check = verifyWebhookSignature({
    payload: raw,
    signatureHeader: req.headers['zuree-webhook-signature'],
    secret: process.env.ZUREE_WEBHOOK_SECRET!,
  });
  if (!check.ok) return res.status(401).end();

  const event = JSON.parse(raw);
  res.status(200).end();
});

curl -s \
  "$ZUREE_BASE_URL/v1/patients/$PID/observations?limit=50" \
  -H "Authorization: Bearer $ZUREE_API_KEY"

# → { "items": [ { "display": "Hemoglobin",
#       "coding": {"system":"LOINC","code":"718-7"},
#       "valueNumeric": 13.5, "unit": "g/dL",
#       "interpretation": "LOW", "confidence": 0.93,
#       "provenance": {…} } ],
#     "nextCursor": "b2Zmc2V0OjUw" }

for await (const obs of zuree.clinical.observationsAll(patient.id)) {
  console.log(
    obs.display,
    obs.valueNumeric ?? obs.valueText,
    obs.unit ?? '',
    `(${obs.confidence})`,
  );
}

for await (const e of zuree.clinical.timelineAll(patient.id)) {
  console.log(e.date ?? '(undated)', e.kind);
}

zuree.app  (iOS / Android)
   │
   └─ POST /v1/documents
      POST /v1/documents/:id/process
      GET  /v1/patients/:id/timeline
         │
         └─ la misma API V1 de esta página

Zuree no hace ninguna afirmación de cumplimiento normativo — ni RGPD, ni HIPAA, ni ningún otro marco. Los controles de al lado son los mecanismos técnicos que implementamos y que explicaremos a tu equipo de seguridad. Determinar bases legales, plazos de retención y obligaciones de supresión en tu jurisdicción sigue siendo tuyo. Preferimos decirlo de entrada y no en la due diligence.

Sin contenido clínico en telemetría

Logs, métricas, analytics, rastreadores de errores, payloads de webhook y registros de auditoría llevan IDs opacos, códigos y recuentos — nunca contenido de documento.

Aislamiento de tenant en cada consulta

La identidad del tenant se resuelve en el servidor a partir de tu clave de API. Un tenant_id nunca se acepta en el cuerpo de una petición.

Almacenamiento privado, URLs efímeras

Los buckets son privados; las URLs firmadas caducan en minutos. Las cargas pasan análisis de malware y el tipo de contenido se verifica desde los bytes.

Transparencia de proveedor de IA

Cada extracción registra qué proveedor, qué modelo exacto, qué versión de prompt y qué versión de pipeline la produjo — legible por la API.

Borrado coordinado

Borrar un documento lo elimina de la base de datos, del almacenamiento de objetos, de la cola de procesamiento y de los archivos temporales — dejando un registro de auditoría de IDs y recuentos, no de contenido.

Retención en tus términos

Indefinida por defecto — Zuree nunca borra lo que no pediste. Activa una ventana de antigüedad de documento por tenant y los archivos vencidos se purgan por la misma vía.