# Relatando Problemas

## Visão Geral

Este guia explica como entender problemas que os usuários podem ter e como relatá-los à equipe de suporte da Pluggy.

## Entendendo Erros

Quando um item encontra um erro esperado, ele retornará com o status `OUTDATED`, com `ERROR` como o status de execução. Erros podem ocorrer após a fornecimento de credenciais, quando o item começa a se conectar à instituição financeira e começa a fornecer respostas/webhooks.

### Erros Inesperados

Erros inesperados geralmente são retornados quando a instituição financeira (FI) está instável ou quando há um caso que não foi mapeado pela Pluggy. Se erros inesperados forem consistentes, você deve relatá-los à equipe.

Quando a instituição está enfrentando uma instabilidade, o `executionStatus` será `SITE_NOT_AVAILABLE`. No entanto, quando é um erro inesperado do lado da Pluggy, o `executionStatus` será `ERROR` ou `CONNECTION_ERROR`.

### Erros de Conexão

Erros de conexão ocorrem após a fornecimento de credenciais, quando o item começa a se conectar à instituição financeira. Esses erros estão tipicamente relacionados a:

- Instabilidade ou inatividade da instituição
- Cenários não mapeados do lado da Pluggy
- Mudanças de autenticação na instituição

## Como Relatar Problemas

Quando você está enfrentando problemas, a chave é fornecer contexto suficiente para que a equipe de suporte possa investigar.

### Usando o Widget

Ao usar o widget, o usuário acabará em uma tela com um erro inesperado e um ErrorCode. Se você estiver usando o Connect widget da Pluggy, esse erro será exibido no widget. Relate uma captura de tela do widget para dar à equipe de suporte contexto suficiente.

### Usando a API Diretamente

Se você estiver criando sua própria UX, verá o erro na resposta HTTP POST `/items`. Relate a resposta HTTP para dar à equipe de suporte contexto suficiente.

> **Evidência: o itemId é obrigatório**
>
> Ao usar o widget, uma captura de tela da **tela de erro ou do código de erro** é suficiente.
>
> É altamente recomendável que os clientes rastreiem as tentativas de conexão de seus usuários, armazenando-as como conexões malsucedidas. Você pode capturar o `itemId` através da implementação do seu Connect widget da Pluggy, capturando o evento `onError`, ou através do evento [webhook item/error](/docs/developer-tools/webhooks-ref).
>
> Ao se conectar diretamente através da API, envie o **itemId** trocado no fluxo da API.
>
> **Não podemos analisar erros sem um itemId, então é obrigatório que você o capture e forneça.**

### Relatório de Execução

Mais informações sobre o que falhou estarão disponíveis no campo `executionReport` do Item. Se algo der errado fatalmente com a conexão, como um erro inesperado, e nenhum dado puder ser recuperado, o status do Item será `OUTDATED` e o `executionStatus` relacionado será `ERROR`.

O widget e a resposta HTTP fornecem informações suficientes para você entender o que está dando errado, e eles dão à equipe de suporte o contexto necessário para investigar o problema.

## Erros ao Fornecer Credenciais (HTTP 400)

Geralmente, esse problema ocorre quando o usuário envia suas credenciais, mas a criação do Item não é bem-sucedida. Isso significa que a criação do Item retorna um erro HTTP 400 para validações.

Geralmente, isso significa:

- As credenciais não estão no formato correto.
- Há credenciais ausentes.
- Há uma conexão ativa ou uma conexão duplicada foi detectada.

Se você estiver usando o Connect widget da Pluggy, esse erro será exibido no **widget**; se você estiver criando sua própria UX, verá esse erro na **resposta** HTTP POST `/items`. Para mais detalhes sobre quais erros são retornados, você pode conferir a [referência da API](/reference/items-create).

> **Evidência**
>
> Quando você está tendo esse tipo de problema, relate uma **captura de tela do widget** ou a **resposta HTTP** para dar à equipe de suporte contexto suficiente. Esperamos que o widget e a resposta HTTP forneçam informações suficientes para você entender o que está dando errado.

## Página de Status

A Pluggy tem uma página de status pública onde eles postam quaisquer incidentes e interrupções para que você possa se manter ciente de quaisquer problemas existentes. Você pode visitar a página de status em [status.pluggy.ai](https://status.pluggy.ai).

Você também pode se inscrever usando o botão no topo da página de status para ser notificado sobre incidentes assim que eles acontecerem. Você pode receber atualizações de incidentes e mensagens de status de manutenção no Slack ao se inscrever.

Para mais informações sobre como se inscrever na página de status, veja [Inscreva-se em nossa Página de Status](/docs/subscribe-to-our-status-page).

## Páginas Relacionadas

- [Erros & Validações](/docs/errors-validations)
- [Ciclo de vida do Item](/docs/item-lifecycle)
- [Cobertura de Conectores](/docs/connectors-coverage)