Naar hoofdinhoud gaan
Aniva prijst één ding: de positie. Een positie is een commercieel aanbod — een samengestelde set biomarkers die één keer wordt gefactureerd tegen een vaste prijs en altijd als geheel wordt geleverd. Een biomarker die je los kunt kopen is simpelweg een positie van één. Alles wat je in pricing ziet volgt daaruit. Lees deze pagina één keer en de vier statussen hieronder lijken niet langer op uitzonderingen.

Wat de getallen betekenen

Elke price_cents is wat jij betaalt, volgens de tariefkaart van je API-sleutel. Daarnaast is retail_cents hetzelfde item volgens de aanbevolen verkoopprijskaart, zodat je een besparing kunt tonen zonder een tweede verzoek. Beide zijn hele centen en beide zijn netto: btw wordt op je maandfactuur toegevoegd tegen het tarief dat bij jouw btw-regeling hoort, en bij een vrijstelling wordt er niets toegevoegd. Een panel dat tegen de consumentencatalogusprijs van Aniva wordt verkocht, wordt opgegeven tegen die prijs zonder de 19 % Duitse btw.
retail_cents is altijd aanwezig. Wanneer je sleutel al op de verkoopprijskaart staat, is die gewoon gelijk aan price_cents.
Voor prijzen heb je de scope prices_view nodig. Zonder deze scope is pricing gelijk aan null in de overzichten en de preview, en geven de Pricing-endpoints 403 terug.

Je tariefkaart

Je tariefkaart bepaalt je prijzen. Lees deze uit via Get Rate Card.
  • Elke analyse heeft een tier: routine of specialty. De prijs ervan is de Aniva-catalogusprijs keer de vermenigvuldigingsfactor van die tier.
  • De kosten gelden per afspraak en de logistieke kosten per ophaling door de koerier. Je afspraken op dezelfde locatie op dezelfde dag delen één ophaling. Aniva factureert de kosten op je maandfactuur.

De vier statussen

price_cents, plus welk optioneel blok ernaast staat, vormt de status. Er is geen apart typeveld.

Positief — los te bestellen

De marker heeft een eigen prijs. Hij kan nog steeds in posities voorkomen, en positions somt ze dan op met de goedkoopste eerst — de positie kopen is vaak goedkoper dan de onderdelen één voor één kopen.
biomarker_ids is de volledige set onderdelen van de positie; includes is die set min de marker die je opvroeg — wat er verder bij zit.

Nul met requires — een ratio

Een ratio wordt berekend uit gemeten markers. De meeste ratio’s kosten 0. Bij een ratio met een positieve price_cents wordt die prijs boven op de onderdelen in rekening gebracht. Bestel je hem, dan zet Aniva de onderdelen voor hun eigen prijs in de winkelwagen. Een onderdeel betaal je één keer per winkelwagen, ongeacht hoeveel ratio’s ervan gebruikmaken.
Een ratio werkt samen met posities in plaats van ermee te concurreren. Als de onderdelen ervan deel uitmaken van een positie die je al koopt, dekt de positie ze en is de ratio zonder extra kosten inbegrepen.
Een ratio waarvan niet alle onderdelen een prijs hebben, ontbreekt in de catalogus — hij verschijnt niet met price_cents: null. Hij komt terug zodra Aniva een prijs vaststelt voor het ontbrekende onderdeel.

Nul met positions — alleen te koop binnen een positie

De marker heeft geen eigen prijs, maar is onderdeel van een of meer posities. Koop een van die posities en je krijgt hem erbij.
Een van deze markers los toevoegen aan een afspraak wordt geweigerd — zie Individuele biomarkers toevoegen. Voeg in plaats daarvan alle biomarkers van een van de vermelde posities toe.

Null — niet gecureerd

Aniva heeft nog niet bepaald wat deze marker kost, dus hij is niet te koop. null betekent niet nul en niet “vraag het ons”: beschouw hem als niet beschikbaar.
Aniva weigert een null-marker bij het bestellen. Een biomarker is bestelbaar onder twee voorwaarden. Een laboratorium waar Aniva naartoe kan routeren moet de biomarker leveren. De catalogus van Aniva moet er een prijs voor hebben. Als je een null-marker aan een afspraak toevoegt, geeft de API 400 terug met error: "biomarker_not_priced". Zie Individuele biomarkers toevoegen. Een laboratorium kan een null-marker leveren, maar levering alleen maakt de marker nog niet beschikbaar. Beschouw null als niet beschikbaar.
Sommige markers zijn bewust null. Aniva verkoopt microbioom- en genetische tests als kits. Een kit heeft één prijs, dus de bijbehorende markers hebben geen eigen prijs. Om deze markers te kopen, bestel je het panel dat de kit vormt. De markers zijn bij het panel inbegrepen. De API accepteert ook een bijbehorende marker die je toevoegt aan een afspraak die dat panel al bevat. Een marker geeft ook null aan wanneer Aniva deze alleen verkoopt binnen een positie die je niet kunt zien. Het resultaat is hetzelfde: je hebt geen prijs om de marker voor te kopen. De marker krijgt een prijs zodra Aniva die positie zichtbaar maakt voor partners.

De goedkoopste manier vinden om een set te kopen

Omdat elke positie waar een marker bij hoort met de marker meekomt, kun je dit lokaal oplossen, zonder extra verzoeken:
  1. Verzamel de gewenste markers via Biomarkers opvragen.
  2. Vergelijk voor elke marker de eigen price_cents met de price_cents van de posities in het positions-blok.
  3. Een positie wordt één keer in rekening gebracht en levert de volledige biomarker_ids-set, dus een positie die meerdere van jouw markers dekt wordt maar eenmaal gefactureerd. Extra markers waar je niet om hebt gevraagd zijn zonder extra kosten inbegrepen.
Niets overlapt dubbel: twee posities die een marker delen leveren elk hun eigen set, de marker wordt één keer vermeld en ze geven nooit korting op elkaar.

De rekening

Voorbeeld van afspraak geeft de rekening van een afspraak terug. Prijsopgave winkelwagen geeft dezelfde rekening terug zonder afspraak. De rekening bevat:
  • positions[] — elke toegepaste positie, één keer in rekening gebracht tegen de vaste prijs.
  • panels[] — elk gekoppeld panel.
  • biomarkers[] — één rij per geleverde marker. Een rij die door een positie wordt gedekt kost 0 en vermeldt die positie in via_position. Een onderdeel dat door een ratio wordt meegenomen bevat required_by; de ratio zelf bevat requires.
  • total_cents — de geprijsde posities plus de geprijsde panels plus de geprijsde biomarker-rijen, met retail_total_cents ernaast.
  • fees en total_with_fees_cents — de kosten van één afspraak, en het totaal inclusief die kosten.
Een rij waar Aniva geen prijs voor kan bepalen bevat price_cents: null. De rij telt niet mee voor het totaal. Je kunt een niet-geprijsde marker niet los toevoegen, dus deze rij komt uit een positie of een panel. Die positie of dat panel brengt de kosten al in rekening.
Aniva heeft nog niet elke positie gepubliceerd. Een niet-gepubliceerde positie wordt wel in rekening gebracht. Deze verschijnt in positions[] met id en name op null, en de bijbehorende biomarker-rijen hebben via_position: null.