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

# Afspraak vooraf bekijken

> Bekijk vooraf de buisjes en de rekening van een afspraak

Geeft terug wat een afspraak nodig heeft voor de panels en biomarkers die erop staan. Er wordt niets besteld.

* `containers`: de buisjes, kaarten of potjes die de behandelaar klaarzet.
* `pricing`: de rekening volgens jouw tariefkaart. [Winkelwagen berekenen](https://docs.anivahealth.com/nl/api/pricing/quote-cart.md) geeft dezelfde
  rekening terug zonder afspraak.
* `routing`: altijd `null`.

Vereist een van de scopes `appointments_view`, `appointments_schedule`, `appointments_operate` of `appointments_manage`.

## Verzoek

### Padparameters

**id** `string` *required*

Unieke identifier (UUID) van de afspraak waarvoor je de benodigde containers wilt bekijken.

## Respons

Bij succes geeft de API `200 OK` terug met de benodigde containers en gereserveerde velden voor toekomstig gebruik.

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

Array met benodigde afnamecontainers. Leeg wanneer er geen panels of biomarkers aan de afspraak zijn toegevoegd. Ook leeg wanneer de locatie-dag van de afspraak nog niet kan worden bepaald, bijvoorbeeld wanneer er geen geplande tijd is.

**container**

**type** `string`

Identifier van het containertype. Een van `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` of `trace_metal`.

**name** `string`

Leesbare naam van de container (bijv. "Serum", "EDTA", "Li-Heparin").

**cap\_color** `string`

Hex-kleurcode van de dop van de container voor weergave (bijv. `"#A0784B"`). `null` wanneer de
container geen dop heeft.

**volume** `string`

Volumecapaciteit van de container (bijv. `"7.5 ml"`). `null` wanneer volume niet van toepassing is.

**article\_number** `string`

Catalogusnummer van de fabrikant (REF), indien bekend (bijv. `"01.1602.001"`). Weggelaten bij containers zonder gekoppeld artikelnummer.

**count** `integer`

Aantal benodigde containers van dit type.

**routing** `null`

Gegevens voor labrouting — bewust niet zichtbaar, altijd `null`.

**pricing** `object | null`

De rekening van de hele winkelwagen voor de afspraak, volgens jouw tariefkaart. `null` wanneer de afspraak geen gekoppelde
tests heeft, of wanneer je sleutel de scope `prices_view` mist. [Prijzen](https://docs.anivahealth.com/nl/concepts/pricing.md) legt het
model uit; losse bedragen volgen de referentie voor [prijsobjecten](https://docs.anivahealth.com/nl/api/biomarkers/list-biomarkers.md#prijsobjecten).

**Rekeningvelden**

**total\_cents** `integer`

Wat de winkelwagen kost op jouw tariefkaart: de geprijsde posities plus de geprijsde panels plus de geprijsde
biomarkerrijen. Een rij met `price_cents: null` voegt niets toe, dus een winkelwagen met zo'n rij komt lager uit
dan deze zal kosten.

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

Hetzelfde totaal volgens de aanbevolen consumententariefkaart.

**fees** `object`

De kosten die één bloedafname toevoegt op jouw tariefkaart, in centen. Deze worden op de maandelijkse factuur in rekening gebracht. Zie [Tariefkaart
ophalen](https://docs.anivahealth.com/nl/api/pricing/get-rate-card.md).

**kosten**

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

Kosten voor de bloedafname per voltooide afspraak.

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

Snack voor de patiënt. Alleen in rekening gebracht als de patiënt een snack krijgt. Weggelaten als je
patiënten geen snacks krijgen; neem contact op met Aniva om snacks aan te bieden.

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

Koerierskosten voor het ophalen. Je afspraken op dezelfde locatie op dezelfde dag delen één
tarief.

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

Verbruiksmaterialen: buisjes, etiketten, zak.

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

`total_cents` plus alle kosten in `fees`, met de volledige logistieke kosten. Dit is lager
wanneer een andere afspraak van jou het ophalen deelt.

**positions** `object[]`

Elke positie die op dit winkelmandje is geactiveerd — eenmaal volledig in rekening gebracht, met
levering van de volledige bijbehorende set. Bevat `id`, `name`, `price_cents`, `retail_cents` en
`tier`. Een positie die niet zichtbaar is voor partners wordt toch geactiveerd en in rekening
gebracht, en wordt gerapporteerd met `id` en `name` op `null`.

**panels** `object[]`

Elk gekoppeld panel, als `id`, `name`, `price_cents` en `retail_cents`.

**biomarkers** `object[]`

Eén rij per **geleverde** biomarker — wat je hebt aangevraagd, plus de componenten die de
ratio's hebben toegevoegd en de onderdelen die de posities leveren.

**id** `number`

Biomarker-identifier.

**name** `string`

Weergavenaam van de biomarker.

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

Wat deze rij kost op je tariefkaart, met `retail_cents` ernaast. `0` wanneer een positie
ervoor betaalt; `null` wanneer Aniva er geen prijs voor kan bepalen.

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

De ratio's die deze component aan het winkelmandje hebben toegevoegd. Weggelaten als dat er
geen zijn. Een component wordt één keer per winkelmandje betaald, ongeacht hoeveel ratio's
ervan afhankelijk zijn.

**requires** `number[]`

Aanwezig wanneer deze rij een ratio IS: de componenten waaronder deze wordt gefactureerd.

**via\_position** `string`

De positie die deze marker betaalt, waardoor de rij `0` kost. Weggelaten wanneer niets deze
dekt. `null` wanneer de dekkende positie niet zichtbaar is voor partners.

## Foutresponsen

| Status | Beschrijving |
| - | - |
| `400` | Ongeldige ID-indeling — de opgegeven waarde is geen geldige UUID. |
| `403` | Geen toegang — je API-sleutel heeft geen toegang tot deze bewerking. |
| `404` | Afspraak niet gevonden. |
| `500` | Interne serverfout. |

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