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

# Presupuestar carrito

> Calcular el precio de paneles y biomarcadores sin cita

Devuelve el presupuesto de paneles y biomarcadores según tu tarifa. No necesitas ninguna cita. No
se reserva nada.

El presupuesto es el mismo que `pricing` en [Previsualizar cita](https://docs.anivahealth.com/es/api/appointments/preview-containers.md),
más lo que añade la forma de tomar la muestra. Por defecto es una extracción de sangre en una
ubicación, con los cargos de la cita. Envía `fulfilment: "home_kit"` y un `country_code` para
calcular el precio de un kit enviado por correo a ese país en su lugar: el cargo del kit, los
dispositivos de recogida, el envío de ida y vuelta, la funda y una bolsa de lancetas de repuesto,
tal como los cobra tu factura mensual. [Precios](https://docs.anivahealth.com/es/concepts/pricing.md) explica cómo calcula Aniva el
precio de las pruebas.

Requiere el scope `prices_view`.

## Solicitud

### Parámetros del cuerpo

Envía al menos un ID en `panel_ids` o `biomarker_ids`.

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

Paneles para calcular el precio, como máximo 50. Cada uno debe estar en [Listar paneles](https://docs.anivahealth.com/es/api/panels/list-panels.md) para tu clave.

**biomarker\_ids** `number[]`

Biomarcadores para calcular el precio, como máximo 500.

**sex** `integer`

Sexo biológico según ISO/IEC 5218: `1` = masculino, `2` = femenino. Algunos paneles añaden
biomarcadores solo para un sexo o una edad. Envía `sex` y `date_of_birth` juntos para aplicar estas
reglas. Sin ellos, las reglas no se aplican.

**date\_of\_birth** `string`

Fecha de nacimiento, `YYYY-MM-DD`. Envíala junto con `sex`.

**rate\_card** `string`

La tarifa con la que calcular precios: `retail` o el `id` de [Obtener tarifa](https://docs.anivahealth.com/es/api/pricing/get-rate-card.md).
Por defecto: la tarifa de tu clave API; si no, la de venta al público.

**fulfilment** `string`

Cómo se toma la muestra. `draw` (por defecto): una extracción de sangre en una ubicación, que añade
los cargos de la cita. `home_kit`: un kit enviado por correo a `country_code`, que añade las líneas
del kit en su lugar. Un kit de prueba en casa contiene exactamente un panel, y el panel debe
venderse como kit de prueba en casa.

**country\_code** `string`

El país de entrega del kit, ISO 3166-1 alfa-2 (`DE`, `SE`). Obligatorio con
`fulfilment: "home_kit"`, y solo en ese caso. Determina las líneas de envío.

## Respuesta

**total\_cents** `integer`

El precio de las pruebas según tu tarifa: cada posición, panel y fila de biomarcador con precio.
Una fila con `price_cents: null` no suma nada.

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

El mismo precio según la tarifa de venta al público recomendada.

**fees** `object`

Los cargos de una cita, en céntimos. Aniva los cobra en tu factura mensual. Se aplican a un
`draw`; un `home_kit` factura las líneas de `fulfilment` en su lugar.

**cargos**

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

Por cita completada.

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

Por cita en la que el paciente recibe un tentempié. No aparece si tus pacientes no reciben
tentempié. Para ofrecer tentempiés, contacta con Aniva.

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

Por recogida de mensajería. Tus citas en la misma ubicación el mismo día comparten una
recogida.

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

Por cita completada. Cubre tubos, etiquetas y la bolsa.

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

`total_cents` más lo que añade la toma de muestra. Para un `draw`: todos los cargos de `fees`.
Cuenta el cargo de logística completo, y una recogida compartida reduce el importe real. Para un
`home_kit`: `fulfilment.total_cents`.

**fulfilment** `object`

Cómo se toma la muestra y qué añade. `kind` es `draw` o `home_kit`. Un `draw` no tiene ningún otro
campo.

**home\_kit**

**country\_code** `string`

El país de entrega para el que se calculó el envío.

**kit\_ref** `string | null`

El kit con el que se envía el panel. `null` cuando Aniva aún no ha configurado uno; en ese
caso, el presupuesto no cuenta ningún dispositivo.

**devices** `integer`

Dispositivos de recogida en la caja, cada uno facturado con el cargo por dispositivo.

**lines** `object[]`

Las líneas del kit que un pedido añade a tu factura mensual, cada una con `description`,
`quantity`, `unit`, `unit_cents` y `amount_cents`. El envío se calcula según los servicios que
el paso de envío reserva para este país. Un cargo de 0 en tu tarifa no genera ninguna línea.
El crédito de material prepagado no se descuenta aquí.

**total\_cents** `integer`

La suma de `lines`, neta.

**activation\_fee\_cents** `integer`

Se cobra aparte, en neto, si no activas el kit antes de que llegue al laboratorio y lo activa
el laboratorio. No está en `lines` ni en `total_cents`. 0 significa que tu tarifa no tiene
este cargo.

**unpriced\_postage\_legs** `string[]`

Trayectos (`out`, `back`) que tu tarifa calcula por país pero para los que no tiene precio en
este país. Se aplicó el cargo fijo de envío, o 0 si tu tarifa no tiene ninguno. Vacío cuando
cada trayecto tiene precio.

**positions** `object[]`

Las posiciones del presupuesto. Una posición es un conjunto de biomarcadores con un único precio.
Tiene `id`, `name`, `price_cents`, `retail_cents` y `tier`. `id` y `name` son `null` para una
posición que Aniva aún no ha publicado.

**panels** `object[]`

Los paneles del presupuesto, con `id`, `name`, `price_cents` y `retail_cents`.

**biomarkers** `object[]`

Una fila por cada biomarcador que recibes. Incluye los componentes de un ratio y cada miembro de
una posición.

**fila de biomarcador**

**id** `number`

ID del biomarcador.

**name** `string`

Nombre del biomarcador.

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

El precio de esta fila, junto con `retail_cents`. `0` cuando una posición o un panel lo cubre.

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

Los ratios que necesitan este biomarcador. Solo lo pagas una vez.

**requires** `number[]`

Solo en un ratio: los biomarcadores a partir de los que se calcula.

**via\_position** `string | null`

La posición que cubre esta fila. `null` cuando la posición aún no está publicada.

## Respuestas de error

| Estado | Descripción |
| - | - |
| `400` | El cuerpo no es válido o tu clave no puede usar ese `rate_card`. |
| `400` | Un presupuesto de `home_kit` necesita exactamente un panel, que se venda como kit de prueba en casa, y un código de país. |
| `400` | `biomarker_not_available`: ningún laboratorio que tu clave pueda usar analiza este biomarcador. |
| `400` | `biomarker_not_priced`: el biomarcador no tiene precio. |
| `400` | `biomarker_requires_position`: el biomarcador solo se vende en una posición. El cuerpo lista las posiciones. |
| `403` | Tu clave API no tiene el scope `prices_view`. |
| `404` | `Panels not found`: el panel no existe o tu clave no puede listarlo. |
| `404` | `Biomarkers not found`: el biomarcador no existe. |
| `500` | Error interno del servidor. |

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/pricing/quote \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "biomarker_ids": [63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 204, 206, 207, 209, 249]
  }'
```

```bash cURL (home kit) theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/pricing/quote \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "panel_ids": ["4d0423c5-6538-48f6-ac93-435f61e456e9"],
    "fulfilment": "home_kit",
    "country_code": "DE"
  }'
```

```json 200 theme={null}
{
  "total_cents": 210,
  "retail_total_cents": 451,
  "fees": {
    "phlebotomy_fee_cents": 2500,
    "logistics_fee_cents": 2000,
    "material_fee_cents": 250
  },
  "total_with_fees_cents": 4960,
  "fulfilment": { "kind": "draw" },
  "positions": [
    { "id": null, "name": null, "price_cents": 210, "retail_cents": 451, "tier": "routine" }
  ],
  "panels": [],
  "biomarkers": [
    { "id": 63, "name": "Eosinophils", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 64, "name": "Lymphocytes", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 65, "name": "Neutrophils", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 66, "name": "Monocytes", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 67, "name": "White Blood Cells (WBC)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 68, "name": "Basophils", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 69, "name": "Hematocrit", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 70, "name": "Red Blood Cells (RBC)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 71, "name": "Hemoglobin", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 72, "name": "Platelets", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 73, "name": "Mean Corpuscular Hemoglobin Concentration (MCHC)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 74, "name": "Mean Corpuscular Volume (MCV)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 75, "name": "Red Cell Distribution Width (RDW)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 76, "name": "Mean Corpuscular Hemoglobin (MCH)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 204, "name": "Lymphocytes (%)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 206, "name": "Eosinophils (%)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 207, "name": "Basophils (%)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 209, "name": "Monocytes (%)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 249, "name": "Neutrophils (%)", "price_cents": 0, "retail_cents": 0, "via_position": null }
  ]
}
```

```json 200 (home kit) theme={null}
{
  "total_cents": 2081,
  "retail_total_cents": 6702,
  "fees": {
    "phlebotomy_fee_cents": 2000,
    "logistics_fee_cents": 2000,
    "material_fee_cents": 0
  },
  "total_with_fees_cents": 4971,
  "fulfilment": {
    "kind": "home_kit",
    "country_code": "DE",
    "kit_ref": "TAS-1-1S1E",
    "devices": 1,
    "lines": [
      { "description": "Home kit (per order)", "quantity": 1, "unit": "kits", "unit_cents": 720, "amount_cents": 720 },
      { "description": "Collection device (per device)", "quantity": 1, "unit": "devices", "unit_cents": 1250, "amount_cents": 1250 },
      { "description": "Postage to the customer (per kit sent)", "quantity": 1, "unit": "kits sent", "unit_cents": 370, "amount_cents": 370 },
      { "description": "Return postage (per kit sent)", "quantity": 1, "unit": "kits sent", "unit_cents": 400, "amount_cents": 400 },
      { "description": "Spare lancet bag (per kit sent with one)", "quantity": 1, "unit": "bags", "unit_cents": 150, "amount_cents": 150 }
    ],
    "total_cents": 2890,
    "activation_fee_cents": 100,
    "unpriced_postage_legs": []
  },
  "positions": [],
  "panels": [
    { "id": "4d0423c5-6538-48f6-ac93-435f61e456e9", "name": "Doctrinus - Gesundheitsprofil 6 (Männer)", "price_cents": 2081, "retail_cents": 6702 }
  ],
  "biomarkers": []
}
```

```json 404 theme={null}
{
  "error": "Panels not found: f1c2d4a3-7b8e-4f2a-9c1d-2e3f4a5b6c7d"
}
```


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