01. DADOS GERAIS

02. SITUAÇÃO/REQUISITO

Após a implementação inicial da conciliação bancária via API para o Banco Bradesco (237), surgiu a necessidade de expandir o processo para o Banco Itaú (341), ampliando a cobertura das integrações bancárias do WinThor.

Com essa atualização, tornou-se necessário:

• Homologar o Banco Itaú (341) para funcionamento na conciliação automática;

• Criar sessão específica para o banco 341, seguindo o mesmo padrão modular já utilizado para o Bradesco;

• Atualizar o método de integração para suportar múltiplos bancos via API;

• Implementar regras de autenticação, consulta e tratamento de retorno conforme documentação do Itaú;

• Garantir que a estrutura atual permita a inclusão futura de novos bancos sem impacto no fluxo existente.

03. SOLUÇÃO

Foi realizada uma evolução do fluxo de conciliação automática via API, inicialmente desenvolvido para o Bradesco, agora contemplando também o Banco Itaú (código 341).

A solução implementada inclui:

3.1. Atualização do método de integração

O método consulta_extratobancario, pertencente ao serviço DLib – Financeiro, foi ajustado para:

• Suportar múltiplos bancos homologados;

• Executar rotinas específicas de autenticação e consulta para o Itaú (341);

• Manter a compatibilidade com o fluxo já existente para o Bradesco (237).

A estrutura agora permite adicionar outros bancos futuramente sem alteração no fluxo central.

3.2. Homologação de novo banco

Foi incluído na lista de bancos homologados para integração via API:

• Banco Itaú — código 341

Com isso, o Itaú passa a operar oficialmente dentro do fluxo de conciliação automática do WinThor.

3.3. Sessão específica para o Banco Itaú

Assim como já existia para o banco 237, foi criada uma nova sessão dedicada ao banco 341, responsável por:

• Armazenar parâmetros próprios do Itaú;

• Controlar comportamentos específicos da API;

• Garantir isolamento entre lógicas dos bancos já integrados.

3.4. Conexão e consulta do extrato – Banco Itaú (341)

O método agora realiza:

• Autenticação utilizando o protocolo definido pelo Itaú para integração via API;

• Envio dos parâmetros obrigatórios (agência, conta, período e tipo de conta);

• Validação de período máximo de 12 meses — mensagem amigável é retornada quando excedido;

• Tratamento das particularidades do modelo de extrato fornecido pelo Itaú.

3.5. Tratamento dos retornos da API do Itaú

A API do Itaú possui códigos próprios, incluindo HTTP e códigos de negócio.

A solução implementa:

• Interpretação dos retornos conforme tabela de status do banco;

• Registro em LOG de qualquer erro de comunicação ou validação;

• Para respostas de sucesso (200), o processamento dos lançamentos segue o fluxo padrão.

3.6. Armazenamento dos dados

Cada lançamento recebido pela API é gravado na tabela PCEXTRATOBANCARIO, seguindo o padrão já utilizado no Bradesco e agora incluindo campos específicos do Itaú (341).
O armazenamento contempla:

• DATAINTEGRACAO = data/hora da importação

• CONCILIADO = ‘N’

• CODBCO = banco utilizado (237 Bradesco / 341 Itaú)

• DATALANCAMENTO

• NUMERODOCUMENTO

• VALORLANCAMENTO

• SINALLANCAMENTO

• HISTORICO

• CODIGOLANCAMENTO

• DESCRITIVOABREVIADO

• DESCRITIVOCOMPLETO

Campos adicionais gravados exclusivamente para o Banco Itaú (341):

• IDLANCAMENTOGUID — Identificador único do lançamento retornado pela API Itaú

• OPERACAO — Código/descrição da operação retornada pelo banco

• CORRELATIONID — Identificador de correlação da requisição, utilizado para rastreabilidade e auditoria

Esses campos são preenchidos somente quando retornados pela API Itaú. Para os demais bancos, permanecem NULL, garantindo compatibilidade total com o fluxo existente.

3.8. Registro de LOG

O mecanismo de logging foi mantido e estendido para o banco 341.

São registradas:

• Data/hora da chamada;

• Parâmetros enviados;

• Endpoint utilizado (Bradesco ou Itaú);

• Código de retorno da API;

• Mensagem de sucesso ou erro;

• Conteúdo retornado para auditoria.

04. DEMAIS INFORMAÇÕES

05. ASSUNTOS RELACIONADOS

• Como atualizar as rotinas do WinThor?