Suporte
Última atualização:
Quem responde suporte aqui é quem escreveu a API. Antes de abrir chamado, vale checar os quatro itens abaixo — resolvem a maior parte dos casos em menos tempo do que leva para escrever a mensagem.
1. A emissão parou: é a SEFAZ ou é você?
Comece por /status. A grade mostra cada autorizador por UF e por documento, com histórico — são 177 alvos verificados a cada 5 minutos. Se o autorizador da sua UF está vermelho, o problema não é seu.
Para automatizar essa checagem antes de disparar um lote, use /status.json — é público, tem cache de 60 segundos e não consome requisição da sua conta.
2. A SEFAZ rejeitou o documento
Rejeição vem com o código e a mensagem do órgão dentro do envelope, no campo
error. Ela significa que o documento chegou e foi analisado — a
correção é no conteúdo, não na integração. As causas mais comuns:
- CFOP incompatível com a operação — confira em /cfop.
- NCM inválido ou inexistente — confira em /ncm (11.093 códigos).
- Inscrição estadual do destinatário irregular ou ausente quando exigida.
- Numeração já usada ou fora de sequência após migração — informe o último número ao cadastrar a empresa.
- Certificado vencido. O painel avisa antes, na tela da empresa.
3. Erro de autenticação ou de limite
| Status | O que significa | O que fazer |
|---|---|---|
401 | Token ausente, inválido ou revogado | Confira o header Authorization: Bearer …. Token regenerado invalida o anterior. |
403 | Produto não vinculado à empresa | Ative o produto para aquele CNPJ no painel, ou por POST /v1/empresas/{id}/produtos/{codigo}. |
422 | Corpo incompleto ou inválido | A mensagem indica o campo. Nada é cobrado nesse caso. |
429 | Limite de requisições atingido | Aguarde o intervalo indicado. Precisa de limite maior? Peça — a gente ajusta. |
A lista completa de códigos está na documentação.
4. Minha cidade emite NFS-e pelo nacional?
Consulte em cobertura NFS-e: são 5.571 municípios na base, com a situação de cada um. Município que não aderiu ao Emissor Nacional não pode ser atendido pelo padrão nacional — nesse caso a emissão depende do sistema da prefeitura.
Ainda precisa de gente
Já sou cliente
Abra chamado pelo painel: o histórico fica junto da conta e tem prioridade.
Abrir chamado →Ainda não tenho conta
Dúvida técnica antes de assinar? Escreva — respondemos igual.
[email protected]Para o chamado andar rápido
Mande junto, sempre que possível:
- A rota chamada e o método (ex.:
POST /v1/nfe/emitir). - O corpo enviado, sem o token e sem a senha do certificado.
- A resposta completa, incluindo o campo
error. - O CNPJ da empresa envolvida e o horário aproximado.
Com isso a gente localiza a requisição no registro e responde com a causa — sem o vai e vem de "pode mandar um exemplo?".