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
Chaqueprice_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.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:routineouspecialty. 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, etpositions 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.
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.
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.
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 :- Récupère les marqueurs que tu souhaites via Lister les biomarqueurs.
- Pour chacun, compare son propre
price_centsauprice_centsdes positions de son blocpositions. - 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.
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ûte0et la mentionne dansvia_position. Un composant ajouté par un ratio comporterequired_by; le ratio lui-même comporterequires.total_cents— les positions tarifées plus les panels tarifés plus les lignes de biomarqueurs tarifées, avecretail_total_centsà côté.feesettotal_with_fees_cents— les frais d’un rendez-vous, et le total avec ces frais.
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.