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

# Preise

> So berechnet die Aniva API für Labortests die Preise für Biomarker, Positionen und Panels auf deiner Preisliste, mit Preisangeboten, bevor du buchst.

Aniva bepreist genau eine Einheit: die **Position**. Eine Position ist ein kommerzielles Angebot – ein kuratiertes Set aus Biomarkern, das einmalig zum Festpreis abgerechnet und immer vollständig geliefert wird. Ein Biomarker, den du einzeln kaufen kannst, ist einfach eine Position mit einem Biomarker.

Alles, was du in `pricing` siehst, ergibt sich daraus. Lies diese Seite einmal durch, und die vier Zustände unten wirken nicht mehr wie Sonderfälle.

## Was die Zahlen bedeuten

Jeder Wert in `price_cents` ist das, was **du** laut der Preistabelle deines API-Schlüssels zahlst. Daneben zeigt `retail_cents` denselben Artikel laut der empfohlenen Verkaufspreistabelle, damit du eine Ersparnis ohne zweite Anfrage darstellen kannst. Beide Werte sind ganzzahlige Cent-Beträge und beide sind **netto**: Die Mehrwertsteuer wird auf deiner monatlichen Rechnung mit dem für dich geltenden Steuersatz aufgeschlagen – bei einer Steuerbefreiung fällt keine an. Ein Panel, das zum Aniva-Endkundenkatalogpreis verkauft wird, wird ohne die 19 % deutsche Mehrwertsteuer angegeben.

> [!NOTE]
>
> `retail_cents` ist immer vorhanden. Wenn für deinen Schlüssel bereits die Verkaufspreistabelle gilt, entspricht der Wert einfach
> `price_cents`.

Preise benötigen den Scope `prices_view`. Ohne ihn ist `pricing` in den Listen und in der Vorschau `null`, und die Pricing-Endpunkte geben `403` zurück.

## Deine Preistabelle

