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 добавит его компоненты в корзину по их собственным ценам. Компонент оплачивается один раз на корзину, сколько бы соотношений на него ни опиралось.
Ноль с positions — продаётся только внутри позиции
У маркера нет собственной цены, но он входит в одну или несколько позиций. Купи одну из этих позиций, и ты его получишь.
Null — цена не задана
Aniva не определила стоимость этого маркера, поэтому он не продаётся.null — это не ноль и не «спроси нас»: считай его недоступным.
null задан намеренно. Aniva продаёт тесты микробиома и генетические тесты в
виде наборов. У набора единая цена, поэтому у входящих в него маркеров нет собственной цены. Чтобы
купить эти маркеры, закажи панель, соответствующую этому набору. Входящие маркеры идут вместе с
панелью. API также примет отдельный маркер, если ты добавишь его в запись, в которой уже есть эта
панель.
Маркер также показывает null, если Aniva продаёт его только в составе позиции, которую ты не
видишь. Результат тот же: у тебя нет цены, по которой можно купить этот маркер. У маркера появится
цена, когда Aniva откроет эту позицию для партнёров.
Поиск самого дешёвого способа купить набор
Поскольку каждая позиция, в которую входит маркер, передаётся вместе с ним, ты можешь решить эту задачу локально, без лишних запросов:- Собери нужные маркеры из Списка биомаркеров.
- Для каждого сравни его собственное значение
price_centsсprice_centsпозиций в его блокеpositions. - Позиция оплачивается один раз и даёт весь свой набор
biomarker_ids, поэтому позиция, покрывающая сразу несколько твоих маркеров, оплачивается однократно. Дополнительные маркеры, которых не было в твоём запросе, идут без доплаты.
Счёт
Предпросмотр записи возвращает счёт за запись. Расчёт корзины возвращает тот же счёт без записи. В счёте есть:positions[]— каждая сработавшая позиция, оплаченная один раз по своей фиксированной цене.panels[]— каждая добавленная панель.biomarkers[]— по одной строке на каждый выполняемый маркер. Строка, оплаченная позицией, стоит0и указывает её вvia_position. Компонент, подтянутый соотношением, содержитrequired_by; само соотношение содержитrequires.total_cents— позиции с ценой плюс панели с ценой плюс строки биомаркеров с ценой, а рядом —retail_total_cents.feesиtotal_with_fees_cents— сборы за одну запись и итоговая сумма с ними.
price_cents: null. Она ничего не добавляет к итогу. Отдельно добавить маркер без цены нельзя, поэтому эту строку добавила позиция или панель. Эта позиция или панель уже выставляет за неё счёт.
Aniva ещё не опубликовала все позиции. Неопубликованная позиция всё равно выставляется в счёт. Она
появляется в
positions[] со значениями null в id и name, а у строк её биомаркеров указано
via_position: null.