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

# Fiyatlandırma

> Aniva laboratuvar testi API'si, fiyat listendeki biyobelirteçleri, kalemleri ve panelleri randevu almadan önce fiyat teklifleriyle nasıl fiyatlandırır.

Aniva tek bir şeyi fiyatlandırır: **pozisyon**. Pozisyon ticari bir tekliftir — tek seferde, sabit bir fiyatla faturalandırılan ve her zaman bütün olarak sunulan, özenle seçilmiş bir biyobelirteç setidir. Tek başına satın alabileceğin bir biyobelirteç, basitçe tek öğeli bir pozisyondur.

`pricing` içinde gördüğün her şey buna dayanır. Bu sayfayı bir kez oku; aşağıdaki dört durum artık özel durum gibi görünmez.

## Sayıların anlamı

Her `price_cents`, API anahtarındaki fiyat tarifesine göre **senin** ödediğin tutardır. Yanındaki `retail_cents`, aynı öğenin önerilen perakende tarifesindeki fiyatıdır; böylece ikinci bir istek atmadan tasarruf tutarını gösterebilirsin. Her ikisi de tam sayı sent cinsindendir ve her ikisi de **nettir**: KDV, aylık faturana KDV statünün gerektirdiği oranda eklenir ve muaf bir statüde hiç eklenmez. Aniva'nın tüketici katalog fiyatından satılan bir panel, %19 Alman KDV'si düşülmüş haliyle verilir.

> [!NOTE]
>
> `retail_cents` her zaman mevcuttur. Anahtarın zaten perakende tarifesindeyse doğrudan
> `price_cents` değerine eşit olur.

Fiyatlar için `prices_view` kapsamı gerekir. Bu kapsam olmadan listelerde ve önizlemede `pricing` değeri `null` olur ve Fiyatlandırma uç noktaları `403` döndürür.

## Fiyat tarifen

