13 operaciones · base https://api.bestdoctorsrd.com
GET/v1/admissions/{admission_id}/discharge-case
Get Discharge Case By Admission
Parámetros
Nombre
En
Tipo
Obl.
admission_id
path
string
Sí
Respuestas
Código
Descripción
Devuelve
200
Respuesta correcta
objeto
422
Error de validación
HTTPValidationError
POST/v1/admissions/{admission_id}/discharge-case
Open Discharge Case
Parámetros
Nombre
En
Tipo
Obl.
admission_id
path
string
Sí
Respuestas
Código
Descripción
Devuelve
201
Respuesta correcta
objeto
422
Error de validación
HTTPValidationError
GET/v1/discharge-cases/{case_id}
Get Discharge Case
Parámetros
Nombre
En
Tipo
Obl.
case_id
path
string
Sí
Respuestas
Código
Descripción
Devuelve
200
Respuesta correcta
objeto
422
Error de validación
HTTPValidationError
PATCH/v1/discharge-cases/{case_id}
Update Discharge Case
Corrige el contenido de una epicrisis no firmada (o ya reabierta).
SEC-249-004: toda edición queda AUDITADA (``DISCHARGE_CASE_UPDATED``, con el valor
anterior de lo que cambió), con el mismo criterio que la nota clínica. Sin ella, la
ventana que el CR abre a propósito —epicrisis reabierta y editable— era justo donde
desaparecía la trazabilidad: la bitácora decía «se reabrió porque X» y «se firmó»,
pero no quién reescribió el resumen clínico ni qué decía antes. En un documento con
valor probatorio (Ley 126-02) esa es la evidencia que importa.
Añade un seguimiento a la epicrisis. CR-350: no si está firmada ni si está cerrada.
Mismo criterio, misma salida y misma auditoría (SEC-350-002) que los medicamentos: el
plan de seguimiento es parte del documento que el paciente se lleva firmado.
Parámetros
Nombre
En
Tipo
Obl.
case_id
path
string
Sí
Cuerpo obligatorioFollowUpIn
Campo
Tipo
Obl.
serviceType
string
Sí
followUpDate
string (date-time)
Sí
appointmentId
string o nulo
No
notes
string o nulo
No
Respuestas
Código
Descripción
Devuelve
201
Respuesta correcta
objeto
422
Error de validación
HTTPValidationError
POST/v1/discharge-cases/{case_id}/medications
Add Medication
Añade un medicamento a la epicrisis. CR-350: no si está firmada ni si está cerrada.
El bloqueo aplica a TODOS los roles del alta (NURSE/RECEPTION/BILLING/TENANT_ADMIN y
el propio médico): la lista de medicamentos es parte del documento firmado. Para
añadir uno después hay que reabrir con motivo y volver a firmar.
SEC-350-002: el alta de la fila queda AUDITADA, con el mismo idioma que el PATCH de
la cabecera. Ver ``_child_added_audit`` para por qué es material.
Parámetros
Nombre
En
Tipo
Obl.
case_id
path
string
Sí
Cuerpo obligatorioMedicationIn
Campo
Tipo
Obl.
medicationName
string
Sí
dosage
string o nulo
No
frequency
string o nulo
No
duration
string o nulo
No
instructions
string o nulo
No
Respuestas
Código
Descripción
Devuelve
201
Respuesta correcta
objeto
422
Error de validación
HTTPValidationError
POST/v1/discharge-cases/{case_id}/reopen
Reopen Discharge Case Signature
Reapertura EXPLÍCITA y auditada de una epicrisis firmada — PRD #931 / CR-249.
Es la única vía para corregir el contenido firmado: invalida la firma primaria y
la co-firma exigiendo un MOTIVO, lo deja auditado
(``DISCHARGE_CASE_SIGNATURE_REOPENED``, con la firma anulada en el metadata) y
devuelve la epicrisis a estado editable. Después hay que volver a firmarla.
SEC-249-002: el vínculo con el médico tratante se exige SIEMPRE, incluso si la
admisión no tiene médico asignado. Desde CR-351 firmar exige lo mismo, así que ya no
hay diferencia entre ambos caminos — ver ``_require_signature_authority``.
Epicrisis firmadas cuyo contenido clínico se completó DESPUÉS de firmarlas.
Remediación (a) de CR-353: informar. Este endpoint no muta nada — ni re-firma ni
invalida, porque la firma es del médico y regenerarla sin él sería el problema que
CR-249 y CR-350 vinieron a cerrar.
Acotado al tenant de quien pregunta, como el resto del portal. El barrido global
(`tenant_id=None` en el servicio) queda para una auditoría puntual desde consola,
no expuesto: un SUPER_ADMIN que lea aquí sigue viendo sólo el tenant resuelto.