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

# Kan almayı onayla

> Kan alındığını kaydet ve laboratuvar siparişi akışını tetikle

Bir kan almanın tamamlandığını kaydet ve laboratuvar sipariş akışını tetikle. Fiziksel örnekleri randevuya bağlamak için kan alma kitindeki laboratuvar kodlarını (tüp barkodlarını) gönder.

Bir kan alma, kodlarını iki yoldan biriyle taşır:

* **Tüm kan alma için tek kod** — aynı barkodun her tüpe basıldığı venöz kan alma. Bunu `lab_code` olarak gönder.
* **Mikrotüp başına bir kod** — her mikrotüpün kendi barkoduna sahip olduğu kapiler kan alma. Bunları `lab_codes` olarak, mikrotüpün içerdiği `panel_ids` değerleriyle birlikte her kod için bir giriş olacak şekilde gönder. Her kod kendi laboratuvar istemi olur — tüpün üzerindeki barkod laboratuvarın sipariş numarasıdır. `panel_ids` içermeyen bir giriş, başka bir yerde belirtilmeyen tüm paneller için genel giriştir. Venöz kan almada en fazla bir tane bulunur.

İkisinden tam olarak birini gönder. Eklenen her panel tam olarak bir kodun altında yer almalıdır (kendi girişi veya genel giriş). Venöz kan almada tekil biyobelirteçler için genel giriş gerekir. Kapiler kan almada her paneli kendi mikrotüpünün kodunda belirt. Tekil biyobelirteçler panel mikrotüplerindeki boş alanı doldurur ve yalnızca gerektiğinde yeni mikrotüpler açar. Bunları eşit olarak dağıtırız. Her mikrotüp bunlardan en fazla 150 µl alır. Kendi başlarına ihtiyaç duydukları her mikrotüp için `panel_ids` içermeyen bir giriş gönder, daha fazlasını değil. Hiç paneli ve biyobelirteci kalmayan bir kod `409` ve `reason: "panel_coverage"` ile reddedilir. Herhangi bir şey yazılmadan önce her kod doğrulanır; herhangi bir kod kullanılamazsa veya bir panel kapsam dışı kalırsa hiçbir şey kaydedilmez ve yanıt sorunu belirtir.

`appointments_schedule`, `appointments_manage` veya `appointments_operate` kapsamını gerektirir.

> [!WARNING]
>
> Bu işlem geri alınamaz. Kan almayı onayladığında randevu kilitlenir — panel ekleme
> dahil başka hiçbir değişiklik yapılamaz.

## İstek

### Yol parametreleri

**id** `string` *required*

Onaylanacak randevunun benzersiz tanımlayıcısı (UUID).

### Gövde parametreleri

**lab\_code** `string`

Tek bir kod tüm tüpleri kapsadığında kan alma kitine basılı olan sayısal laboratuvar kodu. `lab_codes`
ile birlikte kullanılamaz.

**lab\_codes** `object[]`

Kan almanın tarama sırasına göre tüm laboratuvar kodları (en az bir giriş). `lab_code` ile birlikte kullanılamaz. Bir
kod yalnızca bir kez yer alabilir; bir panel yalnızca tek bir girişte belirtilebilir.

**laboratuvar kodu girişi**

**lab\_code** `string` *required*

Bu panellerin tüplerine basılı sayısal laboratuvar kodu.

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

Tüpleri bu kodu taşıyan ekli paneller — randevunun `panels` alanındaki
`panel_id` değerleri. Başka bir yerde belirtilmeyen tüm panelleri ve tekil biyobelirteçleri kapsayan
genel giriş için bu alanı atla veya `[]` gönder. Venöz kan almada en fazla bir genel giriş bulunur. Kapiler kan almada bir genel giriş
yalnızca tekil biyobelirteçleri içerir ve ihtiyaç duydukları her mikrotüp için bir tane gönderirsin.

## Yanıt

Başarılı olduğunda API, laboratuvar sipariş akışının tetiklendiğini onaylayan `200 OK` yanıtı döndürür.

**success** `boolean`

