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

# Randevuyu önizle

> Bir randevunun tüplerini ve faturasını önizle

Bir randevunun üzerindeki paneller ve biyobelirteçler için nelere ihtiyaç duyduğunu döndürür. Hiçbir şey sipariş edilmez.

* `containers`: sağlık çalışanının hazırladığı tüpler, kartlar veya kaplar.
* `pricing`: fiyat tarifene göre tutar. [Sepeti fiyatlandır](https://docs.anivahealth.com/tr/api/pricing/quote-cart.md) aynı
  tutarı randevu olmadan döndürür.
* `routing`: her zaman `null`.

`appointments_view`, `appointments_schedule`, `appointments_operate` veya `appointments_manage` kapsamlarından biri gerekir.

## İstek

### Yol parametreleri

**id** `string` *required*

Kap gereksinimleri önizlenecek randevunun benzersiz tanımlayıcısı (UUID).

## Yanıt

Başarılı olduğunda API, kap gereksinimleri ve gelecekteki kullanım için ayrılmış alanlarla birlikte `200 OK` döndürür.

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

Gerekli numune toplama kaplarının dizisi. Randevuya panel veya biyobelirteç eklenmemişse boştur. Randevunun konum-gün bilgisi henüz belirlenemiyorsa, örneğin planlanmış bir saati yoksa da boştur.

**kap**

**type** `string`

Kap türü tanımlayıcısı. `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` veya `trace_metal` değerlerinden biri.

**name** `string`

İnsan tarafından okunabilir kap adı (ör. Serum, EDTA, Li-Heparin).

**cap\_color** `string`

Gösterim için kap kapağının onaltılık renk kodu (ör. `"#A0784B"`). Kabın kapağı
yoksa `null`.

**volume** `string`

Kabın hacim kapasitesi (ör. `"7.5 ml"`). Hacmin geçerli olmadığı durumlarda `null`.

**article\_number** `string`

Biliniyorsa üretici katalog numarası (REF) (ör. `"01.1602.001"`). Eşleştirilmiş ürün numarası olmayan kaplar için dahil edilmez.

**count** `integer`

Bu türden gereken kap sayısı.

**routing** `null`

Laboratuvar yönlendirme ayrıntıları — kasıtlı olarak dışa aktarılmaz, her zaman `null`.

**pricing** `object | null`

Fiyat tarifene göre randevunun tüm sepet tutarı. Randevuya eklenmiş test yoksa veya
anahtarında `prices_view` kapsamı bulunmuyorsa `null`. [Fiyatlandırma](https://docs.anivahealth.com/tr/concepts/pricing.md) modeli
açıklar; tekil tutarlar [fiyat
nesneleri](https://docs.anivahealth.com/tr/api/biomarkers/list-biomarkers.md#fiyat-nesneleri) başvurusunu izler.

**Tutar alanları**

**total\_cents** `integer`

Sepetin fiyat tarifendeki tutarı: fiyatlandırılmış kalemler, fiyatlandırılmış paneller ve fiyatlandırılmış
biyobelirteç satırlarının toplamı. `price_cents: null` değerine sahip bir satır hiçbir şey eklemez; bu nedenle böyle bir satır içeren sepetin toplamı
gerçek maliyetinden daha düşük çıkar.

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

Önerilen perakende tarifesine göre aynı toplam.

**fees** `object`

Bir kan almanın fiyat tarifene eklediği ücretler, sent cinsinden. Bunlar aylık faturaya yansıtılır. Bkz. [Fiyat tarifesini
al](https://docs.anivahealth.com/tr/api/pricing/get-rate-card.md).

**ücretler**

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

Tamamlanan randevu başına kan alma ücreti.

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

Hasta için atıştırmalık. Yalnızca hasta atıştırmalık aldığında faturalandırılır. Hastaların
atıştırmalık almıyorsa dahil edilmez; atıştırmalık sunmak için Aniva ile iletişime geç.

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

Numune alımı için kurye ücreti. Aynı gün aynı konumdaki randevuların tek bir
ücreti paylaşır.

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

Sarf malzemeleri: tüpler, etiketler, poşet.

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

`total_cents` artı `fees` içindeki tüm ücretler ve tam lojistik ücreti. Başka bir randevun aynı
alımı paylaştığında bu tutar daha düşük olur.

**positions** `object[]`

Bu sepette devreye giren her kalem — bir kez, tam tutarla faturalandırılır ve tüm üye setini
sağlar. `id`, `name`, `price_cents`, `retail_cents` ve `tier` alanlarını taşır. İş ortağına açık
olmayan bir kalem de devreye girer ve faturalandırılır; `id` ve `name` değerleri `null` olarak
bildirilir.

**panels** `object[]`

Eklenen her panel; `id`, `name`, `price_cents` ve `retail_cents` alanlarıyla.

**biomarkers** `object[]`

**Sağlanan** her biyobelirteç için bir satır — istediklerin, oranlarının dahil ettiği bileşenler
ve kalemlerinin sağladığı üyeler.

**id** `number`

Biyobelirteç kimliği.

**name** `string`

Biyobelirteç görünen adı.

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

Bu satırın kartındaki tutarı; yanında `retail_cents` yer alır. Bir kalem tarafından
karşılandığında `0`; Aniva fiyatlandıramadığında `null` olur.

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

Bu bileşeni sepete dahil eden oranlar. Hiçbiri dahil etmediyse yer almaz. Bir bileşene kaç oran
dayanırsa dayansın, sepet başına yalnızca bir kez ödenir.

**requires** `number[]`

Bu satır bir oran OLDUĞUNDA yer alır: faturalandırıldığı bileşenler.

**via\_position** `string`

Bu belirteci karşılayan kalem; satırın `0` tutmasının nedeni budur. Hiçbir kalem karşılamıyorsa
yer almaz. Karşılayan kalem iş ortağına açık değilse `null` olur.

## Hata yanıtları

| Durum | Açıklama |
| - | - |
| `400` | Geçersiz kimlik biçimi — verilen değer geçerli bir UUID değil. |
| `403` | Yasak — API anahtarının bu işleme erişimi yok. |
| `404` | Randevu bulunamadı. |
| `500` | İç sunucu hatası. |

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