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

# Forhåndsvis tid

> Forhåndsvis prøverørene og regningen for en tid

Returnerer, hvad en tid kræver til de paneler og biomarkører, der er på den. Intet bestilles.

* `containers`: de rør, kort eller bægre, som behandleren gør klar.
* `pricing`: regningen efter din prisliste. [Prisberegn kurv](https://docs.anivahealth.com/da/api/pricing/quote-cart.md) returnerer den samme
  regning uden en tid.
* `routing`: altid `null`.

Kræver et af følgende scopes: `appointments_view`, `appointments_schedule`, `appointments_operate` eller `appointments_manage`.

## Forespørgsel

### Stiparametre

**id** `string` *required*

Unikt id (UUID) for den tid, du vil forhåndsvise beholderkrav for.

## Svar

Ved succes returnerer API'et `200 OK` med beholderkravene og felter reserveret til fremtidig brug.

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

Array af påkrævede prøvetagningsbeholdere. Tomt, når der ikke er tilføjet paneler eller biomarkører til tiden. Også tomt, når tidens lokationsdag endnu ikke kan fastlægges, f.eks. når der ikke er planlagt et tidspunkt.

**beholder**

**type** `string`

Id for beholdertype. En af `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 beholdernavn (f.eks. "Serum", "EDTA", "Li-Heparin").

**cap\_color** `string`

Hex-farvekode for beholderens låg til visning (f.eks. `"#A0784B"`). `null`, når
beholderen ikke har noget låg.

**volume** `string`

Beholderens volumenkapacitet (f.eks. `"7.5 ml"`). `null`, hvor volumen ikke er relevant.

**article\_number** `string`

Producentens katalognummer (REF), når det er kendt (f.eks. `"01.1602.001"`). Udelades for beholdere uden tilknyttet varenummer.

**count** `integer`

Antal påkrævede beholdere af denne type.

**routing** `null`

Detaljer om laboratorierouting – vises bevidst ikke, altid `null`.

**pricing** `object | null`

Den samlede kurvregning for tiden efter din prisliste. `null`, når tiden ikke har tilknyttede
tests, eller når din nøgle mangler scopet `prices_view`. [Prissætning](https://docs.anivahealth.com/da/concepts/pricing.md) forklarer
modellen; de enkelte beløb følger referencen for
[prisobjekter](https://docs.anivahealth.com/da/api/biomarkers/list-biomarkers.md#prisobjekter).

**Regningsfelter**

**total\_cents** `integer`

Hvad kurven koster på din prisliste: de prissatte poster plus de prissatte paneler plus de prissatte
biomarkørrækker. En række med `price_cents: null` lægger intet til, så en kurv med sådan en giver en lavere total
end den faktiske pris.

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

Den samme total efter den anbefalede udsalgsprisliste.

**fees** `object`

De gebyrer, én blodprøvetagning tilføjer på din prisliste, i cent. Den månedlige faktura opkræver dem. Se [Hent
prisliste](https://docs.anivahealth.com/da/api/pricing/get-rate-card.md).

**gebyrer**

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

Gebyr for blodprøvetagning pr. gennemført tid.

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

Snack til patienten. Faktureres kun, når patienten får en snack. Udelades, når dine
patienter ikke får nogen; kontakt Aniva for at tilbyde snacks.

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

Kurérgebyr for afhentningen. Dine tider på samme lokation samme dag deler ét
gebyr.

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

Forbrugsvarer: rør, etiketter, pose.

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

`total_cents` plus hvert gebyr i `fees`, med det fulde logistikgebyr. Det er lavere, når en anden af
dine tider deler afhentningen.

**positions** `object[]`

Hver position, der blev udløst på denne kurv — faktureret én gang, fuldt ud, og leverer hele sit
medlemssæt. Indeholder `id`, `name`, `price_cents`, `retail_cents` og `tier`. En position, der ikke er
synlig for partnere, udløses og faktureres stadig, og rapporteres med `id` og `name` sat til
`null`.

**panels** `object[]`

Hvert tilknyttet panel som `id`, `name`, `price_cents` og `retail_cents`.

**biomarkers** `object[]`

Én række pr. **leveret** biomarkør — det, du bad om, plus de komponenter, dens ratioer trak med
ind, og de medlemmer, dens positioner leverer.

**id** `number`

Biomarkør-ID.

**name** `string`

Visningsnavn for biomarkøren.

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

Hvad denne række koster på din prisliste, med `retail_cents` ved siden af. `0`, når en position betaler for
den; `null`, når Aniva ikke kan prissætte den.

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

De ratioer, der trak denne komponent med i kurven. Udelades, når ingen gjorde. En komponent
betales én gang pr. kurv, uanset hvor mange ratioer der bruger den.

**requires** `number[]`

Til stede, når denne række ER en ratio: de komponenter, den faktureres som.

**via\_position** `string`

Den position, der betaler for denne markør, hvilket er grunden til, at rækken koster `0`. Udelades, når intet
dækker den. `null`, når den dækkende position ikke er synlig for partnere.

## Fejlsvar

| Status | Beskrivelse |
| - | - |
| `400` | Ugyldigt ID-format — den angivne værdi er ikke en gyldig UUID. |
| `403` | Adgang nægtet — din API-nøgle har ikke adgang til denne handling. |
| `404` | Tiden blev ikke fundet. |
| `500` | Intern serverfejl. |

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