Erros comuns¶
Material para o time interno de suporte do aluguei+. Procure pelo trecho exato da mensagem com Ctrl+F.
Login / Signup¶
E-mail ou senha inválidos¶
Causa: credenciais erradas, ou conta ainda não confirmada.
Como verificar: consultar usuario_admin no banco — data_confirmacao_email
deve estar preenchida.
Correção: orientar uso de Esqueci minha senha ou reenviar confirmação.
CNPJ já cadastrado¶
Causa: já existe empresa ativa com o mesmo documento.
Como verificar: SELECT * FROM empresa WHERE cnpj = '...'.
Correção: se for cliente legítimo querendo reativar, escalar para admin
reativar a conta original ou liberar o CNPJ.
Configurações da empresa¶
Erro 500 ao salvar configurações¶
Causa conhecida: body do PUT /minha-empresa sem cnaes_secundarios
quebrava GetValue<TJSONArray>.
Correção: conferir os logs da API procurando por cnaes_secundarios.
Falha na emissão: Nenhum provedor selecionado¶
Causa: empresa sem codigo_municipio_ibge cadastrado.
Correção: abrir Configurações > Empresa, clicar na lupa do CNPJ para
reimportar dados da Receita (preenche IBGE automaticamente). Salvar.
Certificado digital¶
Senha do certificado incorreta¶
Causa: a senha digitada no upload não bate com o .pfx.
Correção: reimportar o certificado com a senha correta. Se o cliente não
lembra, ele precisa gerar um certificado novo na AC.
Certificado vencido ou expirando em N dias¶
Causa: validade do A1 (12 meses).
Correção: cliente renova na AC emissora (Serasa, Certisign, SoluTI, etc.) e
sobe o novo .pfx em Configurações > Certificado.
Titular do certificado diferente da conta¶
Causa: o CNPJ/CPF do .pfx não bate com o da empresa logada.
Correção: no fluxo de upload, o app oferece atualizar a empresa (se ainda
não emitiu) ou criar nova conta para aquele titular. Orientar a escolha certa.
Emissão da NFS-e de locação¶
Rejeição do Padrão Nacional¶
Onde ver: a mensagem completa retornada pelo portal fica em
nfse.mensagem_retorno / nfse.erro_detalhe, e aparece na tela de resultado.
Passos gerais:
- Confirmar que o certificado A1 está válido (Configurações > Certificado).
- Conferir usuário/senha do Padrão Nacional (Configurações > Empresa, Configuração NFS-e) — testar o login no gov.br.
- Conferir o código IBGE do imóvel (local de incidência) e o tratamento tributário (CST/cClassTrib) do contrato.
Certificado A1 nao instalado. Carregue em Configuracoes > Certificado.¶
Causa: empresa sem certificado A1 (validação local, antes de chegar ao ADN).
Correção: enviar o .pfx em Configurações > Certificado.
Créditos esgotados na emissão¶
Causa: conta sem créditos disponíveis (plano + avulsos zerados). Correção: o app oferece upgrade de plano ou pacote avulso — orientar a recarga. O crédito é consumido por nota e não volta no cancelamento.
Produção libera em 01/12/2026
A emissão em produção só fica disponível a partir de 01/12/2026 (a NT 009 ainda não está liberada no ADN). Antes disso, a empresa deve estar em Homologação; se um cliente reclama que "não emite de verdade", confirme o ambiente e a data.
DANFSe / PDF¶
MissingPluginException: getTemporaryDirectory (Compartilhar)¶
Onde: versão web do app, ao clicar Compartilhar.
Causa: path_provider não tem implementação web.
Correção: usar a branch kIsWeb (abre WhatsApp Web com link do DANFSe).
Atualizar a versão web.
DANFSe com acentos quebrados ("Locação")¶
Causa: code page do processo do serviço de PDF em CP1252.
Correção: garantir SetMultiByteConversionCodePage(CP_UTF8) +
DefaultSystemCodePage := CP_UTF8 no serviço de geração do DANFSe. Atualizar o
binário.
Cobranças / Asaas¶
Webhook recebido mas plano não ativou¶
Causa: falha de assinatura HMAC ou asaas_customer_id divergente.
Como verificar: tabela log_webhook — coluna processado = false +
erro preenchido.
Correção: ver o erro logado e reprocessar manualmente.
Não achou seu erro aqui?
Antes de escalar, sempre coletar:
- Mensagem exata (print ou copy/paste).
- CNPJ/CPF da empresa afetada.
- Quando aconteceu (data/hora).
- Passos pra reproduzir (3 bullets).
Com isso na mão, abrir chamado interno via WhatsApp do dev.