# Logs de Rotinas de Cobrança Gateway

## Introdução
O formulário **Logs rotinas de Cobrança** é uma ferramenta essencial no Sistema, permitindo a visualização e gerenciamento dos registros das atividades de cobrança realizadas. Esta funcionalidade possibilita o acompanhamento detalhado do status das cobranças e a impressão de boletos quando necessário.

O formulário de Logs de Rotinas de cobrança tem como objetivo incluir informações sobre e-mails e SMS enviados pelo CRM de cobrança, dos quais falharam devido à falha de comunicação de boletos do tipo Gateway.

> [!NOTA] Acesso ao Formulário
> O formulário pode ser acessado através do caminho: Configurações > Logs > Logs de rotinas de cobrança.

### Objetivos do formulário
- Fornecer uma visão abrangente das operações de cobrança que incluem cobranças de boletos do tipo Gateway;
- Facilitar o monitoramento e controle das atividades financeiras;
- Permitir a impressão de boletos diretamente do log.

## Benefícios de uso
- Permite identificar falhas ou gargalos no processo de envio de boletos do tipo Gateway;
- Auxilia fornecendo uma visão clara e objetiva das cobranças automáticas sobre os boletos do tipo Gateway, possibilitando a distinção de conclusão da cobrança devido ao status, se falha ou sucesso.

## Estrutura do formulário 
O formulário Logs de Rotina de Cobrança Gateway é composto por uma única aba dedicada à visualização dos logs de rotinas de cobrança. Esta aba oferece informações detalhadas sobre as operações realizadas, permitindo um acompanhamento preciso das atividades financeiras da empresa.

A aba de Logs de Rotina de Cobrança Gateway é organizada em várias colunas, cada uma contendo informações específicas sobre cada registro de rotina de cobrança. As colunas são descritas abaixo:

| Coluna                  | Descrição                                                                    |
| ----------------------- | ---------------------------------------------------------------------------- |
| **ID**                  | Identificação única do log de cobrança.                                      |
| **Status**              | Indica se a cobrança foi bem-sucedida ou falhou (Sucesso ou Falhou).         |
| **Data e hora**         | Data e hora em que a tentativa de cobrança foi realizada.                    |
| **ID Contas a receber** | Identificação da conta a receber (boleto) associada ao log de cobrança.      |
| **Cliente**             | Nome do cliente relacionado à cobrança.                                      |
| **Descrição**           | Detalhes adicionais sobre a cobrança, incluindo possíveis razões para falha. |
A aba de Logs de Rotina de Cobrança Gateway é constituída por uma grid, da qual reúne as informações de registros de logs, permitindo também a visualização individual de cada registro, ao selecionar um dos logs e clicar no botão "Visualizar". 

Para acessar o formulário, siga os passos descritos a seguir:
1. Acesse menu **Configurações**;
2. Selecione a opção **Logs de rotinas de cobrança**;
3. A grid de logs será apresentada. Se necessário, aplique os filtros na barra de consulta para uma busca específica.
4. Para visualizar um log específico, selecione-o e clique no botão de **Visualizar** para um detalhamento individual do log.

Ao visualizar o log, o sistema apresentará suas informações individuais.

## Como funciona a utilização
A utilização do formulário de Logs de Rotina de Cobrança Gateway parte do uso da ferramenta de [[parametros de cobranca|Parâmetros de Cobrança]], onde uma carteira de cobrança de [[integracoes bancarias - api|Integrações Bancárias - API]], que gera boletos do tipo Gateway, esteja configurada. Considerando de que é necessária a comunicação destes boletos ao Gateway, quando ocorrer a falha da cobrança devido à alguma inconsistência na geração/comunicação deste boleto, será registrada no formulário em questão.

## Funcionalidades principais

- **Visualização de registros**: Exibe os logs em ordem cronológica, do mais recente ao mais antigo e permite uma visão rápida das últimas atividades executadas.
- **Filtros avançados:** Possibilita filtrar logs por data e hora, status da execução (sucesso, falha), cliente afetado, ID do boleto, descrição do logs.
- **Rastreamento de erros:**  Em caso de falhas, exibe: código de erro, mensagem detalhada do erro.
- Permite a reimpressão do boleto não comunicado.

### Conceitos Fundamentais

#### Definições
- **Log**: Registro detalhado de uma atividade ou operação realizada no sistema.
- **Rotina de Cobrança**: Conjunto de ações sistemáticas executadas para efetuar cobranças.
- **ID**: Identificador único atribuído a cada log no sistema.


## Fluxo de utilização 

```mermaid
graph TD
    A[Início] --> B[Parametrizar CRM com configurações de carteira de cobrança tipo gateway]
    B --> C{Rotina de Cobrança Executa}
    C -->|Sucesso| D[Lista logs de sucesso - Boleto comunicado corretamente]
    C -->|Falha| E[Lista logs de falha - Problema na comunicação do boleto]
    D --> F[Usuário acessa menu Configurações]
    E --> F
    F --> G[Acessa Logs]
    G --> H[Clica em Logs de Rotina de Cobrança]
    H --> I{Verifica Status}
    I -->|Sucesso| J[Validação Concluída]
    I -->|Falha| K[Visualiza o log]
    K --> L[Imprime o boleto manualmente]
    L --> M[Fim]
    J --> M
```

## Casos de uso

### Consulta de Logs de Cobrança
1. Acesse o formulário 'Logs de Rotinas de Cobrança Gateway';
2. Utilize os filtros disponíveis para refinar a busca;
3. Analise os logs exibidos na grid.

### Impressão de Boleto
1. Localize o log desejado na grid;
2. Verifique se o status do log é Sucesso ou Falha;
3. Clique no botão 'Imprimir boleto' se Falha; 
4. Confirme a impressão do boleto.
5. Reenvie o boleto manualmente se necessário.

### Exemplos Práticos

**Cenário:** Verificação de cobrança recente
Um analista financeiro precisa verificar se uma cobrança específica foi processada corretamente:

1. Acessa o formulário 'Logs rotinas de Cobrança Gateway';
2. Filtra os logs pela data da cobrança em questão;
3. Localiza o log correspondente pelo ID da conta a receber;
4. Verifica o status e a descrição do log para confirmar o processamento;
5. Se necessário, imprime o boleto diretamente do formulário.

## Considerações Finais

### Resumo
O formulário 'Logs rotinas de Cobrança Gateways' é uma ferramenta crucial para o monitoramento e gestão das atividades de cobrança no Sistema. Sua estrutura simples e funcionalidades integradas permitem um controle eficiente e preciso das operações financeiras.

---
## Etiquetas
#LogsCobranca #Cobranca #ParametrosDeCobranca

## Leia Também
- [[integracoes|Integrações]]
- [[e-mail smtp|E-mail SMTP]]
- [[parametros de cobranca|Parâmetros de Cobrança]]
- [[contas a receber|Contas a Receber]]
- [[emissao de boletos|Emissão de Boletos]]