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

# Prezzi

> Come l'API di Aniva per gli esami di laboratorio calcola i prezzi di biomarcatori, voci e pannelli sul tuo listino, con preventivi prima di prenotare.

Aniva definisce il prezzo di una sola cosa: la **posizione**. Una posizione è un'offerta commerciale — un insieme curato di biomarcatori fatturato una sola volta, a un prezzo fisso, e sempre fornito per intero. Un biomarcatore acquistabile singolarmente è semplicemente una posizione composta da un solo elemento.

Tutto ciò che vedi in `pricing` deriva da questo. Leggi questa pagina una volta e i quattro stati qui sotto smetteranno di sembrare casi speciali.

## Cosa significano i numeri

Ogni `price_cents` è ciò che paghi **tu**, in base al listino associato alla tua chiave API. Accanto, `retail_cents` indica lo stesso articolo al listino consigliato al pubblico, così puoi mostrare il risparmio senza una seconda richiesta. Entrambi sono numeri interi in centesimi ed entrambi sono **netti**: l'IVA viene aggiunta nella tua fattura mensile all'aliquota prevista dal tuo regime IVA, mentre un regime esente non aggiunge nulla. Un pannello venduto al prezzo di catalogo al pubblico di Aniva è indicato a quel prezzo al netto dell'IVA tedesca del 19%.

> [!NOTE]
>
> `retail_cents` è sempre presente. Quando la tua chiave utilizza già il listino al pubblico,
> corrisponde semplicemente a `price_cents`.

I prezzi richiedono lo scope `prices_view`. Senza di esso, `pricing` è `null` negli elenchi e nell'anteprima, e gli endpoint Prezzi restituiscono `403`.

## Il tuo listino

