Bloqueios de documento na Blacklist

É a tela Blacklist do grupo Cadastros: a lista de documentos — CPF ou CNPJ — que o cliente não quer que participem. O bloqueio é consultado no momento em que a nota é enviada. É ele que barra a participação de quem não deve participar, e é o caminho correto quando o cliente pede para impedir alguém: cancelar nota não bloqueia ninguém.

Atenção: o servidor só barra o documento na campanha à qual o bloqueio está vinculado. Cadastrar o documento nesta tela registra o bloqueio no cliente, mas o painel ainda não tem tela para vincular o bloqueio a uma campanha, e esse vínculo não é criado sozinho. Antes de garantir ao cliente que alguém está barrado, confirme com o time técnico que o documento está vinculado àquela campanha.

O bloqueio tem dois tipos: Funcionário (bloqueio por vínculo de funcionário) e Blacklist (bloqueio geral por documento). O tipo serve para o cliente separar os dois casos no próprio cadastro.

O topo da tela mostra o total de bloqueios e quantos são de funcionários e de blacklist geral. A listagem tem busca por documento, e-mail, motivo ou tipo, e os botões "Novo bloqueio" e "Importar arquivo".

No cadastro, o documento e o tipo são obrigatórios. O documento pode ser digitado com ou sem máscara: ele é gravado só com números, e o painel exige um CPF com 11 dígitos ou um CNPJ com 14. O servidor ainda confere os dígitos verificadores — é com o documento limpo e conferido que o cadastro do participante compara. Documento inválido é recusado, com mensagem que não repete o número.

O e-mail e o motivo são opcionais, com limite de tamanho. A edição permite trocar o tipo, o e-mail e o motivo; o documento é a identidade do bloqueio e não pode ser alterado.

Remover o bloqueio pede confirmação e desfaz também os vínculos dele com campanhas.

A importação

O formato do arquivo é documento, e-mail e motivo, separados por ponto e vírgula ou vírgula. E-mail e motivo são opcionais — a linha pode trazer só o documento. O documento pode vir com ou sem máscara; documento inválido recusa só aquela linha. O botão "Baixar modelo" entrega um arquivo pronto para preencher.

O arquivo não traz o tipo: ele é escolhido no formulário e vale para todos os bloqueios do arquivo. O campo começa vazio de propósito, e sem ele a importação não segue. Para importar funcionários e blacklist geral, use um arquivo para cada tipo.

Documento já cadastrado, ou repetido no arquivo, é ignorado e conta nas ignoradas: o bloqueio existente não muda. Nenhuma mensagem do relatório repete o documento ou o e-mail da linha.

A importação gera lote, com histórico abaixo da listagem e opção de desfazer. O desfazer remove os bloqueios que o arquivo criou, inclusive os editados depois da importação, e é tudo ou nada: se algum deles estiver vinculado a campanha, nada é removido e a mensagem diz quantos. O documento que já estava cadastrado antes do arquivo foi ignorado e nunca sai pelo desfazer.

Permissões

Os botões seguem a matriz do papel: criar, editar e excluir na Blacklist. Listar o histórico de importações segue a permissão de ler a Blacklist; desfazer segue a de excluir.

O bloqueio é a ferramenta para impedir que alguém participe. Quatro orientações:

Se o cliente quer barrar uma pessoa, o caminho é bloquear o documento dela na Blacklist — não cancelar as notas. Cancelar nota derruba o que aquela nota rendeu, mas a mesma nota pode ser cadastrada de novo e vai gerar de novo.

O documento precisa ser válido. O painel confere os dígitos verificadores, porque é com o documento limpo e conferido que o cadastro do participante compara. Documento digitado errado criaria um bloqueio que nunca barra ninguém.

No arquivo, o tipo é escolhido no formulário e vale para todas as linhas. Se o cliente tem a lista de funcionários e a lista geral, são dois arquivos.

Reenviar o mesmo arquivo é inofensivo: documento já bloqueado é ignorado e o bloqueio existente não muda. Mas isso também quer dizer que reenviar não corrige o motivo de um bloqueio antigo — para isso é a edição.

• Falha: o cliente cancelou as notas de uma pessoa e ela continua participando.
• Possivel causa: cancelar nota não bloqueia ninguém. A mesma nota recadastrada vale como nota nova.
• Como orientar: oriente a bloquear o documento da pessoa em Cadastros e Blacklist. É esse o caminho para impedir a participação.
• Quando escalar: se o documento estiver bloqueado e a pessoa continuar conseguindo cadastrar nota, acionar o time de desenvolvimento urgentemente e abrir issue no Jira (projeto DEV) com as evidências.

• Falha: o cadastro do bloqueio é recusado com mensagem sobre o documento.
• Possivel causa: o documento não tem 11 ou 14 dígitos ou não tem dígitos verificadores válidos de CPF ou CNPJ.
• Como orientar: confira o documento com o cliente. O painel aceita máscara, mas o valor precisa ser um documento válido.
• Quando escalar: se o documento estiver correto e a recusa continuar, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: a importação de bloqueios não segue.
• Possivel causa: o tipo não foi escolhido no formulário. O tipo é obrigatório e vale para o arquivo inteiro.
• Como orientar: escolha entre Funcionário e Blacklist antes de enviar o arquivo. O campo começa vazio de propósito.
• Quando escalar: se o tipo estiver escolhido e a recusa continuar, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: o arquivo foi reenviado e o motivo dos bloqueios não mudou.
• Possivel causa: documento já cadastrado é ignorado pela importação. O bloqueio existente não muda.
• Como orientar: explique que reenviar não atualiza. Para mudar o tipo, o e-mail ou o motivo, use Editar na listagem.
• Quando escalar: não é falha.

• Falha: o desfazer da importação de bloqueios foi recusado.
• Possivel causa: algum bloqueio do lote está vinculado a campanha. O desfazer é tudo ou nada.
• Como orientar: a mensagem diz quantos impedem, e nada foi removido. Remova os bloqueios restantes pela listagem, se precisar.
• Quando escalar: se nenhum bloqueio do lote estiver vinculado a campanha e o desfazer continuar sendo recusado, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: o bloqueio foi removido e os vínculos com campanhas ficaram.
• Possivel causa: remover o bloqueio desfaz também os vínculos com campanhas. Se algo ficou, pode ser a tela desatualizada.
• Como orientar: recarregue a tela e confira a listagem de novo.
• Quando escalar: se o vínculo persistir depois de recarregar, abrir issue no Jira (projeto DEV) com as evidências.