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

# Prisberäkna varukorg

> Beräkna pris för paneler och biomarkörer utan bokning

Returnerar prisberäkningen för paneler och biomarkörer enligt din prislista. Du behöver ingen bokning.
Inget bokas.

Prisberäkningen är densamma som `pricing` i [Förhandsgranska bokning](https://docs.anivahealth.com/sv/api/appointments/preview-containers.md),
plus det som provtagningssättet lägger till. Som standard är det en blodprovstagning på en provtagningsplats,
med bokningsavgifterna. Skicka `fulfilment: "home_kit"` och en `country_code` för att i stället
prissätta ett hemtestkit som postas till det landet: kitavgiften, provtagningsenheterna, porto tur och
retur, omslaget och en extra lansettpåse, precis som de faktureras på din månadsfaktura.
[Prissättning](https://docs.anivahealth.com/sv/concepts/pricing.md) förklarar hur Aniva prissätter testerna.

Kräver behörigheten `prices_view`.

## Förfrågan

### Body-parametrar

Skicka minst ett id i `panel_ids` eller `biomarker_ids`.

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

Paneler att prissätta, högst 50. Varje panel måste finnas i [Lista paneler](https://docs.anivahealth.com/sv/api/panels/list-panels.md) för din nyckel.

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

Biomarkörer att prissätta, högst 500.

**sex** `integer`

Biologiskt kön enligt ISO/IEC 5218: `1` = man, `2` = kvinna. Vissa paneler lägger bara till
biomarkörer för ett visst kön eller en viss ålder. Skicka `sex` och `date_of_birth` tillsammans för
att tillämpa de här reglerna. Utan dem tillämpas inte reglerna.

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

Födelsedatum, `YYYY-MM-DD`. Skicka det tillsammans med `sex`.

**rate\_card** `string`

Prislistan att prissätta enligt: `retail`, eller `id` från [Hämta prislista](https://docs.anivahealth.com/sv/api/pricing/get-rate-card.md).
Standard: din API-nyckels prislista, annars utpris.

**fulfilment** `string`

Hur provet tas. `draw` (standard): en blodprovstagning på en provtagningsplats, vilket lägger till
bokningsavgifterna. `home_kit`: ett hemtestkit som postas till `country_code`, vilket i stället
lägger till kitraderna. Ett hemtestkit innehåller exakt en panel, och panelen måste säljas som
hemtestkit.

**country\_code** `string`

Leveransland för hemtestkitet, ISO 3166-1 alpha-2 (`DE`, `SE`). Krävs med
`fulfilment: "home_kit"`, och bara då. Det väljer portoraderna.

## Svar

**total\_cents** `integer`

Priset på testerna enligt din prislista: varje prissatt position, panel och biomarkörrad. En rad
med `price_cents: null` lägger inte till något.

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

Samma pris enligt prislistan för rekommenderat utpris.

**fees** `object`

Avgifterna för en bokning, i cent. Aniva fakturerar dem på din månadsfaktura. De gäller för en
`draw`; ett `home_kit` fakturerar raderna i `fulfilment` i stället.

**avgifter**

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

Per genomförd bokning.

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

Per bokning där patienten får ett mellanmål. Saknas när dina patienter inte får något mellanmål.
Kontakta Aniva för att erbjuda mellanmål.

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

Per kurirhämtning. Dina bokningar på samma plats samma dag delar på en hämtning.

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

Per genomförd bokning. Täcker rör, etiketter och påsen.

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

`total_cents` plus det som provtagningssättet lägger till. För en `draw`: varje avgift i `fees`.
Den räknar med hela logistikavgiften, och en delad hämtning gör det faktiska beloppet lägre. För
ett `home_kit`: `fulfilment.total_cents`.

**fulfilment** `object`

Hur provet tas och vad det lägger till. `kind` är `draw` eller `home_kit`. En `draw` har inga
andra fält.

**home\_kit**

**country\_code** `string`

Leveranslandet som portot prissattes för.

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

Kitet som panelen skickas som. `null` när Aniva inte har satt ihop något än; prisberäkningen
räknar då inte med någon enhet.

**devices** `integer`

Provtagningsenheter i lådan, där varje enhet faktureras enligt enhetsavgiften.

**lines** `object[]`

Kitraderna som en beställning lägger till på din månadsfaktura, var och en med `description`,
`quantity`, `unit`, `unit_cents` och `amount_cents`. Portot prissätts enligt de tjänster som
fraktsteget bokar för det här landet. En avgift på 0 i din prislista skapar ingen rad. En
förbetald materialkredit dras inte av här.

**total\_cents** `integer`

Summan av `lines`, netto.

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

Faktureras utöver detta, netto, om du inte aktiverar kitet innan det når labbet och labbet
aktiverar det. Den ingår inte i `lines` eller `total_cents`. 0 betyder att din prislista inte
har någon sådan avgift.

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

Sträckor (`out`, `back`) som din prislista prissätter per land men saknar pris för i det här
landet. De föll tillbaka på den fasta portoavgiften, eller på 0 när prislistan saknar en sådan.
Tom när varje sträcka hittade sitt pris.

**positions** `object[]`

Positionerna i prisberäkningen. En position är en uppsättning biomarkörer med ett gemensamt pris.
Den har `id`, `name`, `price_cents`, `retail_cents` och `tier`. `id` och `name` är `null` för en
position som Aniva inte har publicerat än.

**panels** `object[]`

Panelerna i prisberäkningen, med `id`, `name`, `price_cents` och `retail_cents`.

**biomarkers** `object[]`

En rad per biomarkör du får. Det omfattar delarna i en kvot och varje biomarkör i en position.

**biomarkörrad**

**id** `number`

Biomarkör-id.

**name** `string`

Biomarkörnamn.

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

Priset för den här raden, med `retail_cents` bredvid. `0` när en position eller en panel
täcker den.

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

Kvoterna som behöver den här biomarkören. Du betalar för den en gång.

**requires** `number[]`

Bara för en kvot: biomarkörerna den beräknas från.

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

Positionen som täcker den här raden. `null` när positionen inte är publicerad än.

## Felsvar

| Status | Beskrivning |
| - | - |
| `400` | Anropets body är ogiltig, eller så får din nyckel inte använda `rate_card`. |
| `400` | En `home_kit`-prisberäkning kräver exakt en panel, en panel som säljs som hemtestkit och en landskod. |
| `400` | `biomarker_not_available`: inget labb som din nyckel får använda analyserar biomarkören. |
| `400` | `biomarker_not_priced`: biomarkören saknar pris. |
| `400` | `biomarker_requires_position`: biomarkören säljs bara i en position. Svaret listar positionerna. |
| `403` | Din API-nyckel har inte behörigheten `prices_view`. |
| `404` | `Panels not found`: panelen finns inte, eller så kan din nyckel inte lista den. |
| `404` | `Biomarkers not found`: biomarkören finns inte. |
| `500` | Internt serverfel. |

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