Saltar al contenido principal
PATCH
Añade uno o más biomarcadores individuales a una cita como pruebas a la carta, fuera de cualquier panel predefinido. Las decisiones de enrutamiento se toman posteriormente en el flujo de logística de pedidos según las asignaciones por laboratorio de cada biomarcador. El conjunto resultante se valida de forma síncrona según las reglas de cierre de cada laboratorio. Algunos biomarcadores solo pueden obtenerse pidiéndolos junto con otros: un cociente LDL/HDL, por ejemplo, se obtiene mediante un pedido que también devuelve LDL y HDL, por lo que pedir el cociente por sí solo no es un pedido coherente. (Esos mismos componentes son los que determinan el precio del cociente; consulta el desglose de pricing en Listar biomarcadores). Cuando el conjunto no puede pedirse correctamente, la llamada devuelve 400 con un payload validation y no se guarda nada, así que puedes ir probando hasta dar con un conjunto válido:
  1. PATCH … { "biomarker_ids": [45] } (solo cociente LDL/HDL) → 400; validation.failures[].fix_options[].add_biomarkers incluye LDL y HDL.
  2. PATCH … { "biomarker_ids": [45, 43, 42] } (cociente + LDL + HDL) → 200.
El mismo bucle cubre los biomarcadores que Aniva solo vende dentro de una posición: si pides uno solo, la llamada devuelve 400 con error: "biomarker_requires_position" y las posiciones que lo venden. Consulta Precios. Listar biomarcadores muestra algunos biomarcadores con price_cents: null. Estos biomarcadores no están configurados: Aniva no les ha fijado un precio. Si añades uno, la llamada devuelve 400 con error: "biomarker_not_priced". Ningún otro biomarcador corrige este error, porque null significa que no tienes precio para comprar el marcador. Los marcadores de kit son la excepción. Añade el panel que corresponde al kit y sus componentes vienen con el panel. La llamada también acepta un componente que añadas a una cita que ya tenga ese panel. En una extracción capilar (draw_method: capillary), la extracción se distribuye en microtainers. Los paneles van primero, por orden de reserva. Después, los biomarcadores individuales llenan el espacio libre de los microtainers de los paneles. Cuando necesitan más espacio, abren nuevos microtainers. Los repartimos de forma uniforme. Cada microtainer admite como máximo 150 µl de biomarcadores individuales. Un biomarcador que necesite más de 150 µl en un microtainer propio nunca cabe, y tampoco uno sin un volumen configurado. Si el conjunto resultante incumple esta regla, la llamada devuelve 400 con un mensaje error y no se guarda nada. Esta llamada es idempotente: los biomarcadores que ya están en la cita se mantienen. Requiere los scopes appointments_schedule y schedule_appointments_with_individual_biomarker_selection.
No se pueden añadir biomarcadores después de llamar a Confirmar extracción de sangre. Intentar modificar una cita confirmada devuelve 409 Conflict.

Solicitud

Parámetros de ruta

string
requerido
Identificador único (UUID) de la cita.

Parámetros del cuerpo

number[]
requerido
Array de ID de biomarcadores para añadir. Debe contener al menos un elemento. Usa Listar biomarcadores para consultar los ID.

Respuesta

Si la operación tiene éxito, la API devuelve 200 OK confirmando que se han añadido los biomarcadores.
boolean
true cuando los biomarcadores se han añadido correctamente a la cita.

Interpretar un 400

Todo 400 de validación de cierre o de catálogo incluye una frase en message. Un 400 de validación del cuerpo o de microtainer incluye solo error. Ramifica según error. En un fallo de validación de cierre, error es una frase. En un fallo de catálogo, error es un código de máquina: biomarker_not_priced o biomarker_requires_position. Validación de cierre — el conjunto no se puede pedir correctamente en ningún laboratorio:
  • validation.failures[] — presente solo en fallos de validación de cierre (ausente en simples errores de validación del cuerpo). Una entrada por cada grupo de biomarcadores que ningún laboratorio puede ofrecer, con los biomarker_ids que han fallado y fix_options[], con la opción más pequeña primero. El add_biomarkers ({ id, name }) de cada opción es un conjunto del que debes añadir TODOS los elementos: mantén los originales, añade esos y vuelve a intentarlo. Un fix_options vacío significa que no servirá añadir nada; elimina el biomarcador en su lugar.
Biomarcador sin precio — Aniva no ha fijado un precio para este biomarcador. Listar biomarcadores lo muestra con price_cents: null, o lo omite si es un cociente con un componente sin precio. error es biomarker_not_priced y biomarker_id indica el marcador. Ningún otro biomarcador corrige este error, así que elimina el biomarcador. Dos condiciones hacen que un biomarcador se pueda pedir: un laboratorio al que Aniva pueda enrutarlo debe ofrecerlo y el catálogo de Aniva debe asignarle un precio. Biomarcador restringido — un biomarcador que solo se vende dentro de una posición, sin ninguna posición en el conjunto que lo cubra. error es biomarker_requires_position, biomarker_id indica el marcador y positions[] enumera cada posición que lo vende, de la más barata a la más cara. Añade todos los biomarcadores de una de ellas. Consulta Precios para conocer el modelo y pricing.positions en Obtener biomarcador para ver el conjunto completo de componentes de una posición.

Respuestas de error