Saltar al contenido principal
PATCH
Actualiza los datos de una cita, como la hora programada o la ubicación del análisis. Solo se pueden modificar las citas cuya extracción de sangre aún no se ha confirmado.
No se pueden modificar citas después de confirmar la extracción de sangre ni si ya están canceladas. Intentar actualizar una cita en ese estado devuelve 409 Conflict. La única excepción es results_ready_emails, que puedes seguir cambiando después de la extracción de sangre.
Requiere el scope appointments_schedule o appointments_manage.

Solicitud

Parámetros de ruta

string
requerido
Identificador único (UUID) de la cita que se va a actualizar.

Parámetros del cuerpo

Todos los parámetros del cuerpo son opcionales — incluye solo los campos que quieras cambiar.
string
Nueva fecha y hora de la cita en formato ISO 8601 (por ejemplo, 2026-05-20T14:00:00Z o 2026-05-20T16:00:00+02:00). Debe incluir un indicador de zona horaria — ya sea Z o un desplazamiento explícito como +02:00; se rechazan las fechas y horas sin zona horaria. Debe ser futura.Debe coincidir con el inicio exacto de una franja con capacidad disponible — consulta Obtener disponibilidad. La cita que se reprograma nunca resta capacidad a su propia franja de destino, pero moverla a una franja donde el mismo perfil ya tiene una cita distinta devuelve 409 con el appointment_id de esa cita.Si la ubicación de destino está operada por Aniva, la nueva hora también debe tener al menos 12 horas de antelación — consulta Antelación mínima.
string
UUID de la nueva ubicación del análisis. La ubicación debe existir y estar activa. Usa Listar ubicaciones para encontrar los ID de ubicaciones disponibles.
string[]
Sustituye la lista de hasta 5 direcciones que reciben un correo cada una cuando todos los resultados de laboratorio son definitivos. Envía [] para desactivar estos correos. Este campo sigue siendo editable después de la extracción de sangre; solo se rechaza si la cita está cancelada. Después de la extracción de sangre, envíalo solo: si incluyes scheduled_at o location_id en el mismo cuerpo, la solicitud devuelve 409. Tu clave necesita acceso results_view al paciente; de lo contrario, devuelve 403. Consulta Correos de resultados listos.
string | null
Nuevo método de extracción: capillary o venous, o null para volver a usar el default_draw_method de la ubicación. La ubicación debe incluir el método en su campo draw_methods y las pruebas reservadas deben poder realizarse con él; de lo contrario, devuelve 400. Cuando mueves una cita a otra ubicación, se ejecuta allí la misma comprobación: sobre su propio draw_method o, si no tiene, sobre el default_draw_method de la nueva ubicación.

Respuesta

Si la operación tiene éxito, la API devuelve 200 OK con la cita actualizada y su perfil integrado.
string
requerido
Identificador único de la cita (UUID).
string
requerido
UUID del perfil al que pertenece esta cita.
string
UUID del centro de análisis donde se realiza la extracción de sangre.
string
Fecha y hora programada de la cita como instante UTC (ISO 8601 con sufijo Z, por ejemplo, 2026-05-20T14:00:00Z). Puede ser null.
string
requerido
Estado actual de la cita. Puede ser pending, confirmed, blood_drawn o cancelled. El grado de avance de los resultados de laboratorio se obtiene en Obtener resultados; el progreso detallado de los envíos, a partir de cada entrada del array shipments integrado (ver más abajo) consultándolo en Obtener envío.
string
Motivo en texto libre registrado al cancelar la cita (p. ej., no presentado, cancelación tardía, ‘Fallida. Repetición necesaria’). null salvo que status sea cancelled.
string[]
requerido
Direcciones que reciben un correo cada una cuando todos los resultados de laboratorio son definitivos, en minúsculas. Vacío cuando está desactivado. Consulta Correos de resultados listos.
string
requerido
Cómo se realiza la extracción de sangre: capillary (en la yema del dedo o en la parte superior del brazo, en microtubos) o venous (de la vena, en tubos). Es el método definido en la cita o, en su defecto, el default_draw_method de su ubicación. Después de la extracción de sangre, es el método que se utilizó.
string
requerido
Marca de tiempo ISO 8601 de cuándo se creó la cita.
string
Marca de tiempo ISO 8601 de la última actualización. Puede ser null.
object
requerido
El perfil del paciente asociado a esta cita.
AppointmentPanel[]
requerido
Paneles asociados actualmente a esta cita. Excluye las asociaciones canceladas. Consulta los detalles del panel (nombre, biomarcadores) mediante Listar paneles.
AppointmentIndividualBiomarker[]
requerido
Biomarcadores a la carta asociados a esta cita fuera de cualquier panel (consulta Añadir biomarcadores personalizados). Contrasta cada biomarker_id con Listar biomarcadores para obtener los datos de visualización.
AppointmentShipmentLink[]
requerido
Envíos vinculados a esta cita, ordenados del vínculo más antiguo al más reciente. Array vacío cuando no hay envíos vinculados. Consulta cada id en Obtener envío para ver el payload completo del envío.
string[]
requerido
Códigos de laboratorio (códigos de barras de los tubos) registrados para esta cita, en orden de escaneo. Vacío hasta que se confirme la extracción de sangre. Una extracción venosa lleva un único código impreso en todos los tubos; una extracción capilar lleva un código por microtubo. Los resultados y documentos de Obtener resultados hacen referencia a estos códigos mediante lab_code.

Respuestas de error