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

# Potwierdź pobranie krwi

> Przewodnik krok po kroku: zarejestruj pobranie krwi w API Aniva i wyślij próbkę do kolejki zleceń laboratoryjnych.

Użyj tego przewodnika, aby potwierdzić, że pobranie krwi się odbyło. Potwierdzenie zapisuje kody laboratoryjne (kody kreskowe probówek) fizycznego zestawu i uruchamia proces zleceń laboratoryjnych; postęp wyników odczytasz następnie w [Pobierz wyniki](https://docs.anivahealth.com/pl/api/appointments/get-results.md).

> [!WARNING]
>
> Potwierdzenie jest **nieodwracalne**. Gdy potwierdzisz pobranie krwi, nie będzie można wprowadzać
> żadnych dalszych zmian w wizycie — w tym dodawać paneli. Upewnij się, że wszystkie panele są
> dołączone, a wszystkie dane są poprawne, zanim przejdziesz dalej.

**1. Upewnij się, że panele są dodane**

Przed potwierdzeniem sprawdź, czy wszystkie potrzebne panele badań zostały dodane do wizyty. Po potwierdzeniu nie możesz dodać paneli.

Sprawdź przewodnik [Zaplanuj wizytę](https://docs.anivahealth.com/pl/guides/schedule-appointment.md), aby zobaczyć instrukcje dołączania paneli.

Potwierdź poniższe punkty, zanim przejdziesz dalej:

* Wszystkie wymagane panele są dołączone do wizyty.
* Pola `profile_id` i `location_id` w wizycie są poprawne.
* Pacjent zakończył pobranie krwi, a kod kreskowy każdej probówki jest pod ręką.

**2. Potwierdź pobranie krwi**

Wyślij żądanie `POST` do `/api/v1/appointments/{id}/confirm` z kodami laboratoryjnymi z fizycznego zestawu do pobrania krwi. Pobranie żylne ma jeden kod wydrukowany na każdej probówce — wyślij go jako `lab_code`. Pobranie w aptece ma jeden kod na każdą mikroprobówkę — wyślij je jako `lab_codes`, jeden wpis na kod wraz z `panel_ids`, które zawiera dana mikroprobówka (z pola `panels` wizyty); każdy kod staje się osobnym zleceniem laboratoryjnym. Pojedyncze biomarkery w aptece wypełniają najpierw wolne miejsce w mikroprobówkach paneli. Wyślij jeden wpis bez `panel_ids` dla każdej mikroprobówki, której potrzebują osobno.

> [!WARNING]
>
> Każdy kod musi być ciągiem cyfr wydrukowanym na fizycznej probówce przekazanej pacjentowi. Nie podstawiaj innego identyfikatora — błędny kod spowoduje niepowodzenie zlecenia laboratoryjnego. Każdy kod jest sprawdzany, zanim cokolwiek zostanie zapisane; jeśli jeden zostanie odrzucony, nic nie zostanie zapisane.

```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();
```

Udane żądanie zwraca `200 OK`:

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

**3. Sprawdź status wizyty**

Po potwierdzeniu pobierz wizytę, aby sprawdzić, czy jej status zmienił się na `blood_drawn`.

```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"
```

Gdy wizyta pokazuje `status: "blood_drawn"`, proces zleceń laboratoryjnych został uruchomiony. Sam status wizyty pozostaje od tej pory ustawiony na `blood_drawn`; bardziej szczegółowy dalszy postęp jest udostępniany przez dedykowane endpointy: sprawdź każdy wpis z zagnieżdżonej tablicy `shipments` w [Pobierz przesyłkę](https://docs.anivahealth.com/pl/api/shipments/get-shipment.md) dla zdarzeń kurierskich w drodze / dostarczono i użyj [Pobierz wyniki](https://docs.anivahealth.com/pl/api/appointments/get-results.md), aby śledzić gotowość wyników laboratoryjnych (`status: "in_progress"` → `"completed"`).

## Co dzieje się dalej

Po potwierdzeniu obsługę przejmuje proces zleceń laboratoryjnych Anivy:

1. Każdy kod laboratoryjny jest dopasowywany do swoich fizycznych probówek w laboratorium — zlecenie każdego panelu zawiera kod z własnych probówek.
2. Panele dołączone do wizyty określają, jakie badania zostaną wykonane.
3. Gdy wyniki są gotowe, zostają powiązane z profilem pacjenta i pojawiają się w
   [Pobierz wyniki](https://docs.anivahealth.com/pl/api/appointments/get-results.md) — pole `status` najwyższego poziomu w odpowiedzi
   zmienia się z `in_progress` na `completed`, gdy każde zgłoszenie zostanie zamknięte, a jedno przekaże wyniki.

Po potwierdzeniu twoja integracja nie musi podejmować żadnych dalszych działań.

## Obsługa błędów

| Status | Przyczyna | Rozwiązanie |
| - | - | - |
| `400 Bad Request` | Nie podano żadnego lub podano oba pola `lab_code` / `lab_codes`, kod nie jest numeryczny albo powtórzono kod lub panel. | Wyślij dokładnie jedno z tych dwóch pól z dokładnymi kodami numerycznymi z fizycznych probówek. |
| `409 Conflict` | Kodu nie można użyć (jest już przypisany, niezarejestrowany, należy do domowego zestawu testowego, pochodzi z innej kliniki), panel nie ma kodu albo wizyty nie można potwierdzić. | Sprawdź `reason` i `lab_code`; zeskanuj inną probówkę lub sprawdź status wizyty. |
| `403 Forbidden` | Twój klucz API nie ma dostępu do tej operacji. | Skontaktuj się z Aniva, aby potwierdzić uprawnienia swojego klucza API. |
| `404 Not Found` | ID wizyty nie istnieje lub nie należy do twojego konta. | Sprawdź, czy ID wizyty jest poprawne. |


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