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

# Activar pedido de kit de prueba en casa

> Notificar cuándo el paciente recogió su muestra

Informa de que el paciente ha tomado su muestra. Es el equivalente para kit de prueba en casa de
[Confirmar extracción de sangre](https://docs.anivahealth.com/es/api/appointments/confirm-blood-draw.md), sin código de barras, porque el código del kit
se aplica al empaquetarlo. Solo tienes que pasar la marca de tiempo de la toma.

La marca de tiempo tiene relevancia clínica: es la hora de la toma que figurará en el informe del laboratorio. Envía el
momento real en que el paciente tomó la muestra, no el momento en que tu sistema lo procesó.

Volver a enviar el **mismo** `activated_at` devuelve `200` con el pedido activado; uno **diferente** devuelve `409`. Consulta [Idempotencia](https://docs.anivahealth.com/es/concepts/idempotency.md).

La activación pasa el pedido a `activated`, un estado terminal. Un pedido activado ya no se puede
cancelar, y su composición y dirección de entrega quedan bloqueadas. La activación se acepta mientras el
pedido esté en `pending` o `dispatched`, siempre que tenga un `lab_code`: el paciente puede tener el
kit en sus manos antes de que nuestro registro indique que se ha enviado, y su hora real de toma siempre prevalece sobre nuestro
control interno. Un pedido sin `lab_code` devuelve `409`: sin el código, no se puede asociar la muestra
al paciente en el laboratorio.

La activación también envía la solicitud de laboratorio para el panel del kit bajo el `lab_code` del pedido, de modo que
el laboratorio espera la muestra y los resultados pueden vincularse en cuanto se comunican. Esto ocurre
de forma asíncrona tras la respuesta: un problema en el laboratorio nunca hará fallar tu petición. A partir de aquí,
[Obtener resultados](https://docs.anivahealth.com/es/api/home-kit-orders/get-results.md) muestra los marcadores como `planned` hasta que el laboratorio los
comunique. Un [webhook](https://docs.anivahealth.com/es/concepts/webhooks.md) `home_kit_order.results.updated` te avisa cuando cambian.

Si la muestra llega al laboratorio antes de que actives el kit, Aniva lo activa.
`activated_at` corresponde a la mañana del primer evento de seguimiento del paquete de devolución, o a la mañana en que la
muestra llegó al laboratorio si no hay seguimiento. Una llamada posterior con un
`activated_at` distinto devuelve entonces `409`.

Requiere el scope `home_kit_orders_manage` o el scope más específico `home_kit_orders_activate`.

## Solicitud

### Parámetros de ruta

**id** `string` *required*

Identificador único (UUID) del pedido de kit de prueba en casa que se va a activar.

### Parámetros del cuerpo

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

Momento en que el paciente tomó la muestra, como instante UTC (ISO 8601 con sufijo `Z`, p. ej.,
`2026-08-28T07:30:00Z`). No puede ser futuro ni tener más de 30 días de antigüedad.

## Respuesta

Si tiene éxito, la API devuelve `200 OK` con el pedido de kit de prueba en casa actualizado: `status` es `activated` y
`activated_at` contiene la marca de tiempo que enviaste.

## Respuestas de error

| Estado | Descripción |
| - | - |
| `400` | Error de validación: `activated_at` con formato incorrecto, marca de tiempo futura o con más de 30 días de antigüedad. |
| `403` | Prohibido: tu clave de API no tiene acceso a esta operación o el pedido de kit de prueba en casa está fuera de tu ámbito de permisos. |
| `404` | Pedido de kit de prueba en casa no encontrado. |
| `409` | Conflicto: ya está activado con una hora de recogida *distinta*, está cancelado o aún no tiene `lab_code`. |
| `500` | Error interno 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.