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

# Previzualizează programarea

> Previzualizează eprubetele și factura unei programări

Returnează de ce are nevoie o programare, pentru panelurile și biomarkerii ei. Nu se comandă nimic.

* `containers`: eprubetele, cardurile sau paharele pe care le pregătește personalul medical.
* `pricing`: nota de plată conform grilei tale de tarife. [Estimează coșul](https://docs.anivahealth.com/ro/api/pricing/quote-cart.md) returnează aceeași
  notă de plată fără o programare.
* `routing`: întotdeauna `null`.

Necesită unul dintre scope-urile `appointments_view`, `appointments_schedule`, `appointments_operate` sau `appointments_manage`.

## Cerere

### Parametri de cale

**id** `string` *required*

Identificatorul unic (UUID) al programării pentru care previzualizezi necesarul de recipiente.

## Răspuns

În caz de succes, API-ul returnează `200 OK` cu necesarul de recipiente și câmpuri rezervate pentru utilizare viitoare.

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

Array de recipiente necesare pentru colectarea probelor. Gol când nu au fost adăugate paneluri sau biomarkeri la programare. De asemenea, gol când nu se poate stabili încă locația și ziua programării, de exemplu când nu are o oră programată.

**recipient**

**type** `string`

Identificatorul tipului de recipient. Una dintre valorile `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` sau `trace_metal`.

**name** `string`

Numele recipientului în format lizibil (de ex., "Serum", "EDTA", "Li-Heparin").

**cap\_color** `string`

Codul hex de culoare al capacului recipientului, pentru afișare (de ex., `"#A0784B"`). `null` când
recipientul nu are capac.

**volume** `string`

Capacitatea de volum a recipientului (de ex., `"7.5 ml"`). `null` unde volumul nu se aplică.

**article\_number** `string`

Numărul de catalog al producătorului (REF), când este cunoscut (de ex., `"01.1602.001"`). Omis pentru recipientele fără un număr de articol mapat.

**count** `integer`

Numărul necesar de recipiente de acest tip.

**routing** `null`

Detalii de rutare către laborator — neexpuse intenționat, întotdeauna `null`.

**pricing** `object | null`

Nota de plată pentru întregul coș al programării, conform grilei tale de tarife. `null` când programarea nu are teste
atașate sau când cheia ta nu are scope-ul `prices_view`. [Prețuri](https://docs.anivahealth.com/ro/concepts/pricing.md) explică
modelul; sumele individuale urmează referința pentru [obiecte de
preț](https://docs.anivahealth.com/ro/api/biomarkers/list-biomarkers.md#obiecte-de-pret).

**Câmpurile notei de plată**

**total\_cents** `integer`

Cât costă coșul conform grilei tale de tarife: pozițiile cu preț plus panelurile cu preț plus
rândurile de biomarkeri cu preț. Un rând cu `price_cents: null` nu adaugă nimic, așa că un coș care conține unul are un total mai mic
decât va costa efectiv.

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

Același total conform grilei recomandate de prețuri de retail.

**fees** `object`

Taxele pe care le adaugă o recoltare de sânge conform grilei tale de tarife, în cenți. Sunt taxate pe factura lunară. Vezi [Obține grila
de tarife](https://docs.anivahealth.com/ro/api/pricing/get-rate-card.md).

**taxe**

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

Taxă de recoltare de sânge per programare finalizată.

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

Gustare pentru pacient. Se facturează doar când pacientul primește o gustare. Omisă când
pacienții tăi nu primesc gustări; contactează Aniva pentru a oferi gustări.

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

Taxă de curier pentru ridicare. Programările tale din aceeași locație, în aceeași zi, împart o singură
taxă.

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

Consumabile: eprubete, etichete, pungă.

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

`total_cents` plus fiecare taxă din `fees`, cu taxa integrală de logistică. Este mai mic atunci
când o altă programare a ta împarte ridicarea.

**positions** `object[]`

Fiecare poziție activată pentru acest coș — facturată o singură dată, integral, livrând
întregul său set de membri. Include `id`, `name`, `price_cents`, `retail_cents` și `tier`. O
poziție care nu este vizibilă pentru parteneri se activează și se facturează în continuare și
este raportată cu `id` și `name` setate la `null`.

**panels** `object[]`

Fiecare panel atașat, cu `id`, `name`, `price_cents` și `retail_cents`.

**biomarkers** `object[]`

Un rând pentru fiecare biomarker **livrat** — ce ai solicitat, plus componentele atrase de
rapoartele sale și membrii livrați de pozițiile sale.

**id** `number`

Identificatorul biomarkerului.

**name** `string`

Numele afișat al biomarkerului.

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

Cât costă acest rând pe cardul tău, cu `retail_cents` alături. `0` când o poziție îl plătește;
`null` când Aniva nu îi poate stabili prețul.

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

Rapoartele care au atras această componentă în coș. Omis când nu există niciunul. O componentă
se plătește o singură dată per coș, indiferent câte rapoarte se bazează pe ea.

**requires** `number[]`

Prezent când acest rând ESTE un raport: componentele sub care este facturat.

**via\_position** `string`

Poziția care plătește pentru acest marker, motiv pentru care rândul costă `0`. Omis când nimic
nu îl acoperă. `null` când poziția care îl acoperă nu este vizibilă pentru parteneri.

## Răspunsuri de eroare

| Status | Descriere |
| - | - |
| `400` | Format de ID invalid — valoarea furnizată nu este un UUID valid. |
| `403` | Interzis — cheia ta API nu are acces la această operațiune. |
| `404` | Programarea nu a fost găsită. |
| `500` | Eroare internă de server. |

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