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

# Preus

> Com calcula l'API d'anàlisis de laboratori d'Aniva els preus dels biomarcadors, les partides i els panells a la teva taula de tarifes, amb pressupostos abans de reservar.

Aniva posa preu a una sola cosa: la **posició**. Una posició és una oferta comercial —un conjunt seleccionat de biomarcadors que es factura un sol cop, a un preu fix, i sempre es lliura sencer. Un biomarcador que pots comprar per separat és simplement una posició d'un sol element.

Tot el que veus a `pricing` se'n deriva. Llegeix aquesta pàgina un cop i els quatre estats següents deixaran de semblar casos especials.

## Què signifiquen els números

Cada `price_cents` és el que pagues **tu**, segons la tarifa de la teva clau d'API. Al costat, `retail_cents` és el mateix article segons la tarifa de venda al públic recomanada, perquè puguis mostrar un estalvi sense fer una segona sol·licitud. Tots dos són cèntims enters i tots dos són **nets**: l'IVA s'afegeix a la teva factura mensual al tipus que correspongui al teu règim d'IVA, i un règim exempt no n'afegeix cap. Un panell que es ven al preu del catàleg per a consumidors d'Aniva es mostra amb aquest preu sense el 19 % d'IVA alemany.

> [!NOTE]
>
> `retail_cents` sempre hi és present. Quan la teva clau ja fa servir la tarifa de venda al públic, simplement
> és igual a `price_cents`.

Els preus necessiten l'abast `prices_view`. Sense aquest abast, `pricing` és `null` als llistats i a la previsualització, i els endpoints de preus retornen `403`.

## La teva tarifa

