Перейти до основного вмісту
Aniva встановлює ціну на одне: позицію. Позиція — це комерційна пропозиція: підібраний набір біомаркерів, який оплачується один раз за фіксованою ціною і завжди надається цілком. Біомаркер, який ти можеш купити окремо, — це просто позиція з одного біомаркера. Усе, що ти бачиш у pricing, випливає з цього. Прочитай цю сторінку один раз — і чотири стани нижче перестануть здаватися особливими випадками.

Що означають числа

Кожне price_cents — це сума, яку платиш ти за тарифною сіткою свого API-ключа. Поруч retail_cents — та сама позиція за рекомендованою роздрібною тарифною сіткою, тож ти можеш показати економію без другого запиту. Обидва значення вказані в цілих центах і обидва є нетто: ПДВ додається у твоєму щомісячному рахунку за ставкою твого режиму ПДВ, а при звільненні від ПДВ не нараховується. Панель, що продається за споживчою ціною каталогу Aniva, зазначається за цією ціною за вирахуванням 19% німецького ПДВ.
Поле retail_cents є завжди. Коли твій ключ уже працює за роздрібною тарифною сіткою, воно просто дорівнює price_cents.
Для перегляду цін потрібен дозвіл prices_view. Без нього поле pricing має значення null у списках і попередньому перегляді, а ендпоїнти Pricing повертають 403.

Твоя тарифна сітка

Твоя тарифна сітка визначає твої ціни. Отримай її через Get Rate Card.
  • Кожен аналіз має tier: routine або specialty. Його ціна дорівнює ціні каталогу Aniva, помноженій на коефіцієнт цього рівня.
  • Збори нараховуються за кожен запис, а логістичний збір — за кожен виїзд кур’єра. Твої записи в одній локації в той самий день об’єднуються в один виїзд кур’єра. Aniva виставляє ці збори у твоєму щомісячному рахунку.

Чотири стани

Значення price_cents разом із тим, який необов’язковий блок стоїть поруч, і визначає стан. Окремого поля типу немає.

Додатне — можна замовити окремо

Маркер має власну ціну. Він усе одно може входити до позицій, і тоді positions наводить їх від найдешевшої — купити позицію часто дешевше, ніж купувати її складові окремо.
biomarker_ids — це повний набір складових позиції; includes — цей самий набір без запитаного маркера, тобто те, що йде в комплекті.

Нуль із requires — співвідношення

Співвідношення обчислюється на основі виміряних маркерів. Більшість співвідношень коштують 0. Для співвідношення з додатним price_cents ця сума нараховується додатково до вартості його компонентів. Замов його — і Aniva додасть його компоненти до кошика за їхніми власними цінами. Компонент оплачується один раз на кошик, скільки б співвідношень на нього не спиралося.
Співвідношення поєднується з позиціями, а не конкурує з ними. Якщо його компоненти входять до позиції, яку ти вже купуєш, позиція покриває їхню вартість, а співвідношення додається без доплати.
Співвідношення, у якого не всі компоненти мають ціну, відсутнє в каталозі — воно не відображається з price_cents: null. Воно повертається, щойно Aniva встановить ціну на відсутній компонент.

Нуль із positions — продається лише у складі позиції

У цього маркера немає власної ціни, але він входить до однієї або кількох позицій. Купи одну з цих позицій — і отримаєш його.
Додавання одного з них до запису окремо буде відхилено — див. Додавання окремих біомаркерів. Натомість додай усі біомаркери однієї з перелічених позицій.

Null — неопрацьований

Aniva не визначила ціну цього маркера, тому він не продається. null — це не нуль і не «запитай нас»: вважай його недоступним.
Aniva відхиляє маркер зі значенням null під час замовлення. Щоб біомаркер можна було замовити, потрібні дві умови. Лабораторія, до якої Aniva може спрямувати замовлення, має виконувати цей біомаркер. У каталозі Aniva для нього має бути вказана ціна. Якщо ти додаси маркер зі значенням null до запису, API поверне 400 з error: "biomarker_not_priced". Див. Додавання окремих біомаркерів. Лабораторія може виконувати маркер зі значенням null, але саме по собі це не робить його доступним. Вважай null недоступним.
Деякі маркери мають значення null за задумом. Aniva продає тести мікробіому та генетичні тести як набори. Набір має одну ціну, тому маркери в його складі не мають власної ціни. Щоб купити ці маркери, замов панель, яка відповідає цьому набору. Усі маркери входять до панелі. API також приймає маркер зі складу набору, якщо ти додаєш його до запису, у якому вже є ця панель. Маркер також має значення null, коли Aniva продає його лише в межах позиції, яку ти не бачиш. Результат той самий: у тебе немає ціни, за якою можна купити цей маркер. Маркер отримає ціну, коли Aniva відкриє цю позицію для партнерів.

Як знайти найдешевший спосіб купити набір

Оскільки кожна позиція, до якої входить маркер, передається разом із ним, ти можеш розрахувати це локально, без додаткових запитів:
  1. Збери потрібні маркери через Список біомаркерів.
  2. Для кожного з них порівняй його власне значення price_cents зі значенням price_cents позицій у його блоці positions.
  3. Позиція оплачується один раз і містить увесь свій набір biomarker_ids, тому за позицію, що охоплює кілька твоїх маркерів, плата стягується лише один раз. Додаткові маркери, що не входять до твого запиту, додаються без доплати.
Ніщо не перекривається двічі: дві позиції зі спільним маркером видають кожна свій набір, маркер вказується один раз, і вони ніколи не зменшують ціну одна одної.

Рахунок

Попередній перегляд запису повертає рахунок запису. Розрахунок кошика повертає той самий рахунок без запису. Рахунок містить:
  • positions[] — кожна позиція, що спрацювала, оплачена один раз за її фіксованою ціною.
  • panels[] — кожна додана панель.
  • biomarkers[] — один рядок на кожен наданий маркер. Рядок, оплачений позицією, коштує 0 і вказує її в via_position. Компонент, підтягнутий співвідношенням, містить required_by; саме співвідношення містить requires.
  • total_cents — позиції з ціною плюс панелі з ціною плюс рядки біомаркерів із ціною, а поруч — retail_total_cents.
  • fees і total_with_fees_cents — збори за один запис і підсумкова сума з ними.
Рядок, для якого Aniva не може визначити ціну, має price_cents: null. Цей рядок нічого не додає до підсумку. Ти не можеш додати маркер без ціни окремо, тому цей рядок надійшов із позиції або панелі. Ця позиція або панель уже оплачує його.
Aniva ще не опублікувала всі позиції. Неопублікована позиція все одно оплачується. Вона з’являється в positions[] зі значеннями null для id і name, а її рядки біомаркерів мають via_position: null.