01. DADOS GERAIS 

02. SITUAÇÃO/REQUISITO

Atualmente, o processo de envio dos contas a pagar para o banco é manual e depende de interação do usuário após a assinatura do borderô.

O objetivo desta melhoria é automatizar o envio dos títulos de contas a pagar para o banco Bradesco, logo após a assinatura do borderô, garantindo que o processo ocorra de forma integrada, rastreável e sem intervenção humana.

Além disso, deve-se implementar validações e bloqueios para impedir o cancelamento da assinatura de borderôs que já tiveram seus títulos enviados ao banco.

03. SOLUÇÃO

A rotina 775 - Gerir Contas a Pagar foi ajustada para identificar se o banco utiliza integração via API.

• Caso o banco possua integração ativa, o sistema envia automaticamente os títulos do borderô para o banco assim que o gestor assinar.
• Se o banco não utilizar integração, o processo continua funcionando da forma tradicional (sem envio automático).

Durante o envio, o sistema se comunica com o serviço interno 'dlib-financeiro', responsável por integrar com o banco e registrar o resultado do envio.

Após o processamento, o sistema exibe mensagens informativas conforme o retorno:

• “Contas a pagar enviados para o Banco.” – quando todos os títulos são enviados com sucesso.
• “Erro no envio do contas a pagar para o Banco. Verifique o status.” – quando algum título apresentar falha no envio.

Também foi criada uma proteção para o cancelamento da assinatura:

• Caso o borderô já tenha títulos enviados ao banco, não será possível cancelar a assinatura.

• O sistema apresentará a mensagem:

   “Não é possível cancelar a assinatura, pois um ou mais títulos já foram enviados ao banco.”

Validações Adicionais:

• Tratamento de erros e indisponibilidades do serviço (mensagem de falha controlada).
• Garantia de integridade nas atualizações de status dos títulos.
• Logs detalhados do envio e retorno do serviço para rastreabilidade.

04. REGRAS PRINCIPAIS

1. O envio automático só ocorre quando o campo “Utiliza integração por API para o Contas a Pagar” do banco estiver marcado como “S”.

2. Caso o campo esteja “N” ou em branco, o envio automático não será realizado.

3. O resultado de cada título é armazenado no sistema, permitindo verificar se o envio foi bem-sucedido ou não.

4. O sistema impede o cancelamento da assinatura quando houver qualquer título com status “ENVIADO”.

04. FORMAS DE PAGAMENTO ACEITAS PELA API DO BRADESCO

Ao identificar que o campo PCLANC.FORMAPGTO ou PCLANCAGRUPADO.FORMAPAGTO possui um dos seguintes códigos:

• 30, 31 - O sistema deve enviar o contas a pagar para a API de Boletos de cobrança, conforme o contrato de dados da API do Bradesco.
• 13, 16, 17, 18, 19, 21, 22, 25, 27, 35, 91 - O sistema deve enviar o contas a pagar para a API de Contas de Consumo / Tributos, conforme o contrato de dados da API do Bradesco.
  
• 1, 3, 41, 43 - O sistema deve enviar o contas a pagar para a API de TED, conforme o contrato de dados da API do Bradesco.
• 45 - O sistema deve enviar o contas a pagar para a API de PIX, conforme o contrato de dados da API do Bradesco.

Regra de negócio:

• As formas de pagamento 30 e 31 correspondem a boletos de cobrança, e devem ser enviadas para o endpoint da API de Boletos de Cobrança do Bradesco.

• As formas de pagamento 13, 16, 17, 18, 19, 21, 22, 25, 27, 35 e 91 correspondem a títulos de contas de consumo e tributos, e devem ser enviados para o endpoint específico da API de Contas de Consumo/Tributos.

• As formas de pagamento 1, 3, 41 e 43 correspondem a títulos de TED, e devem ser enviados para o endpoint específico da API de TED.
• As formas de pagamento 45 correspondem a títulos de PIX, e devem ser enviados para o endpoint específico da API de PIX.

• As demais formas de pagamento permanecem sendo tratadas conforme o processo padrão de envio via borderô.

06. DEMAIS INFORMAÇÕES

07. ASSUNTOS RELACIONADOS

• Como atualizar as rotinas do WinThor?
• EDI Financeiro