Fiyatlarını fiyat tarifen belirler. Bunu [Fiyat tarifesini al](https://docs.anivahealth.com/tr/api/pricing/get-rate-card.md) üzerinden oku.

* Her analizin bir `tier` değeri vardır: `routine` veya `specialty`. Fiyatı, Aniva katalog fiyatının bu seviyenin çarpanıyla çarpımına eşittir.
* Ücretler randevu başınadır ve lojistik ücreti kurye alımı başınadır. Aynı gün aynı konumdaki randevuların tek bir alımı paylaşır. Aniva, ücretleri aylık faturana yansıtır.

## Dört durum

`price_cents` ve yanında yer alan isteğe bağlı blok, durumu belirler. Ayrı bir tür alanı yoktur.

| `price_cents` | Yanında bulunan | Anlamı |
| - | - | - |
| pozitif | `positions?` | Bu fiyattan tek başına sipariş edilebilir. Bir oran ayrıca `requires` taşır ve bileşenlerini de faturalandırır. |
| `0` | `requires` | Bir **oran**. Kendi başına bir maliyeti yoktur; bileşenleri için ödeme yaparsın. |
| `0` | `positions` | **Pozisyona bağlı**. Yalnızca listelenen pozisyonlardan birinin içinde satılır. |
| `null` | — | **Kürasyon dışı**. Aniva bunu fiyatlandırmamıştır ve sipariş edilemez. |

### Pozitif — tek başına sipariş edilebilir

Biyobelirtecin kendi fiyatı vardır. Yine de pozisyonlarda yer alabilir ve bu durumda `positions` bunları en ucuzdan başlayarak listeler — pozisyonu satın almak, üyelerini tek tek satın almaktan genellikle daha ucuzdur.

```json theme={null}
{
  "id": 71,
  "name": "Hemoglobin",
  "pricing": {
    "price_cents": 350,
    "retail_cents": 403,
    "tier": "routine",
    "positions": [
      {
        "id": "b7d4c2e1-9a3f-4c8b-91d2-5e6f7a8b9c0d",
        "name": "Aniva Blood Count",
        "price_cents": 452,
        "retail_cents": 520,
        "biomarker_ids": [71, 72, 73],
        "includes": [72, 73]
      }
    ]
  }
}
```

`biomarker_ids`, pozisyonun tam üye setidir; `includes` ise sorguladığın biyobelirteç hariç bu settir — yani beraberinde gelenlerdir.

### `requires` ile sıfır — bir oran

Oran, ölçülen biyobelirteçlerden hesaplanır. Çoğu oranın fiyatı `0`'dır. Pozitif `price_cents` değerine sahip bir oran, bileşenlerine ek olarak bu fiyatı da faturalandırır. Bunu sipariş ettiğinde Aniva, bileşenlerini kendi fiyatlarıyla sepete ekler. Kaç oran ona dayanırsa dayansın, bir bileşen **sepet başına bir kez** ödenir.

```json theme={null}
{
  "id": 279,
  "name": "hs-CRP / HDL Ratio",
  "pricing": {
    "price_cents": 0,
    "retail_cents": 0,
    "requires": [
      { "id": 42, "name": "HDL Cholesterol", "price_cents": 233, "retail_cents": 268 },
      { "id": 84, "name": "High-Sensitivity C-Reactive Protein (hs-CRP)", "price_cents": 1166, "retail_cents": 1341 }
    ]
  }
}
```

Bir oran, pozisyonlarla rekabet etmek yerine onlarla birleşir. Bileşenleri zaten satın aldığın bir pozisyonun üyesiyse, bunların bedelini pozisyon karşılar ve oran da fiyata dahil olur.

> [!WARNING]
>
> Tüm bileşenleri fiyatlandırılmamış bir oran **katalogda yer almaz** — `price_cents: null`
> ile görünmez. Aniva eksik bileşeni fiyatlandırdığında geri gelir.

### `positions` ile sıfır — yalnızca bir pozisyon içinde satılır

Belirtecin kendi fiyatı yoktur, ancak bir veya daha fazla pozisyonun üyesidir. Bu pozisyonlardan birini satın aldığında onu da alırsın.

```json theme={null}
{
  "id": 77,
  "name": "Mean Platelet Volume (MPV)",
  "pricing": {
    "price_cents": 0,
    "retail_cents": 0,
    "positions": [
      {
        "id": "3f1a8c22-64bd-4e57-8a90-1c2d3e4f5a6b",
        "name": "Blood Count (extended)",
        "price_cents": 460,
        "retail_cents": 529,
        "biomarker_ids": [71, 72, 73, 77],
        "includes": [71, 72, 73]
      }
    ]
  }
}
```

Bunlardan birini bir randevuya tek başına eklemek reddedilir — bkz. [Tekil biyobelirteç ekle](https://docs.anivahealth.com/tr/api/appointments/add-individual-biomarkers.md). Bunun yerine listelenen pozisyonlardan birindeki tüm biyobelirteçleri ekle.

### Null — kataloglanmamış

Aniva bu belirtecin fiyatına karar vermedi, bu yüzden satışta değil. `null` sıfır değildir ve "bize sor" demek değildir: bunu kullanılamaz olarak ele al.

```json theme={null}
{ "id": 555, "name": "Poppy Seeds (Pap s)", "pricing": { "price_cents": null, "retail_cents": null } }
```

> [!WARNING]
>
> Aniva, sipariş sırasında `null` bir belirteci reddeder. Bir biyobelirteci sipariş edilebilir
> kılan iki koşul vardır. Aniva'nın yönlendirme yapabileceği bir laboratuvarın bu biyobelirteci
> sunması gerekir. Aniva kataloğunun bunu fiyatlandırması gerekir. Bir randevuya `null` bir
> belirteç eklersen API, `error: "biomarker_not_priced"` ile `400` döndürür. Bkz.
> [Tekil biyobelirteç ekle](https://docs.anivahealth.com/tr/api/appointments/add-individual-biomarkers.md). Bir laboratuvar `null`
> bir belirteci sunabilir, ancak yalnızca sunması belirteci kullanılabilir kılmaz. `null` değerini
> kullanılamaz olarak ele al.

Bazı belirteçler tasarım gereği `null` değerindedir. Aniva, mikrobiyom ve genetik testlerini kit
olarak satar. Bir kitin tek bir fiyatı vardır, bu nedenle üye belirteçlerinin kendi fiyatı yoktur.
Bu belirteçleri satın almak için kit olan paneli sipariş et. Üyeler panelle birlikte gelir. API,
panelini zaten içeren bir randevuya eklediğin bir üyeyi de kabul eder.

Aniva bir belirteci yalnızca senin göremediğin bir pozisyon içinde sattığında da belirteç `null`
görünür. Sonuç aynıdır: belirteci satın alabileceğin bir fiyat yoktur. Aniva bu pozisyonu iş
ortaklarına açtığında belirteç bir fiyat kazanır.

## Bir seti satın almanın en ucuz yolunu bulma

Bir belirtecin ait olduğu her pozisyon belirteçle birlikte geldiğinden, bunu ek istekler göndermeden yerel olarak çözebilirsin:

1. [Biyobelirteçleri listele](https://docs.anivahealth.com/tr/api/biomarkers/list-biomarkers.md) üzerinden istediğin belirteçleri topla.
2. Her biri için kendi `price_cents` değerini, `positions` bloğundaki pozisyonların `price_cents` değerleriyle karşılaştır.
3. Bir pozisyon **bir kez** faturalandırılır ve tüm `biomarker_ids` setini sunar; bu nedenle belirteçlerinden birkaçını kapsayan bir pozisyon tek sefer ücretlendirilir. İstemediğin ek belirteçler ek ücret olmadan birlikte gelir.

Hiçbir şey iki kez çakışmaz: ortak bir üyesi olan iki pozisyonun her biri kendi setini sunar, üye bir kez listelenir ve birbirlerine asla indirim uygulamazlar.

## Fatura

[Randevuyu önizle](https://docs.anivahealth.com/tr/api/appointments/preview-containers.md) bir randevunun faturasını döndürür. [Sepet fiyat teklifi al](https://docs.anivahealth.com/tr/api/pricing/quote-cart.md) aynı faturayı randevu olmadan döndürür. Faturada şunlar yer alır:

* `positions[]` — devreye giren her pozisyon, sabit fiyatından bir kez faturalandırılır.
* `panels[]` — eklenen her panel.
* `biomarkers[]` — **sunulan** her belirteç için bir satır. Bir pozisyonun karşıladığı satır `0` tutarındadır ve onu `via_position` içinde belirtir. Bir oran tarafından dahil edilen bileşen `required_by` taşır; oranın kendisi `requires` taşır.
* `total_cents` — fiyatlandırılmış pozisyonlar artı fiyatlandırılmış paneller artı fiyatlandırılmış biyobelirteç satırları, yanında da `retail_total_cents` bulunur.
* `fees` ve `total_with_fees_cents` — bir randevunun ücretleri ve bunlarla birlikte toplam tutar.

Aniva'nın fiyatlandıramadığı bir satır `price_cents: null` taşır. Bu satır toplama hiçbir şey eklemez. Fiyatlandırılmamış bir belirteci tek başına ekleyemezsin, bu yüzden bu satırı bir pozisyon veya panel sağlamıştır. O pozisyon veya panel bunu zaten faturalandırır.

> [!NOTE]
>
> Aniva henüz her pozisyonu yayımlamadı. Yayımlanmamış bir pozisyon yine de faturalandırılır.
> `positions[]` içinde `id` ve `name` değerleri `null` olarak görünür ve biyobelirteç satırları
> `via_position: null` değerini taşır.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.