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

# Prețuri

> Cum calculează API-ul de analize de laborator Aniva prețurile pentru biomarkeri, poziții și paneluri din grila ta de tarife, cu oferte de preț înainte să faci programarea.

Aniva stabilește prețul pentru un singur lucru: **poziția**. O poziție este o ofertă comercială — un set selectat de biomarkeri care se facturează o singură dată, la un preț fix, și se livrează întotdeauna integral. Un biomarker pe care îl poți cumpăra separat este pur și simplu o poziție cu un singur element.

Tot ce vezi în `pricing` decurge de aici. Citește această pagină o dată și cele patru stări de mai jos nu vor mai părea cazuri speciale.

## Ce înseamnă cifrele

Fiecare `price_cents` este cât plătești **tu**, conform grilei tarifare de pe cheia ta API. Alături, `retail_cents` este același produs la grila recomandată de prețuri cu amănuntul, astfel încât să poți afișa o economie fără o a doua cerere. Ambele sunt valori întregi în cenți și ambele sunt **nete**: TVA-ul se adaugă pe factura ta lunară la cota regimului tău de TVA, iar un regim scutit nu adaugă nimic. Un panel vândut la prețul de catalog Aniva pentru consumatori este cotat la acel preț fără TVA-ul german de 19%.

> [!NOTE]
>
> `retail_cents` este întotdeauna prezent. Când cheia ta este deja pe grila de prețuri cu amănuntul,
> este pur și simplu egal cu `price_cents`.

Prețurile necesită scope-ul `prices_view`. Fără el, `pricing` este `null` în liste și în previzualizare, iar endpointurile de prețuri returnează `403`.

## Grila ta tarifară

