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

# Wyceń koszyk

> Wyceń panele i biomarkery bez umawiania wizyty

Zwraca rachunek za panele i biomarkery według twojego cennika. Nie potrzebujesz wizyty. Nic nie jest
rezerwowane.

Rachunek jest taki sam jak `pricing` w [Podgląd wizyty](https://docs.anivahealth.com/pl/api/appointments/preview-containers.md),
plus koszty wynikające ze sposobu pobrania próbki. Domyślnie jest to pobranie krwi w lokalizacji wraz z
opłatami za wizytę. Zamiast tego wyślij `fulfilment: "home_kit"` oraz `country_code`, aby wycenić jeden zestaw wysłany
do tego kraju: opłatę za zestaw, urządzenia do pobrania, wysyłkę tam i z powrotem, osłonkę
i zapasowy woreczek na lancety, tak jak rozlicza je twoja miesięczna faktura.
[Cennik](https://docs.anivahealth.com/pl/concepts/pricing.md) wyjaśnia, jak Aniva wycenia badania.

Wymaga zakresu `prices_view`.

## Żądanie

### Parametry treści

Wyślij co najmniej jedno id w `panel_ids` lub `biomarker_ids`.

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

Panele do wyceny, maksymalnie 50. Każdy musi znajdować się w [Lista paneli](https://docs.anivahealth.com/pl/api/panels/list-panels.md) dla twojego klucza.

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

Biomarkery do wyceny, maksymalnie 500.

**sex** `integer`

Płeć biologiczna według ISO/IEC 5218: `1` = mężczyzna, `2` = kobieta. Niektóre panele dodają biomarkery tylko dla jednej
płci lub określonego wieku. Wyślij `sex` i `date_of_birth` razem, aby zastosować te reguły. Bez nich reguły
nie są stosowane.

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

Data urodzenia, `YYYY-MM-DD`. Wyślij ją razem z `sex`.

**rate\_card** `string`

Cennik użyty do wyceny: `retail` lub `id` z [Pobierz cennik](https://docs.anivahealth.com/pl/api/pricing/get-rate-card.md).
Domyślnie: cennik twojego klucza API, w przeciwnym razie detaliczny.

**fulfilment** `string`

Sposób pobrania próbki. `draw` (domyślnie): pobranie krwi w lokalizacji, co dolicza opłaty za
wizytę. `home_kit`: jeden zestaw wysłany do `country_code`, co zamiast tego dolicza pozycje zestawu. Domowy zestaw testowy
zawiera dokładnie jeden panel i musi to być panel sprzedawany jako domowy zestaw testowy.

**country\_code** `string`

Kraj dostawy zestawu, ISO 3166-1 alpha-2 (`DE`, `SE`). Wymagany przy
`fulfilment: "home_kit"` i tylko wtedy. Określa pozycje wysyłki.

## Odpowiedź

**total\_cents** `integer`

Cena badań według twojego cennika: każda wyceniona pozycja, panel i wiersz biomarkera. Wiersz
z `price_cents: null` nic nie dolicza.

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

Ta sama cena według sugerowanego cennika detalicznego.

**fees** `object`

Opłaty za jedną wizytę, w centach. Aniva rozlicza je na twojej miesięcznej fakturze. Dotyczą
`draw`; przy `home_kit` rozliczane są zamiast tego pozycje w `fulfilment`.

**opłaty**

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

Za zrealizowaną wizytę.

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

Za wizytę, podczas której pacjent dostaje przekąskę. Brak pola, gdy twoi pacjenci nie dostają przekąsek. Aby
oferować przekąski, skontaktuj się z Aniva.

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

Za odbiór kurierski. Twoje wizyty w tej samej lokalizacji tego samego dnia dzielą jeden odbiór.

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

Za zrealizowaną wizytę. Obejmuje probówki, etykiety i woreczek.

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

`total_cents` plus koszt realizacji. Dla `draw`: każda opłata z `fees`. Uwzględnia pełną
opłatę logistyczną, a wspólny odbiór obniża rzeczywistą kwotę. Dla `home_kit`:
`fulfilment.total_cents`.

**fulfilment** `object`

Sposób pobrania próbki i doliczone koszty. `kind` ma wartość `draw` lub `home_kit`. `draw` nie ma innych
pól.

**home\_kit**

**country\_code** `string`

Kraj dostawy, dla którego wyceniono wysyłkę.

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

Zestaw, w jakim wysyłany jest panel. `null`, gdy Aniva jeszcze takiego nie przygotowała; wycena nie uwzględnia wtedy
żadnego urządzenia.

**devices** `integer`

Urządzenia do pobrania w pudełku, każde rozliczane według opłaty za urządzenie.

**lines** `object[]`

Pozycje zestawu, które jedno zamówienie dodaje do twojej miesięcznej faktury – każda zawiera `description`, `quantity`,
`unit`, `unit_cents` i `amount_cents`. Wysyłka jest wyceniana według usług rezerwowanych na etapie wysyłki
dla tego kraju. Opłata równa 0 w twoim cenniku nie tworzy pozycji. Przedpłacony kredyt na materiały nie jest
tu odliczany.

**total\_cents** `integer`

Suma `lines`, netto.

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

Doliczana dodatkowo, netto, gdy nie aktywujesz zestawu przed dotarciem do laboratorium i zrobi to
laboratorium. Nie ma jej w `lines` ani w `total_cents`. 0 oznacza, że twój cennik nie zawiera takiej opłaty.

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

Kierunki przesyłki (`out`, `back`), które twój cennik wycenia dla poszczególnych krajów, ale nie ma dla nich ceny w tym kraju. Zastosowano
dla nich ryczałtową opłatę za wysyłkę lub 0, gdy cennik jej nie ma. Puste, gdy dla każdego kierunku znaleziono
cenę.

**positions** `object[]`

Pozycje na rachunku. Pozycja to zestaw biomarkerów z jedną ceną. Zawiera `id`, `name`,
`price_cents`, `retail_cents` i `tier`. `id` oraz `name` mają wartość `null` dla pozycji, której Aniva jeszcze nie
opublikowała.

**panels** `object[]`

Panele na rachunku, zawierające `id`, `name`, `price_cents` i `retail_cents`.

**biomarkers** `object[]`

Jeden wiersz na każdy otrzymywany biomarker. Obejmuje składowe wskaźnika i każdy element
pozycji.

**wiersz biomarkera**

**id** `number`

ID biomarkera.

**name** `string`

Nazwa biomarkera.

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

Cena tego wiersza, z `retail_cents` obok. `0`, gdy pokrywa go pozycja lub
panel.

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

Wskaźniki, które wymagają tego biomarkera. Płacisz za niego raz.

**requires** `number[]`

Tylko dla wskaźnika: biomarkery, na podstawie których jest obliczany.

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

Pozycja pokrywająca ten wiersz. `null`, gdy pozycja nie została jeszcze opublikowana.

## Odpowiedzi z błędami

| Status | Opis |
| - | - |
| `400` | Treść żądania jest nieprawidłowa lub twój klucz nie może używać `rate_card`. |
| `400` | Wycena `home_kit` wymaga dokładnie jednego panelu, panelu sprzedawanego jako domowy zestaw testowy oraz kodu kraju. |
| `400` | `biomarker_not_available`: żadne laboratorium dostępne dla twojego klucza nie bada tego biomarkera. |
| `400` | `biomarker_not_priced`: biomarker nie ma ceny. |
| `400` | `biomarker_requires_position`: biomarker jest sprzedawany tylko w ramach pozycji. Treść odpowiedzi zawiera listę pozycji. |
| `403` | Twój klucz API nie ma zakresu `prices_view`. |
| `404` | `Panels not found`: panel nie istnieje lub twój klucz nie może go wyświetlić. |
| `404` | `Biomarkers not found`: biomarker nie istnieje. |
| `500` | Wewnętrzny błąd serwera. |

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