Saltar al contenido principal
Aniva pone precio a una sola cosa: la posición. Una posición es una oferta comercial —un conjunto seleccionado de biomarcadores que se factura una sola vez, a precio fijo, y siempre se entrega completo—. Un biomarcador que puedes comprar por separado es simplemente una posición de uno. Todo lo que ves en pricing parte de ahí. Lee esta página una vez y los cuatro estados siguientes dejarán de parecer casos especiales.

Qué significan los números

Cada price_cents es lo que pagas tú, según la tarifa de tu clave de API. A su lado, retail_cents es el mismo concepto según la tarifa de venta al público recomendada, para que puedas mostrar el ahorro sin hacer una segunda solicitud. Ambos están en céntimos enteros y ambos son netos: el IVA se añade en tu factura mensual al tipo que corresponda a tu régimen de IVA, y un régimen exento no añade ninguno. Un panel que se vende al precio del catálogo para consumidores de Aniva se cotiza a ese precio descontando el 19 % de IVA alemán.
retail_cents siempre está presente. Cuando tu clave ya tiene la tarifa de venta al público, simplemente coincide con price_cents.
Los precios requieren el scope prices_view. Sin él, pricing es null en los listados y en la vista previa, y los endpoints de precios devuelven 403.

Tu tarifa

Tu tarifa define tus precios. Consúltala en Obtener tarifa.
  • Cada análisis tiene un tier: routine o specialty. Su precio es el precio del catálogo de Aniva por el multiplicador de ese nivel.
  • Los cargos son por cita y el cargo logístico es por recogida de mensajería. Tus citas en la misma ubicación el mismo día comparten una sola recogida. Aniva cobra los cargos en tu factura mensual.

Los cuatro estados

price_cents, junto con el bloque opcional que lo acompaña, define el estado. No existe un campo de tipo separado.

Positivo — se puede pedir por separado

El marcador tiene precio propio. Aun así puede aparecer en posiciones, y en ese caso positions las ordena de la más barata a la más cara: comprar la posición suele salir más barato que comprar sus elementos uno por uno.
biomarker_ids es el conjunto completo de elementos de la posición; includes es ese conjunto menos el marcador que has consultado: lo que viene incluido con él.

Cero con requires — una ratio

Una ratio se calcula a partir de marcadores medidos. La mayoría de las ratios cuestan 0. Una ratio con un price_cents positivo factura ese precio además de sus componentes. Si la pides, Aniva añade sus componentes al carrito a su propio precio. Un componente se paga una vez por carrito, por muchas ratios que dependan de él.
Una ratio se combina con las posiciones en lugar de competir con ellas. Si sus componentes forman parte de una posición que ya estás comprando, la posición los cubre y la ratio va incluida.
Una ratio cuyos componentes no tengan todos precio no aparece en el catálogo: no se muestra con price_cents: null. Vuelve a aparecer en cuanto Aniva pone precio al componente que falta.

Cero con positions — solo se vende dentro de una posición

El marcador no tiene precio propio, pero forma parte de una o más posiciones. Compra una de esas posiciones y lo obtendrás.
Se rechaza añadir uno de estos a una cita por separado; consulta Añadir biomarcadores individuales. En su lugar, añade todos los biomarcadores de una de las posiciones listadas.

Null — sin catalogar

Aniva no ha decidido cuánto cuesta este marcador, así que no está a la venta. null no es cero ni significa que debas consultarnos: trátalo como no disponible.
Aniva rechaza un marcador null en el momento del pedido. Para poder pedir un biomarcador deben cumplirse dos condiciones. Un laboratorio al que Aniva pueda derivar el pedido debe ofrecer el biomarcador. El catálogo de Aniva debe asignarle un precio. Si añades un marcador null a una cita, la API devuelve 400 con error: "biomarker_not_priced". Consulta Añadir biomarcadores individuales. Un laboratorio puede ofrecer un marcador null, pero eso por sí solo no hace que el marcador esté disponible. Trata null como no disponible.
Algunos marcadores son null por diseño. Aniva vende las pruebas de microbioma y genética como kits. Un kit tiene un único precio, por lo que los marcadores que incluye no tienen precio propio. Para comprar estos marcadores, pide el panel que corresponde al kit. Sus marcadores vienen con el panel. La API también acepta un marcador que añadas a una cita que ya incluya su panel. Un marcador también aparece como null cuando Aniva lo vende solo dentro de una posición que no puedes ver. El resultado es el mismo: no tienes ningún precio al que comprar el marcador. El marcador obtiene un precio cuando Aniva hace visible esa posición para socios.

Encontrar la forma más barata de comprar un conjunto

Como cada posición a la que pertenece un marcador viene con él, puedes resolver esto en local, sin solicitudes adicionales:
  1. Recopila los marcadores que quieras de Listar biomarcadores.
  2. Para cada uno, compara su propio price_cents con el price_cents de las posiciones de su bloque positions.
  3. Una posición se factura una vez y entrega todo su conjunto biomarker_ids, así que una posición que cubra varios de tus marcadores se cobra una sola vez. Los marcadores adicionales que no hayas pedido se incluyen sin coste adicional.
Nada se solapa dos veces: dos posiciones que comparten un marcador entregan cada una su conjunto, el marcador aparece una sola vez y nunca se descuentan entre sí.

La factura

Previsualizar cita devuelve la factura de una cita. Presupuestar carrito devuelve la misma factura sin una cita. La factura incluye:
  • positions[] — cada posición que se ha aplicado, facturada una vez a su precio fijo.
  • panels[] — cada panel añadido.
  • biomarkers[] — una fila por cada marcador entregado. Una fila pagada por una posición cuesta 0 y la indica en via_position. Un componente incluido por un cociente lleva required_by; el propio cociente lleva requires.
  • total_cents — las posiciones con precio más los paneles con precio más las filas de biomarcadores con precio, junto con retail_total_cents.
  • fees y total_with_fees_cents — las tarifas de una cita y el total con ellas.
Una fila a la que Aniva no puede asignar precio lleva price_cents: null. La fila no suma nada al total. No puedes añadir un marcador sin precio por sí solo, así que una posición o un panel ha aportado esta fila. Esa posición o ese panel ya la factura.
Aniva aún no ha publicado todas las posiciones. Una posición no publicada sigue facturándose. Aparece en positions[] con id y name en null, y sus filas de biomarcadores tienen via_position: null.