> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anivahealth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Precios

> Cómo calcula los precios de biomarcadores, posiciones y paneles la API de análisis de laboratorio de Aniva según tu tarifa, con presupuestos antes de reservar.

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.

> [!NOTE]
>
> `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](https://docs.anivahealth.com/es/api/pricing/get-rate-card.md).

* 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.

| `price_cents` | También presente | Qué significa |
| - | - | - |
| positivo | `positions?` | Se puede pedir por separado a ese precio. Una ratio también lleva `requires` y factura además sus componentes. |
| `0` | `requires` | Una **ratio**. No tiene coste por sí misma; pagas sus componentes. |
| `0` | `positions` | **Solo en posición**. Se vende únicamente dentro de una de las posiciones indicadas. |
| `null` | — | **Sin catalogar**. Aniva no le ha puesto precio y no se puede pedir. |

### 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.

```json theme={null}
{
  "id": 71,
  "name": "Hemoglobin",
  "pricing": {
    "price_cents": 350,
    "retail_cents": 403,
    "tier": "routine",
    "positions": [
      {
        "id": "b7d4c2e1-9a3f-4c8b-91d2-5e6f7a8b9c0d",
        "name": "Aniva Blood Count",
        "price_cents": 452,
        "retail_cents": 520,
        "biomarker_ids": [71, 72, 73],
        "includes": [72, 73]
      }
    ]
  }
}
```

`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.

```json theme={null}
{
  "id": 279,
  "name": "hs-CRP / HDL Ratio",
  "pricing": {
    "price_cents": 0,
    "retail_cents": 0,
    "requires": [
      { "id": 42, "name": "HDL Cholesterol", "price_cents": 233, "retail_cents": 268 },
      { "id": 84, "name": "High-Sensitivity C-Reactive Protein (hs-CRP)", "price_cents": 1166, "retail_cents": 1341 }
    ]
  }
}
```

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.

> [!WARNING]
>
> 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.

```json theme={null}
{
  "id": 77,
  "name": "Mean Platelet Volume (MPV)",
  "pricing": {
    "price_cents": 0,
    "retail_cents": 0,
    "positions": [
      {
        "id": "3f1a8c22-64bd-4e57-8a90-1c2d3e4f5a6b",
        "name": "Blood Count (extended)",
        "price_cents": 460,
        "retail_cents": 529,
        "biomarker_ids": [71, 72, 73, 77],
        "includes": [71, 72, 73]
      }
    ]
  }
}
```

Se rechaza añadir uno de estos a una cita por separado; consulta [Añadir biomarcadores individuales](https://docs.anivahealth.com/es/api/appointments/add-individual-biomarkers.md). 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.

```json theme={null}
{ "id": 555, "name": "Poppy Seeds (Pap s)", "pricing": { "price_cents": null, "retail_cents": null } }
```

> [!WARNING]
>
> 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](https://docs.anivahealth.com/es/api/appointments/add-individual-biomarkers.md). 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](https://docs.anivahealth.com/es/api/biomarkers/list-biomarkers.md).
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](https://docs.anivahealth.com/es/api/appointments/preview-containers.md) devuelve la factura de una cita. [Presupuestar carrito](https://docs.anivahealth.com/es/api/pricing/quote-cart.md) 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.

> [!NOTE]
>
> 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`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.