Exibir origem

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
  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"

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

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

Como atualizar as rotinas do WinThor?
EDI Financeiro