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

# Tarification

> Comment l'API d'analyses en laboratoire Aniva tarifie les biomarqueurs, les postes et les panels selon ta grille tarifaire, avec des devis avant de réserver.

Aniva tarife une seule chose : la **position**. Une position est une offre commerciale — un ensemble sélectionné de biomarqueurs facturé en une fois, à prix fixe, et toujours livré complet. Un biomarqueur que tu peux acheter seul est simplement une position d'un seul élément.

Tout ce que tu vois dans `pricing` en découle. Lis cette page une fois et les quatre états ci-dessous ne te sembleront plus être des cas particuliers.

## Ce que signifient les chiffres

Chaque `price_cents` correspond à ce que **tu** paies, selon la grille tarifaire associée à ta clé API. À côté, `retail_cents` représente le même article selon la grille publique conseillée, pour que tu puisses afficher une économie sans faire une seconde requête. Les deux sont exprimés en centimes entiers et sont **hors taxes** : la TVA est ajoutée sur ta facture mensuelle au taux de ton régime de TVA, et un régime exonéré n'en ajoute aucune. Un panel vendu au prix catalogue grand public d'Aniva est indiqué à ce prix sans sa TVA allemande de 19 %.

> [!NOTE]
>
> `retail_cents` est toujours présent. Quand ta clé utilise déjà la grille publique, il est simplement
> égal à `price_cents`.

Les prix nécessitent le scope `prices_view`. Sans lui, `pricing` vaut `null` dans les listes et l'aperçu, et les endpoints de tarification renvoient `403`.

## Ta grille tarifaire

