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

# Evde test kiti siparişi oluştur

> Bir profil için eve postalanan kendin yap test kiti talep et

Bir hasta profili için evde test kiti siparişi talep et. Evde test kiti siparişi, eve gönderilen ve kişinin kendisinin uyguladığı bir test kiti gönderir — Aniva kiti teslimat adresine kargolar, hasta evde örneğini kendisi alır ve postayla geri gönderir. Bu, bir test noktasında damardan kan alma işlemi olan [randevudan](https://docs.anivahealth.com/tr/api/appointments/create-appointment.md) farklıdır.

**Tam olarak bir panel gereklidir.** Evde test kiti fiziksel bir kit ürünüyle 1:1 eşleşir — panelin kendisi kittir — ve sipariş oluşturulduğu anda paketleme kuyruğuna alınır, bu yüzden içeriğin baştan kesin olması gerekir. Sipariş `pending` durumundayken [Evde test kiti siparişini güncelle](https://docs.anivahealth.com/tr/api/home-kit-orders/update-home-kit.md) üzerinden paneli yine de değiştirebilirsin.

## Yedek kitler

Bir kit sonuçlarını veremediğinde — hasta tüpü dolduramamışsa, örnek yetersiz materyalle ulaşmışsa, laboratuvar örneği analiz edememişse — `replaces_home_kit_order_id` göndererek bir **yedek kit** sipariş et.

Yedek kit, ilk kit hiç etkinleştirilmemiş olsa bile yeni bir laboratuvar kodu içeren yeni bir sipariştir: laboratuvarın yeni bir talebe ihtiyacı vardır ve aynı kod altındaki iki örnek birbirinden ayırt edilemez. Yerine sipariş verdiğin siparişe dokunulmaz — kendi durumunu, kendi laboratuvar kodunu ve altına daha önce işlenmiş tüm sonuçları korur.

Bundan iki sonuç çıkar:

* **Panel devralınır.** `panel_id` alanını göndermezsen yedek kit, yerine geçtiği siparişin panelini taşır; hastanın satın aldığı ve kutunun markalandığı panel budur.
* **Neyin yeniden çalışılacağını sen seçersin.** Sonuç alınamayan belirteçlerle birlikte `biomarker_ids` gönderirsen laboratuvar yalnızca bunları yeniden çalışır, böylece kit sadece gereken tüplerle gönderilir. Tüm paneli yeniden çalışmak için bu alanı gönderme.

Belirteçler tek tek değil, panelin grupları halinde yeniden çalışılır. Bir gruptan tek bir belirteç belirtildiğinde o grubun tamamı yeniden çalışılır; çünkü istenenden fazlasını raporlayan bir laboratuvar siparişi verilemez. Tek belirteçli bir yedek kit bu nedenle birden fazla sonuçla gelebilir ve tüp sayısı belirteç listesinin düşündürdüğünden daha fazla olabilir.

Bir kit için aynı anda yalnızca bir yedek kit yolda olabilir.

> [!NOTE]
>
> Entegrasyonunu bu alanlar eklenmeden önce yaptıysan Aniva, sipariş oluştururken `metadata.original_kit_id` ve
> `metadata.replacement_reason` alanlarını da okur ve siparişi yedek kit olarak değerlendirir. Metadata'nın
> yorumlandığı tek yer burasıdır, yalnızca bu eski entegrasyonu sürdürmek için vardır ve yukarıdaki
> alanlar her zaman önceliklidir. Bu alanları gönder.

`201` yanıtı, siparişin kesinleştiği ve sipariş karşılama sürecine aktarılacağı anlamına gelir — kitin paketlenip kargolanması için başka bir şey yapmana gerek yok.

`home_kit_orders_manage` kapsamını gerektirir.

Bu oluşturma işlemini güvenle yeniden denenebilir kılmak için isteğe bağlı bir `Idempotency-Key` başlığı gönder — aynı anahtarın tekrarı ikincisini oluşturmak yerine ilk yanıtı döndürür. [İdempotans](https://docs.anivahealth.com/tr/concepts/idempotency.md) bölümüne bak.

## İstek

### Gövde parametreleri

**profile\_id** `string` *required*

Evde test kiti siparişinin oluşturulacağı hasta profilinin UUID'si.

**panel\_id** `string` *required*

Sipariş edilecek katalog panelinin UUID'si. Tam olarak bir tane — evde test kiti fiziksel bir kit ürünüyle
1:1 eşleşir, yani panelin kendisi kittir. Panel ID'leri iş ortağı hesabın için Aniva tarafından sağlanır;
[Panelleri listele](https://docs.anivahealth.com/tr/api/panels/list-panels.md) sayfasına bak. Yedek kit siparişinde isteğe bağlıdır;
gönderilmediğinde yerine geçtiği siparişin paneli kullanılır.

**replaces\_home\_kit\_order\_id** `string`

Bu siparişin yerine geçtiği evde test kiti siparişinin UUID'si. Bunu göndermek siparişi bir yedek kit
yapar — yukarıdaki [Yedek kitler](#yedek-kitler) bölümüne bak. Sipariş aynı profile ait olmalı ve
halihazırda yolda bir yedek kiti olmamalıdır.

**replacement\_reason** `string`

Yedek kitin neden gerektiği, tek cümlede (örneğin `Zu wenig Material, HbA1c nicht
    auswertbar`). `replaces_home_kit_order_id` gönderdiğinde zorunludur, aksi halde yok sayılır. En fazla
500 karakter.

**biomarker\_ids** `integer[]`

Yedek kit siparişinde laboratuvarın yeniden çalışacağı belirteçler — genellikle ilk kitin sonuç
veremediği belirteçlerdir. Her biri yerine geçtiği siparişin istediği belirteçlerin bir parçası olmalıdır;
`home_kit=true` parametresiyle [Biyobelirteçleri listele](https://docs.anivahealth.com/tr/api/biomarkers/list-biomarkers.md) üzerinden kontrol et.
Tüm paneli yeniden çalışmak için bu alanı gönderme. Yalnızca `replaces_home_kit_order_id` ile birlikte kabul edilir,
farklı bir `panel_id` ile birlikte kabul edilmez.
Bunun için ek bir kapsam gerekmez: hastanın zaten ödemesini yaptığı belirteçleri yeniden çalışmak tekil bir
seçim değildir.

**metadata** `object`

Her okumada olduğu gibi geri döndürülen ve Aniva tarafından hiçbir zaman yorumlanmayan kendi anahtar/değer
çiftlerin. Bizim ID'lerimizi saklamadan eşleştirme yapabilmek için kendi sipariş referansını taşımak üzere kullan.
En fazla 20 anahtar; anahtarlar `[A-Za-z0-9_-]` ile eşleşmeli ve en fazla 40 karakter olmalıdır; değerler metin,
sayı veya boolean olabilir ve metinler en fazla 500 karakterdir; serileştirilmiş toplam boyut en fazla
16.384 bayttır. `aniva_` ile başlayan anahtarlar ayrılmıştır. `metadata` içine asla kişisel veya klinik veri
koyma — hasta verisi olarak işlenmez.

**results\_ready\_emails** `string[]`

Tüm laboratuvar sonuçları kesinleştiğinde her biri bir e-posta alacak en fazla 5 adres. E-posta,
Aniva yönetim panelindeki sonuç sayfasına yönlendirir. Anahtarının hasta için `results_view`
erişimine sahip olması gerekir, aksi halde `403` döner. Hastanın grubu için ayarlanan varsayılan
adresleri kullanmak için bu alanı gönderme. Boş bir liste e-postaları kapatır.
[Sonuçlar hazır e-postaları](https://docs.anivahealth.com/tr/concepts/results.md#sonuclar-hazir-e-postalari) bölümüne bak.

**delivery\_address** `object` *required*

Kitin postalanacağı adres — iki biçimden biri olabilir: bilinen bir test noktasına referans veren `{ location_id }` ya da satır içi adres alanları (`name`, `street`, `city`, `postal_code`, `country_code`; `company_name` / `house_number` / `address_line_2` / `state` / `phone` / `email` isteğe bağlı — konumlar API'siyle aynı alan adları). Tam olarak birini ver — ya konum referansı ya da satır içi adres, ikisini birden değil.

**teslimat adresi**

> [tab] Konuma referans ver
>
> **location\_id** `string` *required*
>
> Kitin kargolanacağı bilinen bir test noktasının UUID'si. [Konumları
> listele](https://docs.anivahealth.com/tr/api/locations/list-locations.md) ile eşleştir.

> [tab] Satır içi adres
>
> **name** `string` *required*
>
> Alıcı, şirket veya konum adı.
>
> **company\_name** `string`
>
> Paketi alıcı adına teslim alan şirket — `c/o` alıcısı veya bir departman.
>
> **street** `string` *required*
>
> Bina numarası olmadan sokak adı (ör. `Wilhelmstraße`).
>
> **house\_number** `string`
>
> Bina numarası (ör. `118` veya `12a`).
>
> **address\_line\_2** `string`
>
> Bina, giriş veya kat.
>
> **city** `string` *required*
>
> **state** `string`
>
> Eyalet veya il. İsteğe bağlı.
>
> **postal\_code** `string` *required*
>
> Posta kodu. Almanya adresi (`country_code` `DE`) tam olarak 5 haneli olmalıdır, ör. `10117`.
>
> **country\_code** `string` *required*
>
> ISO 3166-1 alpha-2 kodu (iki harf, ör. `DE`). Küçük harf kabul edilir ve büyük harf olarak
> saklanır.
>
> **phone** `string`
>
> Alıcının ülke kodlu telefon numarası (ör. `+4791234567`). Kargo firması bunu alıcıya
> paket hakkında bilgi vermek için kullanır, örneğin paketin teslim alma noktasında beklediğini bildirmek için.
> Göndermezsen kargo firmasına telefon numarası iletilmez.
>
> **email** `string`
>
> Alıcının e-posta adresi. Kargo firması bunu `phone` gibi kullanır. Göndermezsen kargo firmasına
> e-posta iletilmez.

> [!NOTE]
>
> **Packstation veya Postfiliale (yalnızca Almanya):** `street` alanını `Packstation` veya `Postfiliale`,
> `house_number` alanını üç haneli istasyon numarası ve `address_line_2` alanını alıcının DHL
> Postnummer bilgisi (6–10 hane, boşluk kullanılabilir) olarak ayarla. Postnummer olmadan paket için kargo
> kaydı oluşturulamaz. Postfach desteklenmez.

## Yanıt

İşlem başarılı olduğunda API, yeni evde test kiti siparişiyle birlikte `201 Created` yanıtını döndürür.

**id** `string` *required*

Benzersiz evde test kiti siparişi kimliği (UUID).

**profile\_id** `string` *required*

Bu evde test kiti siparişinin ait olduğu profilin UUID'si.

**status** `string` *required*

Mevcut evde test kiti sipariş durumu. `pending`, `dispatched`, `activated` veya `cancelled` değerlerinden
biri. Yeni oluşturulan bir sipariş `pending` durumunda başlar.

**delivery\_address** `object` *required*

Kitin postalanacağı adres — iki biçimden biri: bilinen bir test konumuna referans veren `{ location_id }` veya satır içi adres alanları (`name`, `street`, `city`, `postal_code`, `country_code`; `company_name` / `house_number` / `address_line_2` / `state` / `phone` / `email` isteğe bağlı — konumlar API'siyle aynı terminoloji). Tam olarak birini belirt — konum referansı veya satır içi adres, ikisi birden değil.

**teslimat adresi**

> [tab] Konum referansı
>
> **location\_id** `string` *required*
>
> Kitin gönderileceği test konumunun UUID'si.

> [tab] Satır içi adres
>
> **name** `string` *required*
>
> Alıcı, şirket veya konum adı.
>
> **company\_name** `string`
>
> Alıcı adına paketi teslim alan şirket — bir `c/o` tarafı veya departman.
>
> **street** `string` *required*
>
> Kapı numarası olmadan cadde/sokak adı (örn. `Wilhelmstraße`).
>
> **house\_number** `string`
>
> Kapı numarası (örn. `118` veya `12a`).
>
> **address\_line\_2** `string`
>
> Bina, giriş veya kat.
>
> **city** `string` *required*
>
> **state** `string`
>
> Eyalet veya il. İsteğe bağlı.
>
> **postal\_code** `string` *required*
>
> **country\_code** `string` *required*
>
> ISO 3166-1 alpha-2 kodu (iki harf, örn. `DE`).
>
> **phone** `string`
>
> **email** `string`

**metadata** `object` *required*

Sağladığın anahtar/değer çiftleri. Her zaman bulunur — hiç ayarlamadığında `{}` olur.

**replaces\_home\_kit\_order\_id** `string`

Bu siparişin yerine geçtiği evde test kiti siparişi. Normal bir siparişte `null` olur.

**replacement\_reason** `string`

Sağladığın gerekçe. Normal bir siparişte `null` olur.

**results\_ready\_emails** `string[]` *required*

Tüm laboratuvar sonuçları kesinleştiğinde her birine bir e-posta gönderilen, küçük harfe çevrilmiş adresler. Kapalıyken boştur. Bkz.
[Sonuçlar hazır e-postaları](https://docs.anivahealth.com/tr/concepts/results.md#sonuclar-hazir-e-postalari).

**lab\_code** `string`

Sonuçların altında raporlandığı laboratuvar örnek kodu — fiziksel kitin üzerinde basılıdır ve
hastanın kutudan etkinleştirme kodu olarak okuduğu koddur. Kit paketlenene kadar `null`.
Salt okunur.

**activated\_at** `string` *required*

[Etkinleştir](https://docs.anivahealth.com/tr/api/home-kit-orders/activate-home-kit.md) üzerinden bildirilen örnek alma zaman damgası.
Kit etkinleştirilene kadar `null` olur.

**created\_at** `string` *required*

Evde test kiti siparişinin oluşturulduğu zamanın ISO 8601 zaman damgası.

**updated\_at** `string`

Son güncellemenin ISO 8601 zaman damgası. `null` olabilir.

**profile** `object` *required*

Bu evde test kiti siparişiyle ilişkili hasta profili.

**profil**

**id** `string`

Benzersiz profil tanımlayıcısı (UUID).

**handle** `string`

Profil rumuzu veya kullanıcı adı. `null` olabilir.

**first\_name** `string`

Ad. `null` olabilir.

**last\_name** `string`

Soyad. `null` olabilir.

**email** `string`

E-posta adresi. `null` olabilir.

**phone** `string`

E.164 biçiminde telefon numarası. `null` olabilir.

**sex** `integer`

ISO/IEC 5218 standardına göre biyolojik cinsiyet. `null` olabilir.

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

`YYYY-MM-DD` biçiminde doğum tarihi. `null` olabilir.

**height** `number`

Santimetre cinsinden boy. `null` olabilir.

**weight** `number`

Kilogram cinsinden kilo. `null` olabilir.

**language** `string`

Tercih edilen dil: [Profil oluştur](https://docs.anivahealth.com/tr/api/profiles/create-profile.md) sayfasındaki 32 koddan biri.

**transactional\_emails\_enabled** `boolean`

Bu profilin işlemsel (programatik) e-postalar alıp almadığı. `null` olabilir.

**created\_at** `string`

Profilin oluşturulduğu zamanın ISO 8601 zaman damgası.

**updated\_at** `string`

Son profil güncellemesinin ISO 8601 zaman damgası. `null` olabilir.

**panels** `HomeKitOrderPanel[]` *required*

Bu evde test kiti siparişine bağlı panel — `panel_id` olarak sağladığın ve siparişin oluşturulma zamanıyla
damgalanmış panel. Her zaman tam olarak bir tane. Panel ayrıntılarına (ad, biyobelirteçler)
[Panelleri listele](https://docs.anivahealth.com/tr/api/panels/list-panels.md) üzerinden bak.

**Panel ekleme alanları**

**panel\_id** `string`

Panel UUID'si — [Panelleri listele](https://docs.anivahealth.com/tr/api/panels/list-panels.md) ile karşılaştır.

**added\_at** `string`

Panelin bu evde test kiti siparişine ilk eklendiği zamanın ISO 8601 zaman damgası.

**individual\_biomarkers** `HomeKitOrderIndividualBiomarker[]` *required*

Panel dışında eklenen biyobelirteçler. Normal bir oluşturma işleminde boştur — evde test kiti siparişleri
panel bazında verilir ve bu listeyi sonradan değiştirmek
`home_kit_orders_individual_biomarker_selection` yetki kapsamını gerektirir. Yedek kit siparişinde,
gönderdiğin ve laboratuvarın yeniden çalışacağı `biomarker_ids` değerlerini tutar.

**Tekil biyobelirteç alanları**

**biomarker\_id** `integer`

Biyobelirteç kimliği — `home_kit=true` ile
[Biyobelirteçleri listele](https://docs.anivahealth.com/tr/api/biomarkers/list-biomarkers.md) üzerinden karşılaştır.

**added\_at** `string`

Biyobelirtecin bu evde test kiti siparişine ilk eklendiği zamanın ISO 8601 zaman damgası.

**shipments** `HomeKitOrderShipmentLink[]` *required*

Bu evde test kiti siparişine bağlı paketler, en eski bağlantı ilk sırada olacak şekilde. Oluşturma sırasında
her zaman boştur — tüm paket bilgilerini [Gönderileri listele](https://docs.anivahealth.com/tr/api/shipments/list-shipments.md) ve
`?home_kit_order_id=` ile oku.

**Gönderi bağlantısı alanları**

**id** `string`

Gönderi referansı — [Gönderiyi al](https://docs.anivahealth.com/tr/api/shipments/get-shipment.md) ile karşılaştır.

**added\_at** `string`

Gönderinin bu evde test kiti siparişine bağlandığı zamanın ISO 8601 zaman damgası.

## Hata yanıtları

| Durum | Açıklama |
| - | - |
| `400` | Doğrulama hatası — ör. `delivery_address` içinde bir alan eksik veya Almanya posta kodu 5 haneli değil, `panel_id` geçerli bir UUID değil ya da yedek kit siparişinde `replacement_reason` eksik. |
| `403` | Erişim reddedildi — API anahtarının bu işleme erişimi yok, profil yetki kapsamının dışında ya da hasta için `results_view` erişimin olmadan `results_ready_emails` ayarladın. |
| `404` | Profil, panel veya yerine sipariş verilecek evde test kiti siparişi bulunamadı. |
| `409` | Çakışma — `Idempotency-Key` daha önce farklı bir gövdeyle kullanılmış, ilk isteği henüz tamamlanmamış veya yerine sipariş verdiğin kitin zaten yolda bir yedek kiti var. |
| `422` | Panel evde test kiti olarak sipariş edilemez — bunun için yapılandırılmış bir sipariş karşılama kit ürünü yok. Yedek kit siparişinde: yerine sipariş verdiğin sipariş başka bir profile ait, bir `biomarker_ids` girdisi ilk siparişin istediklerinin parçası değil ya da farklı bir `panel_id` ile birlikte belirteç gönderdin. |
| `500` | Dahili sunucu hatası. |

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/home-kit-orders \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "profile_id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
    "panel_id": "f1c2d4a3-7b8e-4f2a-9c1d-2e3f4a5b6c7d",
    "metadata": { "your_order_ref": "ORD-10482", "priority": true },
    "delivery_address": {
      "name": "Maria Schmidt",
      "company_name": "c/o Weber",
      "street": "Friedrichstraße",
      "house_number": "123",
      "postal_code": "10117",
      "city": "Berlin",
      "country_code": "DE",
      "phone": "+4930123456789",
      "email": "maria.schmidt@example.com"
    }
  }'
```

```bash Replacement kit theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/home-kit-orders \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "profile_id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
    "replaces_home_kit_order_id": "d1e2f3a4-5b6c-4d7e-8f9a-0b1c2d3e4f5a",
    "replacement_reason": "Too little material, HbA1c could not be analysed",
    "biomarker_ids": [103],
    "metadata": { "your_order_ref": "ORD-10482-R1" },
    "delivery_address": {
      "name": "Maria Schmidt",
      "street": "Friedrichstraße",
      "house_number": "123",
      "postal_code": "10117",
      "city": "Berlin",
      "country_code": "DE"
    }
  }'
```

```json 201 theme={null}
{
  "id": "d1e2f3a4-5b6c-4d7e-8f9a-0b1c2d3e4f5a",
  "profile_id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
  "status": "pending",
  "delivery_address": {
    "name": "Maria Schmidt",
    "company_name": "c/o Weber",
    "address_line_2": null,
    "street": "Friedrichstraße",
    "house_number": "123",
    "postal_code": "10117",
    "city": "Berlin",
    "country_code": "DE",
    "phone": "+4930123456789",
    "email": "maria.schmidt@example.com"
  },
  "created_at": "2026-04-01T09:45:00Z",
  "updated_at": null,
  "profile": {
    "id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
    "handle": null,
    "first_name": "Maria",
    "last_name": "Schmidt",
    "email": "maria.schmidt@example.com",
    "phone": "+4930123456789",
    "sex": 2,
    "date_of_birth": "1985-03-22",
    "height": 168,
    "weight": 65,
    "language": "de",
    "transactional_emails_enabled": true,
    "created_at": "2026-04-01T09:14:32Z",
    "updated_at": null
  },
  "panels": [
    {
      "panel_id": "f1c2d4a3-7b8e-4f2a-9c1d-2e3f4a5b6c7d",
      "added_at": "2026-04-01T09:45:00Z"
    }
  ],
  "individual_biomarkers": [],
  "metadata": { "your_order_ref": "ORD-10482", "priority": true },
  "replaces_home_kit_order_id": null,
  "replacement_reason": null,
  "results_ready_emails": [],
  "lab_code": null,
  "activated_at": null,
  "shipments": []
}
```

```json 400 theme={null}
{
  "error": "panel_id: panel_id must be a valid UUID"
}
```

```json 404 theme={null}
{
  "error": "Profile not found"
}
```

```json 409 theme={null}
{
  "error": "Idempotency-Key \"ORD-10482\" was already used with a different request body. Use a new key for a different request, or resend the original body to read back its result."
}
```


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