Central de Ajuda

Leitura de 5 min

Rotina Cancelamento de Cobranças no Gateway

Introdução

A funcionalidade de cancelamento de cobranças no gateway foi projetada para resolver discrepâncias entre o sistema e os registros do Gateway ou API bancária. Isso é especialmente útil em casos onde a cobrança é dada como cancelada no banco, mas permanece ativa no sistema. Este processo otimiza operações financeiras e reduz a necessidade de suporte técnico.

Acesso à Rotina

Caminho: Menu Configurações > Rotinas Financeiro > Rotinas Financeiro > botão Cancelar boletos em massa > Cancelar comunicação gateway (Simular e Executar)

Integrações com Outros Módulos

Metodologia de Funcionamento

Seleção de Cobranças

  • Somente cobranças que já estejam recebidas, canceladas ou renegociadas serão filtradas, respeitando os filtros disponíveis na aba Cancelamento de boletos (exceto o Motivo de cancelamento).
  • A rotina buscará boletos que possuem ao menos um registro de comunicação em seu Histórico Boleto, independente da integração utilizada (Gateway, API bancária ou Pix).

Opções no Botão Cancelar Boletos em Massa

  • Cancelar Comunicação Gateway (Simular): Executa uma simulação do cancelamento sem efetivar no gateway. Útil para validação prévia.

  • Cancelar Comunicação Gateway (Executar): Executa o cancelamento efetivo, enviando todos os logs e informações necessárias ao gateway, sem alterar o status da cobrança no IXC Oner.

Caso a carteira principal da cobrança possua uma alternativa de pagamento com cobrança registrada, um log de cancelamento também será enviado para essa alternativa.

  • Exemplo: carteira gateway de boleto com alternativa Pix modobank.

Estrutura da Rotina

Aba de Filtros - Cancelamento de boletos

A aba Cancelamento de boletos possui filtros que possibilitam o usuário selecionar as cobranças a serem canceladas com base em critérios específicos.

CampoDescrição
FilialSelecionar a filial
Carteira de cobrançaSelecionar a carteira de cobrança específica do Gateway ou API
ContratoSelecionar o tipo de contrato
Status contratoSelecionar o status do contrato
Motivo de cancelamentoEspecificar o motivo do cancelamento
Plano de VendaSelecionar o plano de venda
Tipo de pessoaSelecionar o tipo de pessoa
LoteSelecionar o lote
Data inicial emissãoEspecificar a data inicial de emissão
Data final emissãoEspecificar a data final de emissão
Data inicial vencimentoEspecificar a data inicial de vencimento
Data final vencimentoEspecificar a data final de vencimento
ImpressoDefine se serão incluídos ou não, títulos com registro bancário efetivado, independente do tipo de integração utilizada.
Título registradoDefine se serão incluídos ou não, títulos de remessa e retorno manual (CNAB) que já tiveram linha digitável gerada e registro bancário efetivado.

Como Executar o Cancelamento de Cobranças no Gateway

  1. Acesse o menu Configurações.
  2. Selecione Rotinas financeiro.
  3. Clique na opção Rotinas financeiro.
  4. Na aba de filtros gerais preencha a senha da rotina.
  5. Vá até a aba Cancelamento de boletos.
  6. Preencha os filtros necessários.:
    • Filial: Selecione a filial para a qual deseja cancelar os boletos.
    • Carteira de Cobrança: Escolha a carteira de cobrança correspondente.
  7. Defina o período dos boletos que serão cancelados, preenchendo os campos abaixo:
    • Data Inicial da Emissão: Insira a data de início da emissão dos boletos.
    • Data Final da Emissão: Insira a data final da emissão dos boletos.
    • Data Inicial do Vencimento: Insira a data de início do vencimento dos boletos.
    • Data Final do Vencimento: Insira a data final do vencimento dos boletos.
  8. Filtre o cancelamento por Tipo de Contrato com as opções:
    • Contrato Recorrente.
    • Contrato Avulso.
    • Sem Contrato.
    • Todos.
  9. Para o campo Tipo de Pessoa, você pode escolher entre:
    • Física.
    • Jurídica.
    • Estrangeiro.
    • Todos (este é o padrão).
  10. No campo Plano de Venda, selecione o plano desejado na tabela de planos.
  11. Agora, simule o cancelamento clicando no botão Cancelar boletos em massa > Cancelar comunicação gateway (simular). Você pode visualizar o relatório ou exportá-lo, se necessário.
  12. Verifique se os filtros estão mostrando todos os títulos que deseja cancelar.
  13. Para finalizar, prossiga com o cancelamento clicando em Cancelar boletos em massa > Cancelar comunicação gateway (executar).
  14. Aguarde concluir a execução da rotina e confira a lista de títulos cancelados.
  15. Fim.

Fluxo de Execução - Cancelamento de Cobranças no Gateway

graph TD
    A[Início] --> B[Acesse o menu Configurações]
    B --> C[Selecione Rotinas financeiro]
    C --> D[Clique em Rotinas financeiro]
    D --> E[Preencha a senha da rotina]
    E --> F[Vá para Cancelamento de boletos]
    F --> G[Preencha filtros necessários]
    G --> L[Simule o cancelamento]
    L --> M[Verifique a simulação]
    M --> N[Execute o cancelamento]
    N --> O[Aguarde o fim da rotina]
    O --> P[Confira a relação de títulos cancelados]
    P --> Q[Fim]

Caso de Uso

Problema
  • Durante o processo de cancelamento de uma cobrança no Sistema, pode ocorrer uma falha na comunicação com o gateway, fazendo com que o status da cobrança seja atualizado para Cancelado no Sistema, mas permaneça Ativa no gateway.
Ação
  • Usuário executa a Rotina Cancelar comunicação gateway para corrigir a situação da cobrança em sua instituição financeira.

Considerações Finais

A rotina é criada para reforçar o controle financeiro sem alterar os dados locais a menos que seja necessário, proporcionando ao time financeiro um meio de corrigir e ajustar dados em tempo real sem precisar recorrer ao Suporte Técnico.

Recomenda-se cautela no uso, revisando as seleções antes da execução final e mantendo registros claros dos cancelamentos realizados para consultas futuras.

Etiquetas

Cancelamento Cobranças Gateway API GestãoFinanceira

Leia Também

Visão de gráfico