Histórico da Página
01. DADOS GERAIS
| 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-32855 |
02. SITUAÇÃO/REQUISITO
Atualmente, o Winthor não possui método para envio de informações de Contas a Pagar (CP) via API para o banco Bradesco. O processo é manual e não existe integração direta entre o sistema e o banco para efetuar pagamentos utilizando a conectividade Bradesco API.
Diante disso, é necessário implementar um novo método no serviço responsável por contas a pagar, permitindo que o envio de títulos e pagamentos seja feito automaticamente via integração API, garantindo rastreabilidade, logs de retorno e controle de status.
03. SOLUÇÃO
Foi criado o método ENVIA_CONTASPAGAR dentro do serviço DLIB-FINANCEIRO, responsável por integrar o Contas a Pagar do Winthor com o banco Bradesco via API, conforme documentação oficial do banco (Bradesco Developers).
1 . Alterações de Estrutura (Banco de Dados)
Foram adicionados os seguintes campos na tabela PCLANC para controle de envio e retorno da integração:
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| LOGENVIOCP | CLOB | Opcional | Armazena o log de envio do CP |
| DTENVIOCP | DATE | Opcional | Data do envio do CP |
| STATUSENVIOCP | VARCHAR2(30) | Opcional | Status atual do envio do CP |
| LOGRETORNOCP | CLOB | Opcional | Armazena o log de retorno do banco |
| STATUSRETORNOCP | VARCHAR2(30) | Opcional | Status do retorno recebido |
| DTRETORNOCP | DATE | Opcional | Data do retorno recebido |
| JSONENVIOCP | CLOB | Opcional | Armazena o JSON enviado |
| JSONRETORNOCP | CLOB | Opcional | Armazena o JSON de retorno do banco |
2 . Criação do Método ENVIA_CONTASPAGAR
Foi desenvolvido o método ENVIA_CONTASPAGAR, responsável por:
- Receber o número do borderô (numborderô) da PCLANC;
- Verificar os lançamentos correspondentes e o banco vinculado;
- Efetuar o envio via API quando o banco for homologado (atualmente apenas o Bradesco – código 237);
- Registrar logs e status conforme resultado.
3 . Fluxo de Envio
- O método é acionado pela rotina 775, recebendo o numborderô.
- São selecionados os lançamentos da PCLANC com:
DTENVIOCP IS NULL
ouDTENVIOCPpreenchido eSTATUSENVIOCP = 'ERRO ENVIO'.
- Para cada título elegível:
- Se numbanco = 237 (Bradesco):
- Gera token e conecta ao Bradesco API.
- Envia os dados de CP.
- Atualiza os campos:
- Sucesso:
LOGENVIOCP = "Enviado com sucesso em (DATA)"DTENVIOCP = trunc(sysdate)STATUSENVIOCP = "ENVIADO"JSONENVIOCP = JSON do envio
- Erro:
LOGENVIOCP = "Tentativa de envio com erro em (DATA)"DTENVIOCP = trunc(sysdate)STATUSENVIOCP = "ERRO ENVIO"JSONENVIOCP = JSON do envio
- Sucesso:
- Se numbanco ≠ 237:
LOGENVIOCP = "Banco (NUMBANCO) não homologado para integração de Contas a Pagar por API no Winthor."STATUSENVIOCP = "NAO HOMOLOGADO"
- Se numbanco = 237 (Bradesco):
| Totvs custom tabs box | |||||||
|---|---|---|---|---|---|---|---|
| |||||||
|
04. DEMAIS INFORMAÇÕES
| Aviso |
|---|
Importante! As versões estarão disponíveis para download no CCW. https://centraldecontrole.pcinformatica.com.br/ Mantenha suas rotinas sempre atualizadas! |
05. ASSUNTOS RELACIONADOS
...