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

> Zarejestruj pobranie krwi i uruchom proces zlecenia laboratoryjnego

Zarejestruj zakończenie pobrania krwi i uruchom proces zlecenia laboratoryjnego. Prześlij kody laboratoryjne (kody kreskowe probówek) z zestawu do pobrania krwi, aby powiązać fizyczne próbki z wizytą.

Pobranie krwi ma przypisane kody na jeden z dwóch sposobów:

* **Jeden kod dla całego pobrania krwi** — pobranie żylne, w którym ten sam kod kreskowy jest wydrukowany na każdej probówce. Wyślij go jako `lab_code`.
* **Jeden kod na mikroprobówkę** — pobranie włośniczkowe, w którym każda mikroprobówka ma własny kod kreskowy. Wyślij je jako `lab_codes`, po jednym wpisie na kod wraz z `panel_ids`, które zawiera dana mikroprobówka. Każdy kod staje się osobnym zleceniem laboratoryjnym — kod kreskowy na probówce to numer zlecenia w laboratorium. Wpis bez `panel_ids` jest wpisem zbiorczym dla wszystkich paneli niewymienionych w innych miejscach. Pobranie żylne może mieć co najwyżej jeden taki wpis.

Wyślij dokładnie jedną z tych dwóch opcji. Każdy przypisany panel musi trafić pod dokładnie jeden kod (własny wpis lub wpis zbiorczy). Przy pobraniu żylnym pojedyncze biomarkery wymagają wpisu zbiorczego. Przy pobraniu włośniczkowym wymień każdy panel przy kodzie jego mikroprobówki. Pojedyncze biomarkery wypełniają wolne miejsce w mikroprobówkach paneli i wymagają nowych mikroprobówek tylko wtedy, gdy jest to potrzebne. Rozdzielamy je równomiernie. Każda mikroprobówka mieści ich co najwyżej 150 µl. Wyślij po jednym wpisie bez `panel_ids` dla każdej mikroprobówki, której potrzebują wyłącznie dla siebie, i nie więcej. Kod, do którego nie trafi żaden panel ani biomarker, zostanie odrzucony z kodem `409` i `reason: "panel_coverage"`. Każdy kod jest weryfikowany przed zapisaniem czegokolwiek; jeśli któregokolwiek kodu nie da się użyć lub jakiś panel pozostanie bez pokrycia, nic nie jest zapisywane, a odpowiedź wskazuje problem.

Wymaga zakresu `appointments_schedule`, `appointments_manage` lub `appointments_operate`.

> [!WARNING]
>
> Ta operacja jest nieodwracalna. Po potwierdzeniu pobrania krwi wizyta zostaje zablokowana — żadne
> dalsze zmiany, w tym dodawanie paneli, nie są już możliwe.

## Żądanie

### Parametry ścieżki

**id** `string` *required*

Unikalny identyfikator (UUID) wizyty do potwierdzenia.

### Parametry treści

**lab\_code** `string`

Numeryczny kod laboratoryjny wydrukowany na zestawie do pobrania krwi, gdy jeden kod obejmuje wszystkie probówki. Wyklucza się
wzajemnie z `lab_codes`.

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

Wszystkie kody laboratoryjne pobrania krwi w kolejności skanowania (co najmniej jeden wpis). Wyklucza się wzajemnie z `lab_code`. Każdy
kod może wystąpić tylko raz, a każdy panel może zostać wymieniony tylko w jednym wpisie.

**wpis kodu laboratoryjnego**

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

Numeryczny kod laboratoryjny wydrukowany na probówkach tych paneli.

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

Przypisane panele, których probówki noszą ten kod — wartości `panel_id` z pola `panels`
wizyty. Pomiń lub wyślij `[]`, aby utworzyć wpis zbiorczy obejmujący wszystkie panele niewymienione gdzie indziej oraz
pojedyncze biomarkery. Pobranie żylne ma co najwyżej jeden wpis zbiorczy. Przy pobraniu włośniczkowym wpis zbiorczy
zawiera wyłącznie pojedyncze biomarkery i wysyłasz jeden na każdą potrzebną im mikroprobówkę.

## Odpowiedź

W razie powodzenia API zwraca `200 OK`, potwierdzając uruchomienie procesu zlecenia laboratoryjnego.

**success** `boolean`

`true`, gdy pobranie krwi zostało zarejestrowane, a proces zlecenia laboratoryjnego uruchomiony.

**warning** `string`

Występuje tylko wtedy, gdy pobranie krwi zarejestrowano w innym dniu niż dzień wizyty. Zwykłe
klucze nie mogą tego zrobić — otrzymują `409` z `reason: "appointment_not_today"`. Przełóż
wizytę na dzień pobrania krwi, a następnie potwierdź.

Zarejestrowane kody są zwracane jako `lab_codes` w [Pobierz wizytę](https://docs.anivahealth.com/pl/api/appointments/get-appointment.md), a każdy wynik i dokument w [Pobierz wyniki](https://docs.anivahealth.com/pl/api/appointments/get-results.md) zawiera `lab_code`, pod którym został zapisany.

## Odpowiedzi z błędami

| Status | Opis |
| - | - |
| `400` | Błąd walidacji — nie podano żadnego albo podano oba pola `lab_code` i `lab_codes`, kod nie jest numeryczny albo kod lub panel się powtarza. |
| `403` | Brak dostępu — twój klucz API nie ma uprawnień do tej operacji. |
| `404` | Nie znaleziono wizyty. |
| `409` | Kodu nie można użyć (`reason`: `unregistered`, `already_assigned`, `home_kit_code`, `location_unknown`, `cross_location`), panel pozostał bez kodu, `panel_id` nie jest przypisany, pobranie żylne ma dwa wpisy bez `panel_ids`, pobranie włośniczkowe ma więcej wpisów niż mikroprobówek albo więcej wpisów bez `panel_ids` niż mikroprobówek tylko dla markerów albo kod pobrania włośniczkowego nie pasuje do swoich mikroprobówek (wszystkie: `panel_coverage`), kod zarejestrowany przed resetem wskazuje teraz inne panele (`remapped`) albo musi pozostać przy tym pobraniu krwi, ponieważ laboratorium może mieć już jego zlecenie (`sent_to_lab`, `order_in_flight`), kod wskazuje panel, który nie jest zaplanowany na tej wizycie (`unknown_panel`), albo wizyty nie można potwierdzić (`appointment_cancelled`, `appointment_already_drawn`, `appointment_not_ready`, `appointment_not_today`). `lab_code` wskazuje błędny kod, jeśli przyczyną jest konkretny kod. |
| `500` | Wewnętrzny błąd serwera. |

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