Deine Preistabelle legt deine Preise fest. Lies sie über [Get Rate Card](https://docs.anivahealth.com/de/api/pricing/get-rate-card.md) aus.

* Jede Analyse hat ein `tier`: `routine` oder `specialty`. Ihr Preis ist der Aniva-Katalogpreis multipliziert mit dem Multiplikator dieses Tiers.
* Die Gebühren gelten pro Termin, und die Logistikgebühr gilt pro Kurierabholung. Deine Termine am selben Standort am selben Tag teilen sich eine Abholung. Aniva berechnet die Gebühren auf deiner monatlichen Rechnung.

## Die vier Zustände

`price_cents` zusammen mit dem optionalen Block daneben ergibt den Zustand. Ein eigenes Typfeld gibt es nicht.

| `price_cents` | Ebenfalls vorhanden | Bedeutung |
| - | - | - |
| positiv | `positions?` | Einzeln zu diesem Preis bestellbar. Ein Verhältnis enthält zusätzlich `requires` und berechnet auch seine Bestandteile. |
| `0` | `requires` | Ein **Verhältnis**. Es kostet selbst nichts; du zahlst für seine Bestandteile. |
| `0` | `positions` | **Positionsgebunden**. Wird nur innerhalb einer der aufgeführten Positionen verkauft. |
| `null` | – | **Nicht kuratiert**. Aniva hat keinen Preis festgelegt, und es kann nicht bestellt werden. |

### Positiv – einzeln bestellbar

Der Marker hat einen eigenen Preis. Er kann trotzdem in Positionen vorkommen, und `positions` listet diese dann beginnend mit der günstigsten auf – der Kauf der Position ist oft günstiger als der Einzelkauf ihrer Bestandteile.

```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` ist die vollständige Liste aller Biomarker der Position; `includes` ist diese Liste abzüglich des abgefragten Markers – also das, was zusätzlich enthalten ist.

### Null mit `requires` – ein Verhältnis

Ein Verhältnis wird aus gemessenen Markern berechnet. Die meisten Verhältnisse kosten `0`. Bei einem Verhältnis mit positivem `price_cents` wird dieser Preis zusätzlich zu seinen Bestandteilen berechnet. Bestellst du es, legt Aniva seine Bestandteile zu ihren jeweiligen Preisen in den Warenkorb. Ein Bestandteil wird **einmal pro Warenkorb** bezahlt, egal wie viele Verhältnisse darauf aufbauen.

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

Ein Verhältnis ergänzt Positionen, statt mit ihnen zu konkurrieren. Sind seine Bestandteile bereits Teil einer Position, die du kaufst, deckt die Position sie ab und das Verhältnis ist ohne Aufpreis enthalten.

> [!WARNING]
>
> Ein Verhältnis, dessen Bestandteile nicht alle bepreist sind, **fehlt im Katalog** – es erscheint nicht
> mit `price_cents: null`. Es taucht wieder auf, sobald Aniva den fehlenden Bestandteil bepreist.

### Null mit `positions` – nur innerhalb einer Position erhältlich

Der Marker hat keinen eigenen Preis, ist aber Teil einer oder mehrerer Positionen. Wenn du eine dieser Positionen kaufst, bekommst du ihn.

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

Einen dieser Marker einzeln zu einem Termin hinzuzufügen wird abgelehnt – siehe [Einzelne Biomarker hinzufügen](https://docs.anivahealth.com/de/api/appointments/add-individual-biomarkers.md). Füge stattdessen alle Biomarker einer der aufgeführten Positionen hinzu.

### Null – nicht kuratiert

Aniva hat noch nicht festgelegt, was dieser Marker kostet, daher steht er nicht zum Verkauf. `null` ist nicht null und bedeutet nicht „frag uns“: Behandle es als nicht verfügbar.

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

> [!WARNING]
>
> Aniva lehnt einen `null`-Marker bei der Bestellung ab. Zwei Bedingungen machen einen Biomarker
> bestellbar. Ein Labor, an das Aniva weiterleiten kann, muss den Biomarker liefern. Der
> Aniva-Katalog muss einen Preis dafür enthalten. Wenn du einem Termin einen `null`-Marker
> hinzufügst, gibt die API `400` mit `error: "biomarker_not_priced"` zurück. Siehe
> [Einzelne Biomarker hinzufügen](https://docs.anivahealth.com/de/api/appointments/add-individual-biomarkers.md). Ein Labor kann einen
> `null`-Marker liefern, aber die Lieferung allein macht den Marker nicht verfügbar. Behandle `null`
> als nicht verfügbar.

Einige Marker sind absichtlich `null`. Aniva verkauft Mikrobiom- und Gentests als Kits. Ein Kit
hat einen einzigen Preis, sodass die enthaltenen Marker keinen eigenen Preis haben. Um diese Marker
zu kaufen, bestelle das Panel, das dem Kit entspricht. Die enthaltenen Marker sind im Panel
enthalten. Die API akzeptiert einen enthaltenen Marker auch dann, wenn du ihn zu einem Termin
hinzufügst, der das zugehörige Panel bereits enthält.

Ein Marker hat ebenfalls den Wert `null`, wenn Aniva ihn nur innerhalb einer Position verkauft, die
du nicht sehen kannst. Das Ergebnis ist dasselbe: Du hast keinen Preis, zu dem du den Marker kaufen
kannst. Der Marker erhält einen Preis, sobald Aniva diese Position für Partner freigibt.

## Den günstigsten Weg finden, ein Set zu kaufen

Da jede Position, zu der ein Marker gehört, zusammen mit dem Marker zurückgegeben wird, kannst du das lokal und ohne zusätzliche Anfragen lösen:

1. Sammle die gewünschten Marker über [Biomarker auflisten](https://docs.anivahealth.com/de/api/biomarkers/list-biomarkers.md).
2. Vergleiche für jeden Marker seinen eigenen `price_cents`-Wert mit dem `price_cents`-Wert der Positionen in seinem `positions`-Block.
3. Eine Position wird **einmal** berechnet und liefert ihr gesamtes `biomarker_ids`-Set, sodass eine Position, die mehrere deiner Marker abdeckt, nur einmal in Rechnung gestellt wird. Zusätzliche Marker, die du nicht angefragt hast, sind ohne Aufpreis enthalten.

Nichts überschneidet sich doppelt: Zwei Positionen, die einen Marker gemeinsam haben, liefern jeweils ihr Set, der Marker wird einmal aufgeführt und sie gewähren keinen gegenseitigen Rabatt.

## Die Rechnung

[Terminvorschau](https://docs.anivahealth.com/de/api/appointments/preview-containers.md) gibt die Rechnung für einen Termin zurück. [Warenkorb kalkulieren](https://docs.anivahealth.com/de/api/pricing/quote-cart.md) gibt dieselbe Rechnung ohne Termin zurück. Die Rechnung enthält:

* `positions[]` – jede ausgelöste Position, einmal zu ihrem Pauschalpreis berechnet.
* `panels[]` – jedes hinzugefügte Panel.
* `biomarkers[]` – eine Zeile pro **geliefertem** Marker. Eine Zeile, die über eine Position abgerechnet wird, kostet `0` und nennt diese in `via_position`. Eine Komponente, die durch ein Verhältnis hinzugezogen wird, trägt `required_by`; das Verhältnis selbst trägt `requires`.
* `total_cents` – die bepreisten Positionen plus die bepreisten Panels plus die bepreisten Biomarker-Zeilen, daneben `retail_total_cents`.
* `fees` und `total_with_fees_cents` – die Gebühren eines Termins und die Gesamtsumme inklusive dieser Gebühren.

Eine Zeile, für die Aniva keinen Preis angeben kann, hat `price_cents: null`. Die Zeile trägt nichts zur Gesamtsumme bei. Du kannst einen Marker ohne Preis nicht einzeln hinzufügen, daher wurde diese Zeile über eine Position oder ein Panel bereitgestellt. Diese Position oder dieses Panel berechnet sie bereits.

> [!NOTE]
>
> Aniva hat noch nicht jede Position veröffentlicht. Eine unveröffentlichte Position wird dennoch
> berechnet. Sie erscheint in `positions[]` mit `id` und `name` auf `null` gesetzt, und ihre
> Biomarker-Zeilen haben `via_position: null`.


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