Páginas filhas
  • DDFINAN-32855- DT - 775 - Integração Contas a Pagar Bradesco via API - Banco Bradesco (237)

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

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:

CampoTipoObrigatórioDescrição
LOGENVIOCPCLOBOpcionalArmazena o log de envio do CP
DTENVIOCPDATEOpcionalData do envio do CP
STATUSENVIOCPVARCHAR2(30)OpcionalStatus atual do envio do CP
LOGRETORNOCPCLOBOpcionalArmazena o log de retorno do banco
STATUSRETORNOCPVARCHAR2(30)OpcionalStatus do retorno recebido
DTRETORNOCPDATEOpcionalData do retorno recebido
JSONENVIOCPCLOBOpcionalArmazena o JSON enviado
JSONRETORNOCPCLOBOpcionalArmazena 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
      ou
    • DTENVIOCP preenchido e STATUSENVIOCP = '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
    • Se numbanco ≠ 237:
      • LOGENVIOCP = "Banco (NUMBANCO) não homologado para integração de Contas a Pagar por API no Winthor."
      • STATUSENVIOCP = "NAO HOMOLOGADO"
Totvs custom tabs box
tabsComo ter a melhoria?
idspasso1
Totvs custom tabs box items
defaultyes
referenciapasso1

Solução da rotina 775 - Gerir contas a Pagar a partir da atualização da versão 38.x.x.x ou acima.
Deve atualizar a rotina para a versão igual ou superior

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

...