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

> Adım adım rehber: Aniva API'sinde bir kan alma işlemini kaydet ve numuneyi laboratuvar siparişi akışına gönder.

Bir kan alma işleminin gerçekleştiğini onaylamak için bu kılavuzu kullan. Onay, fiziksel kitin laboratuvar kodlarını (tüp barkodlarını) kaydeder ve laboratuvar siparişi sürecini başlatır; sonuçların ilerleyişi daha sonra [Sonuçları al](https://docs.anivahealth.com/tr/api/appointments/get-results.md) üzerinden okunur.

> [!WARNING]
>
> Onay **geri alınamaz**. Bir kan alma işlemini onayladıktan sonra randevuda —
> panel eklemek dahil — başka hiçbir değişiklik yapılamaz. Devam etmeden önce tüm panellerin eklendiğinden ve
> tüm bilgilerin doğru olduğundan emin ol.

**1. Panellerin eklendiğinden emin ol**

Onaylamadan önce gerekli tüm test panellerinin randevuya eklendiğini doğrula. Onaydan sonra panel ekleyemezsin.

Panel ekleme talimatları için [Randevu planla](https://docs.anivahealth.com/tr/guides/schedule-appointment.md) kılavuzunu incele.

Devam etmeden önce aşağıdakileri doğrula:

* Gerekli tüm paneller randevuya eklendi.
* Randevudaki `profile_id` ve `location_id` değerleri doğru.
* Hasta kan alma işlemini tamamladı ve her tüpün barkodu hazır.

**2. Kan alma işlemini onayla**

Fiziksel kan alma kitindeki laboratuvar kodlarıyla `/api/v1/appointments/{id}/confirm` adresine bir `POST` isteği gönder. Venöz kan almada her tüpün üzerinde tek bir kod basılıdır — bunu `lab_code` olarak gönder. Eczanede yapılan kan almada her mikrotüp için bir kod bulunur — bunları `lab_codes` olarak, kod başına mikrotüpün içerdiği `panel_ids` değerleriyle (randevunun `panels` alanından) bir giriş şeklinde gönder; her kod kendi laboratuvar istemine dönüşür. Eczanedeki tekil biyobelirteçler önce panel mikrotüplerindeki boş alanı doldurur. Kendi başlarına ihtiyaç duydukları her mikrotüp için `panel_ids` olmadan bir giriş gönder.

> [!WARNING]
>
> Her kod, hastaya verilen fiziksel tüpün üzerinde basılı olan sayısal dize olmalıdır. Farklı bir tanımlayıcı kullanma — yanlış bir kod laboratuvar siparişinin başarısız olmasına yol açar. Herhangi bir veri yazılmadan önce her kod doğrulanır; biri reddedilirse hiçbir şey kaydedilmez.

```bash cURL (venous draw, one code) theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments/c9d4e827-3b6f-4a1c-8d2e-5f0b9c7e3a12/confirm \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "lab_code": "7642001234"
  }'
```

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

```javascript JavaScript theme={null}
const response = await fetch(
  'https://anivahealth.com/api/v1/appointments/c9d4e827-3b6f-4a1c-8d2e-5f0b9c7e3a12/confirm',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': 'YOUR_API_KEY',
    },
    body: JSON.stringify({
      lab_codes: [
        { lab_code: '7642001234', panel_ids: ['f1c2d4a3-7b8e-4f2a-9c1d-2e3f4a5b6c7d'] },
        { lab_code: '7642001235', panel_ids: ['0a9b8c7d-6e5f-4a3b-2c1d-0e9f8a7b6c5d'] },
      ],
    }),
  }
);

const result = await response.json();
```

Başarılı bir istek `200 OK` döndürür:

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

**3. Randevu durumunu doğrula**

Onaydan sonra randevuyu getirerek durumunun `blood_drawn` olarak değiştiğini doğrula.

```bash cURL theme={null}
curl --request GET \
  --url https://anivahealth.com/api/v1/appointments/c9d4e827-3b6f-4a1c-8d2e-5f0b9c7e3a12 \
  --header 'x-api-key: YOUR_API_KEY'
```

```javascript JavaScript theme={null}
const response = await fetch(
  'https://anivahealth.com/api/v1/appointments/c9d4e827-3b6f-4a1c-8d2e-5f0b9c7e3a12',
  {
    headers: {
      'x-api-key': 'YOUR_API_KEY',
    },
  }
);

const appointment = await response.json();
console.log(appointment.status); // "blood_drawn"
```

Randevuda `status: "blood_drawn"` göründüğünde laboratuvar siparişi süreci başlatılmış demektir. Randevu durumu bu noktadan itibaren `blood_drawn` olarak kalır; sonraki ayrıntılı ilerleme özel uç noktalar üzerinden sunulur: kuryenin yolda / teslim edildi olayları için satır içi `shipments` dizisindeki her girişi [Gönderiyi al](https://docs.anivahealth.com/tr/api/shipments/get-shipment.md) üzerinden takip et ve laboratuvar sonuçlarının tamamlanması (`status: "in_progress"` → `"completed"`) için [Sonuçları al](https://docs.anivahealth.com/tr/api/appointments/get-results.md) uç noktasını kullan.

## Bundan sonra ne olur

Onaydan sonra Aniva'nın laboratuvar siparişi süreci devralır:

1. Her laboratuvar kodu laboratuvarda fiziksel tüpleriyle eşleştirilir — her panelin istemi kendi tüplerindeki kodu taşır.
2. Randevuya eklenen paneller hangi testlerin yapılacağını belirler.
3. Sonuçlar hazır olduğunda hasta profiliyle ilişkilendirilir ve
   [Sonuçları al](https://docs.anivahealth.com/tr/api/appointments/get-results.md) içinde görünür — tüm gönderimler kapandığında ve biri raporlandığında
   yanıtın üst düzey `status` alanı `in_progress` durumundan `completed` durumuna geçer.

Onaydan sonra entegrasyonunun başka bir işlem yapması gerekmez.

## Hata yönetimi

| Durum | Neden | Çözüm |
| - | - | - |
| `400 Bad Request` | `lab_code` / `lab_codes` alanlarından hiçbiri verilmemiş ya da ikisi birden verilmiş, bir kod sayısal değil veya bir kod ya da panel tekrarlanmış. | İkisinden yalnızca birini, fiziksel tüplerdeki tam sayısal kodlarla gönder. |
| `409 Conflict` | Bir kod kullanılamıyor (zaten atanmış, kayıtlı değil, bir evde test kitine ait, yanlış klinik), bir panelin kodu yok veya randevu onaylanabilir durumda değil. | `reason` ve `lab_code` alanlarını oku; farklı bir tüp tara veya randevu durumunu kontrol et. |
| `403 Forbidden` | API anahtarının bu işleme erişimi yok. | API anahtarı izinlerini doğrulamak için Aniva ile iletişime geç. |
| `404 Not Found` | Randevu ID'si mevcut değil veya hesabına ait değil. | Randevu ID'sinin doğru olduğunu doğrula. |


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