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

Что означают числа

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

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

Твоя тарифная сетка определяет твои цены. Запроси её через Получение тарифной сетки.
  • У каждого анализа есть 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.