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

# Gerenciar disputas

> Acompanhe contestações formais levantadas contra exceções de reconciliação, envie evidências, siga mudanças de estado e registre resoluções.

Use a página **Disputas** na Matcher UI para visualizar e gerenciar todas as disputas das suas exceções de reconciliação. Disputas são contestações formais levantadas contra exceções, permitindo enviar evidências, acompanhar mudanças de estado e registrar resoluções.

## Acessando a página de Disputas

***

Navegue até **Matcher > Exception Handling > Disputes** na barra lateral esquerda.

A página exibe uma lista paginada de todas as disputas para o contexto selecionado.

<Note>
  Um painel retrátil "What is a Dispute?" está disponível no topo da página explicando que uma disputa é uma contestação formal levantada contra uma exceção.
</Note>

## Filtros

***

Use a barra de filtros no topo da lista para refinar os resultados:

| Filtro       | Opções                                                                             |
| ------------ | ---------------------------------------------------------------------------------- |
| **State**    | Open, Pending Evidence, Won, Lost                                                  |
| **Category** | Bank Fee Error, Unrecognized Charge, Duplicate Transaction, Amount Mismatch, Other |

Um botão **Clear Filters** aparece quando algum filtro está ativo.

## Tabela de disputas

***

<Frame caption="Figura 1. A página de lista de Disputas.">
  <img src="https://mintcdn.com/lerian-49cb71fc/dIivJl2jpQJ0JZcX/pt/matcher/ui/images/16-disputes.jpg?fit=max&auto=format&n=dIivJl2jpQJ0JZcX&q=85&s=ca045ae690b5db0b6f911e088c7d3f5d" alt="Página de lista de Disputas do Matcher mostrando as disputas filtradas por status e categoria" width="2000" height="1254" data-path="pt/matcher/ui/images/16-disputes.jpg" />
</Frame>

Cada linha da tabela exibe as seguintes colunas:

| Coluna          | Descrição                                                   |
| --------------- | ----------------------------------------------------------- |
| **ID**          | Identificador único da disputa (copiável)                   |
| **Category**    | Badge da categoria da disputa                               |
| **State**       | Badge do estado atual                                       |
| **Description** | Descrição breve da disputa (truncada na lista)              |
| **Opened by**   | Quem abriu a disputa                                        |
| **Evidence**    | Número de itens de evidência enviados                       |
| **Updated**     | Data e hora da última atualização                           |
| **Actions**     | Menu suspenso com link para a página de detalhes da disputa |

Clique em qualquer linha para abrir a página de detalhes da disputa.

## Estados de disputa

***

| Estado               | Descrição                                                 |
| -------------------- | --------------------------------------------------------- |
| **Open**             | A disputa foi aberta e está aguardando revisão            |
| **Pending Evidence** | Evidência adicional foi solicitada ou está sendo coletada |
| **Won**              | A disputa foi resolvida a favor do contestante            |
| **Lost**             | A disputa foi resolvida contra o contestante              |

## Categorias de disputa

***

| Categoria                 | Descrição                                                    |
| ------------------------- | ------------------------------------------------------------ |
| **Bank Fee Error**        | Discrepância causada por uma taxa bancária incorreta         |
| **Unrecognized Charge**   | Um débito que não pode ser identificado ou atribuído         |
| **Duplicate Transaction** | Uma transação que parece ter sido processada mais de uma vez |
| **Amount Mismatch**       | Os valores entre origem e destino não coincidem              |
| **Other**                 | Qualquer outra categoria de disputa não coberta acima        |

## Página de detalhes da disputa

***

Clique em uma linha de disputa para abrir sua página de detalhes. O layout utiliza três colunas: um navegador de seções à esquerda, a área de conteúdo principal no centro e um painel de resumo à direita.

### Informações da Disputa

A primeira seção exibe detalhes somente leitura sobre a disputa:

| Campo           | Descrição                                                                         |
| --------------- | --------------------------------------------------------------------------------- |
| **Category**    | A categoria da disputa                                                            |
| **Opened by**   | Quem criou a disputa                                                              |
| **Created**     | Quando a disputa foi criada                                                       |
| **Exception**   | O ID da exceção relacionada (copiável, link para a página de detalhes da exceção) |
| **Description** | Descrição completa da disputa                                                     |

### Evidências

A seção **Evidências** mostra uma linha do tempo de todos os itens de evidência enviados. Cada item exibe:

* **Submitted by** — Quem enviou a evidência
* **Date** — Quando foi enviada
* **Comment** — A descrição da evidência
* **File URL** — Link para um arquivo anexado, se fornecido

Para adicionar nova evidência, clique no botão **Add Evidence** e preencha o modal:

| Campo        | Descrição                                        |
| ------------ | ------------------------------------------------ |
| **Comment**  | Descrição da evidência (obrigatório)             |
| **File URL** | Link HTTPS para um arquivo de suporte (opcional) |

<Note>
  Evidências só podem ser adicionadas quando a disputa está no estado Open ou Pending Evidence.
</Note>

### Resolução

A seção **Resolução** mostra o resultado da disputa:

* Se a disputa foi **Won**, um banner verde exibe o texto de resolução.
* Se a disputa foi **Lost**, um banner vermelho exibe o texto de resolução.
* Caso a disputa ainda esteja aberta, uma mensagem indica que ela pode ser fechada para registrar o resultado.

Para fechar uma disputa, clique no botão **Close Dispute** no painel de resumo e preencha o modal:

| Campo          | Descrição                                            |
| -------------- | ---------------------------------------------------- |
| **Outcome**    | Selecionar Won ou Lost                               |
| **Resolution** | Explicação em texto livre da resolução (obrigatório) |

## Painel de resumo

***

O painel de resumo do lado direito exibe de forma resumida:

* Badges de estado e categoria
* Quem abriu
* Contagem de evidências
* Datas de criação e última atualização
* Link **View Exception** para navegar até a exceção relacionada

Quando a disputa está no estado Open ou Pending Evidence, o painel também exibe botões de ação para **Add Evidence** e **Close Dispute**.
