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

# Anteprima appuntamento

> Visualizza in anteprima le provette e il conto di un appuntamento

Restituisce ciò che serve a un appuntamento, per i pannelli e i biomarcatori inclusi. Non viene effettuato alcun ordine.

* `containers`: le provette, i cartoncini o i barattoli che l'operatore prepara.
* `pricing`: il conto secondo il tuo listino. [Preventivo carrello](https://docs.anivahealth.com/it/api/pricing/quote-cart.md) restituisce lo stesso
  conto senza un appuntamento.
* `routing`: sempre `null`.

Richiede uno degli scope `appointments_view`, `appointments_schedule`, `appointments_operate` o `appointments_manage`.

## Richiesta

### Parametri di percorso

**id** `string` *required*

Identificativo univoco (UUID) dell'appuntamento di cui visualizzare in anteprima i contenitori richiesti.

## Risposta

In caso di successo, l'API restituisce `200 OK` con i contenitori richiesti e i campi riservati per usi futuri.

**containers** `object[]` *required*

Array dei contenitori richiesti per la raccolta dei campioni. Vuoto quando non sono stati aggiunti pannelli o biomarcatori all'appuntamento. Vuoto anche quando sede e giorno dell'appuntamento non possono ancora essere determinati, ad esempio se non ha un orario programmato.

**contenitore**

**type** `string`

Identificativo del tipo di contenitore. Uno tra `serum`, `serum_capillary`, `serum_capillary_plain`, `edta`, `edta_capillary`, `citrate`, `lihep`, `lihep_capillary`, `glucoexact`, `fluoride`, `fluoride_capillary`, `homocysteine`, `urine`, `dried_blood_spot`, `swab`, `stool`, `saliva`, `hair` o `trace_metal`.

**name** `string`

Nome leggibile del contenitore (es. "Serum", "EDTA", "Li-Heparin").

**cap\_color** `string`

Codice colore esadecimale del tappo del contenitore per la visualizzazione (es. `"#A0784B"`). `null` se il
contenitore non ha tappo.

**volume** `string`

Capacità di volume del contenitore (es. `"7.5 ml"`). `null` dove il volume non si applica.

**article\_number** `string`

Numero di catalogo del produttore (REF), se noto (es. `"01.1602.001"`). Omesso per i contenitori senza un numero di articolo associato.

**count** `integer`

Numero di contenitori di questo tipo richiesti.

**routing** `null`

Dettagli di instradamento al laboratorio — intenzionalmente non esposti, sempre `null`.

**pricing** `object | null`

Il conto dell'intero carrello per l'appuntamento, secondo il tuo listino. `null` se l'appuntamento non ha
esami associati o se la tua chiave non ha lo scope `prices_view`. [Prezzi](https://docs.anivahealth.com/it/concepts/pricing.md) spiega il
modello; i singoli importi seguono il riferimento degli [oggetti
prezzo](https://docs.anivahealth.com/it/api/biomarkers/list-biomarkers.md#oggetti-prezzo).

**Campi del conto**

**total\_cents** `integer`

Quanto costa il carrello secondo il tuo listino: le voci con prezzo più i pannelli con prezzo più le
righe di biomarcatori con prezzo. Una riga con `price_cents: null` non aggiunge nulla, quindi un carrello che ne contiene una ha un totale inferiore
al costo effettivo.

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

Lo stesso totale secondo il listino consigliato al pubblico.

**fees** `object`

Le tariffe che un prelievo di sangue aggiunge secondo il tuo listino, in centesimi. Vengono addebitate nella fattura mensile. Vedi [Ottieni
listino](https://docs.anivahealth.com/it/api/pricing/get-rate-card.md).

**tariffe**

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

Tariffa per il prelievo di sangue per ogni appuntamento completato.

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

Spuntino per il paziente. Addebitato solo quando il paziente riceve uno spuntino. Omesso se i tuoi
pazienti non ne ricevono; contatta Aniva per offrire spuntini.

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

Tariffa del corriere per il ritiro. I tuoi appuntamenti nella stessa sede nello stesso giorno condividono una
sola tariffa.

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

Materiali di consumo: provette, etichette, busta.

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

`total_cents` più ogni tariffa in `fees`, con la tariffa logistica completa. È inferiore quando un
altro dei tuoi appuntamenti condivide il ritiro.

**positions** `object[]`

Ogni posizione attivata su questo carrello — fatturata una volta, per intero, con consegna
dell'intero set di elementi. Contiene `id`, `name`, `price_cents`, `retail_cents` e `tier`. Una
posizione non visibile ai partner si attiva e viene fatturata comunque, ed è riportata con `id`
e `name` impostati su `null`.

**panels** `object[]`

Ogni pannello associato, con `id`, `name`, `price_cents` e `retail_cents`.

**biomarkers** `object[]`

Una riga per ogni biomarcatore **fornito** — quelli che hai richiesto, più i componenti aggiunti
dai relativi rapporti e gli elementi forniti dalle relative posizioni.

**id** `number`

Identificatore del biomarcatore.

**name** `string`

Nome visualizzato del biomarcatore.

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

Quanto costa questa riga sulla tua carta, con `retail_cents` accanto. `0` quando la paga una
posizione; `null` quando Aniva non riesce a definirne il prezzo.

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

I rapporti che hanno aggiunto questo componente al carrello. Omesso se nessuno lo ha fatto. Un
componente viene pagato una sola volta per carrello, indipendentemente da quanti rapporti lo
richiedono.

**requires** `number[]`

Presente quando questa riga È un rapporto: i componenti con cui viene fatturato.

**via\_position** `string`

La posizione che paga questo marcatore, motivo per cui la riga costa `0`. Omesso quando nulla
lo copre. `null` quando la posizione che lo copre non è visibile ai partner.

## Risposte di errore

| Stato | Descrizione |
| - | - |
| `400` | Formato ID non valido — il valore fornito non è un UUID valido. |
| `403` | Accesso negato — la tua chiave API non ha accesso a questa operazione. |
| `404` | Appuntamento non trovato. |
| `500` | Errore interno del server. |

```bash cURL theme={null}
curl --request GET \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a/preview \
  --header 'x-api-key: YOUR_API_KEY'
```

```json 200 theme={null}
{
  "containers": [
    {
      "type": "serum",
      "name": "Serum",
      "cap_color": "#A0784B",
      "volume": "7.5 ml",
      "article_number": "01.1602.001",
      "count": 3
    },
    {
      "type": "edta",
      "name": "EDTA",
      "cap_color": "#D13438",
      "volume": "3.4 ml",
      "article_number": "04.1914.001",
      "count": 2
    },
    {
      "type": "glucoexact",
      "name": "GlucoEXACT",
      "cap_color": "#9E9E9E",
      "volume": "3.1 ml",
      "article_number": "05.1074.001",
      "count": 1
    }
  ],
  "routing": null,
  "pricing": {
    "total_cents": 13751,
    "retail_total_cents": 17029,
    "fees": {
      "phlebotomy_fee_cents": 2500,
      "snack_fee_cents": 500,
      "logistics_fee_cents": 2000,
      "material_fee_cents": 250
    },
    "total_with_fees_cents": 19001,
    "positions": [
      {
        "id": "b7d4c2e1-9a3f-4c8b-91d2-5e6f7a8b9c0d",
        "name": "Aniva Blood Count",
        "price_cents": 452,
        "retail_cents": 520,
        "tier": "routine"
      }
    ],
    "panels": [
      {
        "id": "f1c2d4a3-7b8e-4f2a-9c1d-2e3f4a5b6c7d",
        "name": "Hormones (Female)",
        "price_cents": 11900,
        "retail_cents": 14900
      }
    ],
    "biomarkers": [
      { "id": 42, "name": "HDL Cholesterol", "price_cents": 233, "retail_cents": 268, "required_by": [279] },
      {
        "id": 71,
        "name": "Hemoglobin",
        "price_cents": 0,
        "retail_cents": 0,
        "via_position": "b7d4c2e1-9a3f-4c8b-91d2-5e6f7a8b9c0d"
      },
      { "id": 84, "name": "High-Sensitivity C-Reactive Protein (hs-CRP)", "price_cents": 1166, "retail_cents": 1341, "required_by": [279] },
      { "id": 279, "name": "hs-CRP / HDL Ratio", "price_cents": 0, "retail_cents": 0, "requires": [42, 84] }
    ]
  }
}
```

```json 200 (no panels) theme={null}
{
  "containers": [],
  "routing": null,
  "pricing": null
}
```

```json 200 (one item without a price) theme={null}
{
  "containers": [],
  "routing": null,
  "pricing": {
    "total_cents": 11900,
    "retail_total_cents": 14900,
    "fees": {
      "phlebotomy_fee_cents": 2500,
      "snack_fee_cents": 500,
      "logistics_fee_cents": 2000,
      "material_fee_cents": 250
    },
    "total_with_fees_cents": 17150,
    "positions": [],
    "panels": [
      {
        "id": "f1c2d4a3-7b8e-4f2a-9c1d-2e3f4a5b6c7d",
        "name": "Hormones (Female)",
        "price_cents": 11900,
        "retail_cents": 14900
      }
    ],
    "biomarkers": [{ "id": 555, "name": "Poppy Seeds (Pap s)", "price_cents": null, "retail_cents": null }]
  }
}
```

```json 404 theme={null}
{
  "error": "Appointment not found"
}
```


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