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

# Blutabnahme bestätigen

> Erfassen, dass Blut abgenommen wurde, und die Laborauftrags-Pipeline auslösen

Erfasse eine abgeschlossene Blutabnahme und starte die Laborauftrags-Pipeline. Übermittle die Laborcodes (Röhrchen-Barcodes) vom Blutabnahme-Kit, um die physischen Proben mit dem Termin zu verknüpfen.

Bei einer Blutabnahme werden die Codes auf eine von zwei Arten angegeben:

* **Ein Code für die gesamte Blutabnahme** – eine venöse Blutabnahme, bei der derselbe Barcode auf jedem Röhrchen aufgedruckt ist. Sende ihn als `lab_code`.
* **Ein Code pro Microtainer** – eine kapillare Blutabnahme, bei der jeder Microtainer seinen eigenen Barcode hat. Sende sie als `lab_codes`, ein Eintrag pro Code mit den `panel_ids`, die der jeweilige Microtainer enthält. Jeder Code wird zu einem eigenen Laborauftrag – der Barcode auf dem Röhrchen ist die Auftragsnummer des Labors. Ein Eintrag ohne `panel_ids` ist ein Sammeleintrag für jedes Panel, das nirgendwo sonst genannt wird. Eine venöse Blutabnahme hat höchstens einen.

Sende genau eines von beiden. Jedes verknüpfte Panel muss unter genau einem Code landen (im eigenen Eintrag oder im Sammeleintrag). Bei einer venösen Blutabnahme benötigen Einzel-Biomarker den Sammeleintrag. Gib bei einer kapillaren Blutabnahme jedes Panel beim Code seines Microtainers an. Einzel-Biomarker füllen den freien Platz der Panel-Microtainer und öffnen nur bei Bedarf neue Microtainer. Wir verteilen sie gleichmäßig. Jeder Microtainer fasst höchstens 150 µl davon. Sende einen Eintrag ohne `panel_ids` für jeden Microtainer, den sie für sich allein benötigen, und nicht mehr. Ein Code, dem am Ende weder ein Panel noch ein Biomarker zugeordnet ist, wird mit `409` und `reason: "panel_coverage"` abgelehnt. Jeder Code wird geprüft, bevor etwas geschrieben wird; wenn ein Code nicht verwendet werden kann oder ein Panel nicht abgedeckt ist, wird nichts erfasst und die Antwort nennt das Problem.

Erfordert den Scope `appointments_schedule`, `appointments_manage` oder `appointments_operate`.

> [!WARNING]
>
> Diese Aktion ist unwiderruflich. Sobald du die Blutabnahme bestätigst, ist der Termin gesperrt – es sind
> keine weiteren Änderungen möglich, auch kein Hinzufügen von Panels.

## Anfrage

### Pfadparameter

**id** `string` *required*

Eindeutige Kennung (UUID) des zu bestätigenden Termins.

### Body-Parameter

**lab\_code** `string`

Numerischer Laborcode auf dem Blutabnahme-Kit, wenn ein Code alle Röhrchen abdeckt. Schließt
sich gegenseitig mit `lab_codes` aus.

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

Alle Laborcodes der Blutabnahme in Scan-Reihenfolge (mindestens ein Eintrag). Schließt sich gegenseitig mit `lab_code` aus. Ein
Code darf nur einmal vorkommen; ein Panel darf nur in einem Eintrag genannt werden.

**Laborcode-Eintrag**

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

Numerischer Laborcode, der auf den Röhrchen dieser Panels aufgedruckt ist.

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

Die verknüpften Panels, deren Röhrchen diesen Code tragen – `panel_id`-Werte aus den
`panels` des Termins. Lasse das Feld weg oder sende `[]` für den Sammeleintrag, der jedes nirgendwo sonst genannte Panel sowie
die Einzel-Biomarker abdeckt. Eine venöse Blutabnahme hat höchstens einen Sammeleintrag. Bei einer kapillaren Blutabnahme enthält ein Sammeleintrag
nur Einzel-Biomarker, und du sendest einen pro benötigtem Microtainer.

## Antwort

Bei Erfolg gibt die API `200 OK` zurück und bestätigt, dass die Laborauftrags-Pipeline gestartet wurde.

**success** `boolean`

`true`, wenn die Blutabnahme erfasst und die Laborauftrags-Pipeline ausgelöst wurde.

**warning** `string`

Nur vorhanden, wenn die Blutabnahme an einem anderen Tag als dem Termintag erfasst wurde. Normale
Schlüssel können das nicht – sie erhalten `409` mit `reason: "appointment_not_today"`. Verschiebe
den Termin auf den Tag der Blutabnahme und bestätige dann.

Die erfassten Codes werden unter [Termin abrufen](https://docs.anivahealth.com/de/api/appointments/get-appointment.md) als `lab_codes` zurückgegeben, und jedes Ergebnis und Dokument unter [Ergebnisse abrufen](https://docs.anivahealth.com/de/api/appointments/get-results.md) trägt den `lab_code`, unter dem es abgelegt wurde.

## Fehlerantworten

| Status | Beschreibung |
| - | - |
| `400` | Validierungsfehler – weder `lab_code` noch `lab_codes` oder beide angegeben, ein Code ist nicht numerisch, oder ein Code oder Panel kommt doppelt vor. |
| `403` | Zugriff verweigert – dein API-Schlüssel hat keinen Zugriff auf diesen Vorgang. |
| `404` | Termin nicht gefunden. |
| `409` | Ein Code kann nicht verwendet werden (`reason`: `unregistered`, `already_assigned`, `home_kit_code`, `location_unknown`, `cross_location`), ein Panel bleibt ohne Code, eine `panel_id` ist nicht zugeordnet, eine venöse Blutabnahme hat zwei Einträge ohne `panel_ids`, eine kapillare Blutabnahme hat mehr Einträge als Microtainer oder mehr Einträge ohne `panel_ids` als reine Marker-Microtainer, oder ein kapillarer Code passt nicht zu seinen Microtainern (alle `panel_coverage`), ein vor einem Reset erfasster Code nennt jetzt andere Panels (`remapped`) oder muss bei dieser Blutabnahme bleiben, weil der Auftrag schon beim Labor sein kann (`sent_to_lab`, `order_in_flight`), ein Code nennt ein Panel, das für den Termin nicht geplant ist (`unknown_panel`), oder der Termin kann nicht bestätigt werden (`appointment_cancelled`, `appointment_already_drawn`, `appointment_not_ready`, `appointment_not_today`). `lab_code` nennt den Code, wenn einer die Ursache ist. |
| `500` | Interner Serverfehler. |

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