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

# Previsualizar cita

> Previsualizar los tubos y la factura de una cita

Devuelve lo que necesita una cita según los paneles y biomarcadores que incluye. No se realiza ningún pedido.

* `containers`: los tubos, tarjetas o botes que prepara el profesional.
* `pricing`: el importe según tu tarifa. [Presupuestar carrito](https://docs.anivahealth.com/es/api/pricing/quote-cart.md) devuelve el mismo
  importe sin una cita.
* `routing`: siempre `null`.

Requiere uno de los ámbitos `appointments_view`, `appointments_schedule`, `appointments_operate` o `appointments_manage`.

## Solicitud

### Parámetros de ruta

**id** `string` *required*

Identificador único (UUID) de la cita para previsualizar los requisitos de recipientes.

## Respuesta

Si tiene éxito, la API devuelve `200 OK` con los requisitos de recipientes y campos reservados para uso futuro.

**containers** `object[]` *required*

Array de recipientes necesarios para la recogida de muestras. Está vacío cuando no se han añadido paneles ni biomarcadores a la cita. También está vacío cuando todavía no se puede resolver la ubicación y el día de la cita, por ejemplo, cuando no tiene hora programada.

**recipiente**

**type** `string`

Identificador del tipo de recipiente. Uno de `serum`, `serum_capillary`, `serum_capillary_plain`, `edta`, `edta_capillary`, `citrate`, `lihep`, `lihep_capillary`, `glucoexact`, `fluoride`, `fluoride_capillary`, `homocysteine`, `urine`, `dried_blood_spot`, `swab`, `stool`, `saliva`, `hair` o `trace_metal`.

**name** `string`

Nombre legible del recipiente (p. ej., "Serum", "EDTA", "Li-Heparin").

**cap\_color** `string`

Código de color hexadecimal de la tapa del recipiente para mostrar (p. ej., `"#A0784B"`). `null` cuando el
recipiente no tiene tapa.

**volume** `string`

Capacidad de volumen del recipiente (p. ej., `"7.5 ml"`). `null` cuando no aplica el volumen.

**article\_number** `string`

Número de catálogo del fabricante (REF), cuando se conoce (p. ej., `"01.1602.001"`). Se omite en los recipientes sin número de artículo asignado.

**count** `integer`

Número de recipientes necesarios de este tipo.

**routing** `null`

Detalles de enrutamiento del laboratorio: no se exponen intencionadamente, siempre `null`.

**pricing** `object | null`

El importe de todo el carrito para la cita, según tu tarifa. `null` cuando la cita no tiene pruebas
asociadas o cuando tu clave no tiene el ámbito `prices_view`. [Precios](https://docs.anivahealth.com/es/concepts/pricing.md) explica el
modelo; los importes individuales siguen la referencia de [objetos de
precio](https://docs.anivahealth.com/es/api/biomarkers/list-biomarkers.md#objetos-de-precio).

**Campos del importe**

**total\_cents** `integer`

Lo que cuesta el carrito según tu tarifa: las posiciones con precio más los paneles con precio más las filas
de biomarcadores con precio. Una fila con `price_cents: null` no suma nada, por lo que un carrito que incluya una tendrá un total menor
de lo que costará.

**retail\_total\_cents** `integer`

El mismo total según la tarifa de venta recomendada.

**fees** `object`

Los cargos que añade una extracción de sangre según tu tarifa, en céntimos. Se cobran en la factura mensual. Consulta [Obtener lista de
tarifas](https://docs.anivahealth.com/es/api/pricing/get-rate-card.md).

**cargos**

**phlebotomy\_fee\_cents** `integer`

Cargo por flebotomía por cita completada.

**snack\_fee\_cents** `integer`

Tentempié para el paciente. Se factura solo cuando el paciente recibe un tentempié. Se omite cuando tus
pacientes no reciben ninguno; ponte en contacto con Aniva para ofrecer tentempiés.

**logistics\_fee\_cents** `integer`

Cargo de mensajería por la recogida. Tus citas en la misma ubicación el mismo día comparten un
único cargo.

**material\_fee\_cents** `integer`

Consumibles: tubos, etiquetas, bolsa.

**total\_with\_fees\_cents** `integer`

`total_cents` más todas las tarifas en `fees`, con la tarifa de logística completa. Es menor cuando otra de
tus citas comparte la recogida.

**positions** `object[]`

Cada posición aplicada en este carrito — se factura una vez, al completo, y entrega todos sus
elementos. Incluye `id`, `name`, `price_cents`, `retail_cents` y `tier`. Una posición que no es
visible para partners sigue aplicándose y facturándose, y se devuelve con `id` y `name` en
`null`.

**panels** `object[]`

Cada panel asociado, con `id`, `name`, `price_cents` y `retail_cents`.

**biomarkers** `object[]`

Una fila por cada biomarcador **entregado** — lo que pediste, más los componentes que incorporaron
sus ratios y los elementos que entregan sus posiciones.

**id** `number`

Identificador del biomarcador.

**name** `string`

Nombre visible del biomarcador.

**price\_cents** `integer | null`

Lo que cuesta esta fila en tu tarifa, con `retail_cents` al lado. `0` cuando la cubre una
posición; `null` cuando Aniva no puede calcular su precio.

**required\_by** `number[]`

Los ratios que incorporaron este componente al carrito. Se omite si ninguno lo hizo. Un componente se
paga una sola vez por carrito, independientemente de cuántos ratios dependan de él.

**requires** `number[]`

Presente cuando esta fila ES un ratio: los componentes por los que se factura.

**via\_position** `string`

La posición que cubre este marcador, motivo por el cual la fila cuesta `0`. Se omite cuando nada
lo cubre. `null` cuando la posición que lo cubre no es visible para partners.

## Respuestas de error

| Estado | Descripción |
| - | - |
| `400` | Formato de ID no válido — el valor proporcionado no es un UUID válido. |
| `403` | Prohibido — tu clave de API no tiene acceso a esta operación. |
| `404` | Cita no encontrada. |
| `500` | Error interno del servidor. |

```bash cURL theme={null}
curl --request GET \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a/preview \
  --header 'x-api-key: YOUR_API_KEY'
```

```json 200 theme={null}
{
  "containers": [
    {
      "type": "serum",
      "name": "Serum",
      "cap_color": "#A0784B",
      "volume": "7.5 ml",
      "article_number": "01.1602.001",
      "count": 3
    },
    {
      "type": "edta",
      "name": "EDTA",
      "cap_color": "#D13438",
      "volume": "3.4 ml",
      "article_number": "04.1914.001",
      "count": 2
    },
    {
      "type": "glucoexact",
      "name": "GlucoEXACT",
      "cap_color": "#9E9E9E",
      "volume": "3.1 ml",
      "article_number": "05.1074.001",
      "count": 1
    }
  ],
  "routing": null,
  "pricing": {
    "total_cents": 13751,
    "retail_total_cents": 17029,
    "fees": {
      "phlebotomy_fee_cents": 2500,
      "snack_fee_cents": 500,
      "logistics_fee_cents": 2000,
      "material_fee_cents": 250
    },
    "total_with_fees_cents": 19001,
    "positions": [
      {
        "id": "b7d4c2e1-9a3f-4c8b-91d2-5e6f7a8b9c0d",
        "name": "Aniva Blood Count",
        "price_cents": 452,
        "retail_cents": 520,
        "tier": "routine"
      }
    ],
    "panels": [
      {
        "id": "f1c2d4a3-7b8e-4f2a-9c1d-2e3f4a5b6c7d",
        "name": "Hormones (Female)",
        "price_cents": 11900,
        "retail_cents": 14900
      }
    ],
    "biomarkers": [
      { "id": 42, "name": "HDL Cholesterol", "price_cents": 233, "retail_cents": 268, "required_by": [279] },
      {
        "id": 71,
        "name": "Hemoglobin",
        "price_cents": 0,
        "retail_cents": 0,
        "via_position": "b7d4c2e1-9a3f-4c8b-91d2-5e6f7a8b9c0d"
      },
      { "id": 84, "name": "High-Sensitivity C-Reactive Protein (hs-CRP)", "price_cents": 1166, "retail_cents": 1341, "required_by": [279] },
      { "id": 279, "name": "hs-CRP / HDL Ratio", "price_cents": 0, "retail_cents": 0, "requires": [42, 84] }
    ]
  }
}
```

```json 200 (no panels) theme={null}
{
  "containers": [],
  "routing": null,
  "pricing": null
}
```

```json 200 (one item without a price) theme={null}
{
  "containers": [],
  "routing": null,
  "pricing": {
    "total_cents": 11900,
    "retail_total_cents": 14900,
    "fees": {
      "phlebotomy_fee_cents": 2500,
      "snack_fee_cents": 500,
      "logistics_fee_cents": 2000,
      "material_fee_cents": 250
    },
    "total_with_fees_cents": 17150,
    "positions": [],
    "panels": [
      {
        "id": "f1c2d4a3-7b8e-4f2a-9c1d-2e3f4a5b6c7d",
        "name": "Hormones (Female)",
        "price_cents": 11900,
        "retail_cents": 14900
      }
    ],
    "biomarkers": [{ "id": 555, "name": "Poppy Seeds (Pap s)", "price_cents": null, "retail_cents": null }]
  }
}
```

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


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