Erros comuns ao salvar
O que o sistema está dizendo quando recusa um cadastro, um anexo ou uma data, ou quando um serviço de fora não responde, e como corrigir sem perder o que você digitou.
Quando o sistema recusa um salvamento, nada foi gravado e o formulário continua preenchido. Corrija o ponto apontado e salve de novo — não é preciso começar do zero.
| O que o sistema recusa | O que isso quer dizer |
|---|---|
| Documento inválido | Os dígitos do CPF ou do CNPJ não conferem, ou o tipo não bate com o cadastro |
| Documento já cadastrado | Já existe outro registro com esse CPF ou CNPJ no seu escritório |
| Campo obrigatório | Falta preencher um campo exigido, às vezes fora da aba aberta |
| Referência inválida | O cliente, a empresa ou o responsável escolhido não pertence ao seu escritório |
| Arquivo recusado | Tipo, tamanho ou conteúdo do arquivo fora do permitido |
| Item repetido | Já existe um registro equivalente naquele contexto |
| Serviço de fora sem resposta | A Receita, o e-mail, o WhatsApp ou a IA não responderam a tempo — veja Quando um serviço de fora não responde, mais abaixo |
CPF e CNPJ
O sistema confere os dígitos verificadores, não só a quantidade de números. Erro de digitação em um dígito derruba o cadastro inteiro.
- Pessoa física exige CPF; pessoa jurídica exige CNPJ. Trocar o tipo do cliente sem trocar o documento é a causa mais comum.
- Pode digitar com ponto, barra e traço. O sistema compara só os números.
- Buscar dados na Receita só funciona com um CNPJ completo e válido.
"Já cadastrado": duplicidade
Cada CPF ou CNPJ pode existir uma vez só dentro do seu escritório. Antes de recadastrar, busque pelo nome — o cadastro provavelmente já está lá, talvez inativo ou com o nome escrito de outro jeito.
Dois detalhes úteis:
- Editar um registro e manter o mesmo documento nunca dá conflito. O sistema ignora o próprio registro na conferência.
- Se o cadastro anterior foi excluído, o documento volta a ser aceito. Um "já cadastrado" significa que existe um registro ativo com aquele número.
AtençãoCadastro duplicado é mais caro do que parece
Processos, documentos e contratos ficam pendurados no cadastro errado. Vale um minuto de busca antes de criar.
Campos obrigatórios
O nome é obrigatório em praticamente todos os cadastros. Além dele, cada tela tem as suas exigências — um caso, por exemplo, precisa estar preso a um grupo. Quando o salvamento não acontece e nenhuma mensagem aparece, role a tela toda e confira as outras abas do formulário: o campo em falta costuma estar marcado.
E-mail e telefone não são obrigatórios, mas se você preencher, precisam estar num formato válido. O e-mail de um usuário do sistema é único dentro do escritório.
Datas e prazos
- Uma data de vencimento vale o dia inteiro. O que vence hoje não está atrasado; ele passa a atrasado na virada do dia.
- Prazos que chegaram por captura automática nascem pendentes de revisão. A data existe, mas só vale como definitiva depois que a controladoria confirma.
- Nas configurações, cada combinação de área e tipo de prazo só pode ter uma regra. Tentar criar a segunda é recusado — edite a regra que já existe.
Anexos e documentos
| Situação | Como resolver |
|---|---|
| Arquivo muito grande | O limite por arquivo é de 50 MB. Divida ou comprima |
| Tipo não permitido | São aceitos formatos de documento, planilha, imagem e compactados. Páginas de internet, imagens vetoriais e executáveis são bloqueados |
| Arquivo com a extensão trocada | O sistema confere o conteúdo real. Renomear um arquivo para .pdf não engana a validação — salve de novo no formato certo |
| Dois documentos do mesmo tipo | Cada entidade aceita um documento por tipo. Substitua o que já está lá em vez de criar outro |
| Documento pessoal em duas pessoas | Um documento pessoal pertence a uma pessoa só. Desfaça o vínculo antigo antes |
| Vínculo repetido | O arquivo já está ligado àquela entidade, ou ela já é o vínculo principal |
Acentos e espaços no nome do arquivo não são problema: o sistema guarda o nome original para exibição e download.
Configurações e usuários
- O escritório precisa ter sempre pelo menos um administrador ativo. A última conta de administrador não pode ser desativada nem rebaixada.
- Ninguém altera o próprio perfil de acesso, nem exclui a própria conta.
- Nomes de parâmetros (tipos de tarefa, de contrato, de documento) não se repetem dentro do mesmo tipo de lista.
Quando um serviço de fora não responde
Algumas ações dependem de serviços de fora do Mandatta: a consulta de CNPJ na Receita, o envio de e-mail, o WhatsApp do escritório e a IA. Cada um tem um tempo limite próprio — a IA, que costuma demorar mais, tem o maior deles. Passado esse tempo, ou se o serviço estiver fora do ar, o sistema para de esperar e avisa na tela, em vez de deixar a tela carregando.
Nos avisos da Receita, do e-mail e do WhatsApp, a mensagem começa pelo nome do serviço — por exemplo, "Receita (BrasilAPI)", "Provedor de e-mail" ou "Z-API", que é o serviço do WhatsApp — e termina dizendo o que houve:
| Final da mensagem | O que quer dizer |
|---|---|
| "sem resposta dentro do prazo" | O serviço não respondeu a tempo |
| "falha de rede, sem resposta" | O sistema não conseguiu falar com o serviço |
| "respondeu HTTP" e um número | O serviço respondeu, mas com erro |
O que fazer em cada caso:
- Consulta à Receita. O sistema já tenta de novo sozinho antes de desistir. Espere alguns minutos e consulte outra vez; o que já estava preenchido no formulário continua lá.
- E-mail e WhatsApp. O envio não é repetido automaticamente, para o cliente não receber a mesma mensagem duas vezes. Confira se ela saiu — no WhatsApp, a conversa marca Não enviada — e envie de novo quando o serviço voltar.
- IA. Espere alguns minutos e peça de novo.
- Se o erro se repetir ao longo do dia, abra um chamado em Tickets com a mensagem exata e o horário.
DicaSe a mensagem não ajudar
Copie o texto exato que apareceu na tela e o horário. Com esses dois dados, quem for atender encontra o registro do que aconteceu em segundos.
O que reunir antes de pedir ajuda