01. DADOS GERAIS

02. SITUAÇÃO/REQUISITO

No cenário anterior, o WinThor não possuía um processo padronizado para integrar o extrato bancário do Bradesco via API.
A conciliação financeira dependia de processos manuais, dificultando o acompanhamento diário dos lançamentos e aumentando o risco de divergências.

Com a implementação da conciliação automática via API, tornou-se necessário:

• Criar um método específico para consultar o extrato diretamente no Bradesco;

• Validar os retornos da API e registrar logs de comunicação;

• Armazenar os lançamentos retornados na tabela de extrato bancário do sistema;

• Restringir o período de consulta a no máximo 12 meses.

03. SOLUÇÃO

Foi implementado pelo time de desenvolvimento um novo fluxo de conciliação automática via API do Bradesco, permitindo que o WinThor consulte e importe extratos bancários de forma integrada.

A solução contempla:

3.1. Novo método de integração

Criado o método consulta_extratobancario dentro do serviço DLib–Financeiro.
Ele é responsável por conectar na API do Bradesco, consultar o extrato bancário e armazenar os dados na tabela.

3.2. Homologação de banco

Incluído o banco Bradesco (código 237) na lista de bancos homologados para integração via API.

3.3. Sessão específica para o Bradesco

Foi criada uma sessão dedicada ao banco 237, permitindo que novos bancos sejam adicionados futuramente sem impacto no fluxo existente.

3.4. Conexão e consulta do extrato

O método:

• Conecta na API utilizando o processo de autenticação/documentação fornecido pelo Bradesco;

• Envia os parâmetros obrigatórios para consulta (agência, conta, período e tipo da conta);

• Valida se o período informado não ultrapassa 12 meses, retornando mensagem amigável caso exceda.

3.5. Tratamento dos retornos da API

A integração interpreta corretamente os códigos de retorno do Bradesco, tanto HTTP quanto de negócio.
Em caso de erro, a mensagem retornada é registrada em LOG e exibida de forma clara ao usuário.

Para retornos de sucesso (código 200), os dados são processados normalmente.

3.6. Processamento dos lançamentos

Do retorno da API, o sistema utiliza apenas o bloco "extratoPorPeriodo", onde estão os lançamentos históricos.
São considerados apenas lançamentos do tipo "02" (lançamentos válidos), ignorando lançamentos de saldo inicial (“01”).

3.7. Armazenamento dos dados

Cada lançamento recebido é gravado na tabela PCEXTRATOBANCARIO, preenchendo:

• DATAINTEGRACAO = data/hora da importação

• CONCILIADO = ‘N’

• CODBCO = banco utilizado

• DATALANCAMENTO

• NUMERODOCUMENTO

• VALORLANCAMENTO

• SINALLANCAMENTO

• HISTORICO

• CODIGOLANCAMENTO

• DESCRITIVOABREVIADO

• DESCRITIVOCOMPLETO

3.8. Registro de LOG

Todas as tentativas de comunicação são registradas, incluindo:

• Data/hora da chamada,

• Parâmetros utilizados,

• Código de retorno,

• Mensagem retornada pela API.

04. DEMAIS INFORMAÇÕES

05. ASSUNTOS RELACIONADOS

• Como atualizar as rotinas do WinThor?