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
Cadaprice_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.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:routineospecialty. 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 casopositions 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.
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.
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.
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:- Recopila los marcadores que quieras de Listar biomarcadores.
- Para cada uno, compara su propio
price_centscon elprice_centsde las posiciones de su bloquepositions. - 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.
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 cuesta0y la indica envia_position. Un componente incluido por un cociente llevarequired_by; el propio cociente llevarequires.total_cents— las posiciones con precio más los paneles con precio más las filas de biomarcadores con precio, junto conretail_total_cents.feesytotal_with_fees_cents— las tarifas de una cita y el total con ellas.
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.