Como resolver a falha na baixa automática do retorno por duplicidade de identificador

Visão geral

A conciliação automática do retorno bancário relaciona os pagamentos informados pelo banco às cobranças e contratos no sistema por meio de um identificador único.

Quando duas ou mais assinaturas usam o mesmo identificador e a opção de permitir duplicidade não está ativada no plano, o sistema não realiza a conciliação automática. Isso evita que o pagamento seja vinculado à cobrança errada.

Quando usar este artigo

Use este artigo quando o pagamento do cliente aparecer no arquivo de retorno bancário, mas a cobrança não for baixada automaticamente porque existe mais de uma assinatura com o mesmo identificador de contrato

Sintoma ou cenário

O arquivo de retorno bancário é processado e o pagamento do cliente está presente no arquivo, porém a cobrança permanece em aberto no sistema sem a realização da baixa automática.

Benefício para o usuário ou operação

Baixa correta de pagamentos no sistema via reprocessamento do arquivo de retorno bancário;
Prevenção contra a duplicidade indevida de cobranças em aberto para assinaturas ativas;
Flexibilidade para optar entre permitir o mesmo identificador em múltiplos contratos ou gerenciar identificadores exclusivos individualmente.

Onde acessar / contexto de uso

Menu Assinaturas > Planos (e Menu Receitas > Retorno bancário).

Pré-requisitos (Antes de começar)

Perfil Exato: Usuário com permissão Contratação (planos) - Alteração (1330), Cobranças - Alteração (1081) ou Recorrentes - Alteração (1091).
Recursos Sistêmicos: Módulo de assinaturas e retorno bancário habilitados na licença.
Insumos e Dados Técnicos: Identificação do cliente e do arquivo de retorno bancário com a liquidação pendente.

Causas prováveis

A opção "Permitir o mesmo identificador em diferentes contratos" está desabilitada nas configurações de planos e existem dois ou mais contratos/assinaturas ativos utilizando o mesmo identificador (gerado por padrão com a razão social ou nome do cliente).

Como fazer ou corrigir

O sistema utiliza o identificador do contrato para vincular os pagamentos do retorno bancário às cobranças. Quando a opção de permitir identificadores idênticos em contratos distintos está desativada, a presença de duplicidade impede a baixa automática no reprocessamento.

Acesse o menu Assinaturas e clique em Planos.
Clique no ícone de engrenagem para abrir as configurações gerais dos planos.
Verifique se a opção Permitir o mesmo identificador em diferentes contratos está desativada.
Para resolver o problema e evitar falhas em cobranças futuras, ative a opção Permitir o mesmo identificador em diferentes contratos.
Caso prefira manter essa opção desativada, altere manualmente o identificador de uma das assinaturas conflitantes.
Reprocesse o arquivo de retorno bancário correspondente para que a cobrança seja liquidada corretamente.

Resultado esperado

O arquivo de retorno é reprocessado com sucesso e a cobrança pendente é liquidada automaticamente no sistema.

Quando escalar

Escale o suporte técnico caso o arquivo de retorno continue sem realizar a baixa automática da cobrança mesmo após a ativação da permissão de duplicidade de identificadores ou a alteração do identificador conflitante.

Informações que devem ser reunidas antes do escalonamento

Nome da licença;
Nosso Número ou ID da cobrança afetada;
ID ou nome do cliente e das assinaturas envolvidas;
Arquivo de retorno bancário processado;
Captura de tela da configuração do plano e do erro no retorno bancário.

Regras importantes / Observações

Por padrão, o identificador do contrato é gerado automaticamente utilizando a Razão Social ou Nome do cliente.
A alteração manual do identificador em uma assinatura afeta apenas as cobranças geradas futuramente.
A modificação do identificador deve ser realizada com cautela para evitar novos conflitos entre assinaturas distintas.

Problemas comuns e como resolver

Problema: A cobrança antiga permanece em aberto mesmo após alterar manualmente o identificador da assinatura.
- Causa provável: A alteração manual do identificador aplica-se exclusivamente às cobranças geradas após a modificação.
- Ação recomendada: Ative a opção "Permitir o mesmo identificador em diferentes contratos" nas configurações dos planos ou realize a liquidação manual da cobrança pendente e reprocesse o retorno.

Dúvidas relacionadas

P: O que gera o identificador do contrato por padrão no sistema? R: Por padrão, o identificador do contrato é gerado automaticamente utilizando a Razão Social ou Nome do cliente.

P: A alteração manual do identificador de uma assinatura corrige retroativamente cobranças antigas? R: Não, a alteração manual do identificador em uma assinatura impacta apenas as cobranças geradas a partir do momento da alteração.

Palavras-chave de busca

baixa automática retorno bancário, duplicidade de identificador, permitir mesmo identificador em diferentes contratos, retorno não baixa cobrança, identificador de assinatura, reprocessar retorno bancário