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

# Terminvorschau anzeigen

> Die Röhrchen und die Rechnung eines Termins in der Vorschau anzeigen

Gibt zurück, was ein Termin für die zugehörigen Panels und Biomarker benötigt. Es wird nichts bestellt.

* `containers`: die Röhrchen, Karten oder Becher, die der Behandler vorbereitet.
* `pricing`: die Abrechnung laut deiner Preisliste. [Warenkorb kalkulieren](https://docs.anivahealth.com/de/api/pricing/quote-cart.md) gibt dieselbe
  Abrechnung ohne Termin zurück.
* `routing`: immer `null`.

Erfordert einen der Scopes `appointments_view`, `appointments_schedule`, `appointments_operate` oder `appointments_manage`.

## Anfrage

### Pfadparameter

**id** `string` *required*

Eindeutige ID (UUID) des Termins für die Vorschau des Behälterbedarfs.

## Antwort

Bei Erfolg gibt die API `200 OK` mit dem Behälterbedarf und reservierten Feldern für die zukünftige Nutzung zurück.

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

Array der benötigten Probenbehälter. Leer, wenn dem Termin keine Panels oder Biomarker hinzugefügt wurden. Ebenfalls leer, wenn der Standort-Tag des Termins noch nicht ermittelt werden kann, zum Beispiel wenn noch keine Uhrzeit festgelegt ist.

**Behälter**

**type** `string`

Kennung des Behältertyps. Einer der Werte `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` oder `trace_metal`.

**name** `string`

Lesbarer Name des Behälters (z. B. Serum, EDTA, Li-Heparin).

**cap\_color** `string`

Hex-Farbcode der Behälterkappe für die Anzeige (z. B. `"#A0784B"`). `null`, wenn der
Behälter keine Kappe hat.

**volume** `string`

Fassungsvermögen des Behälters (z. B. `"7.5 ml"`). `null`, wenn kein Volumen anwendbar ist.

**article\_number** `string`

Hersteller-Artikelnummer (REF), sofern bekannt (z. B. `"01.1602.001"`). Entfällt bei Behältern ohne zugeordnete Artikelnummer.

**count** `integer`

Anzahl der benötigten Behälter dieses Typs.

**routing** `null`

Details zum Labor-Routing – absichtlich nicht offengelegt, immer `null`.

**pricing** `object | null`

Die Abrechnung für den gesamten Warenkorb des Termins laut deiner Preisliste. `null`, wenn dem Termin keine
Tests zugeordnet sind oder deinem Key der Scope `prices_view` fehlt. [Preise](https://docs.anivahealth.com/de/concepts/pricing.md) erklärt das
Modell; einzelne Beträge folgen der Referenz für [Preisobjekte](https://docs.anivahealth.com/de/api/biomarkers/list-biomarkers.md#preisobjekte).

**Abrechnungsfelder**

**total\_cents** `integer`

Was der Warenkorb laut deiner Preisliste kostet: die bepreisten Positionen plus die bepreisten Panels plus die bepreisten
Biomarker-Zeilen. Eine Zeile mit `price_cents: null` fügt nichts hinzu, sodass ein Warenkorb mit einer solchen Zeile weniger
summiert, als er tatsächlich kosten wird.

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

Derselbe Gesamtbetrag laut empfohlener Verkaufspreisliste.

**fees** `object`

Die Gebühren, die eine Blutabnahme laut deiner Preisliste hinzufügt, in Cent. Sie werden über die monatliche Rechnung abgerechnet. Siehe [Preisliste
abrufen](https://docs.anivahealth.com/de/api/pricing/get-rate-card.md).

**Gebühren**

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

Blutabnahme-Gebühr pro abgeschlossenem Termin.

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

Snack für den Patienten. Wird nur berechnet, wenn der Patient einen Snack bekommt. Entfällt, wenn deine
Patienten keinen bekommen; kontaktiere Aniva, um Snacks anzubieten.

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

Kuriergebühr für die Abholung. Deine Termine am selben Standort am selben Tag teilen sich eine
Gebühr.

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

Verbrauchsmaterial: Röhrchen, Etiketten, Beutel.

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

`total_cents` plus alle Gebühren in `fees`, inklusive der vollen Logistikgebühr. Der Betrag ist
niedriger, wenn sich ein anderer deiner Termine die Abholung teilt.

**positions** `object[]`

Jede Position, die für diesen Warenkorb ausgelöst wurde – einmalig und vollständig abgerechnet,
mit allen zugehörigen Biomarkern. Enthält `id`, `name`, `price_cents`, `retail_cents` und `tier`.
Eine Position, die nicht für Partner sichtbar ist, wird trotzdem ausgelöst und abgerechnet und mit
`id` und `name` als `null` gemeldet.

**panels** `object[]`

Jedes verknüpfte Panel mit `id`, `name`, `price_cents` und `retail_cents`.

**biomarkers** `object[]`

Eine Zeile pro **geliefertem** Biomarker – was du angefordert hast, plus die Komponenten, die
durch die Verhältnisse hinzugekommen sind, und die zugehörigen Biomarker, die über die Positionen
geliefert werden.

**id** `number`

Biomarker-Kennung.

**name** `string`

Anzeigename des Biomarkers.

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

Was diese Zeile auf deiner Karte kostet, mit `retail_cents` daneben. `0`, wenn eine Position sie
abdeckt; `null`, wenn Aniva keinen Preis dafür ermitteln kann.

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

Die Verhältnisse, die diese Komponente in den Warenkorb geholt haben. Wird weggelassen, wenn
keines zutrifft. Eine Komponente wird pro Warenkorb nur einmal bezahlt, egal wie viele
Verhältnisse darauf aufbauen.

**requires** `number[]`

Vorhanden, wenn diese Zeile ein Verhältnis IST: die Komponenten, über die es abgerechnet wird.

**via\_position** `string`

Die Position, die diesen Marker abdeckt, weshalb die Zeile `0` kostet. Wird weggelassen, wenn
nichts ihn abdeckt. `null`, wenn die abdeckende Position nicht für Partner sichtbar ist.

## Fehlerantworten

| Status | Beschreibung |
| - | - |
| `400` | Ungültiges ID-Format – der angegebene Wert ist keine gültige UUID. |
| `403` | Zugriff verweigert – dein API-Schlüssel ist für diesen Vorgang nicht berechtigt. |
| `404` | Termin nicht gefunden. |
| `500` | Interner Serverfehler. |

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