# Plano de Taxas (Beta)

{% hint style="danger" %}
**Importante**: para utilizar essa funcionalidade, é necessário que o intermediador solicite ao time da Barte a ativação prévia do recurso. Sem isso, chamadas à API poderão retornar erros.
{% endhint %}

Os *Planos de Taxas* são uma funcionalidade da Barte para otimizar a experiência de aplicação de taxas por intermediadores. O fluxo se inicia com a criação de um plano, que é sempre vinculado à *company* (intermediador) que o originou. A gestão completa — criação, atualização e recuperação — pode ser feita tanto via API quanto pelo Webapp.

### Estrutura e regras do plano

* Os planos podem definir taxas para os métodos de pagamento: **pix**, **boleto**, **débito** e **cartão de crédito**.
* Para **cartão de crédito**, é obrigatório incluir os três tipos de pagamento: `online`, `pos` e `tap`. Eles podem ser enviados com valor zero, mas devem estar presentes.
* Cada tipo de pagamento para cartão pode ainda mapear taxas por bandeiras: `default`, `mastercard`, `visa`, `hipercard`, `elo`, `discover` e `american_express`. A bandeira `default` é obrigatória.

### Lógica de cálculo

* As taxas definidas no plano correspondem à taxa final aplicada aos seus vendedores.
* Para detalhes sobre o cálculo, consulte a interface do Webapp (tela de visualização/edição do plano).

### Associação com vendedores

* Um plano pode ser associado a **múltiplos vendedores**.

### Usabilidade no Webapp:

#### Criando um plano de taxas:

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhY03QzfTvLWOjOsYfPiz%2Fuploads%2FZPWg7blUBycVoCtYmTXq%2FTaxas%20V2%20-%20criar%20plano.mp4?alt=media&token=aecbf7c2-1eb1-4e82-86c3-00acce4760ae>" %}

#### Atualizar taxas de um plano:

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhY03QzfTvLWOjOsYfPiz%2Fuploads%2Fd4fLbdpfbOevSIRQFuQG%2FTaxas%20V2%20-%20editar%20taxas.mp4?alt=media&token=20fc0d49-7edf-4c82-9592-04ac2533f4a1>" %}

#### Atualizar o plano de um vendedor

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhY03QzfTvLWOjOsYfPiz%2Fuploads%2FTMRNHAeMJjUAPZla4vin%2FTaxas%20V2%20-%20Alterar%20plano.mp4?alt=media&token=b52c962d-e435-49f9-85a3-c44311d893fd>" %}
