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

> Registrar que se ha realizado la extracción de sangre y activar el flujo de órdenes de laboratorio

Registra que se ha completado una extracción de sangre y activa el flujo de pedidos al laboratorio. Envía los códigos de laboratorio (códigos de barras de los tubos) del kit de extracción de sangre para vincular las muestras físicas con la cita.

Una extracción de sangre incluye sus códigos de una de estas dos formas:

* **Un código para toda la extracción**: una extracción venosa, en la que el mismo código de barras está impreso en todos los tubos. Envíalo como `lab_code`.
* **Un código por microtubo**: una extracción capilar, en la que cada microtubo tiene su propio código de barras. Envíalos como `lab_codes`, una entrada por código con los `panel_ids` que contiene su microtubo. Cada código se convierte en su propia solicitud de laboratorio: el código de barras del tubo es el número de pedido del laboratorio. Una entrada sin `panel_ids` sirve como comodín para todos los paneles no indicados en otra entrada. Una extracción venosa tiene como máximo una.

Envía exactamente uno de los dos. Cada panel asociado debe quedar bajo exactamente un código (su propia entrada o la entrada comodín). En una extracción venosa, los biomarcadores a la carta necesitan la entrada comodín. En una extracción capilar, indica cada panel en el código de su microtubo. Los biomarcadores a la carta llenan el espacio libre de los microtubos de los paneles y solo abren nuevos microtubos cuando es necesario. Los repartimos de forma uniforme. Cada microtubo admite como máximo 150 µl de ellos. Envía una entrada sin `panel_ids` por cada microtubo que necesiten por sí solos, y ni una más. Un código que quede sin ningún panel ni biomarcador se rechaza con `409` y `reason: "panel_coverage"`. Todos los códigos se validan antes de escribir nada; si algún código no se puede usar o algún panel queda sin cubrir, no se registra nada y la respuesta indica el problema.

Requiere el scope `appointments_schedule`, `appointments_manage` o `appointments_operate`.

> [!WARNING]
>
> Esta acción es irreversible. Una vez que confirmas la extracción de sangre, la cita queda bloqueada: no
> es posible hacer más modificaciones, incluido añadir paneles.

## Solicitud

### Parámetros de ruta

**id** `string` *required*

Identificador único (UUID) de la cita que quieres confirmar.

### Parámetros del cuerpo

**lab\_code** `string`

Código de laboratorio numérico impreso en el kit de extracción de sangre, cuando un solo código cubre todos los tubos. Mutuamente
excluyente con `lab_codes`.

**lab\_codes** `object[]`

Todos los códigos de laboratorio de la extracción de sangre, en orden de escaneo (al menos una entrada). Mutuamente excluyente con `lab_code`. Cada
código solo puede aparecer una vez; cada panel solo puede indicarse en una entrada.

**entrada de código de laboratorio**

**lab\_code** `string` *required*

Código de laboratorio numérico impreso en los tubos de estos paneles.

**panel\_ids** `string[]`

Los paneles asociados cuyos tubos llevan este código: valores de `panel_id` de los
`panels` de la cita. Omítelo o envía `[]` para la entrada comodín que cubre todos los paneles no indicados en otra entrada más
los biomarcadores a la carta. Una extracción venosa tiene como máximo una entrada comodín. En una extracción capilar, una entrada comodín
contiene solo biomarcadores a la carta, y envías una por cada microtubo que necesiten.

## Respuesta

Si tiene éxito, la API devuelve `200 OK` confirmando que se ha activado el flujo de pedidos al laboratorio.

**success** `boolean`

`true` cuando se ha registrado la extracción de sangre y se ha activado el flujo de pedidos al laboratorio.

**warning** `string`

Solo está presente cuando la extracción se registró en un día distinto al de la cita. Las claves
normales no pueden hacer esto: reciben un `409` con `reason: "appointment_not_today"`. Reprograma la
cita para el día de la extracción y luego confírmala.

Los códigos registrados se devuelven como `lab_codes` en [Obtener cita](https://docs.anivahealth.com/es/api/appointments/get-appointment.md), y cada resultado y documento de [Obtener resultados](https://docs.anivahealth.com/es/api/appointments/get-results.md) incluye el `lab_code` con el que se archivó.

## Respuestas de error

| Estado | Descripción |
| - | - |
| `400` | Error de validación: no se ha proporcionado ni `lab_code` ni `lab_codes` o se han proporcionado ambos, un código no es numérico, o un código o panel está repetido. |
| `403` | Prohibido: tu clave de API no tiene acceso a esta operación. |
| `404` | Cita no encontrada. |
| `409` | No se puede usar un código (`reason`: `unregistered`, `already_assigned`, `home_kit_code`, `location_unknown`, `cross_location`), un panel se queda sin código, un `panel_id` no está asociado, una extracción venosa tiene dos entradas sin `panel_ids`, una extracción capilar tiene más entradas que microtubos o más entradas sin `panel_ids` que microtubos solo de marcadores, o un código capilar no coincide con sus microtubos (todos `panel_coverage`), un código registrado antes de un reinicio ahora indica otros paneles (`remapped`) o debe mantenerse en esta extracción porque el laboratorio puede tener su pedido (`sent_to_lab`, `order_in_flight`), un código indica un panel que no está previsto en la cita (`unknown_panel`), o la cita no se puede confirmar (`appointment_cancelled`, `appointment_already_drawn`, `appointment_not_ready`, `appointment_not_today`). `lab_code` indica el código que falla cuando hay uno. |
| `500` | Error interno del servidor. |

```bash cURL (one code, every tube) theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a/confirm \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "lab_code": "7642001234"
  }'
```

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

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

```json 400 theme={null}
{
  "error": "lab_codes: Provide exactly one of `lab_code` or `lab_codes`"
}
```

```json 404 theme={null}
{
  "error": "Appointment not found"
}
```

```json 409 theme={null}
{
  "error": "This barcode has already been assigned to another patient. Please use a different tube.",
  "reason": "already_assigned",
  "lab_code": "7642001235"
}
```

```json 409 (capillary empty code) theme={null}
{
  "error": "Barcode 7642001236 carries no panel and no biomarker.",
  "reason": "panel_coverage",
  "lab_code": null
}
```

```json 409 (cancelled) theme={null}
{
  "error": "This appointment was cancelled, so a blood draw can’t be recorded for it. Reactivate the appointment first if this is a mistake.",
  "reason": "appointment_cancelled",
  "lab_code": "7642001234"
}
```

```json 409 (wrong day) theme={null}
{
  "error": "Recording a blood draw is only available on the appointment day (Oct 13, 2026). Reschedule the appointment to today, then confirm.",
  "reason": "appointment_not_today",
  "lab_code": null
}
```


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