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

# Pressuposta la cistella

> Calcula el preu de panells i biomarcadors sense cita

Retorna el compte dels panells i biomarcadors amb la teva tarifa. No et cal cap cita. No es
reserva res.

El compte és el mateix que `pricing` a [Previsualitza la cita](https://docs.anivahealth.com/ca/api/appointments/preview-containers.md),
més el que afegeix la manera de prendre la mostra. Per defecte és una extracció de sang en una
ubicació, amb els càrrecs de la cita. Envia `fulfilment: "home_kit"` i un `country_code` per
calcular, en lloc d'això, el preu d'un kit enviat per correu a aquell país: el càrrec del kit, els
dispositius de recollida, l'enviament postal d'anada i tornada, la funda i una bossa de llancetes
de recanvi, tal com els cobra la teva factura mensual.
[Preus](https://docs.anivahealth.com/ca/concepts/pricing.md) explica com Aniva fixa el preu de les proves.

Requereix el permís `prices_view`.

## Sol·licitud

### Paràmetres del cos

Envia com a mínim un identificador a `panel_ids` o `biomarker_ids`.

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

Panells per calcular-ne el preu, com a màxim 50. Cadascun ha d'aparèixer a [Llista els
panells](https://docs.anivahealth.com/ca/api/panels/list-panels.md) per a la teva clau.

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

Biomarcadors per calcular-ne el preu, com a màxim 500.

**sex** `integer`

Sexe biològic segons ISO/IEC 5218: `1` = masculí, `2` = femení. Alguns panells afegeixen
biomarcadors només per a un sexe o una edat. Envia `sex` i `date_of_birth` junts per aplicar
aquestes regles. Sense ells, les regles no s'apliquen.

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

Data de naixement, `YYYY-MM-DD`. Envia-la amb `sex`.

**rate\_card** `string`

La tarifa per calcular els preus: `retail`, o l'`id` d'[Obtén la tarifa](https://docs.anivahealth.com/ca/api/pricing/get-rate-card.md).
Per defecte: la tarifa de la teva clau API; si no, la de venda al públic.

**fulfilment** `string`

Com es pren la mostra. `draw` (per defecte): una extracció de sang en una ubicació, que afegeix
els càrrecs de la cita. `home_kit`: un kit enviat per correu a `country_code`, que afegeix les
línies del kit en lloc d'això. Un kit de prova a casa conté exactament un panell, i el panell s'ha
de vendre com a kit de prova a casa.

**country\_code** `string`

El país de lliurament del kit, ISO 3166-1 alfa-2 (`DE`, `SE`). Obligatori amb
`fulfilment: "home_kit"`, i només en aquest cas. Selecciona les línies d'enviament postal.

## Resposta

**total\_cents** `integer`

El preu de les proves segons la teva tarifa: cada posició, panell i fila de biomarcador amb preu.
Una fila amb `price_cents: null` no suma res.

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

El mateix preu segons la tarifa recomanada de venda al públic.

**fees** `object`

Els càrrecs d'una cita, en cèntims. Aniva els cobra a la teva factura mensual. S'apliquen a un
`draw`; en un `home_kit` es cobren les línies de `fulfilment` en lloc d'això.

**càrrecs**

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

Per cita completada.

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

Per cita en què el pacient rep un refrigeri. No apareix quan els teus pacients no reben
refrigeri. Per oferir refrigeris, contacta amb Aniva.

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

Per recollida de missatgeria. Les teves cites a la mateixa ubicació el mateix dia comparteixen
una sola recollida.

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

Per cita completada. Cobreix els tubs, les etiquetes i la bossa.

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

`total_cents` més el que afegeix la modalitat de recollida. Per a un `draw`: tots els càrrecs de
`fees`. Inclou el càrrec de logística complet, i una recollida compartida fa que l'import real
sigui més baix. Per a un `home_kit`: `fulfilment.total_cents`.

**fulfilment** `object`

Com es pren la mostra i què afegeix. `kind` és `draw` o `home_kit`. Un `draw` no té cap altre
camp.

**home\_kit**

**country\_code** `string`

El país de lliurament per al qual s'ha calculat l'enviament postal.

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

El kit amb què s'envia el panell. `null` quan Aniva encara no n'ha configurat cap; el
pressupost no compta llavors cap dispositiu.

**devices** `integer`

Dispositius de recollida a la caixa, cadascun facturat segons el càrrec de dispositiu.

**lines** `object[]`

Les línies del kit que una comanda afegeix a la teva factura mensual, cadascuna amb
`description`, `quantity`, `unit`, `unit_cents` i `amount_cents`. L'enviament postal es
calcula segons els serveis que reserva el pas d'enviament per a aquest país. Un càrrec de 0 a
la teva tarifa no genera cap línia. Aquí no es descompta cap crèdit de material prepagat.

**total\_cents** `integer`

La suma de `lines`, neta.

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

Es cobra a part, en import net, quan no actives el kit abans que arribi al laboratori i és el
laboratori qui l'activa. No s'inclou a `lines` ni a `total_cents`. 0 vol dir que la teva
tarifa no té aquest càrrec.

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

Trajectes (`out`, `back`) que la teva tarifa fixa per país però que no tenen preu en aquest
país. S'ha aplicat el càrrec fix d'enviament postal, o 0 quan la tarifa no en té cap. Buit quan
tots els trajectes han trobat el seu preu.

**positions** `object[]`

Les posicions del compte. Una posició és un conjunt de biomarcadors amb un sol preu. Té `id`,
`name`, `price_cents`, `retail_cents` i `tier`. `id` i `name` són `null` per a una posició que
Aniva encara no ha publicat.

**panels** `object[]`

Els panells del compte, amb `id`, `name`, `price_cents` i `retail_cents`.

**biomarkers** `object[]`

Una fila per cada biomarcador que reps. Això inclou els components d'una ràtio i cada membre d'una
posició.

**fila de biomarcador**

**id** `number`

Identificador del biomarcador.

**name** `string`

Nom del biomarcador.

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

El preu d'aquesta fila, amb `retail_cents` al costat. `0` quan una posició o un panell el
cobreix.

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

Les ràtios que necessiten aquest biomarcador. El pagues una sola vegada.

**requires** `number[]`

Només en una ràtio: els biomarcadors a partir dels quals es calcula.

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

La posició que cobreix aquesta fila. `null` quan la posició encara no s'ha publicat.

## Respostes d'error

| Estat | Descripció |
| - | - |
| `400` | El cos no és vàlid o la teva clau no pot fer servir el `rate_card`. |
| `400` | Un pressupost de `home_kit` necessita exactament un panell, que es vengui com a kit de prova a casa, i un codi de país. |
| `400` | `biomarker_not_available`: cap laboratori que la teva clau pugui fer servir analitza el biomarcador. |
| `400` | `biomarker_not_priced`: el biomarcador no té preu. |
| `400` | `biomarker_requires_position`: el biomarcador només es ven en una posició. El cos llista les posicions. |
| `403` | La teva clau API no té el permís `prices_view`. |
| `404` | `Panels not found`: el panell no existeix o la teva clau no el pot llistar. |
| `404` | `Biomarkers not found`: el biomarcador no existeix. |
| `500` | Error intern 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.