Ugrás a fő tartalomhoz
Az Aniva egyetlen dolgot áraz: a tételt. A tétel egy kereskedelmi ajánlat – biomarkerek válogatott készlete, amelyet egyszer, fix áron számláznak, és mindig egyben teljesül. Az önállóan megvásárolható biomarker egyszerűen egyetlen elemből álló tétel. Minden, amit a pricing mezőben látsz, ebből következik. Olvasd el egyszer ezt az oldalt, és az alábbi négy állapot már nem tűnik különleges esetnek.

Mit jelentenek a számok

Minden price_cents érték az, amit te fizetsz az API-kulcsodhoz tartozó árlista alapján. Mellette a retail_cents ugyanez a tétel az ajánlott kiskereskedelmi árlistán, így egy második kérés nélkül is meg tudod mutatni a megtakarítást. Mindkettő egész centben megadott, és mindkettő nettó: az áfa a havi számládra kerül fel az áfastátuszodnak megfelelő kulccsal, áfamentesség esetén pedig nem kerül rá áfa. Az Aniva fogyasztói katalógusárán értékesített panel ára a 19%-os német áfa nélkül szerepel.
A retail_cents mindig szerepel. Ha a kulcsod már a kiskereskedelmi árlistán van, egyszerűen megegyezik a price_cents értékkel.
Az árakhoz szükséges a prices_view scope. Enélkül a pricing értéke null a listázásoknál és az előnézetnél, a Pricing végpontok pedig 403-at adnak vissza.

Az árlistád

Az árlistád határozza meg az áraidat. A Get Rate Card végpontról olvashatod ki.
  • Minden elemzésnek van egy tier besorolása: routine vagy specialty. Az ára az Aniva katalógusár szorozva az adott szint szorzójával.
  • A díjak időpontonként, a logisztikai díj pedig futáros felvételenként értendő. Az ugyanazon a helyszínen, ugyanazon a napon lévő időpontjaid egyetlen felvételen osztoznak. A díjakat az Aniva a havi számládon számlázza ki.

A négy állapot

A price_cents értéke, valamint a mellette lévő opcionális blokk határozza meg az állapotot. Nincs külön típusmező.

Pozitív – önállóan rendelhető

A markernek saját ára van. Ettől még szerepelhet tételekben, ilyenkor a positions a legolcsóbbtól kezdve sorolja fel őket – a tétel megvásárlása gyakran olcsóbb, mint az elemeit egyenként megvenni.
A biomarker_ids a tétel teljes elemkészlete; az includes ugyanez a készlet a lekérdezett marker nélkül – vagyis ami még jár hozzá.

Nulla requires mezővel – arány

Az arányt mért markerekből számítják ki. A legtöbb arány ára 0. A pozitív price_cents értékű arány az összetevői mellett ezt az árat is felszámítja. Ha megrendeled, az Aniva az összetevőit a saját árukon a kosárba teszi. Egy összetevőt kosaranként egyszer fizetsz ki, bármennyi arány támaszkodik is rá.
Az arány jól kombinálható a tételekkel, nem pedig verseng velük. Ha az összetevői elemei egy olyan tételnek, amelyet már megvásárolsz, a tétel fedezi őket, az arány pedig külön díj nélkül jár hozzá.
Az olyan arány, amelynek nem minden összetevője van beárazva, hiányzik a katalógusból – nem jelenik meg price_cents: null értékkel. Akkor tér vissza, amikor az Aniva beárazza a hiányzó összetevőt.

Nulla positions mezővel – csak tételen belül kapható

A markernek nincs saját ára, de egy vagy több tétel része. Vegyél meg egyet ezek közül a tételek közül, és megkapod.
Ha egy ilyet önállóan adsz hozzá egy időponthoz, a rendszer elutasítja – lásd: Egyéni biomarkerek hozzáadása. Ehelyett add hozzá valamelyik felsorolt tétel összes biomarkerét.

Null – nem beárazott