Grila ta tarifară îți stabilește prețurile. Citește-o din [Obține grila tarifară](https://docs.anivahealth.com/ro/api/pricing/get-rate-card.md).

* Fiecare analiză are un `tier`: `routine` sau `specialty`. Prețul ei este prețul de catalog Aniva înmulțit cu multiplicatorul acelui nivel.
* Taxele se aplică per programare, iar taxa de logistică se aplică per ridicare prin curier. Programările tale din aceeași locație, din aceeași zi, împart o singură ridicare. Aniva facturează taxele pe factura ta lunară.

## Cele patru stări

`price_cents`, împreună cu blocul opțional aflat lângă el, definește starea. Nu există un câmp separat de tip.

| `price_cents` | Prezent alături | Ce înseamnă |
| - | - | - |
| pozitiv | `positions?` | Poate fi comandat separat la acel preț. Un raport include și `requires` și facturează și componentele sale. |
| `0` | `requires` | Un **raport**. Nu costă nimic în sine; plătești pentru componentele sale. |
| `0` | `positions` | **Condiționat de poziție**. Se vinde doar în cadrul uneia dintre pozițiile listate. |
| `null` | — | **Neselectat**. Aniva nu i-a stabilit un preț și nu poate fi comandat. |

### Pozitiv — poate fi comandat separat

Markerul are propriul său preț. Poate apărea totuși în poziții, iar `positions` le listează începând cu cea mai ieftină — cumpărarea poziției este adesea mai ieftină decât cumpărarea componentelor sale una câte una.

```json theme={null}
{
  "id": 71,
  "name": "Hemoglobin",
  "pricing": {
    "price_cents": 350,
    "retail_cents": 403,
    "tier": "routine",
    "positions": [
      {
        "id": "b7d4c2e1-9a3f-4c8b-91d2-5e6f7a8b9c0d",
        "name": "Aniva Blood Count",
        "price_cents": 452,
        "retail_cents": 520,
        "biomarker_ids": [71, 72, 73],
        "includes": [72, 73]
      }
    ]
  }
}
```

`biomarker_ids` este setul complet de membri ai poziției; `includes` este acel set fără markerul pe care l-ai interogat — ce vine împreună cu el.

### Zero cu `requires` — un raport

Un raport se calculează din markerii măsurați. Majoritatea rapoartelor costă `0`. Un raport cu un `price_cents` pozitiv facturează acel preț pe lângă componentele sale. Dacă îl comanzi, Aniva adaugă componentele sale în coș la prețurile lor proprii. O componentă se plătește **o singură dată per coș**, indiferent câte rapoarte se bazează pe ea.

```json theme={null}
{
  "id": 279,
  "name": "hs-CRP / HDL Ratio",
  "pricing": {
    "price_cents": 0,
    "retail_cents": 0,
    "requires": [
      { "id": 42, "name": "HDL Cholesterol", "price_cents": 233, "retail_cents": 268 },
      { "id": 84, "name": "High-Sensitivity C-Reactive Protein (hs-CRP)", "price_cents": 1166, "retail_cents": 1341 }
    ]
  }
}
```

Un raport se combină cu pozițiile, în loc să concureze cu ele. Dacă componentele sale fac parte dintr-o poziție pe care o cumperi deja, poziția le acoperă, iar raportul este inclus.

> [!WARNING]
>
> Un raport ale cărui componente nu au toate un preț **lipsește din catalog** — nu apare cu
> `price_cents: null`. Revine odată ce Aniva stabilește prețul componentei lipsă.

### Zero cu `positions` — vândut doar într-o poziție

Markerul nu are un preț propriu, dar face parte din una sau mai multe poziții. Cumperi una dintre acele poziții și îl primești.

```json theme={null}
{
  "id": 77,
  "name": "Mean Platelet Volume (MPV)",
  "pricing": {
    "price_cents": 0,
    "retail_cents": 0,
    "positions": [
      {
        "id": "3f1a8c22-64bd-4e57-8a90-1c2d3e4f5a6b",
        "name": "Blood Count (extended)",
        "price_cents": 460,
        "retail_cents": 529,
        "biomarker_ids": [71, 72, 73, 77],
        "includes": [71, 72, 73]
      }
    ]
  }
}
```

Adăugarea separată a unuia dintre aceștia la o programare este refuzată — vezi [Adaugă biomarkeri individuali](https://docs.anivahealth.com/ro/api/appointments/add-individual-biomarkers.md). Adaugă în schimb fiecare biomarker dintr-una dintre pozițiile listate.

### Null — neconfigurat

Aniva nu a stabilit cât costă acest marker, deci nu este de vânzare. `null` nu este zero și nici „întreabă-ne”: tratează-l ca indisponibil.

```json theme={null}
{ "id": 555, "name": "Poppy Seeds (Pap s)", "pricing": { "price_cents": null, "retail_cents": null } }
```

> [!WARNING]
>
> Aniva refuză un marker `null` la plasarea comenzii. Două condiții fac un biomarker disponibil
> pentru comandă. Un laborator către care Aniva poate direcționa comanda trebuie să livreze biomarkerul.
> Catalogul Aniva trebuie să îi stabilească un preț. Dacă atașezi un marker `null` la o programare,
> API-ul returnează `400` cu `error: "biomarker_not_priced"`. Vezi
> [Adaugă biomarkeri individuali](https://docs.anivahealth.com/ro/api/appointments/add-individual-biomarkers.md). Un laborator poate livra
> un marker `null`, dar livrarea singură nu face markerul disponibil. Tratează `null` ca indisponibil.

Unii markeri au valoarea `null` în mod intenționat. Aniva vinde testele de microbiom și pe cele genetice sub formă de kituri. Un kit are un singur
preț, așa că markerii care fac parte din el nu au un preț propriu. Pentru a cumpăra acești markeri, comandă panelul care
reprezintă kitul. Markerii incluși vin odată cu panelul. API-ul acceptă și un marker component pe care îl adaugi la o
programare ce include deja panelul respectiv.

Un marker are de asemenea valoarea `null` atunci când Aniva îl vinde doar în cadrul unei poziții pe care nu o poți vedea.
Rezultatul este același: nu ai un preț la care să cumperi markerul. Markerul primește un preț atunci când Aniva
face acea poziție vizibilă partenerilor.

## Cum găsești cea mai ieftină variantă de a cumpăra un set

Deoarece fiecare poziție din care face parte un marker este transmisă împreună cu markerul, poți rezolva acest lucru local, fără cereri suplimentare:

1. Adună markerii doriți din [Listează biomarkerii](https://docs.anivahealth.com/ro/api/biomarkers/list-biomarkers.md).
2. Pentru fiecare, compară propriul `price_cents` cu `price_cents` al pozițiilor din blocul său `positions`.
3. O poziție se facturează **o singură dată** și livrează întregul său set `biomarker_ids`, deci o poziție care acoperă mai mulți dintre markerii tăi este taxată o singură dată. Markerii suplimentari pe care nu i-ai cerut vin fără costuri suplimentare.

Nimic nu se suprapune de două ori: două poziții care au un marker comun își livrează fiecare setul, markerul este listat o singură dată și pozițiile nu își acordă niciodată reduceri reciproc.

## Factura

[Previzualizează programarea](https://docs.anivahealth.com/ro/api/appointments/preview-containers.md) returnează factura unei programări. [Estimează coșul](https://docs.anivahealth.com/ro/api/pricing/quote-cart.md) returnează aceeași factură fără o programare. Factura conține:

* `positions[]` — fiecare poziție aplicată, facturată o singură dată la prețul său fix.
* `panels[]` — fiecare panel atașat.
* `biomarkers[]` — un rând pentru fiecare marker **livrat**. Un rând plătit printr-o poziție costă `0` și indică poziția în `via_position`. O componentă inclusă de un raport are `required_by`; raportul în sine are `requires`.
* `total_cents` — pozițiile cu preț plus panelurile cu preț plus rândurile de biomarkeri cu preț, alături de `retail_total_cents`.
* `fees` și `total_with_fees_cents` — taxele unei programări și totalul care le include.

Un rând căruia Aniva nu îi poate stabili un preț are `price_cents: null`. Rândul nu adaugă nimic la total. Nu poți atașa separat un marker fără preț, deci acest rând provine dintr-o poziție sau dintr-un panel. Acea poziție sau acel panel îl facturează deja.

> [!NOTE]
>
> Aniva nu a publicat încă toate pozițiile. O poziție nepublicată este totuși facturată. Aceasta
> apare în `positions[]` cu `id` și `name` setate la `null`, iar rândurile sale de biomarkeri au
> `via_position: null`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.