Passer au contenu principal
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 %.
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.
  • 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.

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.
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.
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.
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.
Ajouter l’un d’eux seul à un rendez-vous est refusé — voir Ajouter des biomarqueurs individuels. 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.
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. 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.
  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 renvoie la facture d’un rendez-vous. Chiffrer un panier 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à.
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.