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

# Nacenit košík

> Nacenit panely a biomarkery bez termínu

Vrací vyúčtování pro panely a biomarkery podle tvého ceníku. Nepotřebuješ žádný termín. Nic se
nerezervuje.

Vyúčtování je stejné jako `pricing` u [Náhled termínu](https://docs.anivahealth.com/cs/api/appointments/preview-containers.md),
plus to, co přidá způsob odběru vzorku. Ve výchozím nastavení jde o odběr krve na odběrovém místě
s poplatky za termín. Pošli `fulfilment: "home_kit"` a `country_code`, pokud chceš místo toho
nacenit jednu sadu zaslanou poštou do dané země: poplatek za sadu, odběrové pomůcky, poštovné tam
a zpět, obal a náhradní sáček s lancetami, jak je účtuje tvoje měsíční faktura.
[Ceny](https://docs.anivahealth.com/cs/concepts/pricing.md) vysvětlují, jak Aniva určuje ceny testů.

Vyžaduje oprávnění `prices_view`.

## Požadavek

### Parametry těla

Pošli alespoň jedno ID v `panel_ids` nebo `biomarker_ids`.

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

Panely k nacenění, nejvýše 50. Každý musí být ve [Vypsat panely](https://docs.anivahealth.com/cs/api/panels/list-panels.md) pro tvůj klíč.

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

Biomarkery k nacenění, nejvýše 500.

**sex** `integer`

Biologické pohlaví podle ISO/IEC 5218: `1` = muž, `2` = žena. Některé panely přidávají biomarkery
jen pro jedno pohlaví nebo určitý věk. Pošli `sex` a `date_of_birth` společně, aby se tato
pravidla uplatnila. Bez nich se pravidla neuplatní.

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

Datum narození, `YYYY-MM-DD`. Pošli společně se `sex`.

**rate\_card** `string`

Ceník pro výpočet cen: `retail`, nebo `id` ze [Získat ceník](https://docs.anivahealth.com/cs/api/pricing/get-rate-card.md).
Výchozí: ceník tvého API klíče, jinak maloobchodní.

**fulfilment** `string`

Způsob odběru vzorku. `draw` (výchozí): odběr krve na odběrovém místě, který přidá poplatky za
termín. `home_kit`: jedna sada zaslaná poštou do `country_code`, která místo toho přidá položky
sady. Domácí testovací sada obsahuje přesně jeden panel a tento panel se musí prodávat jako domácí
testovací sada.

**country\_code** `string`

Země doručení sady, ISO 3166-1 alpha-2 (`DE`, `SE`). Vyžadováno u
`fulfilment: "home_kit"`, a jen tehdy. Určuje položky poštovného.

## Odpověď

**total\_cents** `integer`

Cena testů podle tvého ceníku: každá naceněná pozice, panel a řádek biomarkeru. Řádek
s `price_cents: null` nic nepřidává.

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

Stejná cena podle doporučeného maloobchodního ceníku.

**fees** `object`

Poplatky za jeden termín v centech. Aniva je účtuje na tvé měsíční faktuře. Platí pro
`draw`; u `home_kit` se místo toho účtují položky ve `fulfilment`.

**poplatky**

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

Za dokončený termín.

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

Za termín, kdy pacient dostane občerstvení. Chybí, pokud tvoji pacienti občerstvení
nedostávají. Chceš-li občerstvení nabízet, kontaktuj Aniva.

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

Za vyzvednutí kurýrem. Tvoje termíny na stejném místě ve stejný den sdílejí jedno vyzvednutí.

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

Za dokončený termín. Zahrnuje zkumavky, štítky a sáček.

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

`total_cents` plus to, co přidá způsob odběru. Pro `draw`: všechny poplatky ve `fees`. Započítává
plný poplatek za logistiku a sdílené vyzvednutí skutečnou částku sníží. Pro `home_kit`:
`fulfilment.total_cents`.

**fulfilment** `object`

Jak se vzorek odebírá a co to přidává. `kind` je `draw` nebo `home_kit`. `draw` nemá žádné další
pole.

**home\_kit**

**country\_code** `string`

Země doručení, pro kterou bylo poštovné naceněno.

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

Sada, v níž se panel zasílá. `null`, když Aniva ještě žádnou nesestavila; cenová nabídka pak
nepočítá žádnou pomůcku.

**devices** `integer`

Odběrové pomůcky v balení, každá účtovaná poplatkem za pomůcku.

**lines** `object[]`

Položky sady, které jedna objednávka přidá na tvou měsíční fakturu, každá s `description`,
`quantity`, `unit`, `unit_cents` a `amount_cents`. Poštovné se oceňuje podle služeb, které
krok odeslání pro tuto zemi objednává. Poplatek 0 v tvém ceníku nevytvoří žádnou položku.
Předplacený kredit na materiál se zde neodečítá.

**total\_cents** `integer`

Součet `lines`, bez DPH.

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

Účtuje se navíc, bez DPH, pokud sadu neaktivuješ před jejím doručením do laboratoře a aktivuje
ji laboratoř. Není zahrnut v `lines` ani v `total_cents`. 0 znamená, že tvůj ceník takový
poplatek nemá.

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

Směry (`out`, `back`), které tvůj ceník oceňuje podle země, ale pro tuto zemi u nich nemá
cenu. Použil se paušální poplatek za poštovné, nebo 0, pokud ho ceník nemá. Prázdné, když se
našla cena pro každý směr.

**positions** `object[]`

Pozice ve vyúčtování. Pozice je sada biomarkerů s jednou cenou. Má `id`, `name`,
`price_cents`, `retail_cents` a `tier`. `id` a `name` jsou `null` u pozice, kterou Aniva ještě
nezveřejnila.

**panels** `object[]`

Panely ve vyúčtování s `id`, `name`, `price_cents` a `retail_cents`.

**biomarkers** `object[]`

Jeden řádek pro každý biomarker, který dostaneš. Zahrnuje složky poměru a každý prvek pozice.

**řádek biomarkeru**

**id** `number`

ID biomarkeru.

**name** `string`

Název biomarkeru.

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

Cena tohoto řádku, vedle ní je `retail_cents`. `0`, když ho pokrývá pozice nebo panel.

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

Poměry, které tento biomarker potřebují. Platíš za něj jednou.

**requires** `number[]`

Jen u poměru: biomarkery, ze kterých se vypočítává.

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

Pozice, která tento řádek pokrývá. `null`, když pozice ještě není zveřejněna.

## Chybové odpovědi

| Stav | Popis |
| - | - |
| `400` | Tělo požadavku je neplatné, nebo tvůj klíč nesmí použít `rate_card`. |
| `400` | Cenová nabídka pro `home_kit` potřebuje přesně jeden panel, panel prodávaný jako domácí testovací sada a kód země. |
| `400` | `biomarker_not_available`: žádná laboratoř, kterou tvůj klíč smí používat, tento biomarker neměří. |
| `400` | `biomarker_not_priced`: biomarker nemá cenu. |
| `400` | `biomarker_requires_position`: biomarker se prodává pouze v pozici. Tělo odpovědi uvádí seznam pozic. |
| `403` | Tvůj API klíč nemá oprávnění `prices_view`. |
| `404` | `Panels not found`: panel neexistuje, nebo ho tvůj klíč nemůže vypsat. |
| `404` | `Biomarkers not found`: biomarker neexistuje. |
| `500` | Interní chyba serveru. |

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