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

# Confirmar extracción de sangre

> Guía paso a paso: registra una extracción de sangre en la API de Aniva y envía la muestra al flujo de pedidos de laboratorio.

Usa esta guía para confirmar que se ha realizado una extracción de sangre. La confirmación registra los códigos de laboratorio (códigos de barras de los tubos) del kit físico y activa el flujo de órdenes de laboratorio; a partir de ahí, el progreso de los resultados se consulta en [Obtener resultados](https://docs.anivahealth.com/es/api/appointments/get-results.md).

> [!WARNING]
>
> La confirmación es **irreversible**. Una vez que confirmas una extracción de sangre, no se pueden hacer más cambios
> —incluido añadir paneles— en la cita. Asegúrate de que todos los paneles estén asociados y de que
> todos los datos sean correctos antes de continuar.

**1. Comprobar que los paneles estén añadidos**

Antes de confirmar, comprueba que se hayan añadido a la cita todos los paneles de análisis necesarios. No puedes añadir paneles después de la confirmación.

Consulta la guía [Programar una cita](https://docs.anivahealth.com/es/guides/schedule-appointment.md) para ver cómo asociar paneles.

Confirma lo siguiente antes de continuar:

* Todos los paneles necesarios están asociados a la cita.
* El `profile_id` y el `location_id` de la cita son correctos.
* El paciente ha completado la extracción de sangre y tienes a mano el código de barras de cada tubo.

**2. Confirmar la extracción de sangre**

Envía una solicitud `POST` a `/api/v1/appointments/{id}/confirm` con los códigos de laboratorio del kit físico de extracción de sangre. Una extracción venosa tiene un único código impreso en todos los tubos: envíalo como `lab_code`. Una extracción en farmacia tiene un código por microtubo: envíalos como `lab_codes`, con una entrada por código y los `panel_ids` que contiene ese microtubo (tomados de `panels` de la cita); cada código genera su propia petición de laboratorio. Los biomarcadores individuales en farmacia ocupan primero el espacio libre de los microtubos de los paneles. Envía una entrada sin `panel_ids` por cada microtubo que necesiten por separado.

> [!WARNING]
>
> Cada código debe ser la cadena numérica impresa en el tubo físico entregado al paciente. No lo sustituyas por otro identificador: un código incorrecto hará que falle la orden de laboratorio. Todos los códigos se validan antes de guardar nada; si se rechaza uno, no se registra nada.

```bash cURL (venous draw, one code) theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments/c9d4e827-3b6f-4a1c-8d2e-5f0b9c7e3a12/confirm \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "lab_code": "7642001234"
  }'
```

```bash cURL (pharmacy draw, one code per panel) theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments/c9d4e827-3b6f-4a1c-8d2e-5f0b9c7e3a12/confirm \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "lab_codes": [
      { "lab_code": "7642001234", "panel_ids": ["f1c2d4a3-7b8e-4f2a-9c1d-2e3f4a5b6c7d"] },
      { "lab_code": "7642001235", "panel_ids": ["0a9b8c7d-6e5f-4a3b-2c1d-0e9f8a7b6c5d"] }
    ]
  }'
```

```javascript JavaScript theme={null}
const response = await fetch(
  'https://anivahealth.com/api/v1/appointments/c9d4e827-3b6f-4a1c-8d2e-5f0b9c7e3a12/confirm',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': 'YOUR_API_KEY',
    },
    body: JSON.stringify({
      lab_codes: [
        { lab_code: '7642001234', panel_ids: ['f1c2d4a3-7b8e-4f2a-9c1d-2e3f4a5b6c7d'] },
        { lab_code: '7642001235', panel_ids: ['0a9b8c7d-6e5f-4a3b-2c1d-0e9f8a7b6c5d'] },
      ],
    }),
  }
);

const result = await response.json();
```

Una solicitud correcta devuelve `200 OK`:

```json theme={null}
{
  "success": true
}
```

**3. Verificar el estado de la cita**

Después de la confirmación, consulta la cita para comprobar que su estado ha cambiado a `blood_drawn`.

```bash cURL theme={null}
curl --request GET \
  --url https://anivahealth.com/api/v1/appointments/c9d4e827-3b6f-4a1c-8d2e-5f0b9c7e3a12 \
  --header 'x-api-key: YOUR_API_KEY'
```

```javascript JavaScript theme={null}
const response = await fetch(
  'https://anivahealth.com/api/v1/appointments/c9d4e827-3b6f-4a1c-8d2e-5f0b9c7e3a12',
  {
    headers: {
      'x-api-key': 'YOUR_API_KEY',
    },
  }
);

const appointment = await response.json();
console.log(appointment.status); // "blood_drawn"
```

Cuando la cita muestra `status: "blood_drawn"`, se ha activado el flujo de órdenes de laboratorio. A partir de aquí, el estado de la cita se mantiene en `blood_drawn`; el avance detallado posterior se consulta en endpoints específicos: sigue cada entrada del array integrado `shipments` en [Obtener envío](https://docs.anivahealth.com/es/api/shipments/get-shipment.md) para los eventos de mensajería en tránsito / entregado, y usa [Obtener resultados](https://docs.anivahealth.com/es/api/appointments/get-results.md) para ver la finalización de los resultados de laboratorio (`status: "in_progress"` → `"completed"`).

## Qué ocurre después

Tras la confirmación, el flujo de órdenes de laboratorio de Aniva toma el relevo:

1. Cada código de laboratorio se empareja con sus tubos físicos en el laboratorio: la petición de cada panel lleva el código de sus propios tubos.
2. Los paneles asociados a la cita determinan qué pruebas se realizan.
3. Cuando los resultados están listos, se asocian al perfil del paciente y aparecen en
   [Obtener resultados](https://docs.anivahealth.com/es/api/appointments/get-results.md): el campo `status` de nivel superior de la respuesta cambia
   de `in_progress` a `completed` cuando todos los envíos se han cerrado y uno ha emitido resultados.

Tu integración no tiene que hacer nada más después de la confirmación.

## Gestión de errores

| Estado | Causa | Solución |
| - | - | - |
| `400 Bad Request` | No se ha indicado ni `lab_code` ni `lab_codes` o se han enviado ambos, un código no es numérico, o un código o panel está repetido. | Envía exactamente uno de los dos, con los códigos numéricos exactos de los tubos físicos. |
| `409 Conflict` | Un código no se puede usar (ya asignado, no registrado, pertenece a un kit de prueba en casa, clínica incorrecta), un panel no tiene código o la cita no se puede confirmar. | Consulta `reason` y `lab_code`; escanea otro tubo o comprueba el estado de la cita. |
| `403 Forbidden` | Tu clave de API no tiene acceso a esta operación. | Contacta con Aniva para confirmar los permisos de tu clave de API. |
| `404 Not Found` | El ID de la cita no existe o no pertenece a tu cuenta. | Comprueba que el ID de la cita sea correcto. |


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