Pular para o conteúdo principal

Como corrigir o erro de esquema RNG9997 (Endereço Incompleto) na emissão de NFS-e no ERP

Visão geral

Instrui operadores de imobiliárias e analistas fiscais a corrigir a falha de validação XML RNG9997 gerada pelo webservice da prefeitura ao tentar transmitir lotes de Notas Fiscais de Serviço Eletrônica (NFS-e) referentes à taxa de administração imobiliária. O erro indica que as tags obrigatórias de logradouro, número, bairro ou CEP do tomador do serviço (proprietário ou locatário) estão vazias ou fora da formatação padrão do município.

Quando usar este artigo

Utilize este artigo quando a transmissão do lote de notas fiscais for rejeitada pela prefeitura com a mensagem: "Erro: Código: RNG9997 Descrição: Erro de esquema. cvc-complex-type.2.4.b: O conteúdo do elemento 'end' não está completo".

Sintoma ou cenário

  • Na tela de Transmissão de Notas Fiscais (Empresa > Nota Fiscal), as notas da competência ficam com status vermelho "Rejeitada pela prefeitura".
  • Ao clicar no ícone de detalhes da nota rejeitada, o sistema retorna a falha técnica de validação de schema XML no elemento <end> (endereço).

Benefício para o usuário ou operação

Regulariza imediatamente o faturamento fiscal da imobiliária, evita multas municipais por atraso de escrituração de NFS-e e desobstrui a transmissão em lote das demais notas fiscais do mês.

Onde acessar / contexto de uso

ERP Superlógica Imobiliárias > Menu Empresa > Nota Fiscal > aba Transmissão de notas fiscais; e menu Cadastros > Proprietários / Locatários.

Pré-requisitos (Antes de começar)

  • Usuário com permissão fiscal ou administrativa no ERP.
  • Identificação do número do RPS ou nome do tomador apontado com erro na listagem de transmissão.
  • Endereço completo e comprovado (com CEP válido consultado nos Correios) do cliente tomador.

Causas prováveis

  1. Cadastro de proprietário ou locatário preenchido sem o número do imóvel (campo em branco ou preenchido com "S/N" em prefeituras que exigem numérico).
  2. Campo de CEP contendo caracteres especiais, traços ou incompleto (menos de 8 dígitos).
  3. Campo de Bairro ou Município em branco no cadastro do tomador da comissão.
  4. Município selecionado com código IBGE desatualizado ou divergente do CEP.

Como fazer ou corrigir

  1. Identificar o Tomador com Inconsistência:
  2. Acesse o menu Empresa > Nota Fiscal.
  3. Na aba Transmissão de notas fiscais, localize a nota rejeitada com o código RNG9997.
  4. Clique sobre a linha da nota e identifique o campo "Tomador do Serviço" (Nome e CPF/CNPJ do proprietário/locatário).
  5. Corrigir o Endereço no Cadastro:
  6. Se o tomador for o proprietário: acesse o menu Cadastros > Proprietários.
  7. Pesquise pelo nome ou CPF e clique no ícone de lápis para editar o cadastro.
  8. Navegue até a aba Endereço:
    • Preencha o CEP e clique no botão de lupa para buscar o logradouro oficial.
    • Certifique-se de que o campo Número não esteja em branco. Caso seja sem número, insira 0 ou SN conforme padrão aceito pela sua prefeitura.
    • Preencha obrigatoriamente o campo Bairro (não deixe espaço em branco).
    • Confirme Estado (UF) e Cidade.
  9. Clique em Salvar alterações.
  10. Atualizar a Nota Fiscal no Módulo Fiscal:
  11. Retorne ao menu Empresa > Nota Fiscal.
  12. Localize a nota rejeitada, clique no botão de opções (...) e selecione Recalcular dados da nota ou Atualizar dados do tomador.
  13. O ERP carregará o novo endereço cadastral para dentro da estrutura do RPS pendente.
  14. Reenviar a Nota Fiscal:
  15. Selecione a nota fiscal corrigida (ou marque o lote todo).
  16. Clique no botão superior Transmitir notas.
  17. Aguarde o retorno do webservice da prefeitura (status mudará para verde: "Autorizada / Emitida").

Resultado esperado

O arquivo XML é gerado em conformidade com o XSD da prefeitura, o lote é transmitido com sucesso e a nota fiscal recebe o número oficial de autenticação da NFS-e.

Quando escalar

Escalar para o N2 Técnico / Fiscal quando todos os campos de endereço estiverem rigorosamente preenchidos e válidos, mas a prefeitura continuar recusando o elemento <end>, o que pode indicar alteração de layout no provedor municipal (ex: Ginfes, Betha, IPM, ISSNet).

Informações para escalonamento

  • Licença da imobiliária (imobXXXXXX).
  • ID da Nota Fiscal / RPS.
  • Nome e documento do tomador.
  • Cidade da prefeitura emissora e print da tela de erro completa.

Regras importantes / Observações

Nunca exclua a nota fiscal rejeitada se a cobrança do contrato já foi liquidada; utilize sempre a função de reprocessamento/atualização cadastral para manter a integridade com o financeiro.

Problemas comuns e como resolver

  • A nota continua rejeitada após salvar o endereço: O operador salvou o cadastro, mas não clicou em "Atualizar dados do tomador" na nota fiscal. A nota gerada anteriormente mantém os dados em cache até ser atualizada.

Dúvidas relacionadas (FAQ)

  • P: A prefeitura aceita 'S/N' no número?
    R: Algumas prefeituras rejeitam texto no campo número do XML. Em caso de recusa com "S/N", informe o número 0 no cadastro e transmita novamente.
  • P: O erro bloqueia as outras notas do mês?
    R: Sim, se a transmissão for feita por lote fechado. Corrigir a nota rejeitada libera a fila inteira.

Palavras-chave de busca

RNG9997, erro de esquema, elemento end, nota fiscal rejeitada, nfs-e imobiliarias, endereco incompleto nf, falha prefeitura superlógica.