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

# Chiffrer un panier

> Calculer le prix de panels et de biomarqueurs sans rendez-vous

Renvoie le décompte des panels et biomarqueurs selon ta grille tarifaire. Aucun rendez-vous n'est nécessaire. Rien n'est
réservé.

Le décompte est identique à `pricing` dans [Prévisualiser un rendez-vous](https://docs.anivahealth.com/fr/api/appointments/preview-containers.md),
plus ce qu'ajoute le mode de prélèvement. Par défaut, il s'agit d'une prise de sang sur site, avec
les frais de rendez-vous. Envoie `fulfilment: "home_kit"` et un `country_code` pour chiffrer à la place un kit expédié
dans ce pays : les frais de kit, les dispositifs de prélèvement, l'affranchissement aller et retour, l'étui
et un sachet de lancettes de rechange, tels qu'ils figurent sur ta facture mensuelle.
[Tarification](https://docs.anivahealth.com/fr/concepts/pricing.md) explique comment Aniva calcule le prix des analyses.

Nécessite le scope `prices_view`.

## Requête

### Paramètres du corps

Envoie au moins un identifiant dans `panel_ids` ou `biomarker_ids`.

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

Panels à chiffrer, 50 au maximum. Chacun doit figurer dans [Lister les panels](https://docs.anivahealth.com/fr/api/panels/list-panels.md) pour ta clé.

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

Biomarqueurs à chiffrer, 500 au maximum.

**sex** `integer`

Sexe biologique selon ISO/IEC 5218 : `1` = masculin, `2` = féminin. Certains panels n'ajoutent des biomarqueurs que pour un
sexe ou un âge donné. Envoie `sex` et `date_of_birth` ensemble pour appliquer ces règles. Sans eux, ces règles
ne s'appliquent pas.

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

Date de naissance, `YYYY-MM-DD`. Envoie-la avec `sex`.

**rate\_card** `string`

La grille tarifaire à utiliser : `retail`, ou l'`id` obtenu via [Obtenir la grille tarifaire](https://docs.anivahealth.com/fr/api/pricing/get-rate-card.md).
Par défaut : la grille tarifaire de ta clé API, sinon le tarif public.

**fulfilment** `string`

Mode de prélèvement. `draw` (par défaut) : une prise de sang sur site, qui ajoute les frais
de rendez-vous. `home_kit` : un kit expédié vers `country_code`, qui ajoute les lignes de kit à la place. Un kit à domicile
contient exactement un panel, et ce panel doit être vendu comme kit à domicile.

**country\_code** `string`

Le pays de livraison du kit, ISO 3166-1 alpha-2 (`DE`, `SE`). Requis avec
`fulfilment: "home_kit"`, et uniquement dans ce cas. Il détermine les lignes d'affranchissement.

## Réponse

**total\_cents** `integer`

Le prix des analyses selon ta grille tarifaire : chaque poste, panel et ligne de biomarqueur tarifé. Une ligne
avec `price_cents: null` n'ajoute rien.

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

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

**fees** `object`

Les frais d'un rendez-vous, en centimes. Aniva les porte sur ta facture mensuelle. Ils s'appliquent à un
`draw` ; un `home_kit` facture à la place les lignes de `fulfilment`.

**frais**

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

Par rendez-vous effectué.

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

Par rendez-vous où le patient reçoit une collation. Absent si tes patients ne reçoivent pas de collation. Pour
proposer des collations, contacte Aniva.

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

Par enlèvement par coursier. Tes rendez-vous au même endroit le même jour partagent un seul enlèvement.

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

Par rendez-vous effectué. Couvre les tubes, les étiquettes et le sachet.

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

`total_cents` plus ce qu'ajoute le mode de prélèvement. Pour un `draw` : tous les frais de `fees`. Il compte les frais
logistiques complets, et un enlèvement partagé réduit le montant réel. Pour un `home_kit` :
`fulfilment.total_cents`.

**fulfilment** `object`

Le mode de prélèvement et ce qu'il ajoute. `kind` vaut `draw` ou `home_kit`. Un `draw` n'a aucun autre
champ.

**home\_kit**

**country\_code** `string`

Le pays de livraison pour lequel l'affranchissement a été chiffré.

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

Le kit sous lequel le panel est expédié. `null` si Aniva n'en a pas encore configuré ; le devis ne compte alors
aucun dispositif.

**devices** `integer`

Dispositifs de prélèvement dans la boîte, chacun facturé au tarif du dispositif.

**lines** `object[]`

Les lignes de kit qu'une commande ajoute à ta facture mensuelle, chacune avec `description`, `quantity`,
`unit`, `unit_cents` et `amount_cents`. L'affranchissement est chiffré selon les services réservés à l'étape d'expédition
pour ce pays. Des frais à 0 sur ta grille ne génèrent aucune ligne. Un crédit de matériel prépayé n'est pas
déduit ici.

**total\_cents** `integer`

La somme de `lines`, hors taxes.

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

Facturé en plus, hors taxes, si tu n'actives pas le kit avant qu'il n'arrive au laboratoire et que le laboratoire
l'active. Il n'apparaît ni dans `lines` ni dans `total_cents`. 0 signifie que ta grille ne prévoit pas ces frais.

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

Trajets (`out`, `back`) que ta grille tarife par pays mais sans tarif pour ce pays. Ils
basculent sur le forfait d'affranchissement, ou sur 0 si ta grille n'en a pas. Vide quand chaque trajet a trouvé
son prix.

**positions** `object[]`

Les postes du décompte. Un poste est un ensemble de biomarqueurs à prix unique. Il contient `id`, `name`,
`price_cents`, `retail_cents` et `tier`. `id` et `name` valent `null` pour un poste qu'Aniva n'a pas
encore publié.

**panels** `object[]`

Les panels du décompte, avec `id`, `name`, `price_cents` et `retail_cents`.

**biomarkers** `object[]`

Une ligne par biomarqueur que tu reçois. Cela inclut les composants d'un ratio et chaque membre d'un
poste.

**ligne de biomarqueur**

**id** `number`

Identifiant du biomarqueur.

**name** `string`

Nom du biomarqueur.

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

Le prix de cette ligne, accompagné de `retail_cents`. `0` quand un poste ou un panel le
couvre.

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

Les ratios qui nécessitent ce biomarqueur. Tu ne le paies qu'une seule fois.

**requires** `number[]`

Uniquement pour un ratio : les biomarqueurs à partir desquels il est calculé.

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

Le poste qui couvre cette ligne. `null` quand le poste n'est pas encore publié.

## Réponses d'erreur

| Statut | Description |
| - | - |
| `400` | Le corps est invalide ou ta clé n'est pas autorisée à utiliser ce `rate_card`. |
| `400` | Un devis `home_kit` nécessite exactement un panel, vendu comme kit à domicile, ainsi qu'un code pays. |
| `400` | `biomarker_not_available` : aucun laboratoire accessible à ta clé n'analyse ce biomarqueur. |
| `400` | `biomarker_not_priced` : le biomarqueur n'a pas de prix. |
| `400` | `biomarker_requires_position` : le biomarqueur est vendu uniquement au sein d'un poste. Le corps liste les postes. |
| `403` | Ta clé API n'a pas le scope `prices_view`. |
| `404` | `Panels not found` : le panel n'existe pas ou ta clé ne peut pas le lister. |
| `404` | `Biomarkers not found` : le biomarqueur n'existe pas. |
| `500` | Erreur interne du serveur. |

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