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

# Activa una comanda de kit de prova a casa

> Informa de quan el pacient va recollir la mostra

Informa que el pacient ha recollit la mostra. És l'equivalent per al kit de prova a casa de
[Confirma l'extracció de sang](https://docs.anivahealth.com/ca/api/appointments/confirm-blood-draw.md) — sense codi de barres, perquè el codi
del kit s'aplica quan s'empaqueta. Només has de passar la marca de temps de la recollida.

La marca de temps té importància clínica: és l'hora de recollida que constarà a l'informe del
laboratori. Envia el moment real en què el pacient ha recollit la mostra, no el moment en què el
teu sistema ho ha processat.

Tornar a enviar el **mateix** `activated_at` retorna `200` amb la comanda activada; un de **diferent** retorna `409`. Consulta [Idempotència](https://docs.anivahealth.com/ca/concepts/idempotency.md).

L'activació passa la comanda a `activated` — un estat final. Una comanda activada ja no es pot
cancel·lar, i la composició i l'adreça de lliurament queden bloquejades. L'activació s'accepta
mentre la comanda és `pending` o `dispatched`, sempre que tingui un `lab_code` — el pacient pot
tenir un kit a les mans abans que el nostre registre indiqui que s'ha enviat, i la seva hora real de
recollida sempre preval sobre el nostre control intern. Una comanda sense `lab_code` retorna `409`:
sense el codi, la mostra no es pot associar al pacient al laboratori.

L'activació també fa la sol·licitud al laboratori per al panell del kit amb el `lab_code` de la
comanda, de manera que el laboratori espera la mostra i els resultats s'hi poden vincular tan bon
punt es notifiquin. Això passa de manera asíncrona després de la resposta — un problema del laboratori
no fa fallar mai la teva petició. A partir d'aquest moment, [Obtén els resultats](https://docs.anivahealth.com/ca/api/home-kit-orders/get-results.md)
mostra els marcadors com a `planned` fins que el laboratori els notifiqui. Un
[webhook](https://docs.anivahealth.com/ca/concepts/webhooks.md) `home_kit_order.results.updated` t'avisa quan canvien.

Si la mostra arriba al laboratori abans que activis el kit, l'activa Aniva.
`activated_at` és el matí del primer esdeveniment de seguiment del paquet de retorn, o el matí en
què la mostra ha arribat al laboratori si no hi ha seguiment. Aleshores, una crida posterior amb un
`activated_at` diferent retorna `409`.

Requereix l'àmbit `home_kit_orders_manage` o l'àmbit més restringit `home_kit_orders_activate`.

## Sol·licitud

### Paràmetres de ruta

**id** `string` *required*

Identificador únic (UUID) de la comanda de kit de prova a casa que vols activar.

### Paràmetres del cos

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

Quan el pacient ha recollit la mostra, com a instant UTC (ISO 8601 amb el sufix `Z`, p. ex.,
`2026-08-28T07:30:00Z`). No pot ser en el futur ni tenir més de 30 dies d'antiguitat.

## Resposta

Si té èxit, l'API retorna `200 OK` amb la comanda de kit de prova a casa actualitzada — `status` és `activated` i
`activated_at` conté la marca de temps que has enviat.

## Respostes d'error

| Estat | Descripció |
| - | - |
| `400` | Error de validació — `activated_at` mal format, una marca de temps futura o amb més de 30 dies d'antiguitat. |
| `403` | Prohibit — la teva clau API no té accés a aquesta operació o la comanda de kit de prova a casa queda fora del teu àmbit de permisos. |
| `404` | No s'ha trobat la comanda de kit de prova a casa. |
| `409` | Conflicte — ja s'ha activat amb una hora de recollida *diferent*, s'ha cancel·lat o encara no té `lab_code`. |
| `500` | Error intern del servidor. |

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