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

# Aktiver bestilling av hjemmetestsett

> Rapporter når pasienten tok prøven sin

Rapporter at pasienten har tatt prøven. Dette er motstykket for hjemmetestsett til
[Bekreft blodprøvetaking](https://docs.anivahealth.com/no/api/appointments/confirm-blood-draw.md) – uten strekkode, fordi settets
kode påføres når settet pakkes. Du sender bare tidspunktet for prøvetakingen.

Tidspunktet har klinisk betydning: det er prøvetakingstidspunktet som vil stå i labrapporten. Send
pasientens faktiske prøvetakingstidspunkt, ikke tidspunktet da systemet ditt behandlet det.

Å sende den **samme** `activated_at` på nytt returnerer `200` med den aktiverte bestillingen; en **annen** returnerer `409`. Se [Idempotens](https://docs.anivahealth.com/no/concepts/idempotency.md).

Aktivering setter bestillingen til `activated` – en endelig status. En aktivert bestilling kan ikke
lenger kanselleres, og sammensetningen og leveringsadressen er låst. Aktivering godtas mens
bestillingen er `pending` eller `dispatched`, så lenge den har en `lab_code` – pasienten kan
allerede ha et sett i hånden før vår registrering viser utsendt, og det faktiske
prøvetakingstidspunktet vinner alltid over vår bokføring. En bestilling uten `lab_code` returnerer
`409`: uten koden kan prøven ikke kobles til pasienten på laboratoriet.

Aktivering legger også inn laboratoriebestillingen for settets panel under bestillingens `lab_code`,
slik at prøven er ventet på laboratoriet og resultatene kan kobles på i det øyeblikket de
rapporteres. Dette skjer asynkront etter svaret – et problem hos laboratoriet får aldri
forespørselen din til å feile. Fra nå av viser [Hent resultater](https://docs.anivahealth.com/no/api/home-kit-orders/get-results.md)
markørene som `planned` til laboratoriet rapporterer dem. En `home_kit_order.results.updated`-[webhook](https://docs.anivahealth.com/no/concepts/webhooks.md) gir deg beskjed når de endres.

Hvis prøven når laboratoriet før du aktiverer settet, aktiverer Aniva det.
`activated_at` er morgenen for den første sporingshendelsen til returpakken, eller morgenen da
prøven ankom laboratoriet hvis det ikke finnes sporing. Et senere kall med en annen
`activated_at` returnerer da `409`.

Krever scopet `home_kit_orders_manage` eller det snevrere scopet `home_kit_orders_activate`.

## Forespørsel

### Stiparametere

**id** `string` *required*

Unik identifikator (UUID) for bestillingen av hjemmetestsett som skal aktiveres.

### Body-parametere

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

Når pasienten tok prøven, som et UTC-tidspunkt (ISO 8601 med `Z`-suffiks, f.eks.
`2026-08-28T07:30:00Z`). Må ikke være i fremtiden eller mer enn 30 dager tilbake i tid.

## Respons

Ved suksess returnerer API-et `200 OK` med den oppdaterte bestillingen av hjemmetestsett – `status` er `activated`, og
`activated_at` inneholder tidsstempelet du sendte.

## Feilresponser

| Status | Beskrivelse |
| - | - |
| `400` | Valideringsfeil – ugyldig format på `activated_at`, et tidsstempel i fremtiden eller et som er eldre enn 30 dager. |
| `403` | Ingen tilgang – API-nøkkelen din har ikke tilgang til denne operasjonen, eller bestillingen av hjemmetestsett ligger utenfor tilgangsområdet ditt. |
| `404` | Fant ikke bestillingen av hjemmetestsett. |
| `409` | Konflikt – allerede aktivert med et *annet* prøvetakingstidspunkt, kansellert eller mangler `lab_code` ennå. |
| `500` | Intern serverfeil. |

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