Przejdź do głównej treści
Aniva wycenia jedną rzecz: pozycję. Pozycja to oferta handlowa — dobrany zestaw biomarkerów, który rozliczany jest raz, w stałej cenie, i zawsze realizowany w całości. Biomarker, który możesz kupić osobno, to po prostu pozycja jednoelementowa. Wszystko, co widzisz w pricing, wynika właśnie z tego. Przeczytaj tę stronę raz, a cztery poniższe stany przestaną wyglądać jak wyjątki.

Co oznaczają liczby

Każda wartość price_cents to kwota, którą ty płacisz według cennika przypisanego do twojego klucza API. Obok niej retail_cents to ten sam element w sugerowanym cenniku detalicznym, dzięki czemu możesz pokazać oszczędność bez drugiego zapytania. Obie wartości to liczby całkowite w centach i obie są netto: VAT doliczany jest na fakturze miesięcznej według stawki wynikającej z twojego statusu VAT, a w przypadku zwolnienia nie jest doliczany. Panel sprzedawany w konsumenckiej cenie katalogowej Aniva jest podawany w tej cenie pomniejszonej o 19% niemieckiego podatku VAT.
Pole retail_cents jest zawsze obecne. Gdy twój klucz korzysta już z cennika detalicznego, po prostu równa się price_cents.
Ceny wymagają zakresu prices_view. Bez niego pricing ma wartość null na listach i w podglądzie, a endpointy Pricing zwracają 403.

Twój cennik

Twój cennik określa twoje ceny. Odczytasz go za pomocą Get Rate Card.
  • Każda analiza ma poziom tier: routine lub specialty. Jej cena to cena katalogowa Aniva pomnożona przez mnożnik tego poziomu.
  • Opłaty naliczane są za wizytę, a opłata logistyczna za odbiór kurierski. Twoje wizyty w tej samej lokalizacji tego samego dnia korzystają z jednego odbioru. Aniva rozlicza te opłaty na twojej fakturze miesięcznej.

Cztery stany

Wartość price_cents oraz to, jaki opcjonalny blok znajduje się obok niej, określają dany stan. Nie ma osobnego pola typu.

Wartość dodatnia — do zamówienia osobno

Marker ma własną cenę. Nadal może występować w pozycjach, a positions wymienia je wtedy od najtańszej — zakup pozycji często jest tańszy niż kupowanie jej składników osobno.
biomarker_ids to pełny zestaw składników pozycji; includes to ten sam zestaw bez markera, o który pytasz — czyli to, co dostajesz dodatkowo.

Zero z requires — wskaźnik

Wskaźnik jest obliczany na podstawie zmierzonych markerów. Większość wskaźników kosztuje 0. Wskaźnik z dodatnią wartością price_cents dolicza tę cenę oprócz ceny swoich składników. Po zamówieniu go Aniva dodaje jego składniki do koszyka w ich własnych cenach. Za składnik płacisz raz na koszyk, niezależnie od tego, ile wskaźników z niego korzysta.
Wskaźnik łączy się z pozycjami, zamiast z nimi konkurować. Jeśli jego składniki należą do pozycji, którą już kupujesz, pozycja pokrywa ich koszt, a wskaźnik jest w cenie.
Wskaźnik, którego nie wszystkie składniki są wycenione, nie występuje w katalogu — nie pojawia się z price_cents: null. Wraca, gdy Aniva wyceni brakujący składnik.

Zero z positions — sprzedawany wyłącznie w ramach pozycji

Marker nie ma własnej ceny, ale należy do jednej lub kilku pozycji. Kup jedną z tych pozycji, a go otrzymasz.
Dodanie takiego markera osobno do wizyty zostanie odrzucone — zobacz Dodaj pojedyncze biomarkery. Zamiast tego dodaj wszystkie biomarkery z jednej z wymienionych pozycji.

Null — nieopracowany

Aniva nie ustaliła ceny tego markera, więc nie jest on w sprzedaży. null nie oznacza zera ani „zapytaj nas”: traktuj go jako niedostępny.
Aniva odrzuca marker z wartością null w momencie zamówienia. Aby biomarker można było zamówić, muszą być spełnione dwa warunki. Laboratorium, do którego Aniva może skierować zlecenie, musi wykonywać ten biomarker. Katalog Aniva musi mieć dla niego cenę. Jeśli dołączysz marker z wartością null do wizyty, API zwróci 400 z error: "biomarker_not_priced". Zobacz Dodaj pojedyncze biomarkery. Laboratorium może wykonywać marker z wartością null, ale sama możliwość wykonania nie sprawia, że marker jest dostępny. Traktuj null jako niedostępny.
Niektóre markery mają wartość null celowo. Aniva sprzedaje badania mikrobiomu i genetyczne jako zestawy. Zestaw ma jedną cenę, więc wchodzące w jego skład markery nie mają własnej ceny. Aby kupić te markery, zamów panel odpowiadający zestawowi. Markery składowe są zawarte w panelu. API akceptuje też marker składowy dodany do wizyty, która zawiera już jego panel. Marker ma również wartość null, gdy Aniva sprzedaje go wyłącznie w ramach pozycji, której nie widzisz. Efekt jest taki sam: nie masz ceny, po której możesz kupić ten marker. Marker otrzymuje cenę, gdy Aniva udostępni tę pozycję partnerom.

Jak najtaniej kupić zestaw

Ponieważ każda pozycja, do której należy marker, jest zwracana razem z nim, możesz to wyliczyć lokalnie, bez dodatkowych zapytań:
  1. Pobierz wybrane markery z Wyświetl biomarkery.
  2. Dla każdego z nich porównaj jego własne price_cents z price_cents pozycji w jego bloku positions.
  3. Pozycja jest rozliczana raz i obejmuje cały swój zestaw biomarker_ids, więc pozycja pokrywająca kilka twoich markerów jest naliczana jednorazowo. Dodatkowe markery spoza twojej listy dostajesz bez dodatkowych kosztów.
Nic się nie nakłada podwójnie: dwie pozycje ze wspólnym markerem dostarczają swoje zestawy, marker jest wymieniony raz, a pozycje nigdy nie obniżają wzajemnie swoich cen.

Rachunek

Podgląd wizyty zwraca rachunek dla wizyty. Wycena koszyka zwraca taki sam rachunek bez wizyty. Rachunek zawiera:
  • positions[] — każda zastosowana pozycja, rozliczona raz według swojej stałej ceny.
  • panels[] — każdy dołączony panel.
  • biomarkers[] — jeden wiersz na każdy dostarczony marker. Wiersz opłacony w ramach pozycji kosztuje 0 i wskazuje ją w via_position. Składnik dodany na potrzeby wskaźnika ma pole required_by, a sam wskaźnik ma pole requires.
  • total_cents — suma wycenionych pozycji, wycenionych paneli i wycenionych wierszy biomarkerów, z polem retail_total_cents obok.
  • fees i total_with_fees_cents — opłaty za jedną wizytę oraz łączna kwota z tymi opłatami.
Wiersz, którego Aniva nie może wycenić, ma wartość price_cents: null. Taki wiersz nie zwiększa sumy. Nie możesz samodzielnie dołączyć niewycenionego markera, więc ten wiersz pochodzi z pozycji lub panelu. Ta pozycja lub panel już go rozlicza.
Aniva nie opublikowała jeszcze wszystkich pozycji. Nieopublikowana pozycja nadal jest rozliczana. Pojawia się w positions[] z polami id i name ustawionymi na null, a wiersze jej biomarkerów mają via_position: null.