NOTA FISCAL DE SERVIÇOS
ELETRÔNICA (NFS-e)
Manual de Utilização do Web Service
(Modelo Nacional – Versão 2.03)
Sistema desenvolvido por Tiplan Tecnologia em Sistema de Informação. Todos os direitos reservados.
http://www.tiplan.com.br
Página 2 de 16
NOTA FISCAL DE SERVIÇO
ELETRÔNICA (NFS-e)
Índice
Índice ............................................................................................................................................................................ 2
1. Introdução ............................................................................................................................................................ 3
2. Serviços Disponíveis .......................................................................................................................................... 4
2.1. Serviços do Modelo Nacional ......................................................................................................................... 4
2.1.1. Enviar Lote de RPS Síncrono ................................................................................................................. 4
2.1.2. Recepção e Processamento de Lote de RPS ........................................................................................ 4
2.1.3. Consulta de Lote de RPS ....................................................................................................................... 4
2.1.4. Consulta de NFS-e por RPS ................................................................................................................... 4
2.1.5. Consulta de NFS-e por Faixa ................................................................................................................. 4
2.1.6. Consulta de NFS-e - Serviços Tomados ou Intermediados ................................................................... 5
2.1.7. Consulta de NFS-e – Serviços Prestados .............................................................................................. 5
2.1.8. Geração de NFS-e .................................................................................................................................. 6
2.1.9. Cancelamento de NFS-e ........................................................................................................................ 6
2.1.10. Substituição de NFS-e ............................................................................................................................ 6
3. Especificações Técnicas .................................................................................................................................... 7
3.1.1 Modelo Nacional ............................................................................................................................................. 7
3.1.2 Endereço do WebService – Homologação .................................................................................................... 7
3.1.3 Endereço do WebService............................................................................................................................... 7
3.1.4 Interfaces do WebService (WSDL) ................................................................................................................ 7
3.1.5 Tamanho Máximo das Mensagens XML ........................................................................................................ 7
3.1.6 Schemas XML ................................................................................................................................................ 8
3.1.7 Exemplos ........................................................................................................................................................ 8
3.1.8 Exemplo de assinatura digital da mensagem XML ........................................................................................ 8
3.1.9 Exemplo de assinatura digital de elementos XML ......................................................................................... 9
4. Códigos de Cancelamento, Erros e Alertas ...................................................................................................12
4.1. Códigos de Cancelamento de NFS-e (exclusivo desde Município) .............................................................12
4.2. Relação de Erros (exclusivo desde Município) ............................................................................................12
4.3. Relação de Alertas (exclusivo desde Município) .........................................................................................15
5. Criando um link para a NFS-e Emitida ............................................................................................................16
Revisado em 23/08/2022
Página 3 de 16
NOTA FISCAL DE SERVIÇO
ELETRÔNICA (NFS-e)
1. Introdução
Este manual tem como objetivo apresentar a definição das especificações e critérios técnicos necessários para
utilização do Web Service do Sistema de Nota Fiscal de Serviços Eletrônica (NFS-e) disponibilizado pela
Prefeitura para as empresas prestadoras e/ou tomadoras de serviços.
Através do Web Service disponibilizado, as empresas podem integrar seus próprios sistemas de informações com
o Sistema de NFS-e da Prefeitura. Desta forma, consegue-se automatizar o processo de emissão, consulta e
cancelamento de NFS-e.
O Web Service e todos os seus serviços, referenciados nesse documento, são baseados no modelo nacional de
NFS-e, definido pela Associação Brasileira de Secretários e Dirigentes das Finanças dos Municípios das Capitais
(ABRASF) e pela Receita Federal do Brasil (RFB).
Revisado em 23/08/2022
Página 4 de 16
NOTA FISCAL DE SERVIÇO
ELETRÔNICA (NFS-e)
2. Serviços Disponíveis
2.1. Serviços do Modelo Nacional
A seguir estão resumidos os serviços disponibilizados pelo WebService visando automatizar o processo de
emissão, consulta e cancelamento de Notas Fiscais de Serviços Eletrônicas (NFS-e). Todos os serviços exigem o
uso de certificados digitais ICP-Brasil para autenticação.
ATENÇÃO!
A descrição completa destes métodos pode ser obtida diretamente do Manual de Integração da ABRASF:
https://nfse.niteroi.rj.gov.br/files/manuais/nfse_abrasf.pdf
2.1.1. Enviar Lote de RPS Síncrono
Esse serviço compreende a recepção do Lote de RPS. Quando efetuada a recepção, o Lote será
processado e serão feitas as validações necessárias e geração das NFS-e.
2.1.2. Recepção e Processamento de Lote de RPS
Esse serviço compreende a recepção do Lote de RPS, a resposta com o número do protocolo gerado
para esta transação e o processamento do lote. Quando efetuada a recepção, o Lote entrará na fila para
processamento posterior quando serão feitas as validações necessárias e geração das NFS-e.
2.1.3. Consulta de Lote de RPS
Esse serviço permite ao contribuinte obter as NFS-e que foram geradas a partir do Lote de RPS enviado,
quando o processamento ocorrer sem problemas; ou obter a lista de erros e/ou inconsistências
encontradas no Lote de RPS enviado.
Na validação do lote, são retornados todos os erros verificados. Excepcionalmente, havendo uma
excessiva quantidade de erros, poderá ser definido um limitador para a quantidade de erros retornados.
2.1.4. Consulta de NFS-e por RPS
Esse serviço efetua a consulta de uma NFS-e a partir do número de RPS que a gerou.
2.1.5. Consulta de NFS-e por Faixa
Esse serviço permite a obtenção de determinadas NFS-e já geradas, informando a faixa na qual se
encontram.
Revisado em 23/08/2022
Página 5 de 16
NOTA FISCAL DE SERVIÇO
ELETRÔNICA (NFS-e)
2.1.6. Consulta de NFS-e - Serviços Tomados ou Intermediados
Esse serviço permite a obtenção de determinadas NFS-e já geradas, informando os dados do
consulente, tomador/intermediário de serviços e os dados da NFS-e conforme estrutura definida na
tabela que segue.
2.1.7. Consulta de NFS-e – Serviços Prestados
Esse serviço permite a obtenção de determinada NFS-e já gerada, informando os dados do prestador de
serviço e os dados da NFS-e conforme estrutura definida na tabela que segue.
Revisado em 23/08/2022
Página 6 de 16
NOTA FISCAL DE SERVIÇO
ELETRÔNICA (NFS-e)
2.1.8. Geração de NFS-e
Esse serviço compreende a recepção do RPS. Quando efetuada a recepção, e serão feitas as
validações necessárias do RPS e geração das NFS-e
2.1.9. Cancelamento de NFS-e
Esse serviço permite o cancelamento direto de uma NFS-e sem substituição da mesma por outra.
Veja no item 4.1 os códigos de cancelamento disponíveis.
2.1.10. Substituição de NFS-e
Esse serviço permite o cancelamento de uma NFS-e com sua substituição por outra.
Revisado em 23/08/2022
Página 7 de 16
NOTA FISCAL DE SERVIÇO
ELETRÔNICA (NFS-e)
3. Especificações Técnicas
3.1.1 Modelo Nacional
O Modelo Nacional de NFS-e, elaborado pela ABRASF em conjunto com a Receita Federal, descreve a
arquitetura de comunicação com o contribuinte e a estrutura de dados utilizada pelo WebService, detalhando: os
conceitos, premissas e regras de negócios envolvidas; as funcionalidades e os serviços disponibilizados; os
padrões técnicos de comunicação, certificação e assinatura digital; a estrutura, esquema e validação das
mensagens XML; o modelo conceitual e operacional de uso dos WebServices; os formatos e padrões adotados e;
os tipos simples e complexos utilizados.
O documento descritivo do modelo nacional – Modelo de Integração - pode ser obtido através do endereço
eletrônico:
https://nfse.niteroi.rj.gov.br/files/manuais/nfse_abrasf.pdf
3.1.2 Endereço do WebService – Homologação
A Prefeitura disponibiliza um ambiente para testes. Esse ambiente possui as mesmas validações do ambiente de
produção (item 3.1.3). O endereço eletrônico do WebService de homologação é:
https://niteroihomologacao.nfe.com.br/nfse/WSNacional2/nfse.asmx
3.1.3 Endereço do WebService
O endereço eletrônico do WebService disponibilizado pela Prefeitura é:
https://nfse.niteroi.rj.gov.br/nfse/WSNacional2/nfse.asmx
ATENÇÃO: Para acessar este endereço e utilizar o WebService, é necessário se autenticar usando certificado
digital ICP-Brasil, conforme explicado no Manual Nacional do Modelo de Integração. As assinaturas digitais do
RPS, do Lote de RPS e/ou do Cancelamento da NFS-e são OPCIONAIS, ficando a critério do contribuinte sua
assinatura (ou não).
3.1.4 Interfaces do WebService (WSDL)
As especificações de interface do WebService (WSDL) podem ser obtidas, mediante o uso de certificados digitais
ICP-Brasil, através do endereço eletrônico:
https://nfse.niteroi.rj.gov.br/nfse/WSNacional2/nfse.asmx?wsdl
3.1.5 Tamanho Máximo das Mensagens XML
O tamanho máximo permitido para o envio de mensagens XML pelo webservice é de 512 KB
Revisado em 23/08/2022
Página 8 de 16
NOTA FISCAL DE SERVIÇO
ELETRÔNICA (NFS-e)
3.1.6 Schemas XML
Todos os schemas XML utilizados pelo WebService podem ser obtidos no endereço eletrônico:
https://nfse.niteroi.rj.gov.br/App_Themes/Niteroi/WSNacional/schemas.zip
3.1.7 Exemplos
Diversos exemplos de mensagens XML (pedido e retorno) de cada um dos métodos disponibilizados podem ser
obtidos no endereço eletrônico:
https://nfse.niteroi.rj.gov.br/App_Themes/Niteroi/WSNacional/exemplos.zip
3.1.8 Exemplo de assinatura digital da mensagem XML
As mensagens enviadas ao Sistema de Nota Fiscal de Serviço Eletrônica da Prefeitura deste Município são
documentos eletrônicos elaborados no padrão XML e podem (opcionalmente) ser assinados digitalmente
utilizando certificado digital.
''' <summary>
''' Exemplo de como assinar uma mensagem XML com um certificado digital.
''' Linguagem: VB.NET
''' Framework: 3.5
''' </summary>
''' <param name="mensagemXML">String contendo a própria mensagem XML</param>
''' <param name="certificado">O certificado que será usado para assinar
''' a mensagam XML</param>
''' <returns>Um objeto do tipo XmlDocument já assinado</returns>
''' <remarks></remarks>
Private Function Assinar(ByVal mensagemXML As String, _
ByVal certificado As _
System.Security.Cryptography.X509Certificates.X509Certificate2) _
As XmlDocument
Dim xmlDoc As New System.Xml.XmlDocument()
Dim Key As New System.Security.Cryptography.RSACryptoServiceProvider()
Dim SignedDocument As System.Security.Cryptography.Xml.SignedXml
Dim keyInfo As New System.Security.Cryptography.Xml.KeyInfo()
xmlDoc.LoadXml(mensagemXML)
'Retira chave privada ligada ao certificado
Key = CType(certificado.PrivateKey, _
System.Security.Cryptography.RSACryptoServiceProvider)
'Adiciona Certificado ao Key Info
keyInfo.AddClause(New _
System.Security.Cryptography.Xml.KeyInfoX509Data(certificado))
Revisado em 23/08/2022
Página 9 de 16
NOTA FISCAL DE SERVIÇO
ELETRÔNICA (NFS-e)
SignedDocument = New System.Security.Cryptography.Xml.SignedXml(xmlDoc)
'Seta chaves
SignedDocument.SigningKey = Key
SignedDocument.KeyInfo = keyInfo
' Cria referencia
Dim reference As New System.Security.Cryptography.Xml.Reference()
reference.Uri = String.Empty
' Adiciona transformacao a referencia
reference.AddTransform(New _
System.Security.Cryptography.Xml.XmlDsigEnvelopedSignatureTransform())
reference.AddTransform(New _
System.Security.Cryptography.Xml.XmlDsigC14NTransform(False))
' Adiciona referencia ao xml
SignedDocument.AddReference(reference)
' Calcula Assinatura
SignedDocument.ComputeSignature()
' Pega representação da assinatura
Dim xmlDigitalSignature As System.Xml.XmlElement = SignedDocument.GetXml()
' Adiciona ao doc XML
xmlDoc.DocumentElement.AppendChild(xmlDoc.ImportNode(xmlDigitalSignature, True))
Return xmlDoc
End Function
3.1.9 Exemplo de assinatura digital de elementos XML
Alguns dos elementos no documento xml podem (opcionalmente) ser assinados individualmente. Veja abaixo um
exemplo de como assinar digitalmente esses elementos:
Imports System.Xml
Imports System.Security.Cryptography
Imports System.Security.Cryptography.Xml
Imports System.Security.Cryptography.X509Certificates
...
''' <summary>
''' Exemplo de como assinar elementos de um documento XML com um certificado digital.
''' Linguagem: VB.NET
''' Framework: 3.5
''' </summary>
''' <param name="Document">
Revisado em 23/08/2022
Página 10 de 16
NOTA FISCAL DE SERVIÇO
ELETRÔNICA (NFS-e)
''' O documento que contem os elementos que devem ser assinados
''' </param>
''' <param name="ParentElementName">O elemento que contem as tags a serem assinadas
''' Ex.:
''' Para assinar o rps em um lote o ParentElementName = "Rps"
''' Para assinar o pedido do lote de rps o ParentElementName = "EnviarLoteRpsEnvio"
''' </param>
''' <param name="ElementName">O elemento (tag) que será assinado
''' Ex.:
''' Para assinar o rps em um lote o ElementName = "InfRps"
''' Para assinar o pedido do lote de rps o ElementName = "LoteRps"
''' </param>
''' <param name="AttributeName">
''' O nome do atributo do elemento que será assinado
''' Obs.:
''' Por padrão o NOME do atributo possui a mesma identificação.
''' AtributeName = "Id"
''' </param>
Public Sub AssinarElementos(ByVal Document As XmlDocument, _
ByVal x509 As X509Certificate2, _
ByVal ParentElementName As String, _
ByVal ElementName As String, _
ByVal AttributeName As String)
Dim el As XmlElement
Dim elInf As XmlElement
Dim elInfID As String
Dim elSigned As SignedXml
Dim Key As RSACryptoServiceProvider
Dim keyInfo As New KeyInfo
'Retira chave privada ligada ao certificado
Key = CType(x509.PrivateKey, RSACryptoServiceProvider)
'Adiciona Certificado ao Key Info
keyInfo.AddClause(New KeyInfoX509Data(x509))
For Each el In Document.GetElementsByTagName(ParentElementName)
elInf = _
Revisado em 23/08/2022
Página 11 de 16
NOTA FISCAL DE SERVIÇO
ELETRÔNICA (NFS-e)
CType(el.GetElementsByTagName(ElementName)(el.GetElementsByTagName(ElementName).Count - 1), _
XmlElement)
elInfID = elInf.Attributes.GetNamedItem(AttributeName).Value
elSigned = New SignedXml(elInf)
'Seta chaves
elSigned.SigningKey = Key
elSigned.KeyInfo = keyInfo
' Cria referencia
Dim reference As New Reference()
reference.Uri = "#" & elInfID
' Adiciona tranformacao a referencia
reference.AddTransform(New XmlDsigEnvelopedSignatureTransform())
reference.AddTransform(New XmlDsigC14NTransform(False))
' Adiciona referencia ao xml
elSigned.AddReference(reference)
' Calcula Assinatura
elSigned.ComputeSignature()
'Adiciona assinatura
el.AppendChild(Document.ImportNode(elSigned.GetXml(), True))
Next
End Sub
...
End Class
Revisado em 23/08/2022
Página 12 de 16
NOTA FISCAL DE SERVIÇO
ELETRÔNICA (NFS-e)
4. Códigos de Cancelamento, Erros e Alertas
As tabelas a seguir, relacionam os erros, alertas e procedimentos específicos do município na substituição do
Recibo Provisório de Serviços - RPS por NFS-e através de arquivo XML. Consulte o manual da Abrasf para obter
os demais códigos de erros e alertas utilizados:
https://nfse.niteroi.rj.gov.br/files/manuais/nfse_abrasf.pdf
4.1. Códigos de Cancelamento de NFS-e (exclusivo desde Município)
# Códigos de Cancelamento
1 Erro na emissão (Uso exclusivo para substituição de NFS-e)
2 Serviço não prestado
4 Duplicidade da nota
4.2. Relação de Erros (exclusivo desde Município)
CÓD. MENSAGEM SOLUÇÃO
CPF/CNPJ do Tomador de Serviços
inválido / CNPJ do Tomador de Serviços
inválido (dígitos verificadores não
902 conferem) / Dígitos verificadores do CPF Verifique o CPF/CNPJ preenchido.
do Tomador de Serviços não conferem.
Não haverá geração de crédito.
O Valor dos serviços deverá ser superior
903 Preencha um valor superior a R$0,00.
a R$ 0,00 (zero)
<<Atividade>> não está disponível para
906 Preencha o campo com outra atividade.
emissão
<<Atividade>> da NFS-e não está Preencha o campo com uma atividade cadastrada para o
907
cadastrada para o prestador de serviço prestador de serviço.
<< Atividade >> da NFS-e não permite
dedução na base de cálculo ou Preencha o campo dedução com 0 / valor inferior ao <<Valor>>
908 << Atividade >> da NFS-e não permite Ou
dedução na base de cálculo superior a Altere a atividade informada para uma que permita dedução.
<< Valor >>
910 <<Atividade>> da NFS-e não informado Preencha a atividade.
Retenções de Tributos Federais só
916 podem ser efetuados por Tomadores Preencha os Tributos Federais com 0.
pessoa jurídica (CNPJ).
Campo Endereço não preenchido
917 Preencha o endereço.
(obrigatório para tomador com CNPJ)
Campo Cidade/UF não preenchido
918 Preencha a Cidade/UF.
(obrigatório para tomador com CNPJ)
Inscrição Municipal do Tomador de
919 Serviços não cadastrada na base de Não preencha a Inscrição Municipal do Tomador de Serviços.
dados de dados da Prefeitura
Revisado em 23/08/2022
Página 13 de 16
NOTA FISCAL DE SERVIÇO
ELETRÔNICA (NFS-e)
CÓD. MENSAGEM SOLUÇÃO
O valor da alíquota informada para
<<Atividade>> deve ser igual a
927 Preencha a alíquota com o <<Valor>>
<<Valor>>
O valor da alíquota informada para a
<<atividade>> deve ser superior (ou
Preencha a alíquota com um valor superior a <<valor mínimo>>
928 igual) a <<valor mínimo>> ou inferior (ou
e inferior a <<valor máximo>
igual) a <<valor máximo>>
Retenção de ISS não permitida, pois o
929 tomador de serviços informado é o Preencha o campo Retenção de ISS com 2 (Não Retido).
próprio prestador.
Esta NFS-e deverá ter o ISS Retido pelo
930 Tomador dos Serviços. Selecione ISS Preencha o campo Retenção de ISS com 1 (ISS Retido)
Retido = SIM.
Esta NFS-e não deverá ter o ISS Retido
931 pelo Tomador dos Serviços. Selecione Preencha o campo Retenção de ISS com 2 (Não Retido).
ISS Retido = NÃO.
Diversas: Erro informando o motivo da
A NFS-e não poderá ser substituída devido ao motivo
941 não permissão de substituição de uma
especificado na mensagem.
NFS-e.
Código do Serviço da NFS-e não é um
942 Verifique se o código de serviço foi digitado corretamente,
serviço emitente de NFS-e.
Código do Serviço da NFS-e não Altere o código de serviço ou preencha o desconto condicionado
943
permite desconto condicionado. com 0 (zero).
Código do Serviço da NFS-e não Altere o código de serviço ou preencha o desconto
944
permite desconto incondicionado incondicionado com 0 (zero).
Código do Serviço da NFS-e não aceita Altere o código de serviço ou não preencha as informações de
945
informações de construção civil. construção civil.
Código do Serviço da NFS-e não aceita Altere o código de serviço ou não preencha as informações de
946
informações de intermediário de serviço intermediário de serviço.
Notas emitidas por optantes do MEI não
947 Preencha a opção de retenção com o valor 2 (não).
podem sofrer retenção.
Notas emitidas por prestadores que
948 recolhem ISS Fixo não podem sofrer Preencha a opção de retenção com o valor 2 (não).
retenção.
Notas emitidas para autônomos, não
949 Preencha a opção de retenção com o valor 2 (não).
podem ser retidas.
O RPS não pode ser convertido mais de uma vez. Remova este
950 O RPS X já foi substituído pela NFS-e Y.
RPS do arquivo XML.
O valor da soma das deduções e
951 descontos deverá ser inferior ao valor Verifique o valor das deduções e descontos.
dos serviços.
A alíquota informada na NFS-e é
diferente da cadastrada no Perfil da
955 Corrija a alíquota da NFS-e ou atualize a alíquota do Perfil.
Empresa. Corrija a alíquota da NFS-e ou
atualize a alíquota do Perfil.
Contribuintes com regime especial de
tributação "Microempresário Individual" Altere a Opção pelo Simples Nacional ou Não utilize o MEI como
960
(MEI) devem ser optantes do Simples Regime Especial.
Nacional.
Contribuintes com regime especial de Contribuintes que optarem pelo regime especial de tributação
961 tributação "Sociedade de profissionais" “Sociedade de profissionais” devem configurar seu perfil como
devem recolher o ISS através de DARM. optantes pelo Simples Nacional.
Não é permitido a emissão de notas com
962 Altere a opção do Regime Especial.
Regime Especial de Estimativa.
Revisado em 23/08/2022
Página 14 de 16
NOTA FISCAL DE SERVIÇO
ELETRÔNICA (NFS-e)
CÓD. MENSAGEM SOLUÇÃO
Não é permitido a emissão de notas com
963 Altere a opção do Regime Especial.
Regime Especial de Cooperativa.
A data da nova competência não deve
964 ser inferior à competência de criação da Altere a data da competência.
NFS-e.
A NFS-e informada não consta como
965 A NFS-e deverá ser retida.
retida.
A NFS-e informada já foi incluída na guia XXX e não pode ser
966 A NFS-e informada consta na guia XXX
alterada.
O status atual desta nota não permite
967 A NFS-e não pode ser alterada.
alteração
A NFS-e informada não está apta para a
968 A competência da NFS-e não pode ser alterada.
troca de competência
A data para nova competência não deve
969 Utilize uma competência válida.
ser superior à competência atual.
O CPF/CNPJ do usuário autorizado a
enviar a mensagem XML não confere
970 Somente CPF/CNPJ autorizados poderão enviar arquivos XML.
com o CPF/CNPJ usado na
comunicação.
Tamanho da mensagem XML
Divida a quantidade de NFS-e em dois ou mais arquivos para
971 ultrapassou o limite máximo permitido de
diminuir o tamanho do XML.
Kbytes.
Mensagem XML de Pedido do serviço
972 Verifique o conteúdo do arquivo XML.
sem conteúdo.
973 Rejeição: Certificado Inválido. Utilize um certificado válido.
O lote informado não pertence a este
974 Informe o lote correto.
prestador.
Esse lote não possui informações de
975 Verifique o lote enviado.
retorno.
O lote informado não possui nenhuma
976 Verifique o número do lote.
NFS-e.
Já existe uma solicitação de Uma NFS-e só pode uma solicitação de cancelamento. Aguarde
977
cancelamento para essa NFS-e. a aprovação/rejeição do fiscal.
RPS optando pelo simples nacional, não
Altere a opção pelo Simples Nacional no arquivo XML ou no
978 confere com a opção especificada no
perfil, para que as duas sejam iguais.
perfil do contribuinte.
O número do lote do contribuinte
979 Altere o número do lote.
informado, já existe.
980 Erro ao processar lote do webservice. Altere a opção pela tributação no perfil.
O regime especial de tributação
informado não confere com o
981 especificado no perfil do prestador. O Altere a opção do regime especial de tributação no perfil.
regime especial de tributação deverá ser
selecionado através do perfil.
Item da lista de serviço informado é
982 incompatível com o código de tributação Preencha o item da lista de serviço corretamente.
no município.
Notas emitidas por optantes do MEI, não
984 Preencha o campo Retenção de ISS com 2 (Não Retido).
podem sofrer retenção.
Notas emitidas para autônomos, não
985 Preencha o campo Retenção de ISS com 2 (Não Retido).
podem ser retidas.
Contribuinte não autorizado a emitir nota
988 Altere o Tipo de Tributação de Serviços.
isenta.
Contribuinte não autorizado a emitir nota
989 Altere o Tipo de Tributação de Serviços.
imune.
Revisado em 23/08/2022
Página 15 de 16
NOTA FISCAL DE SERVIÇO
ELETRÔNICA (NFS-e)
CÓD. MENSAGEM SOLUÇÃO
Contribuinte não autorizado a emitir nota
990 Altere o Tipo de Tributação de Serviços.
com suspensão judicial.
Contribuinte não autorizado a emitir nota
991 Altere o Tipo de Tributação de Serviços.
com suspensão administrativa.
Notas emitidas para tomadores com
994 natureza de fora do município não Preencha o campo Retenção de ISS com 2 (Não Retido).
podem ser retidas.
Para emissão de NFS-e, é necessário
1037 informar seus dados na página de Preencha os dados do Perfil do Contribuinte.
Configurações do Perfil.
Para que essa nota possa ser
1038 intermediada, é necessário definir um Informe o tomador de serviços.
tomador de serviço.
Foi informada retenção, porém o
1039 Informe o responsável da NFS-e.
responsável não foi informado.
Notas emitidas com Regime Especial de
1040 Preencha o campo Retenção de ISS com 2 (Não Retido).
Tributação não podem sofrer retenção.
Notas emitidas por autônomos não
1041 Preencha o campo Retenção de ISS com 2 (Não Retido).
podem ser retidas.
Notas do Simples Nacional não podem
1042 Altere o campo Regime Especial de Tributação.
ter Regime Especial de Tributação.
A nota identificada para substituição não
1043 condiz com o RPS Substituído Altere o campo RPS Substituído
informado.
O endereço do tomador para exportação
deve conter apenas os campos
Preencha os dados do Tomador apenas com campos Endereço
1044 Endereço e Pais preenchidos. O campo
e País e informe o CodigoMunicipio = 9999999
CodigoMunicipio deve ser preenchido
com 9999999.
O Regime Especial de Tributação está
em desacordo com o Cadastro Municipal
O Regime Especial de Tributação, deve ser o mesmo do
1045 de Contribuintes no Município. Em caso
cadastro na Prefeitura.
de dúvidas, contactar a Secretaria
Municipal de Fazenda.
O <<CPFCNPJ>> ultrapassou o limite
2001 máximo permitido de consultas no Efetue menos consultas em um curto espaço de tempo.
período. Tente novamente mais tarde.
4.3. Relação de Alertas (exclusivo desde Município)
CÓD. MENSAGEM SOLUÇÃO
Diversas: Alerta informando o motivo da Esta NFS-e necessita de aprovação de um fiscal para ser
941 solicitação manual de substituição de substituída/cancelada. Aguarde a resposta do fiscal.
NFS-e.
Cidade/UF informada não foi encontrada Preencher os campos Cidade/UF com os dados corretos.
942 na base de dados. Em caso de cidades do exterior (fora do país), deixar campos
Cidade/UF em branco.
Será ignorada a alíquota informada para
957 NFS-e (sem retenção) emitida por
optantes do simples nacional.
Revisado em 23/08/2022
Página 16 de 16
NOTA FISCAL DE SERVIÇO
ELETRÔNICA (NFS-e)
5. Criando um link para a NFS-e Emitida
O sistema de NFS-e da Prefeitura pode enviar um e-mail padrão automático com o link que permite a visualização
da NFS-e emitida para todos os tomadores de serviços.
Os contribuintes que possuem sistema informatizado e que quiserem enviar, através de seu próprio sistema, um
e-mail personalizado para seus clientes com um link de acesso para visualizar/imprimir a NFS-e emitida, podem
fazê-lo utilizando a estrutura abaixo:
https://nfse.niteroi.rj.gov.br/nfse/nfse.aspx?ccm=99999999&nf=999999999&cod=XXXXXXXX
ccm = Inscrição do Prestador de Serviços (sem formato)
nf = Número da NFS-e (sem formato).
cod = Código de Verificação da NFS-e (sem traço)
Este mesmo link pode ser utilizado diretamente no sistema do próprio contribuinte como uma forma rápida de
visualização/impressão da NFS-e, sem necessidade de se logar no sistema.
Revisado em 23/08/2022
