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

# Sepet fiyat teklifi al

> Randevu olmadan panellerin ve biyobelirteçlerin fiyatını hesapla

Fiyat tarifene göre paneller ve biyobelirteçler için fiyat dökümünü döndürür. Randevu gerekmez. Hiçbir şey
rezerve edilmez.

Fiyat dökümü, [Randevuyu önizle](https://docs.anivahealth.com/tr/api/appointments/preview-containers.md) içindeki `pricing` ile aynıdır,
artı numune alma yönteminin eklediği tutarları içerir. Varsayılan olarak bu, randevu ücretleriyle birlikte
bir konumda kan almadır. Bunun yerine ilgili ülkeye postalanan bir kiti fiyatlandırmak için `fulfilment: "home_kit"` ve bir `country_code` gönder: aylık faturanda faturalandırıldığı şekliyle kit ücreti, numune alma cihazları, gidiş-dönüş posta ücreti, kılıf
ve yedek lanset poşeti.
[Fiyatlandırma](https://docs.anivahealth.com/tr/concepts/pricing.md), Aniva'nın testleri nasıl fiyatlandırdığını açıklar.

`prices_view` kapsamını gerektirir.

## İstek

### Gövde parametreleri

`panel_ids` veya `biomarker_ids` içinde en az bir ID gönder.

**panel\_ids** `string[]`

Fiyatlandırılacak paneller, en fazla 50 adet. Her biri anahtarın için [Panelleri listele](https://docs.anivahealth.com/tr/api/panels/list-panels.md) listesinde yer almalıdır.

**biomarker\_ids** `number[]`

Fiyatlandırılacak biyobelirteçler, en fazla 500 adet.

**sex** `integer`

ISO/IEC 5218 uyarınca biyolojik cinsiyet: `1` = erkek, `2` = kadın. Bazı paneller yalnızca belirli bir
cinsiyet veya yaş için biyobelirteç ekler. Bu kuralları uygulamak için `sex` ve `date_of_birth` alanlarını birlikte gönder. Bunlar olmadan kurallar
uygulanmaz.

**date\_of\_birth** `string`

Doğum tarihi, `YYYY-MM-DD`. Bunu `sex` ile birlikte gönder.

**rate\_card** `string`

Fiyatlandırmada kullanılacak tarife: `retail` veya [Fiyat tarifesini al](https://docs.anivahealth.com/tr/api/pricing/get-rate-card.md) içindeki `id`.
Varsayılan: API anahtarının fiyat tarifesi, yoksa perakende.

**fulfilment** `string`

Numunenin nasıl alındığı. `draw` (varsayılan): randevu ücretlerini ekleyen, bir konumda kan
alma. `home_kit`: bunun yerine kit kalemlerini ekleyen, `country_code` ülkesine postalanan bir kit. Bir evde test kiti
tam olarak bir panel içerir ve bu panelin evde test kiti olarak satılması gerekir.

**country\_code** `string`

Kitin teslimat ülkesi, ISO 3166-1 alpha-2 (`DE`, `SE`). Yalnızca
`fulfilment: "home_kit"` ile birlikte zorunludur. Posta kalemlerini belirler.

## Yanıt

**total\_cents** `integer`

Testlerin fiyat tarifendeki fiyatı: fiyatlandırılmış her pozisyon, panel ve biyobelirteç satırı.
`price_cents: null` olan bir satır hiçbir şey eklemez.

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

Önerilen perakende fiyat tarifesindeki aynı fiyat.

**fees** `object`

Sent cinsinden bir randevunun ücretleri. Aniva bunları aylık faturana yansıtır. Bunlar bir
`draw` için geçerlidir; `home_kit` ise bunun yerine `fulfilment` içindeki kalemleri faturalandırır.

**ücretler**

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

Tamamlanan randevu başına.

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

Hastanın atıştırmalık aldığı randevu başına. Hastaların atıştırmalık almıyorsa bu alan yer almaz.
Atıştırmalık sunmak için Aniva ile iletişime geç.

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

Kurye alımı başına. Aynı gün aynı konumdaki randevuların tek bir alımı paylaşır.

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

Tamamlanan randevu başına. Tüpleri, etiketleri ve poşeti kapsar.

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

`total_cents` artı numune alma yönteminin eklediği tutar. `draw` için: `fees` içindeki her ücret. Tam
lojistik ücretini sayar ve paylaşımlı bir kurye alımı gerçek tutarı düşürür. `home_kit` için:
`fulfilment.total_cents`.

**fulfilment** `object`

Numunenin nasıl alındığı ve ne eklediği. `kind` değeri `draw` veya `home_kit` olur. `draw` başka bir alan
içermez.

**home\_kit**

**country\_code** `string`

Posta ücretinin fiyatlandırıldığı teslimat ülkesi.

**kit\_ref** `string | null`

Panelin gönderildiği kit. Aniva henüz bir kit hazırlamadıysa `null` döner; bu durumda teklif hiçbir
cihazı saymaz.

**devices** `integer`

Kutudaki numune alma cihazları, her biri cihaz ücreti üzerinden faturalandırılır.

**lines** `object[]`

Bir siparişin aylık faturana eklediği kit kalemleri; her biri `description`, `quantity`,
`unit`, `unit_cents` ve `amount_cents` alanlarını içerir. Posta ücreti, gönderim adımının bu ülke için ayırdığı hizmetlere
göre fiyatlandırılır. Tarifendeki 0 tutarındaki bir ücret satır oluşturmaz. Ön ödemeli malzeme kredisi
buradan düşülmez.

**total\_cents** `integer`

`lines` toplamı, net.

**activation\_fee\_cents** `integer`

Kiti laboratuvara ulaşmadan önce etkinleştirmediğinde ve laboratuvar etkinleştirdiğinde buna ek olarak net
faturalandırılır. `lines` veya `total_cents` içinde yer almaz. 0, tarifende böyle bir ücret olmadığı anlamına gelir.

**unpriced\_postage\_legs** `string[]`

Tarifenin ülke bazında fiyatlandırdığı ancak bu ülke için fiyatı olmayan etaplar (`out`, `back`). Bunlar
sabit posta ücretine veya tarifede yoksa 0'a düşer. Her etabın fiyatı bulunduğunda
boştur.

**positions** `object[]`

Fiyat dökümündeki pozisyonlar. Pozisyon, tek bir fiyata sahip bir biyobelirteç kümesidir. `id`, `name`,
`price_cents`, `retail_cents` ve `tier` alanlarını içerir. Aniva'nın henüz yayınlamadığı bir pozisyon için `id` ve `name`
`null` olur.

**panels** `object[]`

`id`, `name`, `price_cents` ve `retail_cents` alanlarıyla fiyat dökümündeki paneller.

**biomarkers** `object[]`

Alacağın her biyobelirteç için bir satır. Buna bir oranın bileşenleri ve bir pozisyonun her üyesi
dahildir.

**biyobelirteç satırı**

**id** `number`

Biyobelirteç ID'si.

**name** `string`

Biyobelirteç adı.

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

Yanında `retail_cents` ile birlikte bu satırın fiyatı. Bir pozisyon veya panel bunu karşıladığında
`0` olur.

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

Bu biyobelirtece ihtiyaç duyan oranlar. Bunun için yalnızca bir kez ödeme yaparsın.

**requires** `number[]`

Yalnızca bir oranda bulunur: hesaplandığı biyobelirteçler.

**via\_position** `string | null`

Bu satırı karşılayan pozisyon. Pozisyon henüz yayınlanmadıysa `null` olur.

## Hata yanıtları

| Durum | Açıklama |
| - | - |
| `400` | İstek gövdesi geçersiz veya anahtarın bu `rate_card` değerini kullanmaya yetkili değil. |
| `400` | Bir `home_kit` teklifi tam olarak bir panel, evde test kiti olarak satılan bir panel ve bir ülke kodu gerektirir. |
| `400` | `biomarker_not_available`: anahtarının kullanabileceği hiçbir laboratuvar bu biyobelirteci çalışmıyor. |
| `400` | `biomarker_not_priced`: biyobelirtecin fiyatı yok. |
| `400` | `biomarker_requires_position`: biyobelirteç yalnızca bir pozisyon içinde satılıyor. Gövde, pozisyonları listeler. |
| `403` | API anahtarında `prices_view` kapsamı yok. |
| `404` | `Panels not found`: panel mevcut değil veya anahtarın bunu listeleyemiyor. |
| `404` | `Biomarkers not found`: biyobelirteç mevcut değil. |
| `500` | İç sunucu hatası. |

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/pricing/quote \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "biomarker_ids": [63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 204, 206, 207, 209, 249]
  }'
```

```bash cURL (home kit) theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/pricing/quote \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "panel_ids": ["4d0423c5-6538-48f6-ac93-435f61e456e9"],
    "fulfilment": "home_kit",
    "country_code": "DE"
  }'
```

```json 200 theme={null}
{
  "total_cents": 210,
  "retail_total_cents": 451,
  "fees": {
    "phlebotomy_fee_cents": 2500,
    "logistics_fee_cents": 2000,
    "material_fee_cents": 250
  },
  "total_with_fees_cents": 4960,
  "fulfilment": { "kind": "draw" },
  "positions": [
    { "id": null, "name": null, "price_cents": 210, "retail_cents": 451, "tier": "routine" }
  ],
  "panels": [],
  "biomarkers": [
    { "id": 63, "name": "Eosinophils", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 64, "name": "Lymphocytes", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 65, "name": "Neutrophils", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 66, "name": "Monocytes", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 67, "name": "White Blood Cells (WBC)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 68, "name": "Basophils", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 69, "name": "Hematocrit", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 70, "name": "Red Blood Cells (RBC)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 71, "name": "Hemoglobin", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 72, "name": "Platelets", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 73, "name": "Mean Corpuscular Hemoglobin Concentration (MCHC)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 74, "name": "Mean Corpuscular Volume (MCV)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 75, "name": "Red Cell Distribution Width (RDW)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 76, "name": "Mean Corpuscular Hemoglobin (MCH)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 204, "name": "Lymphocytes (%)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 206, "name": "Eosinophils (%)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 207, "name": "Basophils (%)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 209, "name": "Monocytes (%)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 249, "name": "Neutrophils (%)", "price_cents": 0, "retail_cents": 0, "via_position": null }
  ]
}
```

```json 200 (home kit) theme={null}
{
  "total_cents": 2081,
  "retail_total_cents": 6702,
  "fees": {
    "phlebotomy_fee_cents": 2000,
    "logistics_fee_cents": 2000,
    "material_fee_cents": 0
  },
  "total_with_fees_cents": 4971,
  "fulfilment": {
    "kind": "home_kit",
    "country_code": "DE",
    "kit_ref": "TAS-1-1S1E",
    "devices": 1,
    "lines": [
      { "description": "Home kit (per order)", "quantity": 1, "unit": "kits", "unit_cents": 720, "amount_cents": 720 },
      { "description": "Collection device (per device)", "quantity": 1, "unit": "devices", "unit_cents": 1250, "amount_cents": 1250 },
      { "description": "Postage to the customer (per kit sent)", "quantity": 1, "unit": "kits sent", "unit_cents": 370, "amount_cents": 370 },
      { "description": "Return postage (per kit sent)", "quantity": 1, "unit": "kits sent", "unit_cents": 400, "amount_cents": 400 },
      { "description": "Spare lancet bag (per kit sent with one)", "quantity": 1, "unit": "bags", "unit_cents": 150, "amount_cents": 150 }
    ],
    "total_cents": 2890,
    "activation_fee_cents": 100,
    "unpriced_postage_legs": []
  },
  "positions": [],
  "panels": [
    { "id": "4d0423c5-6538-48f6-ac93-435f61e456e9", "name": "Doctrinus - Gesundheitsprofil 6 (Männer)", "price_cents": 2081, "retail_cents": 6702 }
  ],
  "biomarkers": []
}
```

```json 404 theme={null}
{
  "error": "Panels not found: f1c2d4a3-7b8e-4f2a-9c1d-2e3f4a5b6c7d"
}
```


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