Az Aniva még nem döntötte el, mennyibe kerül ez a marker, ezért nem megvásárolható. A null nem nulla és nem „kérdezz minket”: kezeld nem elérhetőként.
Az Aniva rendeléskor elutasítja a null értékű markert. Két feltétel szükséges ahhoz, hogy egy biomarker rendelhető legyen. Egy olyan laboratóriumnak kell teljesítenie a biomarkert, amelyhez az Aniva át tudja irányítani a rendelést. Az Aniva katalógusának tartalmaznia kell az árát. Ha null értékű markert csatolsz egy időponthoz, az API 400 kóddal és error: "biomarker_not_priced" hibával válaszol. Lásd: Egyéni biomarkerek hozzáadása. Egy laboratórium teljesíthet null értékű markert, de a teljesítés önmagában nem teszi elérhetővé a markert. Kezeld a null értéket nem elérhetőként.
Néhány marker szándékosan null értékű. Az Aniva a mikrobiom- és genetikai teszteket tesztkészletként értékesíti. Egy tesztkészletnek egyetlen ára van, ezért az ahhoz tartozó markereknek nincs saját áruk. Ezeknek a markereknek a megvásárlásához rendeld meg a tesztkészletnek megfelelő panelt. Az elemek a panellel együtt járnak. Az API olyan elemet is elfogad, amelyet olyan időponthoz adsz hozzá, amely már tartalmazza a paneljét. A marker akkor is null értéket mutat, ha az Aniva csak olyan tételen belül értékesíti, amelyet nem látsz. Az eredmény ugyanaz: nincs olyan ár, amelyen megvehetnéd a markert. A marker akkor kap árat, amikor az Aniva láthatóvá teszi az adott tételt a partnerek számára.

Egy összeállítás megvásárlásának legolcsóbb módja

Mivel minden tétel, amelyhez egy marker tartozik, együtt érkezik a markerrel, ezt helyben, további kérések nélkül is megoldhatod:
  1. Gyűjtsd össze a kívánt markereket innen: Biomarkerek listázása.
  2. Mindegyiknél hasonlítsd össze a saját price_cents értékét a positions blokkjában lévő tételek price_cents értékével.
  3. Egy tétel egyszer kerül számlázásra, és a teljes biomarker_ids halmazát biztosítja, így egy több markeredet is lefedő tételt csak egyszer számlázunk ki. A nem kért extra markerek további költség nélkül járnak hozzá.
Semmi sem duplázódik: ha két tételnek van közös eleme, mindkettő biztosítja a saját halmazát, az elem egyszer szerepel a listában, és soha nem csökkentik egymás árát.

A számla

Az Időpont előnézete visszaadja egy időpont számláját. A Kosár árajánlata ugyanezt a számlát adja vissza időpont nélkül. A számla a következőket tartalmazza:
  • positions[] – minden aktiválódott tétel, egyszer számlázva az átalányárán.
  • panels[] – minden csatolt panel.
  • biomarkers[] – egy sor minden teljesített markerhez. Egy tétel által fedezett sor ára 0, és a via_position mezőben megnevezi a tételt. Egy arány által behúzott összetevő tartalmazza a required_by mezőt; maga az arány pedig a requires mezőt.
  • total_cents – az árazott tételek, az árazott panelek és az árazott biomarkersorok összege, mellette a retail_total_cents értékkel.
  • fees és total_with_fees_cents – egy időpont díjai, valamint a velük együtt számított végösszeg.
Az a sor, amelyet az Aniva nem tud beárazni, price_cents: null értéket tartalmaz. A sor nem ad hozzá semmit a végösszeghez. Árazatlan markert önállóan nem csatolhatsz, így ezt a sort egy tétel vagy egy panel adta hozzá. Az adott tétel vagy panel már kiszámlázza.
Az Aniva még nem tett közzé minden tételt. A nem közzétett tételek továbbra is számlázásra kerülnek. Ezek a positions[] tömbben null értékű id és name mezővel jelennek meg, biomarkersoraiknál pedig via_position: null szerepel.