Erros Comuns no Envio Em Lote

**E01 — "Tá tudo numa coluna só"**

- **Sintoma**: no Passo 3, o cliente sobe a planilha e todos os dados aparecem grudados em uma única coluna

- **Causa**: o CSV foi salvo com separador ponto-e-vírgula (`;`) em vez de vírgula (`,`). Padrão do Excel-BR.

- **Solução**: Arquivo → Salvar Como → escolher *CSV UTF-8 (delimitado por vírgula)*. Subir de novo.

**E02 — "Os acentos viraram símbolos estranhos"**

- **Sintoma**: aparece `Jo�o` em vez de `João` na prévia, ou acentos quebrados no PDF final

- **Causa**: arquivo CSV não está em UTF-8

- **Solução**: no Excel, Salvar Como → *CSV UTF-8*. Se for Google Sheets, Arquivo → Fazer Download → CSV (já sai em UTF-8).

**E03 — "O botão Próximo não habilita no Passo 3"**

- **Sintoma**: o cliente sobe a planilha mas o botão *Próximo* fica desabilitado

- **Causa**: CSV vazio, com formato errado, ou com erro de parse (vírgula dentro de célula sem aspas, quebra de linha no meio)

- **Solução**: abrir o CSV no Excel, conferir se tem dados, salvar de novo como CSV UTF-8. Se tiver texto com vírgula (ex: "Rua X, 100"), garantir que está entre aspas duplas: `"Rua X, 100"`.

**E04 — "Planilha tem X linhas mas o sistema só enviou Y"**

- **Sintoma**: planilha tem 100 destinatários mas só 95 foram processados

- **Causa comum**: linhas em branco no meio, ou linhas sem email

- **Solução**: limpar linhas vazias da planilha, conferir se todas as linhas têm email preenchido. Subir CSV novo.

**E05 — "Os campos do PDF vieram em branco"**

- **Sintoma**: o documento foi gerado, mas campos como CPF, valor, data estão vazios

- **Causa**: ou a coluna da planilha estava vazia nessa linha, ou o nome da coluna não bateu com o campo do template

- **Solução**: baixar o modelo de CSV direto do Sign (botão no Passo 3), comparar as colunas. Preencher o que estiver faltando. Recriar envio.

**E06 — "O contrato veio com `{{cpf}}` escrito no lugar do valor"**

- **Sintoma**: literalmente aparece `{{cpf}}` ou outro placeholder no PDF gerado

- **Causa**: o campo NÃO foi mapeado no Passo 4. A IA não encontrou a coluna correspondente e o cliente avançou sem corrigir.

- **Solução**: recriar o envio. No Passo 4, conferir que TODOS os campos têm uma coluna associada (nenhum em branco/cinza).

**E07 — "O Sign diz que meu template tem um campo que não existe na planilha"** - **Sintoma**: mensagem de aviso no Passo 4 sobre campos faltantes

- **Causa**: o template foi atualizado depois que o usuário baixou o modelo

- **Solução**: no Passo 3, clicar de novo em *Baixar modelo de CSV*. O arquivo novo terá as colunas atualizadas.

**E08 — "A IA de mapeamento pegou a coluna errada"**

- **Sintoma**: no Passo 4, o sistema automaticamente mapeou a coluna errada pro campo

- **Causa**: nomes de coluna parecidos (ex: "nome" e "nome_completo")

- **Solução**: no Passo 4, clicar no campo e trocar manualmente pra coluna certa antes de avançar. --- **📑 CATEGORIA 2 — ERROS DE UPLOAD (PDF / ZIP)**

**E09 — "Não consigo subir o arquivo"**

- **Sintoma**: upload fica travado, dá erro ou demora horas

- **Causa**: arquivo muito grande (>100MB), conexão instável, ou formato inválido

- **Solução**: verificar tamanho do arquivo. PDFs: tentar reduzir ou dividir em lotes. ZIPs: recompactar com menos arquivos. Usar conexão estável.

**E10 — "PDF com número de páginas errado"**

- **Sintoma**: o cliente sobe o PDF e o sistema detecta um número diferente do esperado

- **Causa**: páginas em branco no PDF, ou páginas duplicadas geradas pelo sistema origem

- **Solução**: abrir o PDF, limpar páginas em branco/duplicadas, salvar e subir de novo.

**E11 — "ZIP com arquivos corrompidos"**

- **Sintoma**: no Passo 2 (Pacote de Arquivos), a análise do ZIP reporta erro em alguns arquivos

- **Causa**: PDFs corrompidos dentro do ZIP, ou arquivos que não são PDF (ex: Word, imagem)

- **Solução**: garantir que todos os arquivos no ZIP são PDFs válidos. Descompactar, testar cada um, recompactar.

**E12 — "Alguns arquivos do ZIP não apareceram na lista"**

- **Sintoma**: ZIP tem 50 arquivos mas o sistema só listou 48

