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

# Calcola preventivo carrello

> Calcola il prezzo di pannelli e biomarcatori senza appuntamento

Restituisce il conto per pannelli e biomarcatori secondo il tuo listino. Non serve alcun appuntamento. Non viene
prenotato nulla.

Il conto è uguale a `pricing` in [Anteprima appuntamento](https://docs.anivahealth.com/it/api/appointments/preview-containers.md),
più ciò che aggiunge la modalità di prelievo del campione. Per impostazione predefinita si tratta di un prelievo di sangue in una sede, con
i costi dell'appuntamento. Invia invece `fulfilment: "home_kit"` e un `country_code` per calcolare il prezzo di un kit spedito
in quel paese: il costo del kit, i dispositivi di raccolta, la spedizione di andata e ritorno, la custodia
e un sacchetto di lancette di ricambio, come li addebita la tua fattura mensile.
[Prezzi](https://docs.anivahealth.com/it/concepts/pricing.md) spiega come Aniva calcola il prezzo degli esami.

Richiede lo scope `prices_view`.

## Richiesta

### Parametri del body

Invia almeno un id in `panel_ids` o `biomarker_ids`.

**panel\_ids** `string[]`

Pannelli di cui calcolare il prezzo, al massimo 50. Ognuno deve comparire in [Elenca pannelli](https://docs.anivahealth.com/it/api/panels/list-panels.md) per la tua chiave.

**biomarker\_ids** `number[]`

Biomarcatori di cui calcolare il prezzo, al massimo 500.

**sex** `integer`

Sesso biologico secondo ISO/IEC 5218: `1` = maschio, `2` = femmina. Alcuni pannelli aggiungono biomarcatori solo per un
sesso o un'età. Invia `sex` e `date_of_birth` insieme per applicare queste regole. Senza di essi, le regole
non si applicano.

**date\_of\_birth** `string`

Data di nascita, `YYYY-MM-DD`. Inviala con `sex`.

**rate\_card** `string`

Il listino da usare per i prezzi: `retail`, oppure l'`id` da [Ottieni listino](https://docs.anivahealth.com/it/api/pricing/get-rate-card.md).
Predefinito: il listino della tua chiave API, altrimenti quello al pubblico.

**fulfilment** `string`

Come viene prelevato il campione. `draw` (predefinito): un prelievo di sangue in una sede, che aggiunge i costi
dell'appuntamento. `home_kit`: un kit spedito a `country_code`, che aggiunge invece le righe del kit. Un kit domiciliare
contiene esattamente un pannello, e il pannello deve essere venduto come kit domiciliare.

**country\_code** `string`

Il paese di consegna del kit, ISO 3166-1 alpha-2 (`DE`, `SE`). Obbligatorio con
`fulfilment: "home_kit"`, e solo in quel caso. Determina le righe di spedizione.

## Risposta

**total\_cents** `integer`

Il prezzo degli esami secondo il tuo listino: ogni posizione, pannello e riga di biomarcatore con un prezzo. Una riga
con `price_cents: null` non aggiunge nulla.

**retail\_total\_cents** `integer`

Lo stesso prezzo secondo il listino al pubblico consigliato.

**fees** `object`

I costi di un appuntamento, in centesimi. Aniva li addebita sulla tua fattura mensile. Si applicano a un
`draw`; un `home_kit` addebita invece le righe in `fulfilment`.

**costi**

**phlebotomy\_fee\_cents** `integer`

Per appuntamento completato.

**snack\_fee\_cents** `integer`

Per appuntamento in cui il paziente riceve uno snack. Assente quando i tuoi pazienti non ricevono snack. Per
offrire snack, contatta Aniva.

**logistics\_fee\_cents** `integer`

Per ritiro del corriere. I tuoi appuntamenti nella stessa sede nello stesso giorno condividono un solo ritiro.

**material\_fee\_cents** `integer`

Per appuntamento completato. Copre provette, etichette e sacchetto.

**total\_with\_fees\_cents** `integer`

`total_cents` più ciò che aggiunge la modalità di prelievo. Per un `draw`: ogni costo in `fees`. Conta l'intero
costo di logistica, e un ritiro condiviso riduce l'importo reale. Per un `home_kit`:
`fulfilment.total_cents`.

**fulfilment** `object`

Come viene prelevato il campione e cosa aggiunge. `kind` è `draw` o `home_kit`. Un `draw` non ha altri
campi.

**home\_kit**

**country\_code** `string`

Il paese di consegna per cui è stata calcolata la spedizione.

**kit\_ref** `string | null`

Il kit con cui viene spedito il pannello. `null` quando Aniva non ne ha ancora definito uno; in tal caso il preventivo non conteggia
alcun dispositivo.

**devices** `integer`

Dispositivi di raccolta nella scatola, ciascuno addebitato al costo del dispositivo.

**lines** `object[]`

Le righe del kit che un ordine aggiunge alla tua fattura mensile, ciascuna con `description`, `quantity`,
`unit`, `unit_cents` e `amount_cents`. La spedizione è calcolata sui servizi che la fase di spedizione prenota
per questo paese. Un costo pari a 0 sul tuo listino non genera alcuna riga. Un credito prepagato per il materiale non viene
detratto qui.

**total\_cents** `integer`

La somma di `lines`, netta.

**activation\_fee\_cents** `integer`

Addebitato in aggiunta, netto, quando non attivi il kit prima che arrivi in laboratorio e lo attiva il
laboratorio. Non è in `lines` né in `total_cents`. 0 indica che il tuo listino non prevede questo costo.

**unpriced\_postage\_legs** `string[]`

Tratte (`out`, `back`) per cui il tuo listino prevede prezzi per paese, ma non ha un prezzo per questo paese. Sono
passate al costo di spedizione fisso, oppure a 0 quando il listino non ne ha uno. Vuoto quando ogni tratta ha trovato
il suo prezzo.

**positions** `object[]`

Le posizioni nel conto. Una posizione è un insieme di biomarcatori con un unico prezzo. Ha `id`, `name`,
`price_cents`, `retail_cents` e `tier`. `id` e `name` sono `null` per una posizione che Aniva non ha ancora
pubblicato.

**panels** `object[]`

I pannelli nel conto, con `id`, `name`, `price_cents` e `retail_cents`.

**biomarkers** `object[]`

Una riga per ogni biomarcatore che ricevi. Questo include i componenti di un rapporto e ogni membro di una
posizione.

**riga biomarcatore**

**id** `number`

ID del biomarcatore.

**name** `string`

Nome del biomarcatore.

**price\_cents** `integer | null`

Il prezzo di questa riga, con accanto `retail_cents`. `0` quando è coperto da una posizione o da un pannello.

**required\_by** `number[]`

I rapporti che richiedono questo biomarcatore. Lo paghi una sola volta.

**requires** `number[]`

Solo per un rapporto: i biomarcatori da cui viene calcolato.

**via\_position** `string | null`

La posizione che copre questa riga. `null` quando la posizione non è ancora pubblicata.

## Risposte di errore

| Stato | Descrizione |
| - | - |
| `400` | Il body non è valido, oppure la tua chiave non può usare il `rate_card`. |
| `400` | Un preventivo `home_kit` richiede esattamente un pannello, un pannello venduto come kit domiciliare e un codice paese. |
| `400` | `biomarker_not_available`: nessun laboratorio utilizzabile dalla tua chiave esegue il biomarcatore. |
| `400` | `biomarker_not_priced`: il biomarcatore non ha un prezzo. |
| `400` | `biomarker_requires_position`: il biomarcatore è venduto solo in una posizione. Il body elenca le posizioni. |
| `403` | La tua chiave API non ha lo scope `prices_view`. |
| `404` | `Panels not found`: il pannello non esiste, oppure la tua chiave non può elencarlo. |
| `404` | `Biomarkers not found`: il biomarcatore non esiste. |
| `500` | Errore interno del server. |

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/pricing/quote \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "biomarker_ids": [63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 204, 206, 207, 209, 249]
  }'
```

```bash cURL (home kit) theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/pricing/quote \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "panel_ids": ["4d0423c5-6538-48f6-ac93-435f61e456e9"],
    "fulfilment": "home_kit",
    "country_code": "DE"
  }'
```

```json 200 theme={null}
{
  "total_cents": 210,
  "retail_total_cents": 451,
  "fees": {
    "phlebotomy_fee_cents": 2500,
    "logistics_fee_cents": 2000,
    "material_fee_cents": 250
  },
  "total_with_fees_cents": 4960,
  "fulfilment": { "kind": "draw" },
  "positions": [
    { "id": null, "name": null, "price_cents": 210, "retail_cents": 451, "tier": "routine" }
  ],
  "panels": [],
  "biomarkers": [
    { "id": 63, "name": "Eosinophils", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 64, "name": "Lymphocytes", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 65, "name": "Neutrophils", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 66, "name": "Monocytes", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 67, "name": "White Blood Cells (WBC)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 68, "name": "Basophils", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 69, "name": "Hematocrit", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 70, "name": "Red Blood Cells (RBC)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 71, "name": "Hemoglobin", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 72, "name": "Platelets", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 73, "name": "Mean Corpuscular Hemoglobin Concentration (MCHC)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 74, "name": "Mean Corpuscular Volume (MCV)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 75, "name": "Red Cell Distribution Width (RDW)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 76, "name": "Mean Corpuscular Hemoglobin (MCH)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 204, "name": "Lymphocytes (%)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 206, "name": "Eosinophils (%)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 207, "name": "Basophils (%)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 209, "name": "Monocytes (%)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 249, "name": "Neutrophils (%)", "price_cents": 0, "retail_cents": 0, "via_position": null }
  ]
}
```

```json 200 (home kit) theme={null}
{
  "total_cents": 2081,
  "retail_total_cents": 6702,
  "fees": {
    "phlebotomy_fee_cents": 2000,
    "logistics_fee_cents": 2000,
    "material_fee_cents": 0
  },
  "total_with_fees_cents": 4971,
  "fulfilment": {
    "kind": "home_kit",
    "country_code": "DE",
    "kit_ref": "TAS-1-1S1E",
    "devices": 1,
    "lines": [
      { "description": "Home kit (per order)", "quantity": 1, "unit": "kits", "unit_cents": 720, "amount_cents": 720 },
      { "description": "Collection device (per device)", "quantity": 1, "unit": "devices", "unit_cents": 1250, "amount_cents": 1250 },
      { "description": "Postage to the customer (per kit sent)", "quantity": 1, "unit": "kits sent", "unit_cents": 370, "amount_cents": 370 },
      { "description": "Return postage (per kit sent)", "quantity": 1, "unit": "kits sent", "unit_cents": 400, "amount_cents": 400 },
      { "description": "Spare lancet bag (per kit sent with one)", "quantity": 1, "unit": "bags", "unit_cents": 150, "amount_cents": 150 }
    ],
    "total_cents": 2890,
    "activation_fee_cents": 100,
    "unpriced_postage_legs": []
  },
  "positions": [],
  "panels": [
    { "id": "4d0423c5-6538-48f6-ac93-435f61e456e9", "name": "Doctrinus - Gesundheitsprofil 6 (Männer)", "price_cents": 2081, "retail_cents": 6702 }
  ],
  "biomarkers": []
}
```

```json 404 theme={null}
{
  "error": "Panels not found: f1c2d4a3-7b8e-4f2a-9c1d-2e3f4a5b6c7d"
}
```


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