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

# Prévisualiser un rendez-vous

> Prévisualiser les tubes et la facture d'un rendez-vous

Renvoie ce dont un rendez-vous a besoin pour les panels et les biomarqueurs qu'il contient. Rien n'est commandé.

* `containers` : les tubes, cartes ou flacons que le praticien prépare.
* `pricing` : la facture selon ta grille tarifaire. [Estimer un panier](https://docs.anivahealth.com/fr/api/pricing/quote-cart.md) renvoie la même
  facture sans rendez-vous.
* `routing` : toujours `null`.

Nécessite l'un des scopes `appointments_view`, `appointments_schedule`, `appointments_operate` ou `appointments_manage`.

## Requête

### Paramètres de chemin

**id** `string` *required*

Identifiant unique (UUID) du rendez-vous pour lequel prévisualiser les besoins en contenants.

## Réponse

En cas de succès, l'API renvoie `200 OK` avec les besoins en contenants et des champs réservés pour un usage ultérieur.

**containers** `object[]` *required*

Tableau des contenants de prélèvement requis. Vide lorsqu'aucun panel ni biomarqueur n'a été ajouté au rendez-vous. Également vide lorsque le couple lieu-jour du rendez-vous ne peut pas encore être déterminé, par exemple lorsqu'aucun horaire n'est planifié.

**contenant**

**type** `string`

Identifiant du type de contenant. L'une des valeurs suivantes : `serum`, `serum_capillary`, `serum_capillary_plain`, `edta`, `edta_capillary`, `citrate`, `lihep`, `lihep_capillary`, `glucoexact`, `fluoride`, `fluoride_capillary`, `homocysteine`, `urine`, `dried_blood_spot`, `swab`, `stool`, `saliva`, `hair` ou `trace_metal`.

**name** `string`

Nom lisible du contenant (par ex. « Serum », « EDTA », « Li-Heparin »).

**cap\_color** `string`

Code couleur hexadécimal du bouchon du contenant pour l'affichage (par ex. `"#A0784B"`). `null` lorsque le
contenant n'a pas de bouchon.

**volume** `string`

Capacité volumique du contenant (par ex. `"7.5 ml"`). `null` lorsque le volume ne s'applique pas.

**article\_number** `string`

Référence catalogue du fabricant (REF), lorsqu'elle est connue (par ex. `"01.1602.001"`). Omis pour les contenants sans référence associée.

**count** `integer`

Nombre de contenants de ce type requis.

**routing** `null`

Détails d'acheminement vers le laboratoire — volontairement non exposés, toujours `null`.

**pricing** `object | null`

La facture globale du panier pour le rendez-vous, selon ta grille tarifaire. `null` lorsque le rendez-vous n'a aucun
test associé ou que ta clé ne dispose pas du scope `prices_view`. [Tarification](https://docs.anivahealth.com/fr/concepts/pricing.md) explique le
modèle ; les montants individuels suivent la référence des [objets
prix](https://docs.anivahealth.com/fr/api/biomarkers/list-biomarkers.md#objets-de-prix).

**Champs de la facture**

**total\_cents** `integer`

Ce que coûte le panier selon ta grille tarifaire : les postes tarifés plus les panels tarifés plus les lignes
de biomarqueurs tarifées. Une ligne avec `price_cents: null` n'ajoute rien ; un panier qui en contient une affiche donc un total inférieur
à son coût réel.

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

Le même total selon la grille tarifaire publique conseillée.

**fees** `object`

Les frais qu'une prise de sang ajoute selon ta grille tarifaire, en centimes. La facture mensuelle les inclut. Voir [Obtenir la grille
tarifaire](https://docs.anivahealth.com/fr/api/pricing/get-rate-card.md).

**frais**

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

Frais de prélèvement par rendez-vous effectué.

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

Collation pour le patient. Facturée uniquement lorsque le patient reçoit une collation. Omis lorsque tes
patients n'en reçoivent pas ; contacte Aniva pour proposer des collations.

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

Frais de coursier pour l'enlèvement. Tes rendez-vous au même lieu le même jour partagent un seul
forfait.

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

Consommables : tubes, étiquettes, sachet.

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

`total_cents` plus tous les frais de `fees`, avec l'intégralité des frais logistiques. Ce montant
est inférieur lorsqu'un autre de tes rendez-vous partage la collecte.

**positions** `object[]`

Chaque position déclenchée sur ce panier — facturée une seule fois, intégralement, et délivrant
l'ensemble de ses membres. Contient `id`, `name`, `price_cents`, `retail_cents` et `tier`. Une
position qui n'est pas visible par les partenaires se déclenche et est facturée quand même, et est
renvoyée avec `id` et `name` définis sur `null`.

**panels** `object[]`

Chaque panel associé, avec `id`, `name`, `price_cents` et `retail_cents`.

**biomarkers** `object[]`

Une ligne par biomarqueur **délivré** — ce que tu as demandé, plus les composants appelés par ses
ratios et les membres délivrés par ses positions.

**id** `number`

Identifiant du biomarqueur.

**name** `string`

Nom d'affichage du biomarqueur.

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

Ce que coûte cette ligne sur ta carte, avec `retail_cents` à côté. `0` lorsqu'une position la
prend en charge ; `null` lorsqu'Aniva ne peut pas la tarifer.

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

Les ratios qui ont ajouté ce composant au panier. Omis si aucun ne l'a fait. Un composant n'est
payé qu'une fois par panier, quel que soit le nombre de ratios qui s'appuient dessus.

**requires** `number[]`

Présent lorsque cette ligne EST un ratio : les composants sous lesquels elle est facturée.

**via\_position** `string`

La position qui prend en charge ce marqueur, raison pour laquelle la ligne coûte `0`. Omis si
rien ne le couvre. `null` lorsque la position qui le couvre n'est pas visible par les
partenaires.

## Réponses d'erreur

| Statut | Description |
| - | - |
| `400` | Format d'identifiant invalide — la valeur fournie n'est pas un UUID valide. |
| `403` | Accès refusé — ta clé API n'a pas accès à cette opération. |
| `404` | Rendez-vous introuvable. |
| `500` | Erreur interne du serveur. |

```bash cURL theme={null}
curl --request GET \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a/preview \
  --header 'x-api-key: YOUR_API_KEY'
```

```json 200 theme={null}
{
  "containers": [
    {
      "type": "serum",
      "name": "Serum",
      "cap_color": "#A0784B",
      "volume": "7.5 ml",
      "article_number": "01.1602.001",
      "count": 3
    },
    {
      "type": "edta",
      "name": "EDTA",
      "cap_color": "#D13438",
      "volume": "3.4 ml",
      "article_number": "04.1914.001",
      "count": 2
    },
    {
      "type": "glucoexact",
      "name": "GlucoEXACT",
      "cap_color": "#9E9E9E",
      "volume": "3.1 ml",
      "article_number": "05.1074.001",
      "count": 1
    }
  ],
  "routing": null,
  "pricing": {
    "total_cents": 13751,
    "retail_total_cents": 17029,
    "fees": {
      "phlebotomy_fee_cents": 2500,
      "snack_fee_cents": 500,
      "logistics_fee_cents": 2000,
      "material_fee_cents": 250
    },
    "total_with_fees_cents": 19001,
    "positions": [
      {
        "id": "b7d4c2e1-9a3f-4c8b-91d2-5e6f7a8b9c0d",
        "name": "Aniva Blood Count",
        "price_cents": 452,
        "retail_cents": 520,
        "tier": "routine"
      }
    ],
    "panels": [
      {
        "id": "f1c2d4a3-7b8e-4f2a-9c1d-2e3f4a5b6c7d",
        "name": "Hormones (Female)",
        "price_cents": 11900,
        "retail_cents": 14900
      }
    ],
    "biomarkers": [
      { "id": 42, "name": "HDL Cholesterol", "price_cents": 233, "retail_cents": 268, "required_by": [279] },
      {
        "id": 71,
        "name": "Hemoglobin",
        "price_cents": 0,
        "retail_cents": 0,
        "via_position": "b7d4c2e1-9a3f-4c8b-91d2-5e6f7a8b9c0d"
      },
      { "id": 84, "name": "High-Sensitivity C-Reactive Protein (hs-CRP)", "price_cents": 1166, "retail_cents": 1341, "required_by": [279] },
      { "id": 279, "name": "hs-CRP / HDL Ratio", "price_cents": 0, "retail_cents": 0, "requires": [42, 84] }
    ]
  }
}
```

```json 200 (no panels) theme={null}
{
  "containers": [],
  "routing": null,
  "pricing": null
}
```

```json 200 (one item without a price) theme={null}
{
  "containers": [],
  "routing": null,
  "pricing": {
    "total_cents": 11900,
    "retail_total_cents": 14900,
    "fees": {
      "phlebotomy_fee_cents": 2500,
      "snack_fee_cents": 500,
      "logistics_fee_cents": 2000,
      "material_fee_cents": 250
    },
    "total_with_fees_cents": 17150,
    "positions": [],
    "panels": [
      {
        "id": "f1c2d4a3-7b8e-4f2a-9c1d-2e3f4a5b6c7d",
        "name": "Hormones (Female)",
        "price_cents": 11900,
        "retail_cents": 14900
      }
    ],
    "biomarkers": [{ "id": 555, "name": "Poppy Seeds (Pap s)", "price_cents": null, "retail_cents": null }]
  }
}
```

```json 404 theme={null}
{
  "error": "Appointment not found"
}
```


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