La teva tarifa defineix els teus preus. Consulta-la a [Obtenir la tarifa](https://docs.anivahealth.com/ca/api/pricing/get-rate-card.md).

* Cada anàlisi té un `tier`: `routine` o `specialty`. El seu preu és el preu de catàleg d'Aniva aplicant-hi el multiplicador d'aquest nivell.
* Els càrrecs són per cita, i el càrrec logístic és per recollida de missatgeria. Les teves cites a la mateixa ubicació el mateix dia comparteixen una sola recollida. Aniva factura els càrrecs a la teva factura mensual.

## Els quatre estats

`price_cents`, juntament amb el bloc opcional que té al costat, defineix l'estat. No hi ha cap camp de tipus separat.

| `price_cents` | També present | Què significa |
| - | - | - |
| positiu | `positions?` | Es pot demanar per separat a aquest preu. Una ràtio també porta `requires` i factura també els seus components. |
| `0` | `requires` | Una **ràtio**. No té cost per si sola; pagues pels seus components. |
| `0` | `positions` | **Condicionat a una posició**. Només es ven dins d'una de les posicions llistades. |
| `null` | — | **No seleccionat**. Aniva no li ha posat preu i no es pot demanar. |

### Positiu — es pot demanar per separat

El marcador té un preu propi. Encara pot aparèixer en posicions, i llavors `positions` les llista de la més econòmica a la més cara: comprar la posició sovint surt més barat que comprar-ne els elements un per un.

```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` és el conjunt complet d'elements de la posició; `includes` és aquest conjunt menys el marcador que has consultat: el que hi ve inclòs.

### Zero amb `requires` — una ràtio

Una ràtio es calcula a partir de marcadors mesurats. La majoria de ràtios costen `0`. Una ràtio amb un `price_cents` positiu factura aquest preu a més dels seus components. Demana-la i Aniva posa els seus components a la cistella al seu propi preu. Un component es paga **un cop per cistella**, per moltes ràtios que en depenguin.

```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 }
    ]
  }
}
```

Una ràtio es combina amb les posicions en lloc de competir-hi. Si els seus components formen part d'una posició que ja compres, la posició els cobreix i la ràtio hi va inclosa.

> [!WARNING]
>
> Si no tots els components d'una ràtio tenen preu, la ràtio **no apareix al catàleg**: no es mostra
> amb `price_cents: null`. Hi torna a aparèixer quan Aniva posa preu al component que falta.

### Zero amb `positions` — només es ven dins d'una posició

El marcador no té un preu propi, però forma part d'una o més posicions. Compra una d'aquestes posicions i l'obtindràs.

```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]
      }
    ]
  }
}
```

Afegir un d'aquests a una cita per separat es rebutja — consulta [Afegeix biomarcadors individuals](https://docs.anivahealth.com/ca/api/appointments/add-individual-biomarkers.md). En lloc d'això, afegeix tots els biomarcadors d'una de les posicions llistades.

### Null — no catalogat

Aniva no ha decidit quant costa aquest marcador, així que no està a la venda. `null` no és zero ni "pregunta'ns": tracta'l com a no disponible.

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

> [!WARNING]
>
> Aniva rebutja un marcador `null` en el moment de fer la comanda. Dues condicions fan que un
> biomarcador es pugui demanar. Un laboratori al qual Aniva pugui derivar la comanda ha de lliurar
> el biomarcador. El catàleg d'Aniva li ha d'assignar un preu. Si afegeixes un marcador `null` a una
> cita, l'API retorna `400` amb `error: "biomarker_not_priced"`. Consulta
> [Afegeix biomarcadors individuals](https://docs.anivahealth.com/ca/api/appointments/add-individual-biomarkers.md). Un laboratori pot
> lliurar un marcador `null`, però el lliurament per si sol no fa que el marcador estigui
> disponible. Tracta `null` com a no disponible.

Alguns marcadors són `null` per disseny. Aniva ven les proves de microbioma i de genètica com a
kits. Un kit té un únic preu, així que els marcadors que en formen part no tenen un preu propi. Per
comprar aquests marcadors, demana el panell que és el kit. Els membres venen amb el panell. L'API
també accepta un membre que afegeixis a una cita que ja inclou el seu panell.

Un marcador també apareix com a `null` quan Aniva només el ven dins d'una posició que no pots
veure. El resultat és el mateix: no tens cap preu per comprar el marcador. El marcador obté un preu
quan Aniva fa visible aquesta posició per als col·laboradors.

## Trobar la manera més econòmica de comprar un conjunt

Com que cada posició a la qual pertany un marcador viatja amb el marcador, pots resoldre això localment, sense peticions addicionals:

1. Recull els marcadors que vols de [Llista biomarcadors](https://docs.anivahealth.com/ca/api/biomarkers/list-biomarkers.md).
2. Per a cadascun, compara el seu propi `price_cents` amb el `price_cents` de les posicions del seu bloc `positions`.
3. Una posició es factura **un sol cop** i lliura tot el seu conjunt de `biomarker_ids`, de manera que una posició que cobreix diversos dels teus marcadors es cobra una sola vegada. Els marcadors addicionals que no has demanat s'hi inclouen sense cap cost addicional.

Res no se solapa dues vegades: dues posicions que comparteixen un membre lliuren cadascuna el seu conjunt, el membre apareix una sola vegada i mai no es descompten entre si.

## La factura

[Previsualitza la cita](https://docs.anivahealth.com/ca/api/appointments/preview-containers.md) retorna la factura d'una cita. [Pressuposta la cistella](https://docs.anivahealth.com/ca/api/pricing/quote-cart.md) retorna la mateixa factura sense cita. La factura conté:

* `positions[]` — cada posició que s'ha activat, facturada un sol cop al seu preu fix.
* `panels[]` — cada panell afegit.
* `biomarkers[]` — una fila per cada marcador **lliurat**. Una fila que paga una posició costa `0` i l'anomena a `via_position`. Un component incorporat per una ràtio porta `required_by`; la ràtio mateixa porta `requires`.
* `total_cents` — les posicions amb preu més els panells amb preu més les files de biomarcadors amb preu, amb `retail_total_cents` al costat.
* `fees` i `total_with_fees_cents` — les tarifes d'una cita i el total amb elles.

Una fila a la qual Aniva no pot assignar un preu porta `price_cents: null`. La fila no afegeix res al total. No pots afegir un marcador sense preu per separat, així que aquesta fila l'ha proporcionada una posició o un panell. Aquesta posició o aquest panell ja la factura.

> [!NOTE]
>
> Aniva encara no ha publicat totes les posicions. Una posició no publicada es continua facturant.
> Apareix a `positions[]` amb `id` i `name` definits com a `null`, i les seves files de biomarcadors
> tenen `via_position: null`.


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