Erros comuns¶
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 CNPJ.
Como verificar: SELECT * FROM empresa WHERE cnpj = '...'.
Correção: se for cliente legítimo querendo reativar, escalar para
admin para 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>.
Status: corrigido no backend após 2026-06-23. Se aparecer novamente,
checar logs do EmitamaisAPI procurando por cnaes_secundarios.
Falha na emissão: Nenhum provedor selecionado (NFS-e)¶
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 precisa renovar na AC emissora (Serasa, Certisign,
SoluTI, etc.) e subir o novo .pfx em Configurações > Certificado.
Emissão¶
Rejeição XXX: <mensagem> (NFC-e / NF-e)¶
Códigos comuns:
| Código | Mensagem (resumida) | Causa |
|---|---|---|
| 204 | Duplicidade de NF-e | Já existe nota com a mesma chave. Verificar histórico. |
| 215 | Falha schema XSD | Campo obrigatório faltando. Logar XML enviado. |
| 539 | Inconsistência CSC | CSC não cadastrado ou errado. Refazer cadastro. |
| 656 | Consumo indevido | Muitas requisições em curto tempo. Esperar 5 min. |
Geral: mensagem completa da SEFAZ está na coluna nfe.motivo ou
nfse.mensagem_retorno.
MEI + ISS retido rejeitado¶
Mensagem: "Não é permitido retenção do ISSQN para o prestador do serviço que seja MEI". Causa: o serviço estava configurado para reter ISS, mas o emitente é MEI. Correção: já tratada no backend após 2026-06-23 — backend ignora flag de retenção quando o emitente é MEI. Atualizar para versão >= junho/2026.
Erros de validação local (antes de chegar na SEFAZ)¶
Estes aparecem na hora, montados pelo próprio app — não são rejeição da SEFAZ:
| Mensagem | Causa | Correção |
|---|---|---|
Certificado A1 nao instalado. Carregue em Configuracoes > Certificado. |
Empresa sem certificado A1 | Enviar o .pfx em Configurações > Certificado |
CSC nao configurado em Configuracoes > Empresa. |
NFC-e sem ID/token de CSC | Cadastrar o CSC na aba Empresa |
Rejeicao: IE do destinatario nao informada |
Cliente PJ contribuinte sem inscrição estadual | Preencher a IE no cadastro do cliente (ou deixar vazio se não contribuinte) |
CPF/Razao social do cliente nao preenchido (NF-e) |
Cadastro de cliente incompleto | Completar CPF/CNPJ e nome do cliente |
Estorno fora do prazo¶
Mensagem (antiga): "Rejeicao: NF-e de devolucao de mercadoria nao possui
documento fiscal referenciado".
Causa: a NF-e de devolução (estorno) saía sem o grupo NFref/refNFe
apontando para a nota original.
Status: corrigido na versão oficial de 2026-08-06 — o estorno agora
monta a referência e a SEFAZ autoriza (Status 100). Se reaparecer, confirme
que o servidor está com o build atual (/health → campo build).
Corrigidos na versão oficial (2026-08-06)
Três problemas foram resolvidos e validados ao vivo nesta versão:
- Estorno de NFC-e/NF-e fora do prazo (faltava a referência à nota original).
- DANFSe que retornava erro 500 ao visualizar.
- Fuso: notas emitidas à noite sumiam do filtro do dia.
Se algum reaparecer, o primeiro passo é conferir o build no /health
do servidor — pode ser um deploy desatualizado.
DANFE / PDF¶
MissingPluginException: getTemporaryDirectory (Compartilhar)¶
Onde: versão web do app, ao clicar Compartilhar.
Causa: path_provider não tem implementação web.
Status: corrigido após 2026-06-23 — branch kIsWeb abre WhatsApp Web
com chave + link da SEFAZ. Atualizar versão web.
Error loading MIDAS.DLL¶
Onde: backend EmitamaisAPI.exe, ao gerar DANFSe.
Causa: midas.dll (Win64) não está ao lado do exe.
Correção: copiar de C:\Program Files (x86)\Embarcadero\Studio\22.0\Redist\win64\midas.dll
para a pasta do EmitamaisAPI.exe e reiniciar o processo.
DANFSe com acentos quebrados ("Lubrificação")¶
Causa: DefaultSystemCodePage do processo Horse em CP1252 + TStringField
AnsiString do TClientDataSet interno do ACBr.
Status: corrigido após 2026-06-23 — .dpr agora seta
SetMultiByteConversionCodePage(CP_UTF8) + DefaultSystemCodePage := CP_UTF8.
Atualizar EmitamaisAPI.exe.
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 erro logado e reprocessar manualmente.
Não achou seu erro aqui?
Antes de escalar, sempre coletar:
- Mensagem exata (print ou copy/paste).
- CNPJ da empresa afetada.
- Quando aconteceu (data/hora).
- Passos pra reproduzir (3 bullets).
Com isso na mão, abrir chamado interno via WhatsApp do dev.