| Produto: | TOTVS Distribuição e Varejo |
|---|---|
| Linha de Produto: | Linha Winthor |
| Segmento: | Distribuição TOTVS Goiânia |
| Módulo: | 07 - CONTAS A PAGAR |
| Função: | 775 - GERIR CONTAS A PAGAR |
| Requisito/Story/Issue : | DDFINAN-35119 |
Com a evolução das integrações bancárias no Winthor, tornou-se necessário incluir o Banco Itaú (341) no processo de Contas a Pagar, permitindo que os pagamentos sejam realizados de forma mais ágil e automatizada.
A API do Itaú possui uma particularidade importante:
ela aceita apenas pagamentos via PIX e QR Code. Outras formas de pagamento, como boleto, TED e similares, ainda exigem o envio por arquivo magnético (TXT).
Dessa forma, foi necessário implementar um modelo híbrido, onde o sistema:
Envia automaticamente via API os pagamentos que o Itaú aceita (PIX e QR Code);
Gera arquivo TXT para os demais tipos de pagamento, utilizando a Rotina 770 – Geração de Arquivo Magnético;
Mantém rastreabilidade, controle de status e histórico de processamento para todos os títulos.
Esse modelo garante flexibilidade, segurança e compatibilidade com as regras atuais do banco.
A solução implementada contempla a integração do Banco Itaú (341) no processo de Contas a Pagar, utilizando dois fluxos complementares, executados conforme o tipo de pagamento presente no borderô.
Quando o borderô possuir títulos com forma de pagamento PIX ou QR Code, o Winthor realiza o envio automático desses pagamentos para o Itaú via API, a partir da Rotina 775.
O sistema:
Conecta-se ao Itaú conforme o padrão definido pelo banco;
Envia todos os títulos elegíveis do borderô;
Considera apenas títulos que ainda não foram enviados ou que tiveram erro em tentativas anteriores.
Após o processamento, o sistema registra:
Envio com sucesso
Status atualizado para Enviado
Data do envio registrada
Histórico informando o sucesso da operação
Envio com erro
Status atualizado para Erro de envio
Data da tentativa registrada
Histórico informando a falha, permitindo nova tentativa
Além disso, o conteúdo enviado ao banco fica armazenado para fins de auditoria e rastreabilidade.
Quando o borderô possuir formas de pagamento não suportadas pela API do Itaú, como boleto, TED ou outros, o sistema utiliza um novo fluxo exclusivo para o Banco Itaú (341).
Nesse cenário:
O Winthor gera automaticamente um arquivo TXT com esses títulos;
A geração do arquivo segue o padrão já utilizado na Rotina 770 – Geração de Arquivo Magnético;
O arquivo é gravado no caminho configurado para o banco.
Antes da geração, o sistema valida se o layout do banco está corretamente configurado.
Caso seja identificada alguma inconsistência, o usuário é informado e os títulos são retirados do borderô para envio posterior, evitando erros no processamento bancário.
Quando o arquivo é gerado com sucesso, a data da geração é registrada, garantindo controle e rastreabilidade do processo.
A integração de Contas a Pagar via API é permitida apenas para bancos homologados.
O Banco Itaú (341) passa a fazer parte dessa lista;
Caso um banco não homologado seja identificado no processo, o sistema registra a informação, impedindo o envio indevido e mantendo a transparência para o usuário.
|
Importante! As versões estarão disponíveis para download no CCW. https://centraldecontrole.pcinformatica.com.br/ Mantenha suas rotinas sempre atualizadas! |