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

> Acompanhe as disputas formais abertas contra exceções de conciliação na Matcher UI: filtre por estado e categoria, envie evidências e registre os desfechos.

Use a página **Disputas** da Matcher UI para ver e gerenciar todas as disputas das suas exceções de conciliação. Uma disputa é uma contestação formal de uma exceção. Você pode enviar evidências, acompanhar mudanças de estado e registrar resoluções.

## Acessando a página de Disputas

***

Vá em **Matcher > Tratamento de exceções > Disputas** na barra lateral esquerda.

A página mostra uma lista paginada de todas as disputas do contexto selecionado, com uma barra de status que resume as contagens de Abertas, Pendentes, Ganhas e Perdidas.

## Filtros

***

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

| Filtro                            | Opções                                                                        |
| --------------------------------- | ----------------------------------------------------------------------------- |
| **Estado**                        | Rascunho, Aberta, Evidência pendente, Ganha, Perdida                          |
| **Categoria**                     | Erro de tarifa bancária, Cobrança não reconhecida, Transação duplicada, Outro |
| **Data inicial** / **Data final** | Restringe os resultados a um intervalo de datas                               |
| **Ordenar por** / **Ordem**       | Ordena os resultados, da mais nova para a mais antiga ou o contrário          |

Um botão **Limpar filtros** aparece quando algum filtro está ativo.

<Note>
  Divergência de valor é uma categoria apenas de criação. Você pode abrir uma disputa com ela. O filtro da lista não oferece essa categoria, porque a API de disputas não a aceita como valor de filtro.
</Note>

## Tabela de disputas

***

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

Cada linha da tabela de dados mostra as seguintes colunas:

| Coluna         | Descrição                                                                          |
| -------------- | ---------------------------------------------------------------------------------- |
| **Disputa**    | O identificador da disputa, mostrado como link para a página de detalhe da disputa |
| **Exceção**    | O identificador da exceção relacionada                                             |
| **Categoria**  | A categoria da disputa                                                             |
| **Estado**     | Estado atual                                                                       |
| **Aberta por** | Quem abriu a disputa                                                               |
| **Criada**     | Quando a disputa foi criada                                                        |

Clique no ID de uma disputa para abrir a página de detalhe dela.

## Estados da disputa

***

| Estado                 | Descrição                                                        |
| ---------------------- | ---------------------------------------------------------------- |
| **Rascunho**           | A disputa foi criada, mas ainda não foi aberta formalmente       |
| **Aberta**             | A disputa foi aberta e aguarda revisão                           |
| **Evidência pendente** | Foram pedidas evidências adicionais ou elas estão sendo reunidas |
| **Ganha**              | A disputa foi resolvida a favor de quem contestou                |
| **Perdida**            | A disputa foi resolvida contra quem contestou                    |

## Categorias de disputa

***

| Categoria                    | Descrição                                                                                             |
| ---------------------------- | ----------------------------------------------------------------------------------------------------- |
| **Erro de tarifa bancária**  | Uma divergência causada por uma tarifa bancária incorreta                                             |
| **Cobrança não reconhecida** | Uma cobrança que não pode ser identificada nem atribuída                                              |
| **Transação duplicada**      | Uma transação que parece ter sido processada mais de uma vez                                          |
| **Divergência de valor**     | Os valores da origem e do destino não batem (apenas de criação; não é oferecida como filtro da lista) |
| **Outro**                    | Qualquer outra categoria de disputa não coberta acima                                                 |

## Página de detalhe da disputa

***

Clique no ID de uma disputa para abrir a página de detalhe dela. O cabeçalho da página mostra a disputa com as ações **Enviar evidência** e **Encerrar disputa**. Abaixo do cabeçalho, uma barra de status mostra Aberta por, Atualizada e Estado. A página então tem três painéis: **Informações**, **Resolução** e **Evidências**.

### Informações

O painel **Informações** mostra detalhes somente leitura sobre a disputa:

| Campo          | Descrição                                       |
| -------------- | ----------------------------------------------- |
| **Exceção**    | O ID da exceção relacionada (copiável)          |
| **Categoria**  | A categoria da disputa                          |
| **Aberta por** | Quem criou a disputa                            |
| **Estado**     | O estado atual                                  |
| **Descrição**  | Descrição completa da disputa                   |
| **Criada**     | Quando a disputa foi criada                     |
| **Atualizada** | Quando a disputa foi atualizada pela última vez |

### Evidências

O painel **Evidências** lista todos os itens de evidência enviados. Cada item mostra quem o enviou, quando e o comentário. Um link **Abrir anexo** aparece quando o item tem um arquivo. Se a disputa não tem evidências, o painel mostra "Nenhuma evidência enviada ainda."

Para adicionar evidências, clique em **Enviar evidência** no cabeçalho da página. A caixa de diálogo tem duas abas:

| Aba                | Campos                                                                                                |
| ------------------ | ----------------------------------------------------------------------------------------------------- |
| **Colar URL**      | **Comentário** (obrigatório) e **URL do arquivo (opcional)** — um link HTTPS para um arquivo de apoio |
| **Enviar arquivo** | **Comentário** (obrigatório) e um seletor de arquivo — PDF, PNG, JPEG ou CSV, de até 10 MB            |

<Note>
  Você pode enviar evidências enquanto a disputa está em qualquer estado não terminal: Rascunho, Aberta ou Evidência pendente. Assim que uma disputa está Ganha ou Perdida, ela não aceita novas evidências.
</Note>

### Resolução

O painel **Resolução** mostra o desfecho registrado como texto simples: a explicação da **Resolução** e, se a disputa foi reaberta, o **Motivo da reabertura**.

Para encerrar uma disputa, clique em **Encerrar disputa** no cabeçalho da página e preencha a caixa de diálogo:

| Campo         | Descrição                                            |
| ------------- | ---------------------------------------------------- |
| **Desfecho**  | Selecione **Ganha** ou **Perdida**                   |
| **Resolução** | Explicação em texto livre da resolução (obrigatório) |

<Note>
  Você pode encerrar uma disputa a partir de qualquer estado não terminal (Rascunho, Aberta ou Evidência pendente).
</Note>
