> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anivahealth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Preços

> Como a API de análises laboratoriais da Aniva calcula o preço de biomarcadores, posições e painéis na tua tabela de preços, com cotações antes de marcares.

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%.

> [!NOTE]
>
> `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](https://docs.anivahealth.com/pt/api/pricing/get-rate-card.md).

* 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.

| `price_cents` | Também presente | O que significa |
| - | - | - |
| positivo | `positions?` | Pode ser pedido isoladamente a esse preço. Um rácio também inclui `requires` e fatura igualmente os seus componentes. |
| `0` | `requires` | Um **rácio**. Não custa nada por si só; pagas pelos seus componentes. |
| `0` | `positions` | **Limitado a posições**. Vendido apenas dentro de uma das posições listadas. |
| `null` | — | **Sem curadoria**. A Aniva não lhe definiu preço e não pode ser pedido. |

### 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.

```json theme={null}
{
  "id": 71,
  "name": "Hemoglobin",
  "pricing": {
    "price_cents": 350,
    "retail_cents": 403,
    "tier": "routine",
    "positions": [
      {
        "id": "b7d4c2e1-9a3f-4c8b-91d2-5e6f7a8b9c0d",
        "name": "Aniva Blood Count",
        "price_cents": 452,
        "retail_cents": 520,
        "biomarker_ids": [71, 72, 73],
        "includes": [72, 73]
      }
    ]
  }
}
```

`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.

```json theme={null}
{
  "id": 279,
  "name": "hs-CRP / HDL Ratio",
  "pricing": {
    "price_cents": 0,
    "retail_cents": 0,
    "requires": [
      { "id": 42, "name": "HDL Cholesterol", "price_cents": 233, "retail_cents": 268 },
      { "id": 84, "name": "High-Sensitivity C-Reactive Protein (hs-CRP)", "price_cents": 1166, "retail_cents": 1341 }
    ]
  }
}
```

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.

> [!WARNING]
>
> 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.

```json theme={null}
{
  "id": 77,
  "name": "Mean Platelet Volume (MPV)",
  "pricing": {
    "price_cents": 0,
    "retail_cents": 0,
    "positions": [
      {
        "id": "3f1a8c22-64bd-4e57-8a90-1c2d3e4f5a6b",
        "name": "Blood Count (extended)",
        "price_cents": 460,
        "retail_cents": 529,
        "biomarker_ids": [71, 72, 73, 77],
        "includes": [71, 72, 73]
      }
    ]
  }
}
```

Adicionar um destes isoladamente a uma marcação é recusado — consulta [Adicionar biomarcadores individuais](https://docs.anivahealth.com/pt/api/appointments/add-individual-biomarkers.md). 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.

```json theme={null}
{ "id": 555, "name": "Poppy Seeds (Pap s)", "pricing": { "price_cents": null, "retail_cents": null } }
```

> [!WARNING]
>
> 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](https://docs.anivahealth.com/pt/api/appointments/add-individual-biomarkers.md). 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](https://docs.anivahealth.com/pt/api/biomarkers/list-biomarkers.md).
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](https://docs.anivahealth.com/pt/api/appointments/preview-containers.md) devolve a fatura de uma marcação. [Orçamentar carrinho](https://docs.anivahealth.com/pt/api/pricing/quote-cart.md) 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.

> [!NOTE]
>
> 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`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.