Heimtest-Kit-Bestellungen
Heimtest-Kit-Bestellung aktivieren
Melden, wann der Patient die Probe genommen hat
POST
/
api
/
v1
/
home-kit-orders
/
{id}
/
activate
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"
}'
{
"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" }
]
}
{
"error": "Home kit order is already activated"
}
Melde, dass der Patient seine Probe genommen hat. Dies ist das Heimtest-Kit-Gegenstück zu
Blutabnahme bestätigen – 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.
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 Marker als planned an, bis das Labor sie
meldet. Ein home_kit_order.results.updated-Webhook 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
Body-Parameter
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 API200 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. |
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"
}'
{
"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" }
]
}
{
"error": "Home kit order is already activated"
}
⌘I
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"
}'
{
"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" }
]
}
{
"error": "Home kit order is already activated"
}