Ta grille tarifaire détermine tes prix. Consulte-la via [Obtenir la grille tarifaire](https://docs.anivahealth.com/fr/api/pricing/get-rate-card.md).

* Chaque analyse a un `tier` : `routine` ou `specialty`. Son prix correspond au prix catalogue Aniva multiplié par le coefficient de ce palier.
* Les frais s'appliquent par rendez-vous, et les frais logistiques par collecte par coursier. Tes rendez-vous au même lieu le même jour partagent une seule collecte. Aniva facture ces frais sur ta facture mensuelle.

## Les quatre états

`price_cents`, combiné au bloc optionnel qui l'accompagne, définit l'état. Il n'existe pas de champ de type distinct.

| `price_cents` | Également présent | Signification |
| - | - | - |
| positif | `positions?` | Commandable seul à ce prix. Un ratio comporte aussi `requires` et facture également ses composants. |
| `0` | `requires` | Un **ratio**. Il ne coûte rien en soi ; tu paies ses composants. |
| `0` | `positions` | **Lié à une position**. Vendu uniquement au sein de l'une des positions listées. |
| `null` | — | **Non référencé**. Aniva ne l'a pas tarifé et il ne peut pas être commandé. |

### Positif — commandable seul

Le marqueur a son propre prix. Il peut tout de même figurer dans des positions, et `positions` les liste alors de la moins chère à la plus chère — acheter la position revient souvent moins cher que d'acheter ses éléments un par 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` est l'ensemble complet des éléments de la position ; `includes` est cet ensemble sans le marqueur que tu as demandé — ce qui l'accompagne.

### Zéro avec `requires` — un ratio

Un ratio est calculé à partir de marqueurs mesurés. La plupart des ratios coûtent `0`. Un ratio avec un `price_cents` positif facture ce prix en plus de ses composants. Commande-le et Aniva ajoute ses composants au panier à leur propre prix. Un composant est payé **une seule fois par panier**, quel que soit le nombre de ratios qui en dépendent.

```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 ratio se combine avec les positions au lieu d'entrer en concurrence avec elles. Si ses composants font partie d'une position que tu achètes déjà, la position les couvre et le ratio est inclus.

> [!WARNING]
>
> Un ratio dont tous les composants ne sont pas tarifés est **absent du catalogue** — il n'apparaît
> pas avec `price_cents: null`. Il réapparaît dès qu'Aniva tarife le composant manquant.

### Zéro avec `positions` — vendu uniquement dans une position

Le marqueur n'a pas de prix propre, mais il fait partie d'une ou plusieurs positions. Achète l'une de ces positions et tu l'obtiens.

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

Ajouter l'un d'eux seul à un rendez-vous est refusé — voir [Ajouter des biomarqueurs individuels](https://docs.anivahealth.com/fr/api/appointments/add-individual-biomarkers.md). Ajoute plutôt tous les biomarqueurs de l'une des positions listées.

### Null — non référencé

Aniva n'a pas décidé du prix de ce marqueur, il n'est donc pas en vente. `null` n'est ni zéro ni « demande-nous » : considère-le comme indisponible.

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

> [!WARNING]
>
> Aniva refuse un marqueur `null` à la commande. Deux conditions rendent un biomarqueur
> commandable. Un laboratoire vers lequel Aniva peut acheminer la commande doit fournir le
> biomarqueur. Le catalogue Aniva doit lui attribuer un prix. Si tu associes un marqueur `null` à
> un rendez-vous, l'API renvoie `400` avec `error: "biomarker_not_priced"`. Voir [Ajouter des
> biomarqueurs individuels](https://docs.anivahealth.com/fr/api/appointments/add-individual-biomarkers.md). Un laboratoire peut
> fournir un marqueur `null`, mais cela seul ne rend pas le marqueur disponible. Considère `null`
> comme indisponible.

Certains marqueurs sont `null` par conception. Aniva vend les tests de microbiome et de génétique
sous forme de kits. Un kit a un prix unique, ses marqueurs membres n'ont donc pas de prix propre.
Pour acheter ces marqueurs, commande le panel correspondant au kit. Les membres sont fournis avec
le panel. L'API accepte aussi un membre que tu ajoutes à un rendez-vous qui comporte déjà son panel.

Un marqueur affiche aussi `null` quand Aniva le vend uniquement dans une position que tu ne peux pas
voir. Le résultat est le même : tu n'as pas de prix pour acheter le marqueur. Le marqueur
obtient un prix quand Aniva rend cette position visible aux partenaires.

## Trouver la façon la moins chère d'acheter un ensemble

Comme chaque position à laquelle appartient un marqueur est renvoyée avec celui-ci, tu peux résoudre cela localement, sans requêtes supplémentaires :

1. Récupère les marqueurs que tu souhaites via [Lister les biomarqueurs](https://docs.anivahealth.com/fr/api/biomarkers/list-biomarkers.md).
2. Pour chacun, compare son propre `price_cents` au `price_cents` des positions de son bloc `positions`.
3. Une position est facturée **une fois** et fournit tout son ensemble `biomarker_ids`, donc une position couvrant plusieurs de tes marqueurs n'est facturée qu'une seule fois. Les marqueurs supplémentaires que tu n'as pas demandés s'ajoutent sans coût supplémentaire.

Rien ne se chevauche deux fois : deux positions qui partagent un membre fournissent chacune leur ensemble, le membre n'est listé qu'une fois et elles ne se déduisent jamais l'une de l'autre.

## La facture

[Prévisualiser un rendez-vous](https://docs.anivahealth.com/fr/api/appointments/preview-containers.md) renvoie la facture d'un rendez-vous. [Chiffrer un panier](https://docs.anivahealth.com/fr/api/pricing/quote-cart.md) renvoie la même facture sans rendez-vous. La facture comprend :

* `positions[]` — chaque position déclenchée, facturée une fois à son prix forfaitaire.
* `panels[]` — chaque panel associé.
* `biomarkers[]` — une ligne par marqueur **fourni**. Une ligne couverte par une position coûte `0` et la mentionne dans `via_position`. Un composant ajouté par un ratio comporte `required_by` ; le ratio lui-même comporte `requires`.
* `total_cents` — les positions tarifées plus les panels tarifés plus les lignes de biomarqueurs tarifées, avec `retail_total_cents` à côté.
* `fees` et `total_with_fees_cents` — les frais d'un rendez-vous, et le total avec ces frais.

Une ligne qu'Aniva ne peut pas tarifer comporte `price_cents: null`. La ligne n'ajoute rien au total. Tu ne peux pas associer seul un marqueur non tarifé, c'est donc une position ou un panel qui a fourni cette ligne. Cette position ou ce panel la facture déjà.

> [!NOTE]
>
> Aniva n'a pas encore publié toutes les positions. Une position non publiée est tout de même
> facturée. Elle apparaît dans `positions[]` avec `id` et `name` définis sur `null`, et ses lignes
> de biomarqueurs ont `via_position: null`.


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