- **Causa**: arquivos em subpastas dentro do ZIP (o sistema busca pelo nome base, mas pode ter conflito), ou arquivos com caracteres especiais no nome

- **Solução**: criar ZIP sem subpastas, com todos os PDFs na raiz. Renomear arquivos pra usar só letras, números e underscore (sem acento, sem espaço).

**E13 — "PDF protegido por senha"**

- **Sintoma**: sistema rejeita o upload ou dá erro de processamento

- **Causa**: PDF com senha de abertura ou restrições

- **Solução**: remover a senha/proteção do PDF antes de subir. No Adobe Reader: Arquivo → Propriedades → Segurança → Sem segurança. ---

**E14 — "O João recebeu o documento da Maria"** (Dividir Páginas)

- **Sintoma**: trocou os destinatários das páginas

- **Causa**: a ORDEM da planilha não corresponde à ORDEM das páginas do PDF

- **Solução**: conferir em que ordem o PDF foi gerado (pelo sistema de origem). Ordenar a planilha na mesma sequência. Se o PDF está em ordem alfabética, a planilha precisa estar também.

**E15 — "Alguns documentos no Pacote de Arquivos falharam"** (ZIP)

- **Sintoma**: 47 de 50 funcionaram, 3 deram erro

- **Causa MAIS COMUM**: nome do arquivo na planilha não bate com o nome real no ZIP — maiúscula/minúscula, extensão `.pdf` faltando, ou acento diferente

- **Solução**: abrir o ZIP, copiar os nomes dos arquivos EXATAMENTE como aparecem, colar na coluna da planilha. Depois usar o botão *Tentar novamente* nos documentos que falharam.

**E16 — "Cada funcionário tem 2 páginas mas recebeu só 1 email com 1 página"**

- **Sintoma**: holerite com múltiplas páginas por pessoa, mas cada um recebeu documento separado

- **Causa**: o toggle *Mesclar documentos para mesmo destinatário* não foi ativado no Passo 4

- **Solução**: criar novo envio. Na planilha, repetir o email da pessoa em uma linha por página dela. No Passo 4, LIGAR o toggle de mesclar.

**E17 — "Alguém com 2 páginas recebeu 2 emails separados"** (mesma coisa de E16 por outro ângulo)

- **Sintoma**: destinatário reclama que recebeu o "mesmo" documento várias vezes

- **Causa**: email repetido na planilha sem o toggle de mesclar ativado

- **Solução**: E16. Ativar o toggle e reenviar o necessário.

**E18 — "Email duplicado na planilha gerou 2 envios pra mesma pessoa"**

- **Sintoma**: destinatário recebeu duas cópias idênticas

- **Causa**: planilha tem a mesma linha (ou email) mais de uma vez

- **Solução**: limpar duplicatas antes de subir. Se for caso de múltiplas páginas pra mesma pessoa, ativar toggle de mesclar.

**E19 — "Envio travou em Processando"**

- **Sintoma**: o status do lote fica em *Processando* por muito tempo (mais de 30 minutos)

- **Causa possível**: lote grande (acima de 500 destinatários pode demorar, é normal), ou limite de envio do provedor de email

- **Solução**:

1. Primeiro — esperar. Lotes com 1000+ destinatários podem demorar 1-2 horas.

2. Se passar de 2 horas sem mexer, abrir ticket técnico (não é problema de uso).

**E20 — "Vários documentos com status Falhou"**

- **Sintoma**: na tela do envio, vários itens aparecem em vermelho como *Falhou*

- **Causa**: depende do motivo. Passar o mouse sobre o status mostra a razão.

- **Motivos mais comuns**:

- *Email inválido* → corrigir na planilha, usar *Tentar novamente*

- *Campo obrigatório vazio* → preencher o campo no CSV original, recriar

- *Arquivo não encontrado (ZIP)* → ver E15

- *Erro de geração de PDF* → problema técnico, escalar

- **Solução geral**: identificar o motivo por item, corrigir a causa, usar *Reprocessar falhas* (botão que tenta de novo todos os falhados).

**E21 — "Cancelei o envio mas ainda chegaram emails"**

- **Sintoma**: cliente cancelou e alguns destinatários ainda receberam

- **Causa**: documentos já enfileirados continuam sendo processados por alguns minutos após o cancelamento. Não tem como interromper envios "em trânsito".

- **Solução**: explicar ao cliente que o cancelamento para os PRÓXIMOS, mas não os que já foram disparados. Se enviou pra alguém por engano, orientar a enviar um email manual explicando.

**E22 — "Um envio inteiro falhou com status de erro"**

- **Sintoma**: status do lote inteiro aparece como *Falhou* ou *Erro*

- **Causa**: problema genérico na configuração (ex: template foi deletado durante o processamento, permissão perdida)

- **Solução**: escalar pra equipe técnica com o ID do envio (aparece na URL: `/bulk-sends/{id}`).

