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

# Förhandsgranska bokning

> Förhandsgranska provrören och fakturan för en bokning

Returnerar vad en bokning behöver för de paneler och biomarkörer den innehåller. Inget beställs.

* `containers`: de rör, kort eller bägare som provtagaren förbereder.
* `pricing`: kostnaden enligt din prislista. [Prisberäkna varukorg](https://docs.anivahealth.com/sv/api/pricing/quote-cart.md) returnerar samma
  kostnad utan en bokning.
* `routing`: alltid `null`.

Kräver någon av behörigheterna `appointments_view`, `appointments_schedule`, `appointments_operate` eller `appointments_manage`.

## Förfrågan

### Sökvägsparametrar

**id** `string` *required*

Unik identifierare (UUID) för bokningen du vill förhandsgranska behållarkrav för.

## Svar

Vid lyckat anrop returnerar API:et `200 OK` med kraven på behållare och fält reserverade för framtida bruk.

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

Array med nödvändiga provtagningsbehållare. Tom när inga paneler eller biomarkörer har lagts till i bokningen. Även tom när bokningens plats och dag ännu inte kan fastställas, till exempel när den saknar bokad tid.

**behållare**

**type** `string`

Identifierare för behållartyp. Ett av `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` eller `trace_metal`.

**name** `string`

Läsbart namn på behållaren (t.ex. Serum, EDTA, Li-Heparin).

**cap\_color** `string`

Hex-färgkod för behållarens kork vid visning (t.ex. `"#A0784B"`). `null` när
behållaren saknar kork.

**volume** `string`

Behållarens volymkapacitet (t.ex. `"7.5 ml"`). `null` när volym inte är tillämpligt.

**article\_number** `string`

Tillverkarens katalognummer (REF), om känt (t.ex. `"01.1602.001"`). Utelämnas för behållare utan kopplat artikelnummer.

**count** `integer`

Antal behållare av den här typen som behövs.

**routing** `null`

Information om labbdirigering – exponeras avsiktligt inte, alltid `null`.

**pricing** `object | null`

Totalkostnaden för varukorgen för bokningen, enligt din prislista. `null` när bokningen inte har några kopplade
tester, eller när din nyckel saknar behörigheten `prices_view`. [Prissättning](https://docs.anivahealth.com/sv/concepts/pricing.md) förklarar
modellen; enskilda belopp följer referensen för [prisobjekt](https://docs.anivahealth.com/sv/api/biomarkers/list-biomarkers.md#prisobjekt).

**Kostnadsfält**

**total\_cents** `integer`

Vad varukorgen kostar enligt din prislista: de prissatta posterna plus de prissatta panelerna plus de prissatta
biomarkörraderna. En rad med `price_cents: null` lägger inte till något, så en varukorg som innehåller en sådan får en lägre totalsumma
än den faktiska kostnaden.

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

Samma totalsumma enligt den rekommenderade konsumentprislistan.

**fees** `object`

De avgifter en blodprovstagning medför enligt din prislista, i cent. De debiteras på månadsfakturan. Se [Hämta
prislista](https://docs.anivahealth.com/sv/api/pricing/get-rate-card.md).

**avgifter**

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

Provtagningsavgift per genomförd bokning.

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

Mellanmål till patienten. Debiteras bara när patienten får ett mellanmål. Utelämnas när dina
patienter inte får något; kontakta Aniva för att erbjuda mellanmål.

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

Budavgift för upphämtningen. Dina bokningar på samma plats samma dag delar på en
avgift.

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

Förbrukningsmaterial: rör, etiketter, påse.

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

`total_cents` plus varje avgift i `fees`, med hela logistikavgiften. Det blir lägre när en annan
av dina bokningar delar på upphämtningen.

**positions** `object[]`

Varje position som utlöstes i den här varukorgen – faktureras en gång, till fullt belopp, och
levererar hela sin uppsättning markörer. Innehåller `id`, `name`, `price_cents`, `retail_cents`
och `tier`. En position som inte är synlig för partners utlöses ändå och faktureras ändå, och
rapporteras med `id` och `name` satta till `null`.

**panels** `object[]`

Varje kopplad panel, med `id`, `name`, `price_cents` och `retail_cents`.

**biomarkers** `object[]`

En rad per **levererad** biomarkör – det du begärde, plus de komponenter som dess kvoter drog in
och de markörer som dess positioner levererar.

**id** `number`

Biomarkörens identifierare.

**name** `string`

Biomarkörens visningsnamn.

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

Vad den här raden kostar på ditt kort, med `retail_cents` bredvid. `0` när en position betalar
för den; `null` när Aniva inte kan prissätta den.

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

De kvoter som drog in den här komponenten i varukorgen. Utelämnas när ingen gjorde det. En
komponent betalas en gång per varukorg oavsett hur många kvoter som bygger på den.

**requires** `number[]`

Finns med när den här raden ÄR en kvot: de komponenter den faktureras som.

**via\_position** `string`

Den position som betalar för den här markören, vilket är anledningen till att raden kostar `0`.
Utelämnas när inget täcker den. `null` när den täckande positionen inte är synlig för partners.

## Felsvar

| Status | Beskrivning |
| - | - |
| `400` | Ogiltigt ID-format — det angivna värdet är inte ett giltigt UUID. |
| `403` | Åtkomst nekad — din API-nyckel har inte behörighet för den här åtgärden. |
| `404` | Bokningen hittades inte. |
| `500` | Internt serverfel. |

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