## Histórico de envio Connect

### 📍 Caminho de acesso

**Históricos → Envio Connect**

## 🎯 Objetivo

A tela **Envio Connect** é uma das principais ferramentas para acompanhamento das automações da NOTAX.

Ela apresenta o histórico das execuções realizadas pelo robô, permitindo identificar **qual pessoa foi processada, qual produto foi consultado, quando ocorreu a execução, qual foi o resultado e qual mensagem retornou do processamento**.

É nessa tela que o usuário consegue entender se a NOTAX conseguiu realizar corretamente a captura das informações no portal ou se alguma situação impediu a execução.

---

## 📋 Informações apresentadas

A listagem apresenta os seguintes dados:

**Data/Hora:** momento em que o processamento foi executado.

**Pessoa:** empresa ou pessoa consultada. O CPF/CNPJ também é apresentado para facilitar a identificação.

**Produto:** identifica qual rotina foi executada.

Entre os produtos apresentados no histórico podem estar:

**Caixa Postal, Situação Fiscal, Comunicados e Intimações, Intimações, Consulta PER/DCOMP e Importação PER/DCOMP.**

**Status:** demonstra o resultado da execução.

**Registros:** apresenta a quantidade de informações encontradas ou processadas naquela execução.

**Mensagem:** apresenta o retorno detalhado do robô, permitindo entender o resultado da consulta.

---

## ✅ Entendendo os resultados

Quando uma automação é executada corretamente, o sistema apresenta o status **Sucesso**.

Além do status, a coluna **Mensagem** ajuda a compreender o que efetivamente aconteceu.

Exemplos de retornos que podem aparecer:

> Caixa Postal capturada com sucesso. 11 mensagens encontradas.

ou

> Comunicados e intimações capturados com sucesso. 2 registros encontrados.

No caso da Situação Fiscal, o retorno também pode informar que não existem pendências encontradas nos órgãos consultados.

### ⚠️ Sucesso com zero registros

É importante observar que **zero registros não significa necessariamente que houve uma falha**.

Uma consulta pode ter sido executada corretamente e simplesmente não existir nenhuma nova informação disponível naquele momento.

Por isso, a análise deve considerar conjuntamente:

**Status + quantidade de registros + mensagem retornada.**

---

## ⚠️ Falha de negócio

Quando o sistema não consegue concluir determinada rotina, o histórico pode apresentar o status **Falha de Negócio**.

A coluna **Mensagem** deve ser consultada para entender o motivo.

Entre as situações que podem impedir o processamento estão:

* ausência de procuração necessária para realizar a consulta;

* empresa sem certificado digital válido/configurado;

* certificado com **verificação em duas etapas**;

* falha durante o login;

* ausência de comunicação ou informação para aquela consulta;

* dados ou configurações necessárias não disponíveis.

Por exemplo, o sistema pode apresentar uma mensagem semelhante a:

> Falha ao efetuar login. Certificado com verificação de duas etapas.

Nesse caso, não basta simplesmente verificar que houve uma falha. A **mensagem do histórico indica o que precisa ser analisado ou corrigido antes de uma nova tentativa**.

---

## 🔎 Filtros do Envio Connect

Para facilitar a análise de grandes volumes de processamento, a tela possui diversos filtros.

### 🔍 Pessoa

Permite pesquisar diretamente pelo cliente/empresa desejado.

### 🏷️ Status

Permite visualizar registros de acordo com o resultado da execução, facilitando, por exemplo, a identificação das automações que apresentaram **Falha de Negócio**.

### 📦 Produto

Permite analisar somente determinada rotina.

Entre as opções apresentadas estão:

**Intimações, Consulta PER/DCOMP, Caixa Postal, Importação PER/DCOMP, Situação Fiscal e Comunicados e Intimações.**

Esse filtro é muito útil quando o usuário deseja investigar especificamente uma automação.

---

## 🎛️ Mais filtros

No botão de filtros adicionais também podem ser utilizados:

**Data início:** define o início do período pesquisado.

**Data fim:** define o final do período pesquisado.

**Somente última mensagem:** permite escolher entre **Sim** e **Não**.

Esse recurso é especialmente útil para reduzir a quantidade de registros apresentados durante uma análise e facilitar a visualização do processamento mais recente.

> 💡 Os filtros podem ser combinados. Por exemplo: pesquisar uma empresa específica + status Falha de Negócio + produto Consulta PER/DCOMP.

---

## 🔄 Reprocessamento das automações

Uma das funções mais importantes do **Envio Connect** é a possibilidade de solicitar um novo processamento.

Quando uma falha é identificada e sua causa é corrigida — por exemplo, regularização do certificado, procuração ou autenticação — não é necessário aguardar obrigatoriamente a próxima rotina automática para testar novamente o processamento.

### Como reprocessar

1. Acesse **Históricos → Envio Connect**.

2. Utilize os filtros para localizar os registros desejados.

3. Analise a coluna **Mensagem** para identificar a causa do problema.

4. Corrija a situação necessária, quando aplicável.

5. Marque a caixa de seleção dos registros que deseja processar novamente.

6. Clique no menu de **três pontos** no canto superior direito.

7. Selecione **Reprocessar Selecionados**.

O sistema realizará uma nova tentativa para os itens escolhidos.

### 🔄 Reprocessar todos

O menu também disponibiliza a opção **Reprocessar Todos**, utilizada quando for necessário solicitar novamente o processamento de todos os registros aplicáveis ao contexto apresentado.

> ⚠️ **Atenção:** antes de solicitar um reprocessamento, é recomendável verificar a mensagem de retorno e corrigir a causa da falha. Reprocessar sem corrigir o problema pode gerar novamente o mesmo resultado.

---

## 🧭 Como utilizar o Histórico no dia a dia

O módulo pode ser utilizado como uma rotina de acompanhamento operacional da NOTAX:

**1.** O robô executa as automações durante a madrugada, normalmente entre **2h e 6h**.

**2.** O usuário pode acessar **Históricos → Envio Connect** para acompanhar os resultados.

**3.** Os registros com **Sucesso** confirmam as rotinas executadas corretamente.

**4.** Os registros com falha devem ser analisados principalmente pela coluna **Mensagem**.

**5.** Quando necessário, deve-se corrigir a causa identificada.

**6.** Após a correção, o processamento pode ser solicitado novamente pelo próprio histórico.

Para comunicações, o acompanhamento deve ser realizado em **Históricos → Envio de Notificações**, verificando principalmente **destinatário, canal, data/hora e status do envio**.

---

## 💡 Ponto importante

O módulo **Históricos** é uma ferramenta de rastreabilidade da NOTAX.

Quando uma informação esperada não aparecer em uma determinada rotina, uma das primeiras verificações recomendadas é consultar o **Envio Connect**. Muitas vezes, o próprio histórico indicará se a automação foi executada, se não havia informações disponíveis ou se alguma condição impediu a captura.

Da mesma forma, quando houver dúvida sobre o processamento de uma comunicação, o **Envio de Notificações** permite verificar o histórico correspondente e, quando disponível, realizar uma nova tentativa de envio.

Assim, o usuário consegue diferenciar **ausência de dados**, **problemas de configuração/acesso** e **falhas de processamento**, tornando o diagnóstico das automações muito mais rápido.