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

# Kosár árazása

> Árazz be paneleket és biomarkereket időpont nélkül

Visszaadja a panelek és biomarkerek költségösszesítőjét a díjszabásod szerint. Nincs szükség
időpontra. Nem történik foglalás.

A költségösszesítő megegyezik az [Időpont előnézete](https://docs.anivahealth.com/hu/api/appointments/preview-containers.md) végpont
`pricing` mezőjével, kiegészítve a mintavétel módjából adódó tételekkel. Alapértelmezés szerint ez
egy helyszíni vérvétel, az időpont díjaival. Küldj `fulfilment: "home_kit"` értéket és egy
`country_code` kódot, hogy helyette egy abba az országba postázott tesztkészlet árát számold ki: a
készlet díját, a mintavételi eszközöket, az oda- és visszaküldés postaköltségét, a védőtokot és egy
tartalék lándzsatasakot, ahogy a havi számládon is szerepelnek.
Az [Árazás](https://docs.anivahealth.com/hu/concepts/pricing.md) oldal bemutatja, hogyan árazza az Aniva a teszteket.

A `prices_view` scope szükséges hozzá.

## Kérés

### Törzsparaméterek

Küldj legalább egy azonosítót a `panel_ids` vagy a `biomarker_ids` mezőben.

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

Árazandó panelek, legfeljebb 50. Mindegyiknek szerepelnie kell a kulcsodhoz tartozó [Panelek
listázása](https://docs.anivahealth.com/hu/api/panels/list-panels.md) válaszban.

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

Árazandó biomarkerek, legfeljebb 500.

**sex** `integer`

Biológiai nem az ISO/IEC 5218 szerint: `1` = férfi, `2` = nő. Egyes panelek csak bizonyos nemhez
vagy életkorhoz adnak hozzá biomarkereket. Küldd el együtt a `sex` és a `date_of_birth` mezőt,
hogy ezek a szabályok érvényesüljenek. Nélkülük a szabályok nem lépnek életbe.

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

Születési dátum, `YYYY-MM-DD` formátumban. A `sex` mezővel együtt küldd el.

**rate\_card** `string`

Az árazáshoz használt díjszabás: `retail`, vagy a [Díjszabás lekérése](https://docs.anivahealth.com/hu/api/pricing/get-rate-card.md)
végpontból kapott `id`. Alapértelmezés: az API-kulcsod díjszabása, különben a kiskereskedelmi.

**fulfilment** `string`

A mintavétel módja. `draw` (alapértelmezett): helyszíni vérvétel, amely hozzáadja az időpont
díjait. `home_kit`: egy `country_code` szerinti országba postázott otthoni tesztkészlet, amely
helyette a készlet tételeit adja hozzá. Egy otthoni tesztkészlet pontosan egy panelt tartalmaz,
és a panelt otthoni tesztkészletként kell forgalmazni.

**country\_code** `string`

A tesztkészlet szállítási országa, ISO 3166-1 alpha-2 formátumban (`DE`, `SE`). Kötelező
`fulfilment: "home_kit"` esetén, és csak akkor. Ez választja ki a postaköltség tételeit.

## Válasz

**total\_cents** `integer`

A tesztek ára a díjszabásod szerint: minden árazott pozíció, panel és biomarkersor. A
`price_cents: null` értékű sor nem ad hozzá semmit.

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

Ugyanez az ár az ajánlott kiskereskedelmi díjszabás szerint.

**fees** `object`

Egy időpont díjai, centben. Az Aniva a havi számládon számlázza ki őket. A `draw` esetére
vonatkoznak; a `home_kit` helyettük a `fulfilment` tételeit számlázza ki.

**díjak**

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

Teljesített időpontonként.

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

Minden olyan időpont után, ahol a páciens harapnivalót kap. Hiányzik, ha a pácienseid nem
kapnak harapnivalót. Ha szeretnél harapnivalót biztosítani, vedd fel a kapcsolatot az
Anivával.

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

Futárfelvételenként. Az ugyanazon a helyszínen és ugyanazon a napon lévő időpontjaid egy
felvételen osztoznak.

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

Teljesített időpontonként. A csöveket, a címkéket és a tasakot fedezi.

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

A `total_cents` plusz a teljesítésből adódó díjak. `draw` esetén: a `fees` összes díja. A teljes
logisztikai díjjal számol, egy közös futárfelvétel pedig csökkenti a tényleges összeget.
`home_kit` esetén: `fulfilment.total_cents`.

**fulfilment** `object`

A mintavétel módja és az ahhoz kapcsolódó tételek. A `kind` értéke `draw` vagy `home_kit`. A
`draw` nem tartalmaz más mezőt.

**home\_kit**

**country\_code** `string`

A postaköltség árazásához használt szállítási ország.

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

A tesztkészlet, amelyben a panelt szállítják. `null`, ha az Aniva még nem állított össze
egyet; ilyenkor az árajánlat nem számol eszközzel.

**devices** `integer`

A dobozban lévő mintavételi eszközök, mindegyik az eszközdíjon számlázva.

**lines** `object[]`

A készlettételek, amelyeket egy rendelés hozzáad a havi számládhoz, mindegyik `description`,
`quantity`, `unit`, `unit_cents` és `amount_cents` mezővel. A postaköltség azokon a
szolgáltatásokon alapul, amelyeket a szállítási lépés ehhez az országhoz foglal le. A
díjszabásodon szereplő 0 díj nem hoz létre sort. Az előre fizetett anyagkredit itt nincs
levonva.

**total\_cents** `integer`

A `lines` tételek nettó összege.

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

Ezen felül, nettó összegben számlázva, ha nem aktiválod a tesztkészletet, mielőtt a laborba
ér, és a labor aktiválja. Nem szerepel a `lines` vagy a `total_cents` mezőben. A 0 azt
jelenti, hogy a díjszabásodon nincs ilyen díj.

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

Azok a szállítási irányok (`out`, `back`), amelyeket a díjszabásod országonként áraz, de
ehhez az országhoz nincs áruk. Helyettük az átalány postadíj lépett életbe, vagy 0, ha a
díjszabásban nincs ilyen. Üres, ha minden irányhoz volt ár.

**positions** `object[]`

A költségösszesítőben szereplő pozíciók. Egy pozíció biomarkerek közös árú csoportja.
Tartalmazza az `id`, `name`, `price_cents`, `retail_cents` és `tier` mezőket. Az `id` és a `name`
értéke `null`, ha az Aniva még nem tette közzé az adott pozíciót.

**panels** `object[]`

A költségösszesítőben szereplő panelek, az `id`, `name`, `price_cents` és `retail_cents`
mezőkkel.

**biomarkers** `object[]`

Minden megkapott biomarkerhez egy sor tartozik. Ez magában foglalja az arányok összetevőit és egy
pozíció minden tagját.

**biomarkersor**

**id** `number`

Biomarker-azonosító.

**name** `string`

Biomarker neve.

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

Ennek a sornak az ára, mellette a `retail_cents` értékkel. `0`, ha egy pozíció vagy panel
fedezi.

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

Azok az arányok, amelyekhez ez a biomarker szükséges. Csak egyszer fizetsz érte.

**requires** `number[]`

Csak arányoknál: azok a biomarkerek, amelyekből számítják.

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

Az a pozíció, amely fedezi ezt a sort. `null`, ha a pozíció még nincs közzétéve.

## Hibaválaszok

| Státusz | Leírás |
| - | - |
| `400` | A kérés törzse érvénytelen, vagy a kulcsod nem használhatja a `rate_card` értéket. |
| `400` | Egy `home_kit` árajánlathoz pontosan egy, otthoni tesztkészletként forgalmazott panelre és egy országkódra van szükség. |
| `400` | `biomarker_not_available`: a kulcsod által használható laborok egyike sem vizsgálja ezt a biomarkert. |
| `400` | `biomarker_not_priced`: a biomarkernek nincs ára. |
| `400` | `biomarker_requires_position`: a biomarker csak pozícióban érhető el. A válasz törzse felsorolja a pozíciókat. |
| `403` | Az API-kulcsod nem rendelkezik a `prices_view` scope-pal. |
| `404` | `Panels not found`: a panel nem létezik, vagy a kulcsod nem listázhatja. |
| `404` | `Biomarkers not found`: a biomarker nem létezik. |
| `500` | Belső szerverhiba. |

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