Saltar al contenido principal
GET
Devuelve un catálogo paginado de los biomarcadores que tu clave de API puede pedir en un origen. Añádelos a citas o a kits de prueba en casa. Los biomarcadores archivados quedan excluidos. Un biomarcador aparece en la lista cuando un pedido en un laboratorio que tu clave puede usar lo incluye y el pedido recoge muestras solo en los recipientes que tiene el origen. Lo deciden los tubos de muestra, no el tipo de analito. Requiere el alcance panels_access. El objeto pricing también requiere el alcance prices_view.

Solicitud

Parámetros de consulta

El origen puede tener dos formas: un centro de pruebas o un kit de prueba en casa. Envía exactamente uno. Si no envías ninguno o envías ambos, devuelve 400.
string
requerido
El centro donde se realizan las extracciones de sangre de las citas. Un biomarcador aparece en la lista cuando su pedido recoge muestras solo en los recipientes que tiene ese centro. Relaciónalo con Listar centros.
string
Sobrescribe la lista de tarifas que usa price_cents: retail o el id de una lista de tarifas que tu clave puede usar. Obtener lista de tarifas devuelve ese id. Por defecto usa la lista de la cuenta de facturación de tu clave de API; si no, la de venta al público. retail_cents corresponde siempre a la lista de venta al público.
number
Número máximo de resultados que devolver (1–1.000). Omítelo para devolver todo el catálogo coincidente — está acotado (unos pocos miles de filas como máximo). Cuando se omite, pagination.limit devuelve el mismo valor que total.
number
predeterminado:"0"
Desplazamiento de paginación. Debe ser ≥ 0.

Respuesta

Biomarker[]
Array de biomarcadores que coinciden con la consulta.
object

Objetos de precio

Los precios tienen una única estructura allá donde aparecen — biomarcadores, paneles, la vista previa de la cita y un presupuesto. Precios explica el modelo que hay detrás; esta es la referencia de campos. Todos los importes están en céntimos enteros.
integer | null
Lo que cuesta en tu lista de tarifas. 0 es un precio real de cero — el elemento no se vende por separado, y el bloque requires o positions contiguo indica cómo se vende en su lugar. null es distinto: Aniva no le ha fijado precio, no tiene coste cero, no se puede pedir y no suma nada a ningún total.
integer | null
El mismo importe en la lista de tarifas recomendada de venta al público. Siempre presente; igual a price_cents cuando tu clave ya usa la lista de venta al público.
"routine" | "specialty"
Cuál de las dos tarifas de Aniva de tu lista fijó el precio de este marcador. Presente solo cuando tiene precio propio.
object[]
Las ofertas comerciales que contienen este biomarcador, de la más barata a la más cara. Con price_cents: 0 son la única forma de pedirlo; con un price_cents positivo son los paquetes a los que también pertenece. Una posición se factura una vez y siempre se entrega completa.
string
Identificador estable de la posición. Enlaza con via_position en la factura de una cita.
string
Nombre de la posición visible para el socio.
integer | null
Lo que cuesta toda la posición en tu tarifa, facturada una sola vez. retail_cents va junto a él.
number[]
Todos los biomarcadores que ofrece la posición, incluido el que consultaste.
number[]
Los demás elementos aparte del biomarcador que consultaste: lo que viene incluido al comprarlo.
object[]
Presente cuando este biomarcador es un cociente. Al pedirlo, estos componentes se añaden al carrito con sus propios precios, y cada componente se paga una sola vez por carrito sin importar cuántos cocientes dependan de él. El price_cents propio del cociente se factura además de sus componentes. La mayoría de los cocientes cuestan 0. Cada entrada contiene id, name, price_cents y retail_cents.Un cociente cuyos componentes no tengan todos precio queda fuera del catálogo por completo: nunca aparece con price_cents: null.
Los paneles solo incluyen price_cents y retail_cents: un panel tiene un único precio de catálogo y ninguna posición ni componente.

Respuestas de error