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

# Heimtest-Kit-Bestellung aktivieren

> Melden, wann der Patient die Probe genommen hat

Melde, dass der Patient seine Probe genommen hat. Dies ist das Heimtest-Kit-Gegenstück zu
[Blutabnahme bestätigen](https://docs.anivahealth.com/de/api/appointments/confirm-blood-draw.md) – ohne Barcode, da der Code des
Kits beim Packen angebracht wird. Du übergibst nur den Zeitpunkt der Probenahme.

Der Zeitstempel ist klinisch wichtig: Er ist der Zeitpunkt der Probenahme, der im Laborbericht
steht. Sende den tatsächlichen Zeitpunkt der Probenahme des Patienten, nicht den Zeitpunkt, zu dem
dein System dies verarbeitet hat.

Erneutes Senden **desselben** `activated_at` gibt `200` mit der aktivierten Bestellung zurück; ein **anderer** Wert gibt `409` zurück. Siehe [Idempotenz](https://docs.anivahealth.com/de/concepts/idempotency.md).

Die Aktivierung setzt die Bestellung auf `activated` – ein Endstatus. Eine aktivierte Bestellung
kann nicht mehr storniert werden, und ihre Zusammensetzung sowie Lieferadresse sind gesperrt. Eine
Aktivierung wird akzeptiert, solange die Bestellung `pending` oder `dispatched` ist und einen
`lab_code` hat – der Patient kann ein Kit schon in den Händen halten, bevor unsere Daten es als
versendet führen, und sein tatsächlicher Zeitpunkt der Probenahme hat immer Vorrang vor unserer
Buchführung. Eine Bestellung ohne `lab_code` gibt `409` zurück: Ohne den Code lässt sich die Probe
im Labor nicht dem Patienten zuordnen.

Die Aktivierung gibt außerdem den Laborauftrag für das Panel des Kits unter dem `lab_code` der
Bestellung auf, sodass die Probe im Labor erwartet wird und Ergebnisse sofort zugeordnet werden
können, sobald sie gemeldet werden. Das passiert asynchron nach der Antwort – ein Laborproblem
lässt deine Anfrage nie fehlschlagen. Ab diesem Zeitpunkt zeigt
[Ergebnisse abrufen](https://docs.anivahealth.com/de/api/home-kit-orders/get-results.md) Marker als `planned` an, bis das Labor sie
meldet. Ein `home_kit_order.results.updated`-[Webhook](https://docs.anivahealth.com/de/concepts/webhooks.md) benachrichtigt dich,
wenn sie sich ändern.

Wenn die Probe das Labor erreicht, bevor du das Kit aktivierst, aktiviert Aniva es.
`activated_at` ist der Morgen des ersten Tracking-Ereignisses des Rücksendepakets oder der Morgen,
an dem die Probe im Labor eingetroffen ist, falls es kein Tracking gibt. Ein späterer Aufruf mit
einem anderen `activated_at` gibt dann `409` zurück.

Erfordert den Scope `home_kit_orders_manage` oder den engeren Scope `home_kit_orders_activate`.

## Anfrage

### Pfadparameter

**id** `string` *required*

Eindeutige Kennung (UUID) der Heimtest-Kit-Bestellung, die aktiviert werden soll.

### Body-Parameter

**activated\_at** `string` *required*

Wann der Patient die Probe genommen hat, als UTC-Zeitpunkt (ISO 8601 mit `Z`-Suffix, z. B.
`2026-08-28T07:30:00Z`). Darf nicht in der Zukunft und nicht mehr als 30 Tage in der Vergangenheit
liegen.

## Antwort

Bei Erfolg gibt die API `200 OK` mit der aktualisierten Heimtest-Kit-Bestellung zurück – `status` ist `activated` und
`activated_at` enthält den Zeitstempel, den du gesendet hast.

## Fehlerantworten

| Status | Beschreibung |
| - | - |
| `400` | Validierungsfehler – ungültig formatiertes `activated_at`, ein Zeitstempel in der Zukunft oder älter als 30 Tage. |
| `403` | Zugriff verweigert – dein API-Schlüssel hat keinen Zugriff auf diese Operation oder die Heimtest-Kit-Bestellung liegt außerhalb deines Berechtigungsbereichs. |
| `404` | Heimtest-Kit-Bestellung nicht gefunden. |
| `409` | Konflikt – bereits mit einer *anderen* Probenahmezeit aktiviert, storniert oder noch kein `lab_code` vorhanden. |
| `500` | Interner Serverfehler. |

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/home-kit-orders/d1e2f3a4-5b6c-4d7e-8f9a-0b1c2d3e4f5a/activate \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "activated_at": "2026-08-28T07:30:00Z"
  }'
```

```json 200 theme={null}
{
  "id": "d1e2f3a4-5b6c-4d7e-8f9a-0b1c2d3e4f5a",
  "profile_id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
  "status": "activated",
  "lab_code": "7642200101",
  "activated_at": "2026-08-28T07:30:00Z",
  "delivery_address": {
    "name": "Maria Schmidt",
    "company_name": "c/o Weber",
    "address_line_2": null,
    "street": "Friedrichstraße",
    "house_number": "123",
    "postal_code": "10117",
    "city": "Berlin",
    "country_code": "DE",
    "phone": "+4930123456789",
    "email": "maria.schmidt@example.com"
  },
  "created_at": "2026-08-20T09:45:00Z",
  "updated_at": "2026-08-28T07:31:12Z",
  "profile": {
    "id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
    "handle": null,
    "first_name": "Maria",
    "last_name": "Schmidt",
    "email": "maria.schmidt@example.com",
    "phone": "+4930123456789",
    "sex": 2,
    "date_of_birth": "1985-03-22",
    "height": 168,
    "weight": 65,
    "language": "de",
    "transactional_emails_enabled": true,
    "created_at": "2026-08-20T09:14:32Z",
    "updated_at": null
  },
  "panels": [
    {
      "panel_id": "f1c2d4a3-7b8e-4f2a-9c1d-2e3f4a5b6c7d",
      "added_at": "2026-08-20T09:45:00Z"
    }
  ],
  "individual_biomarkers": [],
  "metadata": { "your_order_ref": "ORD-10482" },
  "replaces_home_kit_order_id": null,
  "replacement_reason": null,
  "results_ready_emails": [],
  "shipments": [
    { "id": "K2608211FQ7", "added_at": "2026-08-21T08:00:00Z" },
    { "id": "K260821P3XD", "added_at": "2026-08-21T08:00:00Z" }
  ]
}
```

```json 409 theme={null}
{
  "error": "Home kit order is already activated"
}
```


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