**E23 — "Sistema diz que não posso enviar mais, quota atingida"**

- **Sintoma**: na hora de enviar, aparece mensagem de limite/quota

- **Causa**: o tenant (empresa do cliente) tem limite mensal de envios configurado e já foi atingido

- **Solução**: verificar o plano contratado. Orientar que o limite reseta mensalmente. Para aumentar, contatar o comercial/admin do tenant. ---

**E24 — "O destinatário não recebeu o email"**

- **Sintoma**: destinatário diz que nunca chegou email dele

- **Passos de diagnóstico** (nessa ordem): 1. Pedir pra verificar caixa de SPAM/lixo eletrônico 2. Verificar status dele na tela do envio no Sign: - *Enviado* → email saiu, problema é do lado dele - *Bounced / Falhou* → email retornou (ver próximos) - *Pendente* → ainda não foi processado 3. Confirmar o email escrito certo na planilha 4. Perguntar o domínio do email (se for corporativo, pode ter bloqueio interno)

- **Solução por caso**: - Spam → orientar o cliente a adicionar `[email protected]` aos contatos/remetentes confiáveis - Email errado → corrigir e reenviar com botão *Reenviar convite* na linha do destinatário - Bloqueio corporativo → pedir ao TI do destinatário pra liberar o domínio do remetente

**E25 — "Email caiu em SPAM"**

- **Sintoma**: destinatário achou o email mas estava na caixa de spam

- **Causa**: configuração do servidor do destinatário, ou primeira vez que recebe email do domínio do Sign

- **Solução**: pedir ao destinatário pra marcar como "não é spam" e adicionar o remetente aos contatos. Isso treina o filtro pra próximos envios.

**E26 — "Email retornou com erro (Bounced)"**

- **Sintoma**: status do destinatário aparece como *Bounced* ou *Falhou*

- **Causa**: email inválido, caixa postal cheia, domínio inexistente

- **Solução**: corrigir o email na planilha (se for digitação), ou confirmar com o cliente se o endereço certo é outro. Usar *Reenviar convite* depois de corrigir.

**E27 — "Destinatários estão recebendo com delay"**

- **Sintoma**: alguns receberam rápido, outros demoram horas

- **Causa**: normal em lotes grandes — o sistema tem limite de envio por segundo (rate limit). Em lote de 1000 destinatários, os últimos podem demorar mais.

- **Solução**: explicar que é comportamento normal. Orientar o cliente a comunicar os destinatários pra esperarem até algumas horas. ---

**E28 — "O link diz que expirou"**

- **Sintoma**: destinatário clicou no link e a tela diz "link expirado" ou "inválido"

- **Causa**: links têm validade limitada. Se o destinatário demorou demais pra clicar, expira.

- **Solução**: no Sign, na tela do envio, clicar no destinatário → botão *Reenviar convite*. Gera um link novo.

**E29 — "Link dá página em branco ou erro"**

- **Sintoma**: destinatário clica e vê tela em branco, mensagem de erro, ou 404

- **Causas possíveis**:

- Navegador antigo/desatualizado

- Extensão do navegador bloqueando

- Link foi copiado parcialmente (cortado no email)

- **Solução**: pedir pra tentar em outro navegador (Chrome ou Edge atualizados), desabilitar adblock/extensões, ou abrir em modo anônimo.

**E30 — "Não consigo assinar — botão de assinar não habilita"**

- **Sintoma**: destinatário abre o documento, preenche os dados, mas não consegue clicar em *Assinar*

- **Causas possíveis**:

- Campos obrigatórios não preenchidos (o sistema destaca em vermelho os campos vazios)

- Documento foi configurado com assinatura sequencial e a pessoa não é a próxima na ordem

- **Solução**: se é sequencial, orientar a aguardar o signatário anterior. Senão, verificar se todos os campos obrigatórios têm dados.

**E31 — "Código de verificação (OTP) não chegou" (em assinatura em lote)**

- **Sintoma**: destinatário recebeu link, abriu, mas o código de 6 dígitos não chegou no email/celular

- **Causa**: delay no provedor de email/SMS

- **Solução**: aguardar 2-3 minutos, depois usar o botão *Reenviar código*. Verificar spam. Se não vier em 10 min, trocar o canal (email vs SMS, se disponível).

**E32 — "Destinatário assinou mas no Sign aparece como pendente"**

- **Sintoma**: pessoa diz que assinou mas o status continua *Pendente*

- **Causa possível**:

- Atraso de sincronização (aguardar 1-2 minutos, atualizar a tela)

- Pessoa assinou mas fechou antes de confirmar

- Erro no processamento final

- **Solução**: atualizar a tela. Se ainda assim não atualizar, pedir pra pessoa clicar no link de novo — se estiver concluído, vai aparecer "já assinado". Se ela conseguir reabrir e assinar, o status atualiza.