Il tuo listino definisce i tuoi prezzi. Leggilo tramite [Ottieni listino](https://docs.anivahealth.com/it/api/pricing/get-rate-card.md).

* Ogni analisi ha un `tier`: `routine` o `specialty`. Il suo prezzo è il prezzo di catalogo Aniva moltiplicato per il moltiplicatore di quel livello.
* Le tariffe sono per appuntamento e la tariffa logistica è per ritiro del corriere. I tuoi appuntamenti nella stessa sede e nello stesso giorno condividono un unico ritiro. Aniva addebita le tariffe nella tua fattura mensile.

## I quattro stati

`price_cents`, insieme al blocco opzionale presente accanto, determina lo stato. Non esiste un campo separato per il tipo.

| `price_cents` | Presente anche | Cosa significa |
| - | - | - |
| positivo | `positions?` | Ordinabile singolarmente a quel prezzo. Un rapporto include anche `requires` e fattura anche i suoi componenti. |
| `0` | `requires` | Un **rapporto**. Non ha un costo proprio; paghi i suoi componenti. |
| `0` | `positions` | **Vincolato a una posizione**. Venduto solo all'interno di una delle posizioni elencate. |
| `null` | — | **Non curato**. Aniva non ha definito un prezzo e non può essere ordinato. |

### Positivo — ordinabile singolarmente

Il marcatore ha un prezzo proprio. Può comunque comparire in alcune posizioni, che `positions` elenca dalla più economica in poi — acquistare la posizione costa spesso meno che acquistare i suoi elementi uno per 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` è l'insieme completo degli elementi della posizione; `includes` è quell'insieme meno il marcatore richiesto — ciò che è incluso in aggiunta.

### Zero con `requires` — un rapporto

Un rapporto viene calcolato a partire da marcatori misurati. La maggior parte dei rapporti costa `0`. Un rapporto con un `price_cents` positivo fattura quel prezzo in aggiunta ai suoi componenti. Se lo ordini, Aniva inserisce i suoi componenti nel carrello al rispettivo prezzo. Un componente si paga **una sola volta per carrello**, indipendentemente da quanti rapporti si basano su di esso.

```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 }
    ]
  }
}
```

Un rapporto si combina con le posizioni anziché entrare in conflitto con esse. Se i suoi componenti fanno parte di una posizione che stai già acquistando, li copre la posizione e il rapporto è incluso.

> [!WARNING]
>
> Un rapporto i cui componenti non hanno tutti un prezzo è **assente dal catalogo** — non compare
> con `price_cents: null`. Ritorna non appena Aniva definisce il prezzo del componente mancante.

### Zero con `positions` — venduto solo all'interno di una posizione

Il marcatore non ha un prezzo proprio, ma fa parte di una o più posizioni. Acquista una di quelle posizioni e lo ottieni.

```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]
      }
    ]
  }
}
```

Aggiungerne uno da solo a un appuntamento viene rifiutato — vedi [Aggiungi singoli biomarcatori](https://docs.anivahealth.com/it/api/appointments/add-individual-biomarkers.md). Aggiungi invece tutti i biomarcatori di una delle posizioni elencate.

### Null — non configurato

Aniva non ha stabilito il prezzo di questo marcatore, quindi non è in vendita. `null` non significa zero e nemmeno "chiedi a noi": consideralo non disponibile.

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

> [!WARNING]
>
> Aniva rifiuta un marcatore `null` al momento dell'ordine. Due condizioni rendono un biomarcatore
> ordinabile. Un laboratorio a cui Aniva può inviare l'ordine deve fornire il biomarcatore. Il
> catalogo Aniva deve assegnargli un prezzo. Se aggiungi un marcatore `null` a un appuntamento,
> l'API restituisce `400` con `error: "biomarker_not_priced"`. Vedi
> [Aggiungi singoli biomarcatori](https://docs.anivahealth.com/it/api/appointments/add-individual-biomarkers.md). Un laboratorio può
> fornire un marcatore `null`, ma la fornitura da sola non rende disponibile il marcatore. Considera
> `null` come non disponibile.

Alcuni marcatori sono `null` per scelta. Aniva vende i test del microbioma e genetici come kit. Un
kit ha un prezzo unico, quindi i marcatori che include non hanno un prezzo proprio. Per acquistare
questi marcatori, ordina il pannello corrispondente al kit. I suoi marcatori sono inclusi nel
pannello. L'API accetta anche un marcatore del kit se lo aggiungi a un appuntamento che include già
il relativo pannello.

Un marcatore risulta `null` anche quando Aniva lo vende solo all'interno di una posizione che non
puoi vedere. Il risultato è lo stesso: non hai un prezzo per acquistare il marcatore. Il marcatore
ottiene un prezzo quando Aniva rende quella posizione visibile ai partner.

## Trovare il modo più conveniente per acquistare un set

Dato che ogni posizione di cui un marcatore fa parte viene restituita insieme al marcatore, puoi risolverlo in locale, senza richieste aggiuntive:

1. Raccogli i marcatori che vuoi da [Elenca biomarcatori](https://docs.anivahealth.com/it/api/biomarkers/list-biomarkers.md).
2. Per ciascuno, confronta il suo `price_cents` con il `price_cents` delle posizioni nel suo blocco `positions`.
3. Una posizione viene fatturata **una volta** e fornisce l'intero set `biomarker_ids`, quindi una posizione che copre diversi tuoi marcatori viene addebitata una sola volta. I marcatori extra che non hai richiesto sono inclusi senza costi aggiuntivi.

Nulla si sovrappone due volte: due posizioni che condividono un marcatore forniscono ciascuna il proprio set, il marcatore compare una sola volta e le posizioni non si scontano mai a vicenda.

## Il conto

[Anteprima appuntamento](https://docs.anivahealth.com/it/api/appointments/preview-containers.md) restituisce il conto di un appuntamento. [Preventivo carrello](https://docs.anivahealth.com/it/api/pricing/quote-cart.md) restituisce lo stesso conto senza un appuntamento. Il conto include:

* `positions[]` — ogni posizione attivata, addebitata una sola volta al suo prezzo fisso.
* `panels[]` — ogni pannello associato.
* `biomarkers[]` — una riga per ogni marcatore **fornito**. Una riga coperta da una posizione costa `0` e la indica in `via_position`. Un componente richiamato da un rapporto riporta `required_by`; il rapporto stesso riporta `requires`.
* `total_cents` — le posizioni prezzate più i pannelli prezzati più le righe di biomarcatori prezzate, con `retail_total_cents` accanto.
* `fees` e `total_with_fees_cents` — le spese di un appuntamento e il totale che le include.

Una riga a cui Aniva non può assegnare un prezzo riporta `price_cents: null`. La riga non aggiunge nulla al totale. Non puoi aggiungere da solo un marcatore senza prezzo, quindi questa riga è stata inclusa da una posizione o da un pannello. Quella posizione o quel pannello la addebita già.

> [!NOTE]
>
> Aniva non ha ancora pubblicato tutte le posizioni. Una posizione non pubblicata viene comunque
> addebitata. Compare in `positions[]` con `id` e `name` impostati su `null`, e le relative righe di
> biomarcatori hanno `via_position: null`.


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