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
Cadaprice_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.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:routineouspecialty. 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, epositions 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.
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.
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.
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:- Recolhe os marcadores que queres em Listar biomarcadores.
- Para cada um, compara o seu
price_centscom oprice_centsdas posições no seu blocopositions. - 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.
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 custa0e indica-a emvia_position. Um componente adicionado por um rácio temrequired_by; o próprio rácio temrequires.total_cents— as posições com preço, mais os painéis com preço, mais as linhas de biomarcadores com preço, comretail_total_centsao lado.feesetotal_with_fees_cents— as taxas de uma marcação e o total com elas.
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.