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

# Calculează prețul coșului

> Calculează prețul pentru paneluri și biomarkeri fără o programare

Returnează nota de plată pentru paneluri și biomarkeri la grila ta de tarife. Nu ai nevoie de
programare. Nu se rezervă nimic.

Nota de plată este aceeași cu `pricing` din [Previzualizează programarea](https://docs.anivahealth.com/ro/api/appointments/preview-containers.md),
plus ce adaugă modul de prelevare a probei. Implicit, acesta este o recoltare de sânge într-o
locație, cu taxele de programare. Trimite `fulfilment: "home_kit"` și un `country_code` pentru a
calcula în schimb prețul unui kit trimis prin poștă în acea țară: taxa de kit, dispozitivele de
recoltare, taxele poștale dus-întors, manșonul și o pungă de rezervă cu lanțete, așa cum le
include factura ta lunară. [Prețuri](https://docs.anivahealth.com/ro/concepts/pricing.md) explică cum stabilește Aniva prețurile
testelor.

Necesită scope-ul `prices_view`.

## Cerere

### Parametri de corp

Trimite cel puțin un ID în `panel_ids` sau `biomarker_ids`.

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

Paneluri pentru care se calculează prețul, cel mult 50. Fiecare trebuie să apară în [Listează
panelurile](https://docs.anivahealth.com/ro/api/panels/list-panels.md) pentru cheia ta.

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

Biomarkeri pentru care se calculează prețul, cel mult 500.

**sex** `integer`

Sexul biologic conform ISO/IEC 5218: `1` = masculin, `2` = feminin. Unele paneluri adaugă
biomarkeri doar pentru un anumit sex sau o anumită vârstă. Trimite `sex` și `date_of_birth`
împreună pentru a aplica aceste reguli. Fără ele, regulile nu se aplică.

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

Data nașterii, `YYYY-MM-DD`. Trimite-o împreună cu `sex`.

**rate\_card** `string`

Grila de tarife după care se calculează prețul: `retail` sau `id`-ul din [Obține grila de
tarife](https://docs.anivahealth.com/ro/api/pricing/get-rate-card.md). Implicit: grila de tarife a cheii tale API, altfel retail.

**fulfilment** `string`

Modul în care se prelevează proba. `draw` (implicit): o recoltare de sânge într-o locație, care
adaugă taxele de programare. `home_kit`: un kit trimis prin poștă în `country_code`, care adaugă
în schimb liniile pentru kit. Un kit de testare la domiciliu conține exact un panel, iar panelul
trebuie să fie vândut ca kit de testare la domiciliu.

**country\_code** `string`

Țara de livrare a kitului, ISO 3166-1 alpha-2 (`DE`, `SE`). Obligatoriu cu
`fulfilment: "home_kit"` și doar atunci. Determină liniile pentru taxele poștale.

## Răspuns

**total\_cents** `integer`

Prețul testelor conform grilei tale de tarife: fiecare poziție, panel și rând de biomarker cu
preț. Un rând cu `price_cents: null` nu adaugă nimic.

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

Același preț conform grilei recomandate de retail.

**fees** `object`

Taxele unei programări, în cenți. Aniva le include pe factura ta lunară. Se aplică pentru un
`draw`; un `home_kit` facturează în schimb liniile din `fulfilment`.

**taxe**

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

Per programare finalizată.

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

Per programare în care pacientul primește o gustare. Lipsește când pacienții tăi nu primesc
gustare. Pentru a oferi gustări, contactează Aniva.

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

Per ridicare prin curier. Programările tale din aceeași locație, în aceeași zi, împart o
singură ridicare.

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

Per programare finalizată. Acoperă eprubetele, etichetele și punga.

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

`total_cents` plus ce adaugă modul de prelevare. Pentru un `draw`: fiecare taxă din `fees`.
Include taxa integrală de logistică, iar o ridicare comună face suma reală mai mică. Pentru un
`home_kit`: `fulfilment.total_cents`.

**fulfilment** `object`

Modul în care se prelevează proba și ce adaugă acesta. `kind` este `draw` sau `home_kit`. Un
`draw` nu are niciun alt câmp.

**home\_kit**

**country\_code** `string`

Țara de livrare pentru care au fost calculate taxele poștale.

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

Kitul sub forma căruia se livrează panelul. `null` când Aniva nu a configurat încă unul;
estimarea nu include atunci niciun dispozitiv.

**devices** `integer`

Dispozitivele de recoltare din cutie, fiecare facturat la taxa de dispozitiv.

**lines** `object[]`

Liniile de kit pe care o comandă le adaugă pe factura ta lunară, fiecare cu `description`,
`quantity`, `unit`, `unit_cents` și `amount_cents`. Taxele poștale sunt calculate după
serviciile pe care pasul de expediere le rezervă pentru această țară. O taxă de 0 din grila
ta nu generează nicio linie. Un credit preplătit pentru materiale nu se scade aici.

**total\_cents** `integer`

Suma valorilor din `lines`, net.

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

Facturată suplimentar, net, când nu activezi kitul înainte să ajungă la laborator, iar
laboratorul îl activează. Nu este inclusă în `lines` sau `total_cents`. 0 înseamnă că grila
ta nu are o astfel de taxă.

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

Segmentele (`out`, `back`) pe care grila ta le tarifează pe țară, dar nu are preț pentru
această țară. Au revenit la taxa poștală fixă sau la 0 când grila nu are una. Gol când
fiecare segment și-a găsit prețul.

**positions** `object[]`

Pozițiile din nota de plată. O poziție este un set de biomarkeri cu un singur preț. Are `id`,
`name`, `price_cents`, `retail_cents` și `tier`. `id` și `name` sunt `null` pentru o poziție
pe care Aniva nu a publicat-o încă.

**panels** `object[]`

Panelurile din nota de plată, cu `id`, `name`, `price_cents` și `retail_cents`.

**biomarkers** `object[]`

Un rând per biomarker pe care îl primești. Aceasta include componentele unui raport și fiecare
membru al unei poziții.

**rând biomarker**

**id** `number`

ID-ul biomarkerului.

**name** `string`

Numele biomarkerului.

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

Prețul acestui rând, cu `retail_cents` alături. `0` când o poziție sau un panel îl acoperă.

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

Rapoartele care au nevoie de acest biomarker. Îl plătești o singură dată.

**requires** `number[]`

Doar pe un raport: biomarkerii din care se calculează.

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

Poziția care acoperă acest rând. `null` când poziția nu este încă publicată.

## Răspunsuri de eroare

| Status | Descriere |
| - | - |
| `400` | Corpul cererii este invalid sau cheia ta nu poate folosi `rate_card`. |
| `400` | O estimare `home_kit` necesită exact un panel, un panel vândut ca kit de testare la domiciliu și un cod de țară. |
| `400` | `biomarker_not_available`: niciun laborator pe care cheia ta îl poate folosi nu efectuează biomarkerul. |
| `400` | `biomarker_not_priced`: biomarkerul nu are preț. |
| `400` | `biomarker_requires_position`: biomarkerul se vinde doar într-o poziție. Corpul răspunsului listează pozițiile. |
| `403` | Cheia ta API nu are scope-ul `prices_view`. |
| `404` | `Panels not found`: panelul nu există sau cheia ta nu îl poate lista. |
| `404` | `Biomarkers not found`: biomarkerul nu există. |
| `500` | Eroare internă de server. |

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