Pular para conteúdo

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:

  1. Confirmar que o certificado A1 está válido (Configurações > Certificado).
  2. Conferir usuário/senha do Padrão Nacional (Configurações > Empresa, Configuração NFS-e) — testar o login no gov.br.
  3. 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:

  1. Mensagem exata (print ou copy/paste).
  2. CNPJ/CPF da empresa afetada.
  3. Quando aconteceu (data/hora).
  4. Passos pra reproduzir (3 bullets).

Com isso na mão, abrir chamado interno via WhatsApp do dev.