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

> Schritt-für-Schritt-Anleitung: Erfasse eine Blutabnahme in der Aniva API und sende die Probe an die Laborauftrags-Pipeline.

Mit dieser Anleitung bestätigst du, dass eine Blutabnahme stattgefunden hat. Die Bestätigung erfasst die Laborcodes (Röhrchen-Barcodes) des physischen Kits und startet die Laborauftrags-Pipeline; den Fortschritt der Ergebnisse liest du anschließend über [Ergebnisse abrufen](https://docs.anivahealth.com/de/api/appointments/get-results.md) aus.

> [!WARNING]
>
> Die Bestätigung ist **unumkehrbar**. Sobald du eine Blutabnahme bestätigt hast, kannst du am Termin keine weiteren Änderungen mehr vornehmen –
> auch keine Panels mehr hinzufügen. Stelle sicher, dass alle Panels hinterlegt und
> alle Angaben korrekt sind, bevor du fortfährst.

**1. Sicherstellen, dass Panels hinzugefügt wurden**

Prüfe vor der Bestätigung, ob alle erforderlichen Test-Panels zum Termin hinzugefügt wurden. Nach der Bestätigung kannst du keine Panels mehr hinzufügen.

In der Anleitung [Termin planen](https://docs.anivahealth.com/de/guides/schedule-appointment.md) erfährst du, wie du Panels hinzufügst.

Stelle Folgendes sicher, bevor du fortfährst:

* Alle erforderlichen Panels sind zum Termin hinzugefügt.
* Die `profile_id` und `location_id` des Termins sind korrekt.
* Der Patient hat die Blutabnahme abgeschlossen und der Barcode jedes Röhrchens liegt vor.

**2. Blutabnahme bestätigen**

Sende eine `POST`-Anfrage an `/api/v1/appointments/{id}/confirm` mit den Laborcodes des physischen Blutabnahme-Kits. Bei einer venösen Blutabnahme ist ein Code auf jedem Röhrchen aufgedruckt – sende ihn als `lab_code`. Bei einer Blutabnahme in der Apotheke gibt es einen Code pro Microtainer – sende sie als `lab_codes`, mit einem Eintrag pro Code und den `panel_ids`, die der jeweilige Microtainer enthält (aus `panels` des Termins); jeder Code wird zu einer eigenen Laboranforderung. Einzelne Biomarker in einer Apotheke füllen zuerst den freien Platz der Panel-Microtainer. Sende für jeden Microtainer, den sie für sich allein benötigen, einen Eintrag ohne `panel_ids`.

> [!WARNING]
>
> Jeder Code muss die Ziffernfolge sein, die auf dem physischen Röhrchen aufgedruckt ist, das dem Patienten übergeben wurde. Ersetze ihn nicht durch eine andere Kennung – ein falscher Code führt dazu, dass der Laborauftrag fehlschlägt. Jeder Code wird validiert, bevor etwas geschrieben wird; wird einer abgelehnt, wird nichts gespeichert.

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

Eine erfolgreiche Anfrage liefert `200 OK` zurück:

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

**3. Terminstatus prüfen**

Rufe nach der Bestätigung den Termin ab, um zu prüfen, ob sich der Status auf `blood_drawn` geändert hat.

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

Sobald der Termin `status: "blood_drawn"` zeigt, wurde die Laborauftrags-Pipeline gestartet. Der Terminstatus selbst bleibt ab hier auf `blood_drawn`; den genaueren weiteren Verlauf liefern eigene Endpunkte: Folge jedem Eintrag im eingebetteten `shipments`-Array zu [Sendung abrufen](https://docs.anivahealth.com/de/api/shipments/get-shipment.md) für Kurier-Events (unterwegs / zugestellt) und nutze [Ergebnisse abrufen](https://docs.anivahealth.com/de/api/appointments/get-results.md) für den Abschluss der Laborergebnisse (`status: "in_progress"` → `"completed"`).

## Was als Nächstes passiert

Nach der Bestätigung übernimmt die Laborauftrags-Pipeline von Aniva:

1. Jeder Laborcode wird im Labor seinen physischen Röhrchen zugeordnet – die Laboranforderung jedes Panels trägt den Code der zugehörigen Röhrchen.
2. Die zum Termin hinzugefügten Panels bestimmen, welche Tests durchgeführt werden.
3. Sobald Ergebnisse vorliegen, werden sie dem Patientenprofil zugeordnet und erscheinen unter
   [Ergebnisse abrufen](https://docs.anivahealth.com/de/api/appointments/get-results.md) – das `status`-Feld auf oberster Ebene der Antwort wechselt
   von `in_progress` zu `completed`, sobald jede Einsendung abgeschlossen ist und eine Ergebnisse geliefert hat.

Nach der Bestätigung muss deine Integration nichts weiter tun.

## Fehlerbehandlung

| Status | Ursache | Lösung |
| - | - | - |
| `400 Bad Request` | Weder `lab_code` noch `lab_codes` oder beide angegeben, ein Code ist nicht numerisch oder ein Code bzw. Panel ist doppelt. | Sende genau eines der beiden Felder mit den exakten numerischen Codes der physischen Röhrchen. |
| `409 Conflict` | Ein Code kann nicht verwendet werden (bereits zugewiesen, nicht registriert, gehört zu einem Heimtest-Kit, falsche Klinik), ein Panel hat keinen Code oder der Termin kann nicht bestätigt werden. | Lies `reason` und `lab_code`; scanne ein anderes Röhrchen oder prüfe den Terminstatus. |
| `403 Forbidden` | Dein API-Key hat keinen Zugriff auf diesen Vorgang. | Kontaktiere Aniva, um die Berechtigungen deines API-Keys bestätigen zu lassen. |
| `404 Not Found` | Die Termin-ID existiert nicht oder gehört nicht zu deinem Konto. | Prüfe, ob die Termin-ID korrekt ist. |


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