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

# Gerenciando Pacotes de Cobrança

> Crie, edite, ative e exclua Pacotes de Cobrança de volume e de manutenção no Console Midaz para definir as cobranças periódicas que as Execuções de Faturamento calculam.

Um **Pacote de Cobrança** define uma cobrança periódica no [Fees Engine](/pt/products/midaz/fees/console/fees-engine-overview). Um pacote tem um de dois tipos:

* **Volume**: cobra pelo número de eventos no período. Ele aceita faixas de preço, uma cota gratuita e descontos.
* **Manutenção**: cobra um valor fixo de cada conta alvo a cada período.

<Note>
  Habilite o Fees Engine nas [configurações do Módulo Midaz](/pt/platform/console/plugin-settings) antes de usar esta página.
</Note>

## Acessando a página Pacotes de Cobrança

***

Na barra lateral do Módulo Midaz, expanda **Fees Engine**. Selecione **Pacotes de Cobrança**. A página lista os pacotes do Ledger que você seleciona no seletor de organização.

A lista mostra o **Nome**, o **Tipo**, o **Ativo** e o **Status** de cada pacote. Use o filtro **Tipo** para mostrar pacotes de Volume ou de Manutenção.

Na lista, você pode:

* Ligar ou desligar o switch **Status** para ativar ou desativar um pacote.
* Selecionar **Detalhes** no menu da linha para ver a configuração do pacote.
* Selecionar **Editar** no menu da linha para alterar o pacote.
* Selecionar **Excluir** no menu da linha para excluir o pacote. O Console pede que você confirme.

## Criando um Pacote de Cobrança

***

<Steps>
  <Step title="Escolher o tipo">
    Clique em **Novo Pacote**. Em **Escolha o tipo de cobrança**, selecione **Pacote de Volume (Faixas)** ou **Pacote de Manutenção (Taxa Fixa)**.
  </Step>

  <Step title="Preencher as informações básicas">
    Em **Tipo e Informações**, informe o **Nome do Pacote** e uma **Descrição** opcional. Selecione o **Código do Ativo**. O pacote usa o Ledger que você seleciona no seletor de organização.
  </Step>

  <Step title="Configurar o pacote">
    Em **Configuração**, defina os campos do tipo de pacote. As duas próximas seções descrevem esses campos.
  </Step>

  <Step title="Revisar e salvar">
    Em **Revisão**, confira o resumo. Para alterar uma seção, use o botão de edição dela para voltar àquela etapa. Depois selecione **Salvar**.
  </Step>
</Steps>

Um pacote novo fica ativo quando você o cria. A próxima execução de faturamento o inclui.

Você pode trocar o tipo até salvar o pacote. Se você trocar depois de preencher **Configuração**, o Console descarta os dados de **Configuração**.

## Campos do pacote de volume

***

| Seção | O que você define |
| - | - |
| **Filtro de Eventos** | A **Rota de Transação** que define quais transações o pacote conta, e o **Status da Transação** a contar: **Aprovada** ou **Pendente**. |
| **Modelo de Precificação** | **Por Faixa**: os eventos preenchem as faixas em ordem, e cada faixa tem o próprio preço unitário. **Faixa Única**: um preço unitário se aplica a cada evento. |
| **Faixas de Preço** | Em **Por Faixa**, cada linha tem **De (mín.)**, **Até (máx.)** e **Preço Unitário**. Cada faixa começa na quantidade seguinte ao máximo da faixa anterior. A última faixa não tem máximo. Em **Faixa Única**, você define um preço unitário. |
| **Cota Gratuita** | Em **Por Faixa**. O pacote não cobra os primeiros N eventos do período, onde N é a cota. |
| **Descontos Progressivos (opcional)** | Em **Por Faixa**. Cada desconto define um percentual que se aplica a partir de uma quantidade inicial. Informe os descontos em ordem crescente. |
| **Contas de Débito e Crédito** | A **Conta de Débito (alias)** e a **Conta de Crédito (alias)**. As duas são obrigatórias. |
| **Pré-visualização do Cálculo** | A cobrança para quantidades de eventos de exemplo, a partir das faixas, da cota gratuita e dos descontos. |

## Campos do pacote de manutenção

***

* **Valor da Taxa**: o valor que o pacote cobra de cada conta alvo a cada período.
* **Contas Alvo**: as contas a cobrar.
  * **Por Segmento**: as contas do segmento selecionado.
  * **Por Portfólio**: as contas do portfólio selecionado.
  * **Lista de Contas**: aliases de conta que você digita, ou que você envia em um arquivo CSV UTF-8 com uma coluna `accountAlias`.
* **Conta de Crédito (alias)**: a conta que recebe os valores cobrados.

Uma lista de contas pode ter no máximo 100 aliases. Quando você cria o pacote, o Midaz confere se cada alias existe no Ledger. Se um alias não existir, o Midaz recusa o pacote.

## Editando um Pacote de Cobrança

***

Selecione **Editar** no menu da linha. Você pode alterar o **Nome do Pacote** e a **Descrição**. O tipo, o ativo e os campos de **Configuração** não mudam depois da criação.

Para um pacote parar de cobrar, desligue o switch **Status** dele. As execuções de faturamento usam apenas pacotes ativos.

## Para onde ir depois

***

<Columns cols={2}>
  <Card title="Execuções de Faturamento" icon="receipt" horizontal href="/pt/products/midaz/fees/console/billing-runs">
    Veja uma prévia das tarifas de um período antes de aplicá-las.
  </Card>

  <Card title="Visão geral do Fees Engine" icon="gauge" horizontal href="/pt/products/midaz/fees/console/fees-engine-overview">
    Entenda como o Fees Engine, os pacotes e as regras se encaixam.
  </Card>
</Columns>


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