Kan alma kaydedildiğinde ve laboratuvar siparişi akışı tetiklendiğinde `true`.

**warning** `string`

Yalnızca kan alma, randevu gününden farklı bir günde kaydedildiğinde bulunur. Standart anahtarlar
bunu yapamaz — `reason: "appointment_not_today"` ile `409` alırlar. Randevuyu kan alma gününe
yeniden planla, ardından onayla.

Kaydedilen kodlar [Randevuyu getir](https://docs.anivahealth.com/tr/api/appointments/get-appointment.md) içinde `lab_codes` olarak döner ve [Sonuçları getir](https://docs.anivahealth.com/tr/api/appointments/get-results.md) içindeki her sonuç ve belge, kaydedildiği `lab_code` değerini taşır.

## Hata yanıtları

| Durum | Açıklama |
| - | - |
| `400` | Doğrulama hatası — `lab_code` ve `lab_codes` alanlarının hiçbiri veya her ikisi birden verilmiş, bir kod sayısal değil ya da bir kod veya panel tekrarlanmış. |
| `403` | Erişim reddedildi — API anahtarının bu işleme erişimi yok. |
| `404` | Randevu bulunamadı. |
| `409` | Bir kod kullanılamıyor (`reason`: `unregistered`, `already_assigned`, `home_kit_code`, `location_unknown`, `cross_location`), bir panel kodsuz kalmış, bir `panel_id` bağlı değil, venöz bir kan almada `panel_ids` olmadan iki kayıt var, kapiler bir kan almada mikrotüp sayısından fazla kayıt ya da yalnızca belirteçli mikrotüp sayısından fazla `panel_ids` içermeyen kayıt var veya bir kapiler kod kendi mikrotüpleriyle eşleşmiyor (tümü `panel_coverage`), sıfırlamadan önce kaydedilmiş bir kod artık başka panelleri belirtiyor (`remapped`) veya laboratuvar siparişini tutuyor olabileceğinden bu kan almada kalması gerekiyor (`sent_to_lab`, `order_in_flight`), bir kod randevuda planlanmamış bir paneli belirtiyor (`unknown_panel`) ya da randevu onaylanabilir durumda değil (`appointment_cancelled`, `appointment_already_drawn`, `appointment_not_ready`, `appointment_not_today`). Sorun belirli bir koddan kaynaklanıyorsa `lab_code` bu kodu belirtir. |
| `500` | İç sunucu hatası. |

```bash cURL (one code, every tube) theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a/confirm \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "lab_code": "7642001234"
  }'
```

```bash cURL (one code per panel) theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a/confirm \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "lab_codes": [
      { "lab_code": "7642001234", "panel_ids": ["f1c2d4a3-7b8e-4f2a-9c1d-2e3f4a5b6c7d"] },
      { "lab_code": "7642001235", "panel_ids": ["0a9b8c7d-6e5f-4a3b-2c1d-0e9f8a7b6c5d"] }
    ]
  }'
```

```json 200 theme={null}
{
  "success": true
}
```

```json 400 theme={null}
{
  "error": "lab_codes: Provide exactly one of `lab_code` or `lab_codes`"
}
```

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

```json 409 theme={null}
{
  "error": "This barcode has already been assigned to another patient. Please use a different tube.",
  "reason": "already_assigned",
  "lab_code": "7642001235"
}
```

```json 409 (capillary empty code) theme={null}
{
  "error": "Barcode 7642001236 carries no panel and no biomarker.",
  "reason": "panel_coverage",
  "lab_code": null
}
```

```json 409 (cancelled) theme={null}
{
  "error": "This appointment was cancelled, so a blood draw can’t be recorded for it. Reactivate the appointment first if this is a mistake.",
  "reason": "appointment_cancelled",
  "lab_code": "7642001234"
}
```

```json 409 (wrong day) theme={null}
{
  "error": "Recording a blood draw is only available on the appointment day (Oct 13, 2026). Reschedule the appointment to today, then confirm.",
  "reason": "appointment_not_today",
  "lab_code": null
}
```


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