Erros comuns para transmissão de notas no portal nacional
Visão geral
Este conteúdo detalha o tratamento e a solução dos erros comuns para transmissão de notas no portal nacional, focando em fornecer uma orientação clara e prática para a execução correta da rotina de faturamento no sistema Superlógica Imobiliárias.
Quando usar este artigo
Utilize este guia sempre que encontrar inconsistências ou rejeições no lote de notas fiscais ao realizar a transmissão para o Portal Nacional da NFS-e ou quando encontrar dúvidas sobre as regras de negócio e validações fiscais associadas a este procedimento.
Sintoma ou cenário
O usuário tenta transmitir as notas fiscais de comissão da imobiliária (taxa de administração) e o sistema retorna mensagens de erro ou códigos de rejeição impeditivos (como GW3000, GW3001, E351, E0038, E0039) na central de notas.
Benefício para o usuário ou operação
Resolução ágil de falhas na emissão de NFS-e do faturamento de comissões.
Eliminação de inconsistências nos arquivos enviados para o Fisco Nacional.
Maior agilidade e autonomia na gestão financeira e fiscal de locações da imobiliária.
Onde acessar / contexto de uso
Acesse o gerenciador de notas fiscais em Receitas > Notas Fiscais ou as parametrizações tributárias da empresa no menu Empresa > Tributação.
Pré-requisitos (Antes de começar)
Perfil Exato: Permissões de escrita e gestão no módulo Contas a Receber e Faturamento Fiscal.
Recursos Sistêmicos: Módulo de emissão de Nota Fiscal ativo na licença Superlógica Imobiliárias.
Insumos e Dados Técnicos: Confirmação da adesão do município ao Portal Nacional da NFS-e e dados do contrato de locação com repasse devidamente liquidado.
Causas prováveis
Tentativa de envio de notas com códigos de tributação, NBS ou tributos incompletos ou fora do padrão de formatação exigido pelo Portal Nacional.
Emissão de notas fiscais retroativas com data de competência anterior à adesão do município ao sistema nacional (competências em 2025 ou anteriores).
Configuração do sistema apontando para o Portal Nacional em municípios que ainda utilizam webservices locais e não migraram oficialmente.
Como fazer ou corrigir
Este artigo orienta sobre erros comuns na emissão de NFS-e para municípios que migraram ao Portal Nacional. Não se aplica a emissores municipais próprios.
Antes de analisar o erro
Confirme a Adesão do Município: Confirme se o seu município aderiu ao Portal Nacional consultando sua contabilidade ou o portal oficial do Governo Federal. Caso o município não tenha aderido, a emissão deve permanecer no emissor municipal próprio.
Regra de Competência Retroativa: O Portal Nacional não aceita notas com competência até 31/12/2025. Dessa forma, notas retroativas devem ter a data de emissão ajustada para 01/2026 e seus impactos contábeis devem ser avaliados previamente com a contabilidade da imobiliária.
Erros mais comuns e como solucionar
| Código do Erro | Mensagem no Sistema | Causa mais comum | Como solucionar |
| GW3000 | Código de tributação informado é inválido | Código de serviço não preenchido ou fora do formato estipulado. | Valide o código com sua contabilidade. O campo Código Complementar Municipal deve ter exatamente 9 dígitos numéricos (sem pontos ou traços). |
| GW3001 | É necessário informar o percentual aproximado de tributos da nota | Faltam os percentuais de impostos detalhados por âmbito. | Acesse o menu Empresa > Tributos e preencha os percentuais de tributos por tipo (Municipal, Estadual e Federal). |
| E351 | Código NBS não informado | Campo de Nomenclatura Brasileira de Serviços vazio. | Acesse Empresa > Tributação, edite o serviço e preencha o código NBS de preenchimento obrigatório. |
| E0038 | Convênio do município não está ativo | Tentativa de emissão com competência retroativa ($\le$ 31/12/2025). | Altere a data de emissão para 01/2026 no cadastro do faturamento. |
| E0039 | Município não parametrizado para emissor nacional | O município da imobiliária não aderiu ao Portal Nacional. | Seu município não optou por realizar a emissão pelo portal nacional; retorne as configurações de envio para o emissor municipal. |
Antes de analisar o erro
- Confirme se o município aderiu ao portal nacional consultando sua contabilidade ou este link Caso não tenha aderido, a emissão deve permanecer no emissor municipal.
- O portal nacional não aceita notas com competência até 31/12/2025, dessa forma, notas retroativas devem ter a data de emissão ajustada para 01/2026e seus impactos contábeis devem ser avaliados com a contabilidade do cliente.
Resultado esperado
Ao concluir as correções indicadas, a transmissão executada em Receitas > Notas Fiscais processará as notas fiscais de comissão com sucesso, alterando o status do lote para transmitido/autorizado com total transparência.
Quando escalar
Escalone o chamado para o suporte técnico do Superlógica Imobiliárias caso o sistema apresente mensagens de erro de schema XML impeditivas ou se o comportamento de rejeição persistir na tela de emissão mesmo após a validação de todos os códigos de 9 dígitos, NBS e ajuste da data de emissão para 2026.
Informações para escalonamento
Print da tela do erro técnico exibido no log de transmissão.
ID da licença da imobiliária e ID do contrato de locação/repasse afetado.
Código e mensagem exata retornados pelo webservice.
Data e hora da tentativa de envio.
Regras importantes / Observações
Base de Cálculo da Nota Fiscal: A nota emitida no Superlógica refere-se estritamente à comissão da imobiliária (taxa de administração) e não ao valor bruto do aluguel pago pelo inquilino.
Transmissão Obrigatoriamente Manual: A geração interna da nota fiscal pode ocorrer automaticamente após a liquidação do repasse (recurso exclusivo a partir do plano Enterprise), porém a transmissão do lote para a prefeitura/portal é sempre um procedimento manual executado pelo operador em Receitas > Notas Fiscais.
Dependência do Repasse: A nota fiscal só estará disponível para processamento e geração no sistema após o repasse do proprietário ter sido liquidado no financeiro em Despesas > Repasses.
Problemas comuns e como resolver
Problema: A nota fiscal referente à taxa de administração do repasse não aparece disponível na tela de transmissão.
Causa provável: O repasse ao proprietário ainda não foi baixado/liquidado no módulo financeiro ou o contrato está configurado como "não emite nota fiscal".
Ação recomendada: Acesse Despesas > Repasses, efetue a liquidação do repasse e confirme no menu Contrato > Contrato (aba Tributação) se a opção "vai emitir nota fiscal" está habilitada.
Dúvidas relacionadas (FAQ)
P: É possível programar o envio das notas fiscais para o Portal Nacional de forma 100% automática?
R: Não. Embora a geração interna da nota fiscal possa ser automatizada após a liquidação do repasse no plano Enterprise, a transmissão oficial do lote para a prefeitura ou Portal Nacional exige sempre a ação manual do usuário em Receitas > Notas Fiscais.
P: Por que notas com competência de 2025 apresentam erro de convênio não ativo (E0038) no Portal Nacional?
R: O Portal Nacional da NFS-e não aceita recepção de notas fiscais com competência igual ou anterior a 31/12/2025. Nesses casos, ajuste a data de emissão para a partir de 01/2026 e avalie os impactos contábeis com o seu contador.
Palavras-chave de busca
erros comuns para transmissão de notas no portal nacional, suporte superlógica imobiliárias, ajuda, manual, base de conhecimento, erros nfs-e portal nacional, gw3000, e351, e0038, comissao imobiliaria nota fiscal.