Saltar para o conteúdo principal
A Aniva define preços para uma só coisa: a posição. Uma posição é uma oferta comercial — um conjunto selecionado de biomarcadores faturado uma única vez, a um preço fixo, e sempre entregue por inteiro. Um biomarcador que podes comprar isoladamente é simplesmente uma posição de um. Tudo o que vês em pricing decorre disso. Lê esta página uma vez e os quatro estados abaixo deixam de parecer casos especiais.

O que significam os números

Cada price_cents é o que tu pagas, segundo a tabela de preços da tua chave de API. Ao lado, retail_cents é o mesmo item na tabela de retalho recomendada, para poderes mostrar uma poupança sem um segundo pedido. Ambos são valores inteiros em cêntimos e ambos são líquidos: o IVA é adicionado na tua fatura mensal à taxa aplicável ao teu regime de IVA, e um regime de isenção não adiciona nada. Um painel vendido ao preço de catálogo ao consumidor da Aniva é apresentado a esse preço sem o IVA alemão de 19%.
retail_cents está sempre presente. Quando a tua chave já está na tabela de retalho, é simplesmente igual a price_cents.
Os preços precisam do scope prices_view. Sem ele, pricing é null nas listagens e na pré-visualização, e os endpoints de Preços devolvem 403.

A tua tabela de preços

A tua tabela de preços define os teus preços. Lê-a em Obter tabela de preços.
  • Cada análise tem um tier: routine ou specialty. O seu preço é o preço de catálogo da Aniva multiplicado pelo multiplicador desse nível.
  • As taxas são por marcação e a taxa de logística é por recolha por estafeta. As tuas marcações no mesmo local no mesmo dia partilham uma recolha. A Aniva fatura as taxas na tua fatura mensal.

Os quatro estados

price_cents, mais o bloco opcional que aparece ao lado, define o estado. Não existe um campo de tipo separado.

Positivo — pode ser pedido isoladamente

O marcador tem um preço próprio. Ainda assim, pode aparecer em posições, e positions lista-as da mais barata para a mais cara — comprar a posição é muitas vezes mais barato do que comprar os seus elementos um a um.
biomarker_ids é o conjunto completo de elementos da posição; includes é esse conjunto menos o marcador que consultaste — o que vem incluído.

Zero com requires — um rácio

Um rácio é calculado a partir de marcadores medidos. A maioria dos rácios custa 0. Um rácio com price_cents positivo fatura esse preço para além dos seus componentes. Pede-o e a Aniva coloca os seus componentes no carrinho aos respetivos preços. Um componente é pago uma vez por carrinho, independentemente de quantos rácios dependam dele.
Um rácio combina-se com posições em vez de competir com elas. Se os seus componentes forem elementos de uma posição que já estás a comprar, a posição paga por eles e o rácio vem incluído sem custo adicional.
Um rácio cujos componentes não tenham todos preço está ausente do catálogo — não aparece com price_cents: null. Volta a aparecer assim que a Aniva definir preço para o componente em falta.

Zero com positions — vendido apenas dentro de uma posição

O marcador não tem preço próprio, mas faz parte de uma ou mais posições. Compra uma dessas posições e recebes o marcador.
Adicionar um destes isoladamente a uma marcação é recusado — consulta Adicionar biomarcadores individuais. Em vez disso, adiciona todos os biomarcadores de uma das posições listadas.

Null — sem curadoria

A Aniva não definiu o preço deste marcador, por isso não está à venda. null não é zero nem “pergunta-nos”: trata-o como indisponível.
A Aniva recusa um marcador null no momento do pedido. Duas condições permitem pedir um biomarcador. Um laboratório para o qual a Aniva possa encaminhar tem de fornecer o biomarcador. O catálogo da Aniva tem de lhe definir um preço. Se associares um marcador null a uma marcação, a API devolve 400 com error: "biomarker_not_priced". Consulta Adicionar biomarcadores individuais. Um laboratório pode fornecer um marcador null, mas o fornecimento por si só não torna o marcador disponível. Trata null como indisponível.
Alguns marcadores são null por conceção. A Aniva vende testes de microbioma e genética em kits. Um kit tem um preço único, por isso os marcadores que o integram não têm preço próprio. Para comprares estes marcadores, pede o painel que corresponde ao kit. Os marcadores vêm com o painel. A API também aceita qualquer um destes marcadores que adiciones a uma marcação que já inclua o respetivo painel. Um marcador também aparece como null quando a Aniva só o vende dentro de uma posição que não consegues ver. O resultado é o mesmo: não tens preço para comprar o marcador. O marcador passa a ter preço quando a Aniva torna essa posição visível para parceiros.

Encontrar a forma mais barata de comprar um conjunto

Como todas as posições a que um marcador pertence acompanham o marcador, podes resolver isto localmente, sem pedidos adicionais:
  1. Recolhe os marcadores que queres em Listar biomarcadores.
  2. Para cada um, compara o seu price_cents com o price_cents das posições no seu bloco positions.
  3. Uma posição é faturada uma vez e fornece todo o seu conjunto biomarker_ids, por isso uma posição que cubra vários dos teus marcadores é cobrada uma única vez. Os marcadores extra que não pediste vêm sem custo adicional.
Nada se sobrepõe duas vezes: duas posições que partilham um membro fornecem cada uma o seu conjunto, o membro aparece listado uma vez e nunca se descontam mutuamente.

A fatura

Pré-visualizar marcação devolve a fatura de uma marcação. Orçamentar carrinho devolve a mesma fatura sem uma marcação. A fatura contém:
  • positions[] — todas as posições aplicadas, faturadas uma vez pelo seu preço fixo.
  • panels[] — todos os painéis associados.
  • biomarkers[] — uma linha por marcador fornecido. Uma linha paga por uma posição custa 0 e indica-a em via_position. Um componente adicionado por um rácio tem required_by; o próprio rácio tem requires.
  • total_cents — as posições com preço, mais os painéis com preço, mais as linhas de biomarcadores com preço, com retail_total_cents ao lado.
  • fees e total_with_fees_cents — as taxas de uma marcação e o total com elas.
Uma linha à qual a Aniva não consegue atribuir preço tem price_cents: null. A linha não acrescenta nada ao total. Não podes associar um marcador sem preço isoladamente, por isso foi uma posição ou um painel que forneceu esta linha. Essa posição ou esse painel já fatura por ela.
A Aniva ainda não publicou todas as posições. Uma posição não publicada continua a ser faturada. Aparece em positions[] com id e name definidos como null, e as respetivas linhas de biomarcadores têm via_position: null.