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

# Tipos de recursos

> Recursos podem ser unitários (quantidades discretas) ou monetários (valores financeiros). O tipo afeta como são exibidos e quais modelos de precificação podem ser aplicados.

> O tipo de um recurso define a natureza do que ele mede — quantidades discretas ou valores financeiros — e determina quais modelos de precificação podem ser usados no plano.

<h2 id="unitario-vs-monetario">
  Unitário vs Monetário
</h2>

<Tabs>
  <Tab title="Recurso Unitário">
    Mede **quantidades discretas** — coisas que você conta.

    **Exemplos:**

    * Requisições de API (`value: 1` por chamada)
    * Tickets resolvidos (`value: 1` por ticket)
    * Usuários ativos (`value: 150` ao final do dia)
    * GB armazenados (`value: 50`)

    **Modelos de precificação disponíveis:**

    * Unitário — preço × quantidade (ex: `R$ 0,01` por requisição)
    * Pacote — preço por bloco de unidades (ex: `R$ 100` por cada 1.000 requisições)
    * Fixo — valor fixo por faixa, independente da quantidade

    **Exibição:** valores são mostrados como quantidades simples (ex: "25.000 requisições")
  </Tab>

  <Tab title="Recurso Monetário">
    Mede **valores financeiros** — montantes em dinheiro.

    **Exemplos:**

    * Volume transacionado (`value: 150000` → `R$ 1.500,00`)
    * Receita gerada (`value: 5000000` → `R$ 50.000,00`)
    * Créditos consumidos (`value: 89900` → `R$ 899,00`)

    **Modelos de precificação disponíveis:**

    * Fixo — valor fixo por faixa (ex: `R$ 1.000` para transações até `R$ 100.000`)
    * Percentual (basis points) — porcentagem sobre o valor (ex: 2,5% do volume)

    **Exibição:** valores são formatados como moeda (ex: "`R$ 150.000,00`")

    <Note>
      Para recursos monetários, envie os valores em **centavos**. `R$ 1.200,50` deve ser enviado como `120050`. Isso garante precisão e evita arredondamentos.
    </Note>
  </Tab>
</Tabs>

<br />

<h2 id="modelo-de-cobranca">
  Modelo de cobrança
</h2>

Além do tipo (unitário ou monetário), cada recurso possui um **modelo de cobrança** que define como o uso é calculado dentro do ciclo:

<Tabs>
  <Tab title="Integral">
    O valor de uso total do recurso no ciclo é diretamente mapeado nas faixas de preço. É o modelo mais comum.

    **Quando usar:** a maioria dos cenários — requisições de API, transações, mensagens, armazenamento acumulado no mês.
  </Tab>

  <Tab title="Prorrata (diário)">
    Compatível apenas com recursos que usam agregação "Último do Período". Para cada dia do ciclo, o sistema:

    <Steps>
      <Step title="Captura o valor">
        Pega o último valor registrado naquele dia.
      </Step>

      <Step title="Aplica as faixas">
        Mapeia o valor nas faixas de preço configuradas.
      </Step>

      <Step title="Proporcionaliza">
        Divide o valor resultante por 30 ou 31 (dias do mês).
      </Step>
    </Steps>

    **Quando usar:** licenciamento por usuário ativo por dia, onde o número de usuários pode mudar ao longo do mês.

    <Info>
      **Exemplo:** um cliente teve 12 dias com 100 usuários e 18 dias com 150 usuários. O prorrata calcula a cobrança proporcional de cada dia, somando o total ao final do ciclo.
    </Info>
  </Tab>
</Tabs>

<br />

## Qual tipo escolher?

| Se você quer cobrar por...            | Tipo      | Modelo de preço típico |
| ------------------------------------- | --------- | ---------------------- |
| Número de chamadas de API             | Unitário  | `R$ 0,01` por unidade  |
| GB de armazenamento                   | Unitário  | `R$ 0,50` por GB       |
| Pacotes de mensagens (ex: a cada 100) | Unitário  | `R$ 10` por pacote     |
| Comissão sobre volume financeiro      | Monetário | 2,5% do valor          |
| Taxa fixa por faixa de faturamento    | Monetário | `R$ 500` até `R$ 100k` |

<br />

<h2 id="reutilizacao-de-recursos">
  Reutilização de recursos
</h2>

Recursos são independentes de planos. Um mesmo recurso pode ser usado em múltiplos planos com precificações diferentes:

* **Plano Starter:** Recurso "Requisições de API" → `R$ 0,02`/unidade
* **Plano Pro:** Recurso "Requisições de API" → `R$ 0,01`/unidade
* **Plano Enterprise:** Recurso "Requisições de API" → `R$ 0,005`/unidade com franquia de 100k inclusa

<Tip>
  Reutilizar recursos entre planos garante consistência na medição. A métrica é a mesma — o que muda é apenas o preço aplicado.
</Tip>

<br />

<h2 id="proximos-passos">
  Próximos passos
</h2>

* [Filtragem e agregação](/recursos/filtragem-e-agregacao) — configure filtros e tipos de agregação
* [Planos](/planos/criar-planos) — associe recursos a modelos de precificação
* [Eventos](/eventos/visao-geral) — entenda como eventos alimentam os recursos