# Tarefa - Consulta de Pagamento Banco do Brasil Api

## Introdução
A Agenda de Tarefas é uma ferramenta essencial para automatizar processos e garantir a execução regular de tarefas importantes no sistema. Este documento abordará especificamente a configuração da tarefa "Consulta de Pagamento Banco do Brasil Api", uma funcionalidade crucial para o gerenciamento financeiro eficiente quando a API configurada não utiliza o meio de comunicação via webhook.

> [!NOTA] **Acesso ao Formulário**
> **Caminho:** Menu Ferramentas > Ferramentas > Agenda de tarefas

## Conceito
A tarefa "Consulta de Pagamento Banco do Brasil Api" é uma funcionalidade automatizada que utiliza a API do Banco do Brasil para verificar e atualizar o status de pagamentos de boletos bancários no sistema. Esta rotina estabelece uma conexão segura com a API do banco, consulta o status dos boletos emitidos, processa as informações recebidas e atualiza os registros internos. Ela é crucial para manter a precisão dos registros financeiros, eliminar verificações manuais, melhorar a gestão do fluxo de caixa e fornecer uma visão atualizada dos recebimentos. A tarefa gera logs detalhados para auditoria e rastreamento, garantindo uma integração rápida e segura com o Banco do Brasil, conforme os padrões estabelecidos.

## Passo a Passo - Configuração da Tarefa "Consulta de Pagamento Banco do Brasil Api"
Costumamos cadastrar até 4 tarefas de consulta divididas entre as 24h do dia para as carteiras de APIs bancárias, devendo a última rodar o mais próximo da meia-noite.
- Exemplo: 06h50, 12h50, 18h50, 23h50.

1. Acesse o menu **Ferramentas** no sistema.
2. Selecione a opção **Ferramentas**.
3. Clique em **Agenda de tarefas**.
4. Na tela de Agenda de tarefas, clique no botão **Novo** para adicionar uma nova tarefa.
5. No campo **Tarefa**, selecione "Consulta de Pagamento Banco do Brasil Api".
6. Agora, nos parâmetros de data, é recomendado que a tarefa seja configurada para executar uma vez no dia, em um horário que não vá conflitar com a comunicação Webhook da integração de pagamento, sendo assim, configure:
	 - **Minuto (0-59)**
		- **Tipo**: Selecione a opção "Valor"
		- **Valor**: Insira o número "0"
	 - **Hora (0-23)**
		- **Tipo**: Selecione a opção "Valor"
		- **Valor**: Insira o **6,12,18,23**.
	 - **Dia do mes (1-31)**
		- **Tipo**: Selecione a opção "Valor"
		- **Valor**: Não preencher
	 - **Mes (1-12)**
		- **Tipo**: Selecione a opção "Valor"
		- **Valor**: Não preencher
	 - **Dia da semana (0-6) 0=dom, 1=seg...**
		- **Tipo**: Selecione a opção "Valor"
		- **Valor**: Não preencher

7. Clique no botão **Salvar** para confirmar a configuração da tarefa.
8. Verifique se a tarefa aparece na lista de tarefas agendadas.

> [!SUCCESS] Finalizado!
> Com a configuração acima, as tarefas ficaram configuradas para executar todos os dias às 6, 12, 18 e 23h.

## Fluxo de Processo

```mermaid
graph TD
    A[Início] --> B[Acessar menu Ferramentas]
    B --> C[Selecionar Ferramentas]
    C --> D[Clicar em Agenda de tarefas]
    D --> E[Clicar em Novo]
    E --> F[Selecionar 'Consulta de Pagamento Banco do Brasil Api']
    F --> G[Configurar Minuto]
    G --> H[Configurar Hora]
    H --> I[Configurar Dia do mês]
    I --> J[Configurar Mês]
    J --> K[Configurar Dia da semana]
    K --> L[Clicar em Salvar]
    L --> M[Verificar lista de tarefas agendadas]
    M --> N[Fim]
```

## Considerações Finais
A implementação da tarefa "Consulta de Pagamento Banco do Brasil Api" representa um avanço significativo na gestão financeira das empresas que utilizam boletos do Banco do Brasil. Esta automação não apenas otimiza processos internos, mas também melhora a precisão e a eficiência na reconciliação bancária. Ao reduzir a intervenção manual e proporcionar atualizações em tempo quase real, a tarefa contribui para uma tomada de decisão mais informada e uma gestão de fluxo de caixa mais eficaz. É importante, no entanto, manter um monitoramento regular do processo, garantindo que as credenciais de acesso à API estejam sempre atualizadas e que os logs gerados sejam periodicamente revisados para identificar possíveis anomalias ou oportunidades de melhoria no processo.

> [!DANGER] Cuidado!
> Esta tarefa é necessária apenas quando a carteira de API Banco do Brasil configurada não utilizar o webhook para comunicação com o banco. <br>
> Caso sua carteira use a comunicação webhook, cadastrar essa tarefa pode duplicar recebimentos.

## ETIQUETAS
#AgendaTarefas #ConsultaPagamentos #BancoDoBrasil #BoletoHibrido #AutomacaoFinanceira #GestaoFinanceira #Boleto #Pix

## LEIA TAMBÉM
- [[carteira de cobranca|Carteira de Cobrança]]
- [[contas a receber|Contas a Receber]]
- [[integracoes bancarias - carteira de cobranca|Integrações Bancárias - Carteira de Cobrança]]
- [[integracoes bancarias - api|Integrações Bancárias - API]]
- [[api banco do brasil|API Banco do Brasil]]
- [[consulta manual de pagamentos|Consulta Manual de Pagamentos]]
- [[logs gateway|Logs Gateway]]
- [[como reprocessar logs gateway|Como Reprocessar Logs Gateway]]
- [[localizar pagamentos - logs gateway|Localizar Pagamentos - Logs Gateway]]
- [[logs de rotinas de cobranca gateway|Logs de Rotinas de Cobrança Gateway]]
- [[logs gateway|Logs Gateway]]
- [[logs de tarefas|Logs de Tarefas]]