Está en la página 1de 100

MANUAL DE CONECTIVIDADE DA

NFS-e
Verso 1.6.5

DOCUMENTO CONTROLADO.
Este documento faz parte da documentao do software GIF- Gesto eInteligncia Fiscal e no pode ser reproduzido
MC_010
sem autorizao da INFISC.
REV 03 Pg. 1 de 100
Elaborao DTI Reviso Qualidade Aprovao Diretoria MC_010 REV 03
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

HISTRICO
REVISO DATA HISTRICO DAS ALTERAES
DAS REVISES
01 15/09/2013 Versao 1.6.1
02 08/10/2013 Verso 1.6.2
03 03/04/2014 Verso 1.6.3
04 20/08/2014 Contedo Alterado da verso 1.6.3 para a verso 1.6.4 Verso 1.6.4

a) No quadro da Seo 2.2.1 (pg.12), logo depois da tipo


TNFSe, foi includo o tipo TNum para representar valores
numricos do tipo inteiro com nove dgitos.

b) No final do quadro da Seo 2.2.1 (pg.13) foi includo o


tipo TStringBase64 para representar campo com informaes
codificadas utilizando o formato Base 64.

c) No quadro Id (pg.15) foram acrescentadas as tags rps,


serierps e dataEmissaoRpsPapel para identificar o nmero, a
srie e a data de emisso do RPS papel, respectivamente, do
Recibo Provisrio de Servios emitido em papel, que deu
origem NFS-e, quando for o caso.

d) No quadro confirmaLote (pg.32), a tag mot foi alterada


para obrigatria, pois sempre includa mesmo quando
vazia.

e) Na Seo 3.1.4 (pg. 33) foi alterado ttulo do quadro de


confirmaLote para resultadoLote, que o nome correto
da tag correspondente.

f) No quadro da Seo 3.1.4 (pg.34) foi includa a tag


motivos, que serve para agrupar as vrias ocorrncias
possveis da tag mot e ajustado o exemplo de XML logo
abaixo do quadro.

g) No quadro confirmaCancelamentoLote (pg.35), a tag mot


foi alterada para obrigatria, pois sempre includa mesmo
quando vazia.

h) No Seo 3.1.8 foi alterado o primeiro pargrafo para


refletir exatamente o que o servio Web oferece.

i) No quadro resPedidoLoteNFSe (pg.36), foi removida a tag


cLote.

j) No quadro resPedidoLoteNFSe (pg.36), a tag mot teve o


Tipo alterado para TString256.
DOCUMENTO CONTROLADO.
Este documento faz parte da documentao do software GIF- Gesto eInteligncia Fiscal e no pode ser reproduzido
MC_010
sem autorizao da INFISC.
REV 03 Pg. 2 de 100
Elaborao DTI Reviso Qualidade Aprovao Diretoria MC_010 REV 03
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

k) No quadro resCancelaNFSe (pg.38), a tag mot teve o Tipo


alterado para TString256.

l) No quadro resPedidoNFSe (pg.39), a tag NFSe foi alterada


para NFS-e (includo um hfen).

m) No quadro resPedidoNFSe (pg.39), a tag mot teve o Tipo


alterado para TString256.

n) Na Seo 3.2.6 (pg. 40) foi alterado ttulo do quadro de


resPedConsultaNFSe para resConsultaTrans, que o
nome correto da tag correspondente.

o) ) No quadro da Seo 3.2.6 (pg.40), a tag mot teve o Tipo


alterado para TString256.

p) No quadro da Seo 3.2.6 (pg.40), foi retirada a tag


motCanc, pois o motivo do cancelamento j est
contemplado na informao da tag sitNFS-e; e foi feito o
ajuste no exemplo de XML logo depois do quadro.

q) Na Seo 3.2.8 (pg. 41) foi alterado ttulo do quadro de


resPedidoNFSePNG para resPedidoLoteNFSePNG, que o
nome correto da tag correspondente e ajustado o exemplo
de XML depois do quadro.

r) No quadro da Seo 3.2.8 (pg.41), a tag mot teve o Tipo


alterado para TString256.

s) No quadro da Seo 3.2.8 (pg.41), a tag NFS-ePNG teve o


Tipo alterado para TStringBase64.

t) No quadro retornoSolicitacaoInutilizacao (pg.42), a tag


Mensagem teve o Tipo alterado para TString256.

u) Nas Sees 3.2.9 e 3.2.10 (pgs.42 e 43) foram ajustados


os exemplos de XML para que as tags que marcam o final de
uma informao sejam com o nome completo da tag (tags
inutilizar e inutilizado).

v) Na Seo 4.1.3 foram alterados os nomes dos servios


Web de cancelamento de NFS-e para refletir os nomes
corretos descritos nos quadros das Sees anteriores.

w) Na Seo 5.2 (pg.50) foi ajustado o exemplo de XML para


utilizar o nome correto da tag resPedidoLoteNFSePNG.

x) Na Seo 5.7.2 (pg.56), foi retirada a referncia


http://www.bcb.gov.br/?RED-TABELAPAISES que no est
mais disponvel.

DOCUMENTO CONTROLADO.
Este documento faz parte da documentao do software GIF- Gesto eInteligncia Fiscal e no pode ser reproduzido
MC_010
sem autorizao da INFISC.
REV 03 Pg. 3 de 100
Elaborao DTI Reviso Qualidade Aprovao Diretoria MC_010 REV 03
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

05 13/07/2015 Contedo Alterado da verso 1.6.4 para a verso 1.6.5 Verso 1.6.5

1- Tabela tipo Simples includa a tag TDec_1304 pg. 17;

2- Tabela tipo Simples alterada a descrio da tag


TSituacaoLote, incluindo o cdigo 217 para indicar que
este em fila para o processamento. pag. 18;

3- Tabela infNFe alterada a descrio da tag infAdicLT - Se


tag localVerifResServ for igual a "2", no deve ser
informada. pg. 20;

4- Tabela det alterada a descrio da tag ISSST includa a


palavra retido n o paragrafo Vale destacar que no
permitido ter um item de servio retido com esta tag e
tambm ter informaes de imposto prprio na tag
serv.. pag. 25;

5- Tabela serv alterada a descrio da tag cServ possvel


consultar a lista de cdigos autorizados para a(s)
empresa(s) em:
https://nfse.caxias.rs.gov.br/site/consultar-atividades/,
pag. 25;

6- Tabela serv alterada o tipo da tag vUnit de TDec1302


para TDec 1304 pag. 25;

7- Tabela serv alterada a descrio da tag vBCISS


complementado com . Para contribuinte Simples
Nacional deve ser informado zerado, 0.00., pag. 26;

8- Tabela serv alterada a descrio da tag pISS


complementado com Para contribuinte Simples Nacional
deve ser informado zerado, 0.00.!, pag. 26;

9- Tabela serv alterada a descrio da tag vISS


complementado com Para contribuinte Simples Nacional
deve ser informado zerado, 0.00.!, pag. 26;

10- Tabela ISS alterada a descrio da tag vBCISS


,complementado com Para contribuinte Simples
Nacional deve ser informado zerado, 0.00. pg. 28;

11- Tabela ISS alterada a descrio da tag vISS


complementado com Para contribuinte Simples Nacional
deve ser informado zerado, 0.00., pg. 28;

12- Tabela envioLote alterada a ocorrncia da tag NFS-e, de


1-N para 1_999 pg. 37;
DOCUMENTO CONTROLADO.
Este documento faz parte da documentao do software GIF- Gesto eInteligncia Fiscal e no pode ser reproduzido
MC_010
sem autorizao da INFISC.
REV 03 Pg. 4 de 100
Elaborao DTI Reviso Qualidade Aprovao Diretoria MC_010 REV 03
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

13- Tabela resultado Lote alterada a ocorrncia da tg NFSe


de 1-N para 1_999 pg. 43;

14- Includo exemplo de XML em caso de lote aguardando


processamento pg. 44;

15- Tabela resPedidoLoteNFse alterada ocorrncia da tag


NFSe de 1-N para 1_999, pg. 47;

16- Alterado o Item 3.2.9 Solicitao de Inutilizao de


Numerao de NFS-e. pg. 54;

17- Tabela solicitacaoInutilizacao alterada a ocorrncia da tag


inutilizar de 1-N para 1_999, pag. 55;

18- Tabela retornoSolicitacaoInutilizacao alterada a


ocorrncia da mensagem de 1-N para 1 pg. 57;

19- Includo o item Pedido Imagem de uma NFS-e em


formato PDF, pg. 57;

20- Includo o item 3.2.12 Resultado do pedido da imagem


de uma NFS-e em formato PDF, pg. 58;

21- Includo o n 1212 na tabela de codificao de


mensagem de erro e de aviso referindo-se a assinatura
invalida, pg. 82;

22- Includo na descrio do o n 3450 da tabela de


codificao de mensagem de erro e de aviso . possvel
consultar a lista de cdigos autorizados para a(s) empresa(s) em:
https://nfse.caxias.rs.gov.br/site/consultar-atividades/,
pg. 83;

23- Includa na descrio do n 3642 da tabela de codificao


de mensagem de erro e de aviso e infAdicLT pg. 95;

24- - incluso de uma estrutura alternativa de retorno do mtodo


obterCriticaLote pg. 43.

DOCUMENTO CONTROLADO.
Este documento faz parte da documentao do software GIF- Gesto eInteligncia Fiscal e no pode ser reproduzido
MC_010
sem autorizao da INFISC.
REV 03 Pg. 5 de 100
Elaborao DTI Reviso Qualidade Aprovao Diretoria MC_010 REV 03
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

Sumrio
1. Introduo ......................................................................................................................................... 8
1.1 Conceitos ................................................................................................................................................ 8
1.1.1 Nota Fiscal de Servios eletrnica - NFS-e ..................................................................................... 8
1.1.2 Recibo Provisrio de Servios - RPS ............................................................................................... 8
1.1.3 Mecanismos para Conectividade ................................................................................................... 9
1.2 Ambientes de Homologao e de Produo ........................................................................................ 10
2. Modelo Operacional ......................................................................................................................... 11
2.1. Modelo bsico de operao ................................................................................................................ 11
2.1.1 Servios Sncronos ........................................................................................................................ 12
2.1.2 Servios Assncronos .................................................................................................................... 12
2.2 Tipos de Dados ..................................................................................................................................... 14
2.2.1 Tipos Simples................................................................................................................................ 16
2.2.2 Tipos Compostos .......................................................................................................................... 19
2.3 Padro XML........................................................................................................................................... 29
2.3.1 Certificado Digital ......................................................................................................................... 29
2.3.2 Validao do arquivo XML ............................................................................................................ 29
2.3.3 Estrutura do envelope SOAP ........................................................................................................ 31
3. Servios Web disponveis .................................................................................................................. 36
3.1 Servios sobre lotes NFS-e .................................................................................................................... 36
3.1.1 Envio de lote NFS-e....................................................................................................................... 36
3.1.2 Confirmao de recebimento de lote NFS-e ................................................................................ 42
3.1.3 Pedido de status de um lote NFS-e............................................................................................... 42
3.1.4 Resultado do pedido de status de um lote NFS-e ........................................................................ 43
3.1.5 Pedido de cancelamento de lote NFS-e........................................................................................ 44
3.1.6 Resultado do pedido de cancelamento de lote NFS-e.................................................................. 45
3.1.7 Pedido de um lote NFS-e .............................................................................................................. 46
3.1.8 Resultado do pedido de um lote NFS-e .........................................................................................47
3.2 Servios sobre uma NFS-e .................................................................................................................... 48
3.2.1 Cancelamento de NFS-e ............................................................................................................... 48
3.2.2 Resultado de cancelamento de NFS-e .......................................................................................... 49
3.2.3 Pedido de uma NFS-e ................................................................................................................... 50
3.2.4 Resultado de pedido de uma NFS-e ............................................................................................. 50
3.2.5 Consulta sobre status de uma NFS-e ............................................................................................ 51
3.2.6 Resultado da consulta sobre status de uma NFS-e....................................................................... 52
3.2.7 Pedido da imagem de uma NFS-e em formato PNG .................................................................... 53
3.2.8 Resultado do pedido da imagem de uma NFS-e em formato PNG .............................................. 54
3.2.9 Solicitao de Inutilizao de Numerao de NFS-e .................................................................... 54
3.2.10 Resultado de solicitao de inutilizao de numerao de NFS-e ............................................. 56
3.2.11 Pedido da imagem de uma NFS-e em formato PDF ....................................................................57
3.2.12 Resultado do pedido da imagem de uma NFS-e em formato PDF ............................................. 58
4. Informaes complementares ........................................................................................................... 59
4.1. Orientaes sobre o uso das tags da NFS-e ......................................................................................... 59
4.1.1. Informaes sobre tomador ........................................................................................................ 59
4.1.2. Informaes sobre servios ......................................................................................................... 59
4.1.3. Informaes sobre retenes ...................................................................................................... 60
4.1.4. Anulao e cancelamento de NFS-e ............................................................................................ 60
4.2. Informaes Adicionais na NFS-e ........................................................................................................ 61
DOCUMENTO CONTROLADO.
Este documento faz parte da documentao do software GIF- Gesto eInteligncia Fiscal e no pode ser reproduzido
MC_010
sem autorizao da INFISC.
REV 03 Pg. 6 de 100
Elaborao DTI Reviso Qualidade Aprovao Diretoria MC_010 REV 03
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

4.2.1. Informaes Adicionais obrigatrias na NFS-e ............................................................................ 61


4.2.3. Informaes Adicionais para Descries das Retenes Federais ............................................... 63
4.2.4. Informaes Adicionais para Esclarecimento ao Consumidor Lei n 12.741/2012 ...................... 63
5. Informaes gerais sobre NFS-e ........................................................................................................ 64
5.1. Gerao da NFS-e ................................................................................................................................ 64
5.2. Impresso e imagem da NFS-e ............................................................................................................ 64
5.3. Informaes e campos variveis na imagem da NFS-e ........................................................................ 65
5.3.1. NFS-e x NFFS-e............................................................................................................................. 65
5.3.2. Quadro Discriminao dos Servios ......................................................................................... 66
5.3.3. Responsabilidades pelo recolhimento do ISSQN......................................................................... 66
5.4. Dados da obra...................................................................................................................................... 70
5.5. Personalizaes da NFS-e .................................................................................................................... 70
5.6. Cancelamento da NFS-e ...................................................................................................................... 71
5.7. Tabelas auxiliares da NFS-e.................................................................................................................. 71
5.7.1. Tabela de cdigo de municpios e UF - IBGE ............................................................................... 71
5.7.2. Tabela de cdigo de pas - BACEN ............................................................................................... 73
5.8. Inutilizao de Numerao de NFS-e................................................................................................... 73
5.8.1. Regras para reutilizao de numerao rejeitada ....................................................................... 73
5.8.2. Uso do servio Web para inutilizao de numerao ..................................................................74
6. Codificao das mensagens de erro e de aviso ................................................................................... 77
7. Glossrio .......................................................................................................................................... 97

DOCUMENTO CONTROLADO.
Este documento faz parte da documentao do software GIF- Gesto eInteligncia Fiscal e no pode ser reproduzido
MC_010
sem autorizao da INFISC.
REV 03 Pg. 7 de 100
Elaborao DTI Reviso Qualidade Aprovao Diretoria MC_010 REV 03
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

1. Introduo
As empresas prestadoras de servios podero integrar seus prprios sistemas de
gerenciamento de Nota Fiscal com o sistema de Nota Fiscal eletrnica do Municpio, denominado
NFS-e, automatizando assim o processo de emisso, consulta e cancelamento de suas notas fiscais.
Este manual apresenta as especificaes e critrios tcnicos necessrios para esta integrao,
viabilizada atravs do uso de servios Web disponibilizados pela Administrao Tributria
Municipal s empresas interessadas, prestadoras e/ou tomadoras de servios. Todas as
informaes e orientaes necessrias para a utilizao desses servios Web esto disponveis
neste documento.

1.1 Conceitos
Nesta seo so introduzidos os principais conceitos e tecnologias adotados no sistema NFS-e,
de modo a facilitar o entendimento dos recursos de conectividade a serem utilizados para
integrao dos sistemas prprios das empresas com o sistema NFS-e.
Para facilitar a troca de informaes entre as vrias esferas de governo, a NFS-e do Municpio
de Caxias do Sul est fundamentada no modelo conceitual da Receita Federal do Brasil, das
secretarias de fazenda estaduais e da ABRASF (Associao Brasileira das Secretarias de Finanas
das Capitais).

1.1.1 Nota Fiscal de Servios eletrnica - NFS-e


De acordo com o modelo conceitual da ABRASF, que vem coordenando, em mbito nacional,
as atividades relacionadas automatizao de vrios processos das Administraes Tributrias
Municipais, uma NFS-e um documento de existncia exclusivamente digital, gerado e
armazenado eletronicamente pela Administrao Tributria Municipal ou por outra entidade
conveniada, para documentar as operaes de prestao de servios.
A gerao da NFS-e ser disponibilizada aos contribuintes por meio de servios informatizados.
Para isto, os dados que compem uma nota fiscal de servios sero informados, validados,
analisados, processados, e, se corretos, geraro o documento eletrnico.
A responsabilidade pelo cumprimento da obrigao acessria de emisso da NFS-e e pelo
correto fornecimento dos dados Administrao Tributria Municipal, para a gerao da mesma,
do contribuinte.

1.1.2 Recibo Provisrio de Servios - RPS


Ainda segundo o modelo conceitual da ABRASF, a NFS-e somente pode ser gerada com a
utilizao dos servios informatizados disponibilizados pelas Administraes Tributrias
Municipais. Como esse tipo de servio online pressupe riscos inerentes disponibilidade do
ambiente tecnolgico, podendo, eventualmente, sofrer interrupes temporrias, surgiu o
conceito de Recibo Provisrio de Servios (RPS). Este conceito disponibilizado aos contribuintes
visa manter as suas atividades ininterruptas, mesmo se os servios informatizados municipais
estiverem indisponveis atravs da internet.

Pg. 8 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

O RPS de posse e responsabilidade do contribuinte que o emitiu, sendo obrigatria sua


converso para NFS-e atravs de registro de seus dados no sistema da NFS-e de Caxias do Sul,
dentro do prazo estipulado pela legislao tributria municipal.

1.1.3 Mecanismos para Conectividade


O meio fsico de comunicao utilizado entre os sistemas de informao dos contribuintes e o
sistema de NFS-e da Administrao Tributria Municipal a Internet, com o uso do protocolo SSL
(Secure Socket Layer), que alm de garantir um mecanismo de comunicao seguro na Internet,
permite a identificao do servidor e do cliente com a utilizao obrigatria de certificados digitais
do tipo e-CNPJ ou NF-e, eliminando, neste caso, a necessidade de identificao do usurio com a
utilizao de nome ou cdigo de usurio e senha.
O modelo de comunicao segue o padro de Web Services definido pelo WS-I Basic Profile:
uma especificao, padronizada por um consrcio de empresas da rea de Tecnologia da
Informao, para garantir a interoperabilidade de aplicaes voltadas para a Internet.
A troca de mensagens entre o servio Web do sistema de NFS-e do municpio e o sistema do
contribuinte implementada atravs do padro SOAP (Simple Object Access Protocol), com troca
de mensagens em XML (eXtended Markup Language).
Para descrever os servios disponibilizados pelo servio Web utilizado um documento WSDL
(Web Service Description Language), que o padro amplamente recomendado para a descrio
de servios SOAP.
As mensagens enviadas aos servios disponibilizados pela Administrao Tributria Municipal
so documentos eletrnicos elaborados no padro XML e devem ser assinados digitalmente com
um certificado digital que contenha o CNPJ do estabelecimento emissor da NFS-e objeto do
pedido.
Um arquivo XML definido internamente por tags (marcaes) que correspondem aos
parmetros e informaes que sero transmitidos para que seja possvel a integrao entre os
sistemas. Eis exemplos de tags em XML:

<nome>Empresa Teste Ltda</nome>


<cnpj>49454600000119</cnpj>

As tags <nome> e </nome> marcam o incio e o final do campo onde deve constar o nome de
pessoa, por exemplo.
A especificao adotada para as mensagens XML a recomendao W3C para XML 1.0,
disponvel em http://www.w3.org/TR/REC-xml e a codificao dos caracteres ser em UTF-8.
Para garantir minimamente a integridade das informaes prestadas e a correta formao dos
arquivos XML, o contribuinte deve submeter as mensagens XML para validao pela linguagem de
Schema do XML (XSD XML Schema Definition), disponibilizada pela Administrao Tributria
Municipal, antes de seu envio.

Pg. 9 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

As chamadas dos servios Web disponibilizados pela Administrao Tributria Municipal e os


respectivos resultados do processamento so realizadas atravs da utilizao de mensagens
usando tags e valores passados em seu prprio corpo, como parmetros. A estrutura de tags de
cada servio Web e a estrutura dos possveis retornos esto detalhadas na prxima seo.

1.2 Ambientes de Homologao e de Produo


O Municpio de Caxias do Sul RS mantm dois ambientes para recepo das NFS-e.
O ambiente de homologao especfico para a realizao de testes e integrao das
aplicaes do contribuinte durante a fase de implementao e adequao do sistema de emisso
de NFS-e do contribuinte, e nos casos em que esse sistema sofre alteraes aps entrar em regime
de operao normal.
O ambiente de produo destinado para emisso da NFS-e de forma oficial, onde a NFS-e
gerada considerada um documento fiscal para todos os fins legais. A assinatura digital exigida e
validada nos ambientes de produo e homologao.
A utilizao pelo contribuinte de qualquer um dos dois ambientes fica condicionada a prvia
autorizao da Administrao Tributria Municipal. O acesso a cada um dos ambientes ser
concedido mediante prvia requisio do contribuinte ou de ofcio, caso seja de interesse da
Administrao Tributria.
Os endereos para acesso dos contribuintes so:

Portal do ISS: https://nfse.caxias.rs.gov.br/site/nfse

Homologao:
Portal: https://nfsehomol.caxias.rs.gov.br/portal
Servios Web https://nfsehomol.caxias.rs.gov.br/portal/Servicos
WSDL https://nfsehomol.caxias.rs.gov.br/portal/Servicos?wsdl

Produo:
Portal: https://nfse.caxias.rs.gov.br/portal
Servios Web https://nfse.caxias.rs.gov.br/portal/Servicos
WSDL https://nfse.caxias.rs.gov.br/portal/Servicos?wsdl

Pg. 10 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

2. Modelo Operacional
No modelo operacional do sistema NFS-e do Municpio de Caxias do Sul, existe uma nica
soluo Web que oferece todos os servios relacionados emisso de notas fiscais eletrnicas:
Portal da NFS-e. O fluxo de comunicao sempre iniciado pelo sistema do contribuinte com o
envio de uma mensagem XML ao servio Web com o pedido do servio desejado.
A forma de processamento das solicitaes de servios no sistema NFS-e pode ser sncrona,
caso o atendimento da solicitao de servio seja realizado na mesma conexo, ou assncrona,
quando o processamento do servio solicitado no atendido na mesma conexo, devido a uma
demanda de processamento de grande quantidade de informao. Nessa situao torna-se
necessria a realizao de mais uma conexo para a obteno do resultado do processamento.

2.1. Modelo bsico de operao


As solicitaes de servios que exigem processamento intenso sero executadas de forma
assncrona e as demais solicitaes de servios de forma sncrona. Assim, os servios da NFS-e
esto implementados da seguinte forma:

Servio Web Implementao


Envio de lote NFS-e Assncrona
Pedido de status de um lote NFS-e Sncrona
Pedido de cancelamento de um lote NFS-e Sncrona
Pedido de um lote NFS-e Sncrona
Pedido de um lote imagens de NFS-e Sncrona
Cancelamento de NFS-e Sncrona
Pedido de uma NFS-e Sncrona
Consulta sobre status de uma NFS-e Sncrona
Solicitao de inutilizao de numerao Sncrona

Tabela 1: Tipos de implementao dos servios Web

Pg. 11 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

2.1.1 Servios Sncronos


As solicitaes de servios de implementao sncrona so processadas imediatamente e o
resultado do processamento obtido em uma nica conexo. A Figura 1 abaixo representa o fluxo
simplificado de funcionamento:

Figura 1: Fluxo de servios Web sncrono

Etapas do processo ideal:


1. A aplicao do prestador prepara a solicitao de um servio gerando um arquivo no
formato XML contendo todas as informaes necessrias;
2. A aplicao do prestador inicia a conexo enviando uma mensagem de solicitao de
servio para o servio Web de recepo de solicitao de servios;
3. O servio Web recebe a mensagem de solicitao de servio e encaminha imediatamente
para processamento do servio solicitado pelo sistema NFS-e;
4. O sistema NFS-e recebe a mensagem de solicitao de servios e realiza o processamento,
devolvendo uma mensagem de resultado do processamento ao servio Web;
5. O servio Web recebe a mensagem de resultado do processamento e o encaminha a
aplicao do prestador;
6. A aplicao do prestador recebe a mensagem de resultado do processamento.

2.1.2 Servios Assncronos


As solicitaes de servios de implementao assncrona so processadas de forma distribuda
por vrios processos e o resultado do processamento somente obtido na segunda conexo. Na
Figura 2 a seguir tem-se o fluxo simplificado de funcionamento:

Figura 2: Fluxo de servio Web assncrono

Pg. 12 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

Etapas do processo ideal:


Solicitao e processamento:
1. A aplicao do prestador prepara a solicitao de um servio gerando um arquivo no
formato XML contendo todas as informaes necessrias;
2. A aplicao do prestador inicia a conexo enviando uma mensagem de solicitao de
servio para o servio Web de recepo de solicitao de servios;
3. O servio Web de recepo de solicitao de servios recebe a mensagem de solicitao de
servio e:
a) a coloca na fila de servios solicitados;
b) no momento oportuno, direcionada para processamento e o resultado do
processamento colocado na fila de servios processados;
4. O servio Web de recepo de solicitao de servios fornece como resposta o protocolo da
solicitao de servio e a data e hora de gravao na fila de servios solicitados para a
aplicao do contribuinte;
5. A aplicao do prestador recebe o protocolo.

Obteno do resultado do servio:


1. A aplicao do prestador, utilizando o protocolo recebido, envia uma consulta ao servio
que retornar o resultado do processamento daquele protocolo, iniciando uma conexo
com o servio Web;
2. O servio Web recebe a mensagem de consulta e localiza o resultado de processamento da
solicitao de servio;
3. O servio Web devolve o resultado do processamento para a aplicao do prestador;
4. A aplicao do prestador recebe a mensagem de resultado do processamento e, caso no
exista outra mensagem, encerra a conexo.

Pg. 13 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

2.2 Tipos de Dados


Abaixo seguem algumas formataes de dados que devem ser seguidas para gerao correta
na estrutura dos arquivos em XML.

Formato Descrio
ART Tem o formato NNNNNNNNNNNNN (13 algarismos), devendo ser sempre informado apenas
nmeros, sem pontos, traos, espaos ou qualquer outro caracter, nas tags XML.
CEI Tem o formato NN.NNN.NNNNN/NN (12 algarismos), devendo ser sempre informado apenas
nmeros, sem pontos, traos, espaos ou qualquer outro caracter, nas tags XML.
CEP Tem o formato NNNNN-NNN (8 algarismos), mas deve ser sempre informado apenas nmeros,
sem pontos, traos, espaos ou qualquer outro caracter, nas tags XML.
CNPJ Tem o formato NN.NNN.NNN/NNNN-NN (14 algarismos), mas deve ser sempre informado
apenas nmeros, sem pontos, traos, espaos ou qualquer outro caracter, nas tags XML.
CPF Tem o formato NNN.NNN.NNN-NN (11 algarismos), mas deve ser sempre informado apenas
nmeros, sem pontos, traos, espaos ou qualquer outro caracter, nas tags XML.
Cdigo de servio Tem o formato NN.NN (4 algarismos), mas deve ser sempre informado apenas nmeros, sem
conforme LC 116 pontos, traos, espaos ou qualquer outro caracter, nas tags XML.
Data (Date) Tem o formato AAAA-MM-DD onde, AAAA representa o ano com quatro caracteres, MM
representa o ms com dois caracteres e DD representa o dia com dois caracteres.
Data/Hora (datetime) Tem o formato AAAA-MM-DDTHH:MM:SS onde, AAAA representa o ano com quatro caracteres,
MM representa o ms com dois caracteres, DD representa o dia com dois caracteres, T
representa o caractere de formatao (devendo ser usado um espao em branco) que deve
existir separando a data da hora, HH representa a hora com dois caracteres, MM representa os
minutos com dois caracteres e SS representa os segundos com dois caracteres (no sendo
obrigatrio incluir os segundos).
Hora Tem o formato HH:MM onde, HH representa a hora com dois caracteres e MM representa os
minutos com dois caracteres.
Inscrio Estadual Tem o formato NNN/NNNNNNN (10 algarismos), mas deve ser sempre informado apenas
nmeros, sem pontos, traos, espaos ou qualquer outro caracter, nas tags XML.
Para tomadores de outros estados, que no o Rio Grande do Sul, pode se usar at 15
algarismos, inclusive sendo permitido caracteres diferentes de nmero.
Inscrio Municipal Tem o formato NNN.NNN, mas deve ser sempre informado apenas nmeros, sem pontos,
traos, espaos ou qualquer outro caracter, nas tags XML.
Para tomadores de outros municpios, que no Caxias do Sul, pode se usar at 15 algarismos,
inclusive sendo permitido caracteres diferentes de nmero.
Municpio e UF Tem o formato NNNNNNN (7 algarismos), onde os dois primeiros algarismos NN correspondem
ao cdigo da UF e os cinco algarismos restantes NNNNN correspondem ao cdigo do
municpio.
Para informar o cdigo completo NNNNNNN (7 algarismos), deve ser utilizado o formato
padro do IBGE, de acordo com tabela disponvel em
ftp://geoftp.ibge.gov.br/organizacao_territorial/municipios_criados_e_instalados/
Nas tags do XML, os zeros esquerda precisam ser indicados no cdigo do municpio. Por
exemplo, o cdigo do IBGE para Caxias do Sul RS 4305108 e tem que ser indicado nas tags
como 4305108, no desprezando qualquer zero que exista entre a indicao da UF (43 para a
UF Rio Grande do Sul) e do Municpio (05108 para o municpio Caxias do Sul).

Pg. 14 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

Pas Tem o formato NNNNN (5 algarismos), devendo ser utilizado o formato padro do BACEN, de
acordo com tabela disponvel em
http://www.bcb.gov.br/?TABELAPAISES
Nas tags do XML os zeros esquerda no precisam ser indicados no cdigo do pas. Assim, o
cdigo do BACEN para Brasil 01058 e pode ser indicado nas tags como 01058 ou mesmo
como 1058.
Telefone (exterior) Tem o formato +AA (BB) CCCCCCCC, onde AA o cdigo do pas do destino (DDI), BB o cdigo
de rea (DDD) e CCCCCCCC o nmero, na forma internacional (segundo padro da Unio
Internacional de Telecomunicaes).
Mas devem ser sempre informados apenas nmeros, sem pontos, traos, espaos ou qualquer
outro caracter, nas tags XML.
Telefone (nacional) Tem o formato (BB) CCCCC CCCC ou (BB) CCCC CCCC, onde BB o cdigo de rea (DDD) e
CCCCCCCCC ou CCCCCCCC o nmero do telefone.
Mas devem ser sempre informados apenas nmeros, sem pontos, traos, espaos ou qualquer
outro caracter, nas tags XML.
Valores Decimais Tem o formato: 0.00
No deve ser utilizado separador de milhar. O ponto (.) deve ser utilizado para separar a parte
(decimal) inteira da fracionria.

Exemplo:48.562,25 = 48562.25
1,00 = 1.00 ou 1
0,50 = 0.50 ou 0.5

O arredondamento de valores/clculos na validao da nota admite uma margem de


divergncia de R$ 0,03.
Valores Percentuais Tem o formato 000.00
O formato em percentual presume o valor percentual em sua forma fracionria. O ponto (.)
(decimal) separa a parte inteira da fracionria.

Exemplo: 62% = 62
150% = 150
25,32% = 25.32
2,75% = 2.75

Vale ressaltar que existem tags que apesar de estarem indicadas como no obrigatrias nos
quadros adiante, dependendo de caractersticas especficas do prestador de servio, ou do prprio
servio prestado, podem ser ainda assim exigidas.

Pg. 15 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

2.2.1 Tipos Simples


A seguir encontra-se a tabela com a lista dos tipos simples que sero utilizados como tipos de
dados. A tabela consiste das seguintes colunas:
Campo: nome do tipo simples;
Tipo: tipo primitivo de dados utilizados pelo campo: C - Caractere, N - Nmero, D - Data ou
Data/Hora, H hora apenas e T - Token;
Descrio: descreve informaes sobre o campo;

Tam.: tamanho do campo


Quando forem caracteres, o tamanho define a quantidade mxima de caracteres que
o texto poder ter;
Quando for numrico o tamanho pode ser representado das seguintes formas
Nmero inteiro, que define o total de dgitos existente no nmero. Exemplo:
15 significa que o nmero poder ter, no mximo, 15dgitos;
Nmero fracionrio, que define o total de dgitos e quantos deles sero
designados para a parte fracionria. Exemplo: 13,2 significa que o nmero
poder ter, no mximo, 15 dgitos sendo 2 deles a da parte fracionria. A
parte fracionria no obrigatria quando assim definido;

Campo Tipo Descrio Tam.


TCep N Cdigo Postal da EBCT, informando apenas nmeros, sem 8
pontos, traos ou qualquer outro caracter
TCharInt C Representa um nico caracter numrico, ou seja, apenas 1
nmeros
TChaveAcesso C/N Chave de acesso de uma NFS-e, com a seguinte estrutura: 39
----------------------------------------------
Tam.|Tipo| Descrio
----------------------------------------------
2 | N |Cdigo IBGE para UF do prestador
----------------------------------------------
14 | N |CNPJ do prestador
----------------------------------------------
2 | N |Modelo da nota (valor 98 por padro)
----------------------------------------------
3 | C |Srie da nota (em maisculas, com zeros direita)
----------------------------------------------
9 | N |Nmero da nota (com zeros esquerda)
----------------------------------------------
9 | N |Cdigo numrico aleatrio
----------------------------------------------
TCnpj N CNPJ, somente nmeros, sem formatao 14
TCodMunIBGE N Cdigo do Municpio conforme IBGE, somente nmeros, 7
sem formatao

Pg. 16 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

TcPais N Cdigo de pas conforme BACEN, somente nmeros, sem 5


formatao
TCpf N CPF, somente nmeros, sem formatao 11
TData D Data no formato AAAA-MM-DD 10
TDataHora D Data no formato AAAA-MM-DDTHH:MM:SS 19
TDec_0302 N Decimal com 5 dgitos, sendo 3 de corpo e 2 decimais 3,2
TDec_1302 N Decimal com 15 dgitos, sendo 13 de corpo e 2 decimais 13,2
TDec_1304 N Decimal com 15 dgitos, possvel valor com at 4 casas x,4
decimais.
TEmissao C Forma de emisso de uma NFS-e. Devendo ter valor N 1
para Normal ou C para Contingncia
TFone N Nmero de telefone, conforme formatos descritos na 14
tabela do incio desta Seo 2.2, usando somente
nmeros, sem qualquer formatao
TFrete N Responsvel pelo pagamento do frete. Devendo ter valor 1
0 para Prestador responsvel ou 1 para Tomador
responsvel
THora H Hora no formato HH:mm 5
TImpressao N Formato de impresso de uma NFS-e, devendo ser 1
utilizado sempre o valor 1 para indicar modo Retrato.
TLCServ N Cdigo de servio conforme Lei Complementar 116, com 4
formato descrito na tabela do incio desta Seo 2.2,
utilizando somente nmeros, sem qualquer formatao.
TModelo N Modelo de NFS-e (utilizar sempre o cdigo 98). 2
TMotCanc N Motivo do cancelamento. Pode ter valor 1, que 1
representa Servio no foi prestado ou valor 2 que
representa NFS-e emitida com dados incorretos.
TNF N Nmero da Nota Fiscal de Servios eletrnica, formado 9
por um nmero crescente e sequencial, com 9 algarismos.
TNFSe N Tipos de NFS-e, que pode ser de Entrada ou de Sada. 1
Deve ser utilizado sempre o valor 1 para indicar nota de
Sada.
TNum N Cdigo numrico para uso em campos de valor inteiro 9
TNumAleatorio N Cdigo numrico com valor aleatrio (ou seja, produzido 9
por um gerador de nmeros aleatrios)
TNumFatura N Nmero de uma fatura em uma NFS-e, com at 15 15
caracteres alfanumricos.
TOrdemSeq N Nmero sequencial e crescente, entre 1 e 999, para 3
indicar ordem de itens em notas fiscais
TPlacaVeic C Placa de veculo com os possveis seguintes formatos: 7
XXX9999, XXX999, XX9999 ou XXXX999. Informar a placa
em campo de Informaes Adicionais quando tiver lei de
formao diversa destes formatos.
TSerie C Srie para notas fiscais 3
TSimNao C Tipo utilizado para indicar resposta sim (utilizar valor S) 1
ou resposta no (utilizar valor N)

Pg. 17 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

TSituacaoCancelamento N Cdigo de situao da cancelamento de uma nota, que 3


Nota pode ter o valor 100 para indicar que o cancelamento
foi homologado, ou um valor 200 que o cancelamento
foi rejeitado.
TSituacaoLote N Cdigo de situao de um lote de NFS-e submetido para 3
processamento, que pode ter o valor 100 para indicar
que o lote foi Aceito , valor 200 para indicar que o lote
foi Rejeitado e 217 para indicar que est em fila para
processamento
TSituacaoNFSe N Cdigo de situao de uma NFS-e, indicando o estado 1
atual da NFS-e, tendo um dos seguintes valores:
1 para Uso autorizado, 2 para NFS-e substituta de
outra NFS-e, 3 para NFS-e cancelada, 4 para NFS-e
substituda por outra NFS-e, 5 para NFS-e no existente
na base de dados, ou 6 para NFS-e corrigida.
Esta situao recebida quando se solicita o XML de uma
NFS-e j submetida.
TSituacaoNota N Cdigo de situao para cada NFS-e individual dentro de 3
um lote submetido para processamento. Pode ter os
valores 100 para Uso autorizado e 200 para NFS-e
rejeitada. Esta situao recebida quando se solicita o
resultado do processamento de um lote (crtica de lote).
TString2 C String com tamanho mximo de 2 2
TString3 C String com tamanho mximo de 3 3
TString5 C String com tamanho mximo de 5 5
TString6 C String com tamanho mximo de 6 6
TString12 C String com tamanho mximo de 12 12
TString13 C String com tamanho mximo de 13 13
TString15 C String com tamanho mximo de 15 15
TString50 C String com tamanho mximo de 50 50
TString60 C String com tamanho mximo de 60 60
TString100 C String com tamanho mximo de 100 100
TString120 C String com tamanho mximo de 120 120
TString150 C String com tamanho mximo de 150 150
TString256 C String com tamanho mximo de 256 256
TStringBase64 C String contendo informao em formato Base 64 -

Pg. 18 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

2.2.2 Tipos Compostos


A seguir so detalhadas as tabelas de cada tipo composto e seus campos. A tabela est
dividida da seguinte forma:
(1)
(2)
Nome Tipo Ocor. Obr. Descrio
(4) (5) (6) (7) (8)
(3)
(4) (5) (6) (7) (8)

Legenda da Tabela:
(1) Nome do tipo complexo;
(2) Descrio do tipo complexo;
(3) Identifica se a sequncia de campos far parte de uma escolha (Choice);
(4) Nome do campo que faz parte do tipo complexo;
(5) Tipo do campo, que pode ser simples ou complexo;
(6) Quantas vezes o campo se repete na estrutura de dados: Formato: x-y onde x a
quantidade mnima e y a quantidade mxima. Se a quantidade mxima for indefinida, ser
utilizado N no lugar do y;
(7) Indica se obrigatrio (valor 'S') ou opcional (valor 'N')
(8) Descrio do campo.

NFS-e
Representa a estrutura da Nota Fiscal de Servios eletrnica
Nome Tipo Ocor. Obr. Descrio
infNFSe infNFSe 1-1 S Informaes sobre cada NFS-e

Pg. 19 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

infNFSe
Representa os dados informativos da Nota Fiscal de Servios eletrnica
Nome Tipo Ocor. Obr. Descrio
Id Id 1-1 S Identificao da nota
prest prest 1-1 S Prestador de servios
TomS TomS 1-1 S Tomador de servios
dadosDaObra dadosDaObra 0-1 N Dados da obra construo civil
transportadora transportadora 0-1 N Dados da transportadora
det det 1-999 S Discriminao dos servios
total total 1-1 S Totalizaes
faturas faturas 0-1 N Dados de Faturamento

infAdicLT TCodMunIBGE 1-1 S Local da tributao utilizando cdigo do


municpio conforme IBGE. Se tag
localVerifResServ for igual a "2", no deve
ser informada.
infAdicES TSimNao 0-1 N Indica que deve ser includa a mensagem
Exportao de Servio no quadro de
Informaes Adicionais da NFS-e
infAdic TString256 0-N N Informaes adicionais
infAdicAT TCharInt 0-1 N Indica se deve ou no ser exibida a
informao de valores totais aproximados
de tributos, devendo ter valor 0para no
exibir e o valor 1 para exibir.

Id
Representa dados que identificam uma Nota Fiscal de Servios eletrnica
Nome Tipo Ocor. Obr. Descrio
cNFS-e TNumAleatorio 1-1 S Cdigo numrico aleatrio, que faz parte da
chave de acesso da NFS-e, servindo para evitar
que robots vasculhem todas as notas dos
contribuintes.
mod TModelo 1-1 S Modelo da nota (utilizar sempre o cdigo 98).
serie TSerie 1-1 S Srie da nota.
nNFS-e TNF 1-1 S Nmero da nota, sequencial e crescente.
dEmi TData 1-1 S Data de emisso, conforme formato indicado no
quadro da Seo 2.2.1.
hEmi THora 1-1 S Hora de emisso, conforme formato indicado no
quadro da Seo 2.2.1.
tpNF TNFSe 1-1 S Tipo de nota, que deve ter sempre
o valor 1 indicando nota do tipo Sada (servios
prestados).
refNF TChaveAcesso 1-1 S Chave de acesso, conforme formato indicado no
quadro da Seo 2.2.1.

Pg. 20 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

tpImp TImpressao 0-1 N Formato de impresso, que deve ser sempre


usado o valor 1 para indicar Retrato.
tpEmis TEmissao 1-1 S Tipo de emisso, conforme formato indicado no
quadro da Seo 2.2.1.
cancelada TSimNao 0-1 N Indicador de Nota Cancelada.
motCanc TMotCanc 0-1 N Motivo do cancelamento.
dataCanc TData 0-1 N Data do cancelamento.
notaSub TNF 0-1 N Nmero da nota que substitui a presente nota.
canhoto TCharInt 0-1 N Se no for informada esta tag ou for informado
valor 0, o canhoto no ser includo; se for
informado 1, o canhoto includo no topo e
2, o canhoto includo na parte debaixo da
imagem da nota.
ambienteEmi TCharInt 1-1 S Deve ter o valor 1 para indicar que foi emitida
em ambiente de produo e o valor 2 para
indicar ambiente de homologao.
formaEmi TCharInt 1-1 S Deve ter o valor 1 para indicar que foi emitido
via Portal do Contribuinte, valor 2 para
emisso via servios Web (ERP do contribuinte),
valor 3 para lotes submetidos via Upload no
Portal do Contribuinte e valor 4 para emisso
via RPS.
empreitadaGlobal TCharInt 1-1 S Deve ter valor '1' caso se trate de nota do tipo
Empreitada Global (especfica para construo
civil) e '2' caso contrrio.
rps TNum 0-1 N Nmero do RPS papel que deu origem NFS-e,
quando for o caso.
serierps TSerie 0-1 N Srie do RPS papel que deu origem NFS-e,
quando for o caso.
dataEmissaoRpsPa TData 0-1 N Data de emisso do RPS em papel que deu
pel origem NFS-e, quando for o caso.

prest
Representa dados do prestador do servio
Nome Tipo Ocor. Obr. Descrio
CNPJ TCnpj 1-1 S CNPJ do prestador
xNome TString150 1-1 S Razo social do prestador, completa, evitando
abreviatura e usando grafia igual a do alvar
xFant TString60 0-1 N Nome fantasia do prestador, que deve ser idntico ao
cadastrado no Portal do Contribuinte
IM TString15 1-1 S Inscrio Municipal do prestador
xEmail TString50 0-1 N E-mail do prestador
xSite TString50 0-1 N Site do prestador
end end 1-1 S Endereo do prestador

Pg. 21 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

fone TFone 0-1 N Telefone do prestador


fone2 TFone 0-1 N Telefone alternativo do prestador
IE TString15 0-1 N Inscrio Estadual
regimeTrib TCharInt 1-1 S Regime tributrio. Pode ter o valor: 1 para Simples
Nacional, 2 para SIMEI e 3 para Normal. Deve
coincidir com a informao atual no cadastro do
prestador junto no Portal do Contribuinte.

end
Representao completa do endereo do prestador do servio
Nome Tipo Ocor. Obr. Descrio
xLgr TString100 1-1 S Logradouro
nro TString6 1-1 S Nmero, caso seja Sem nmero no colocar qualquer
informao dentro da tag e ir aparecer s/n na imagem
da nota.
xCpl TString100 0-1 N Complemento
xBairro TString100 1-1 S Bairro
cMun TCodMunIBGE 1-1 S Cdigo do municpio do prestador. Utilizar sempre o
cdigo 4305108 de Caxias do Sul
xMun TString60 1-1 S Nome do municpio. Utilizar sempre o nome Caxias do
Sul
UF TString2 1-1 S Sigla do Estado. Utilizar sempre RS
CEP TCep 1-1 S Cdigo postal, de acordo com EBCT

cPais TcPais 1-1 S Cdigo de pas, de acordo com BACEN. Utilizar sempre o
cdigo 01058 do Brasil.
xPais TString60 1-1 S Nome do pas. Utilizar sempre o nome Brasil.

TomS
Representa dados do tomador de servio
Nome Tipo Ocor. Obr. Descrio
CPF TCpf 1-1 S Nmero do CPF do tomador. Se for o caso de um
Choice CPF no informado deve ser utilizado o valor
00000000000 (correspondendo ao CPF
000.000.000/00).
CNPJ TCnpj 1-1 S Nmero de CNPJ do tomador. Informar apenas
nmeros, sem qualquer formatao.
xNome TString100 0-1 N Nome ou razo social
ender ender 1-1 S Endereo
xEmail TString120 0-1 N Endereo de correio eletrnico
IE TString15 0-1 N Inscrio Estadual. Somente nmeros, sem
qualquer formatao

Pg. 22 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

IM TString15 0-1 N Inscrio Municipal. Somente nmeros, sem


qualquer formatao

IME TString15 0-1 N Inscrio Municipal Eventual junto ao Municpio


de Caxias do Sul - RS
fone TFone 0-1 N Telefone
fone2 TFone 0-1 N Segundo telefone

ender
Representao completa do endereo do tomador do servio
Nome Tipo Ocor. Obr. Descrio
xLgr TString100 0-1 N Logradouro
nro TString6 0-1 N Nmero, caso seja Sem nmero no colocar
qualquer informao dentro da tag e ir aparecer
s/n na imagem da nota.
xCpl TString100 0-1 N Complemento
xBairro TString100 0-1 N Bairro
cMun TCodMunIBGE 1-1 S Cdigo do municpio do tomador, conforme IBGE.
Informar 0000000 quando for tomador do exterior.
xMun TString60 S Nome do municpio do tomador, conforme IBGE. Se
1-1 tomador do exterior, no se usa ento o padro do
IBGE.
UF TString2 1-1 S Sigla do Estado do tomador. Informar EX, se for
tomador do exterior.
CEP TCep 0-1 N Cdigo postal da EBCT
cPais TcPais 1-1 S Cdigo do pas de acordo com BACEN
xPais TString100 1-1 S Nome do pas

dadosDaObra
Representao completa do endereo do local da obra, para os servios de construo civil
Nome Tipo Ocor. Obr. Descrio
xLogObra TString100 1-1 S Logradouro
xComplObra TString100 0-1 N Complemento
vNumeroObra TString6 0-1 N Nmero
xBairroObra TString100 0-1 N Bairro
xCepObra TCep 0-1 N Cdigo postal da EBCT
cCidadeObra TCodMunIBGE 1-1 S Cdigo do municpio conforme IBGE.
obrigatrio caso se trate de local da obra.
xCidadeObra TString60 1-1 S Nome do municpio, conforme tabela IBGE.
obrigatrio caso se trate de local da obra.

Pg. 23 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

xUfObra TString2 1-1 S Sigla do Estado, conforme tabela IBGE.


obrigatrio caso se trate de local da obra.
cPaisObra TcPais 1-1 S Cdigo do pas de acordo com BACEN.
obrigatrio caso se trate de local da obra.
xPaisObra TString100 1-1 S Nome do pas
numeroArt TString12 0-1 N Nmero ART, usando 12 algarismos, sem
qualquer formatao, apenas nmeros
numeroCei TString12 0-1 N Nmero CEI, usando 12 algarismos sem
qualquer formatao, apenas nmeros
numeroProj TString15 0-1 N Nmero do projeto
numeroMatri TString15 0-1 N Nmero de matrcula

transportadora
Dados cadastrais da empresa transportadora, se houver
Nome Tipo Ocor. Obr. Descrio
xNomeTrans TString100 1-1 S Nome ou Razo Social
xCpfCnpjTrans Tcpf ou TCnpj 0-1 N CPF ou CNPJ da transportadora
xInscEstTrans TString15 0-1 N Inscrio Estadual
xPlacaTrans TPlacaVeic 0-1 N Placa do veculo
xEndTrans TString100 0-1 N Endereo
cMunTrans TCodMunIBGE 0-1 N Cdigo do municpio conforme IBGE.
xMunTrans TString60 0-1 N Nome do municpio pelo IBGE
xUfTrans TString2 0-1 N Sigla do Estado de acordo com IBGE
cPaisTrans TcPais 0-1 N Cdigo do pas de acordo com BACEN.
xPaisTrans TString100 0-1 N Nome do pas
vTipoFreteTrans TFrete 0-1 N Tipo do frete, conforme tabela da seo
2.2.1

Pg. 24 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

det
Representa detalhamento dos servios que compem a NFS-e
Nome Tipo Ocor. Obr. Descrio
nItem TOrdemSeq 1-1 S Nmero do item na nota
serv serv 1-1 S Informaes sobre o servio prestado
ISSST ISSST 0-1 N Reteno de ISSQN por substituio tributria. Esta tag
somente deve estar presente se o item de servio
sendo detalhado tiver ISSQN retido. As informaes de
ISSQN prprio do item de servio devem ser indicadas
nas tags especificas dentro da tag serv.
Vale destacar que no permitido ter um item de
servio retido com esta tag e tambm ter informaes
de imposto prprio na tag serv.

serv

Representa informaes de um servio da NFS-e

Nome Tipo Ocor. Obr. Descrio


Cdigo municipal do servio, devendo ser
informado apenas nmeros. possvel consultar
a lista de cdigos autorizados para a(s)
cServ TString60 1-1 S
empresa(s) em:
https://nfse.caxias.rs.gov.br/site/consultar-
atividades/
Cdigo do servio conforme Lei Complementar
cLCServ TLCServ 1-1 S
116

Discriminao do item de servio. Podem ser


xServ TString256 1-1 S utilizado os caracteres \s\n para quebrar a
linha em qualquer ponto do texto.

Local de tributao, conforme codificao do


localTributacao TCodMunIBGE 1-1 S
IBGE.
Local da verificao do resultado do servio.
localVerifResServ TCharInt 1-1 S Pode ter o valor '1' se for no Brasil ou o valor '2'
se for no Exterior.
uTrib TString2 1-1 S Unidade
qTrib TDec_1302 1-1 S Quantidade
vUnit Tdec_1304 1-1 s Valor unitrio

Pg. 25 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

Valor do servio, que igual a Valor Unitrio


vServ TDec_1302 1-1 S do item de servio x Quantidade - Valor do
desconto Incondicional do item de servio

vDesc TDec_1302 1-1 N Valor do desconto incondicional

Valor da base de clculo do ISSQN, que igual a


Valor do servio Valor da reduo de base
vBCISS TDec_1302 0-1 N de clculo do item de servio. Para contribuinte
Simples Nacional deve ser informado zerado,
0.00.

Alquota de ISSQN. Para contribuinte Simples


pISS TDec_0302 0-1 N
Nacional deve ser informado zerado, 0.00.

Valor do ISSQN. Para contribuinte Simples


vISS TDec_1302 0-1 N
Nacional deve ser informado zerado, 0.00.

vBCINSS TDec_1302 0-1 N Valor de base de clculo INSS


pRetINSS TDec_0302 0-1 N Percentual de reteno INSS
vRetINSS TDec_1302 0-1 N Valor de reteno INSS
vRed TDec_1302 0-1 N Valor da reduo da base de clculo do ISS
vBCRetIR TDec_1302 0-1 N Valor de base de clculo reteno IR
pRetIR TDec_0302 0-1 N Percentual de reteno IR
vRetIR TDec_1302 0-1 N Valor de reteno IR
vBCCOFINS TDec_1302 0-1 N Valor de base de clculo COFINS
pRetCOFINS TDec_0302 0-1 N Percentual reteno COFINS
vRetCOFINS TDec_1302 0-1 N Valor reteno COFINS
vBCCSLL TDec_1302 0-1 N Valor de base de clculo CSLL
pRetCSLL TDec_0302 0-1 N Percentual reteno CSLL
vRetCSLL TDec_1302 0-1 N Valor reteno CSLL
vBCPISPASEP TDec_1302 0-1 N Valor de base de clculo PIS-PASEP
pRetPISPASEP TDec_0302 0-1 N Percentual reteno PIS-PASEP
vRetPISPASEP TDec_1302 0-1 N Valor reteno PIS-PASEP
Valor aproximado de tributos associados ao
totalAproxTribServ TDec_1302 0-1 N
servio

Pg. 26 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

ISSST
Representa informaes do ISSQN retido em um item de servio da NFS-e
Nome Tipo Ocor. Obr. Descrio
vRedBCST TDec_1302 0-1 N Valor da reduo da base de clculo do ISSQN
retido do item de servio
vBCST TDec_1302 1-1 S Valor da base de clculo do ISSQN retido do item
de servio, que igual a Valor do servio Valor
da reduo de base de clculo do item de servio
pISSST TDec_0302 1-1 S Alquota do ISSQN retido do item de servio
vISSST TDec_1302 1-1 S Valor do ISSQN retido do item de servio

total
Representa informaes de totalizaes em uma NFS-e
Nome Tipo Ocor. Obr. Descrio
vServ TDec_1302 1-1 S Valor total de servios, que o somatrio de
Valor do servio X Quantidade de cada item de
servio somatrio dos Descontos
Incondicionais de cada item de servio
vRedBCCivil TDec_1302 0-1 N Valor da reduo da base de clculo da
construo civil
vDesc TDec_1302 0-1 N Valor total de desconto, que o somatrio de
todos os Descontos incondicionais
vtNF TDec_1302 1-1 S Valor total da nota, que a soma do Valor total
do servios
vtLiq TDec_1302 1-1 S Valor lquido total da nota, que o Valor total da
nota menos o somatrio de todas as retenes,
que deve coincidir com o Valor lquido total das
faturas
totalAproxTrib TDec_1302 0-1 N Valor aproximado total dos tributos associado
nota
Ret Ret 0-1 N Valor total de cada uma das retenes federais
vtLiqFaturas TDec_1302 0-1 N Valor lquido total das faturas
ISS ISS 1-1 S Valores totais do ISSQN

Pg. 27 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

ISS
Representa informaes de valores totais do ISSQN em uma NFS-e
Nome Tipo Ocor. Obr. Descrio
vBCISS TDec_1302 0-1 N Valor total da base clculo ISSQN, que igual ao
somatrio das bases de clculo de cada item de servio
menos a Reduo da Base de Clculo da Construo
Civil. Para contribuinte Simples Nacional deve ser
informado zerado, 0.00.
vISS TDec_1302 0-1 N Valor total do ISSQN. Para contribuinte Simples Nacional
deve ser informado zerado, 0.00.
vBCSTISS TDec_1302 0-1 N Valor total da base de clculo de ISSQN devido por
substituio tributria, que igual ao somatrio das
bases de clculo de cada item de servio retido menos
a Reduo da Base de Clculo da Construo Civil
vSTISS TDec_1302 0-1 N Valor total do ISSQN de substituio tributria

Ret
Representa informaes de retenes fiscais em uma NFS-e
Nome Tipo Ocor. Obr. Descrio
vRetIR TDec_1302 0-1 N Valor da reteno de IR.
vRetPISPASEP TDec_1302 0-1 N Valor da reteno de PIS-PASEP.
vRetCOFINS TDec_1302 0-1 N Valor da reteno de COFINS.
vRetCSLL TDec_1302 0-1 N Valor da reteno de CSLL.
vRetINSS TDec_1302 0-1 N Valor da reteno de INSS.

faturas
Representa informaes de faturas em uma NFS-e
Nome Tipo Ocor. Obr. Descrio
fat fat 1-999 S Fatura

fat
Representa informaes sobre faturas em uma NFS-e
Nome Tipo Ocor. Obr. Descrio
nItem TOrdemSeq 1-1 S Nmero sequencial para ordenar faturas
nFat TNumFatura 1-1 S Nmero da fatura
dVenc TData 0-1 N Data de vencimento da fatura
vFat TDec_1302 1-1 S Valor da fatura

Pg. 28 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

tipoVencFat TCharInt 0-1 N Indica o tipo de vencimento da fatura, podendo


ter o valor 1 para Data Certa, 2 para
Apresentao, 3 para vista e 4 para Outros.
descTipoVencFat Tstring15 0-1 N Descrio para o tipo de vencimento da fatura,
quando esta for do tipo 4, ou seja, do tipo
Outros.

2.3 Padro XML


2.3.1 Certificado Digital
Os certificados digitais que podem ser utilizados no sistema NFS-e para a Administrao
Tributria Municipal devem ser emitidos por Autoridade Certificadora credenciada pela
Infraestrutura de Chaves Pblicas Brasileira ICP-Brasil, de pessoa jurdica, dos tipos A1 ou A3.
Os certificados digitais podero ser utilizados em dois momentos distintos para a integrao
entre o sistema do contribuinte e o servio Web do municpio:
Assinatura de Mensagens: O certificado digital utilizado para essa funo dever conter
o CNPJ do prestador de servios emitente da respectiva NFS-e.
Transmisso (durante a transmisso das mensagens entre os servidores do contribuinte
e os servios disponibilizados pelo municpio): O certificado digital utilizado para
identificao do aplicativo do contribuinte deve conter o CNPJ da empresa responsvel
pela transmisso das mensagens.

2.3.2 Validao do arquivo XML


Para garantir minimamente a integridade das informaes prestadas e a correta formao das
mensagens XML, o contribuinte dever submeter cada uma das mensagens XML de pedido de
servio para validao pelo seu respectivo arquivo XSD (XML Schema Definition, definio de
esquemas XML) antes de seu envio. Este manual utiliza a nomenclatura Schema XML para nos
referir a arquivo XSD.
Um Schema XML define o contedo de uma mensagem XML, descrevendo os seus atributos,
seus elementos e a sua organizao, alm de estabelecer regras de preenchimento de contedo e
de obrigatoriedade de cada elemento ou grupo de informao.
A validao da estrutura da mensagem XML realizada por um analisador sinttico (parser)
que verifica se a mensagem XML atende s definies e regras de seu respectivo Schema XML.
Qualquer divergncia da estrutura da mensagem XML em relao ao seu respectivo Schema XML,
provoca um erro de validao do Schema XML. Neste caso o contedo da mensagem XML de
pedido do servio no poder ser processado.

Pg. 29 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

Para realizar esta validao, est disponvel uma aplicao chamada Validador de Schema,
compatvel com todas as plataformas atuais. A Figura 3 a seguir mostra a tela inicial desta
aplicao.

Figura 3: Tela inicial do Validador

No campo Arquivo XSD pode ser especificado o arquivo contendo o XML Schema a ser
utilizado na validao. Para validar o XML Schema do sistema de NFS-e deve ser indicado o arquivo
NFSe-CaxiasDoSul.xsd, que se encontra na pasta da prpria aplicao. No campo Arquivo XML
deve ser indicado o XML a ser validado.
Depois de indicados os arquivos e se clicar no boto Validar, a aplicao ir confrontar o
arquivo XML com as definies do XML Schema. Caso a validao seja concluda com sucesso,
aparecer a janela mostrada na Figura 4 a seguir.

Figura 4: Janela indicando sucesso da validao do XML

Pg. 30 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

Contudo se o arquivo XML no estiver em conformidade com o XML Schema, uma mensagem
de erro ser exibida para o usurio informando a linha do erro e o motivo da gerao do erro. Por
exemplo, se o contribuinte no informar o CNPJ na tag <CNPJ></CNPJ>, deixando-a em branco,
uma mensagem como a mostrada na Figura 5 ser exibida.

Figura 5: Janela de erro na validao do XML

2.3.3 Estrutura do envelope SOAP


SOAP o protocolo baseado em XML para a troca de informaes entre sistemas que se
utilizam da Internet como meio de comunicao. As aplicaes que envolvem comunicao via
servios Web utilizam uma estrutura SOAP para envio e recebimento de solicitaes.
A seguir, tem-se um exemplo de estrutura SOAP em XML montada para a solicitao do envio
de um lote de notas fiscais no sistema NFS-e para Administraes Tributrias Municipais.

<?xml version="1.0" encoding="UTF-8"?>


<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<soapenv:Body>
<ns1:enviarLoteNotas soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:ns1="http://ws.pc.gif.com.br/">
<xml xsi:type="xsd:string">
<!-- Aqui vai o contedo XML definido de acordo com os formatos
de cada servio Web a ser chamado. Estes formatos so apresentados
na Seo 3 a seguir deste Manual
-->
</xml>
</ns1:enviarLoteNotas>
</soapenv:Body>
</soapenv:Envelope>

Pg. 31 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

Para incluir a assinatura digital em cada arquivo XML utilizado para chamado do servio Web
desejado deve ser utilizada a tag Signature (detalhada no quadro adiante), na posio indicada nos
formatos XML descritos na Seo 3 a seguir.

Signature
Representa informaes de uma assinatura digital
Nome Tipo Ocor. Obr. Descrio
Id TString256 0-1 N Identificador da assinatura
SignedInfo SignedInfo 1-1 S Informaes sobre assinatura
SignatureValue TString256 1-1 S Dados da assinatura
KeyInfo KeyInfo 1-1 S Informaes da chave

SignedInfo
Representa informaes bsicas de uma assinatura digital
Nome Tipo Ocor. Obr. Descrio
CanonicalizationM CanonicalizationM 1-1 S Informaes sobre mtodo usado para
ethod ethod normalizao
SignatureMethod SignatureMethod 1-1 S Informaes sobre mtodo usado para
assinatura
Reference Reference 1-1 S Informaes sobre mtodo para
referncia

CanonicalizationMethod
Representa informaes sobre mtodo usado para normalizao
Nome Tipo Ocor. Obr. Descrio
Algorithm TString256, como 1-1 S Algoritmo adotado, conforme padro em
atributo http://www.w3.org/TR/2001/REC-xml-
c14n-20010315

SignatureMethod
Representa informaes sobre mtodo usado para assinatura
Nome Tipo Ocor. Obr. Descrio
Algorithm TString256, como 1-1 S Algoritmo adotado, conforme padro em
atributo http://www.w3.org/2000/09/xmldsig#rs a-sha1

Pg. 32 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

Reference
Representa informaes sobre mtodo para referncia
Nome Tipo Ocor. Obr. Descrio
URI TString256, como 1-1 S Identificar Unificado de Recurso (Uniform
atributo Resource Identifier)
Transforms Transforms 1-1 S Informaes sobre algoritmo adotado para
transformao
DigestMethod DigestMethod 1-1 S Informaes sobre mtodo usado para
digest
DigestValue TString256 1-1 S Dados do digest

Transforms
Representa informaes sobre algoritmo adotado para transformao
Nome Tipo Ocor. Obr. Descrio
Transform Transform 1-1 S Informaes sobre transformao

Transform
Representa informaes sobre transformao
Nome Tipo Ocor. Obr. Descrio
Algorithm TString256, como 1-1 S Algoritmo adotado para Transform
atributo

DigestMethod
Representa informaes sobre mtodo usado para digest
Nome Tipo Ocor. Obr. Descrio
Algorithm Tstring256, como 1-1 S Algoritmo adotado no mtodo de digest, de
atributo acordo com padro em
http://www.w3.org/2000/09/xmldsig#sha1

KeyInfo
Representa dados da chave
Nome Tipo Ocor. Obr. Descrio
X509Data X509Data 1-1 S Dados da chave

X509Data
Representa dados da chave
Nome Tipo Ocor. Obr. Descrio

Pg. 33 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

X509SubjectName TString256 1-1 S Dados do assinante


X509Certificate Cadeia de caracteres 1-1 S Certificado digital
contendo o certificado digital

Exemplo de tag Signature


<Signature xmlns="http://www.w3.org/2000/09/xmldsig#">
<SignedInfo>
<CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/>
<SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1"/>
<Reference URI="">
<Transforms>
<Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"/>
<Transform Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/>
</Transforms>
<DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/>
<DigestValue>hsr+JtpASOG8Yf+gZt7BOuzGWeY=</DigestValue>
</Reference>
</SignedInfo>
<SignatureValue>
eKea3wK5XOdH+9KBNk/ZzeVa8tPLp5mllkeOXx+ABMCCiXh4xTRyshvCc+16VELCU+anY/3TswzP
poxM3hSEct2kNfBYFnZVjXzUoD1Sl9rOAq2mj5Kbaft58fA/Q8JhVssgnCtLtd5itN59iHQh4MBF
40nX0tFXtJ4U9AsxNrM=
</SignatureValue>
<KeyInfo>
<X509Data>
<X509SubjectName>
CN=SILVA e SILVA LTDA,OU=(EM BRANCO),OU=(EM BRANCO),OU=(EM BRANCO),OU=(EM BRANCO),
OU=(EM BRANCO),OU=49454600000119,OU=(EM BRANCO),O=ICP-Brasil,C=BR
</X509SubjectName>
<X509Certificate>
MIIGTjCCBTagAwIBAgIICh7+zptO1n8wDQYJKoZIhvcNAQEFBQAwTDELMAkGA1UEBhMCQlIxEzAR
BgNVBAoTCklDUC1CcmFzaWwxKDAmBgNVBAMTH1NFUkFTQSBDZXJ0aWZpY2Fkb3JhIERpZ2l0YWwg
djEwHhcNMTEwMTAzMTkzNTA0WhcNMTIwMTAzMTkzNTA0WjCB+DELMAkGA1UEBhMCQlIxEzARBgNV
BAoTCklDUC1CcmFzaWwxFDASBgNVBAsTCyhFTSBCUkFOQ08pMRgwFgYDVQQLEw8wMDAwMDEwMDE1
OTA3MTAxFDASBgNVBAsTCyhFTSBCUkFOQ08pMRQwEgYDVQQLEwsoRU0gQlJBTkNPKTEUMBIGA1UE
CxMLKEVNIEJSQU5DTykxFDASBgNVBAsTCyhFTSBCUkFOQ08pMRQwEgYDVQQLEwsoRU0gQlJBTkNP
KTE2MDQGA1UEAwwtR0VUTkVUIFRFQyBFTSBDQVBUIEUgUFJPQyBUUkFOU0FDT0VTIEhVQUggUy9B
MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQD4yxM5Zyhx2eyOMHVbhAPL/KABe8uwRoG5VJ4Y
4a44xjYXcvDxB5WHIxsnsuhCfdfpKUVZlZig7SH/s44qFG22J6t0mZzF1HJRaXroU1w8kVyIhTUt
bZLEvSzePRj/4CbbwZcFz3mTYCI01DeLdNTGJhBZf6seyevvqdjnLavSbQIDAQABo4IDCTCCAwUw
DgYDVR0PAQH/BAQDAgXgMB0GA1UdJQQWMBQGCCsGAQUFBwMCBggrBgEFBQcDBDAfBgNVHSMEGDAW
gBS3YKhb+bKmrgDtdOvVSsmWaGb1XDCBzAYDVR0RBIHEMIHBgShPQlJJR0FDQU9GSVNDQUxAR0VU
TkVULVRFQ05PTE9HSUEuQ09NLkJSoDgGBWBMAQMEoC8TLTA5MDExOTUzMTQ1MTM3MTQwMzQwMDAw
MDAwMDAwMDAwMDAwMDAwMDAwMDAwMKAnBgVgTAEDAqAeExxBTlRPTklPIENMQVVESU8gTVVOSVo
g
Qk9SR0VToBkGBWBMAQMDoBATDjA1MTI3NDM4MDAwMTU5oBcGBWBMAQMHoA4TDDAwMDAwMDAw
MDAw
MDBXBgNVHSAEUDBOMEwGBmBMAQIBBjBCMEAGCCsGAQUFBwIBFjRodHRwOi8vd3d3LmNlcnRpZmlj
YWRvZGlnaXRhbC5jb20uYnIvcmVwb3NpdG9yaW8vZHBjMIHwBgNVHR8EgegwgeUwSaBHoEWGQ2h0

Pg. 34 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

dHA6Ly93d3cuY2VydGlmaWNhZG9kaWdpdGFsLmNvbS5ici9yZXBvc2l0b3Jpby9sY3Ivc2VyYXNh
Y2R2MS5jcmwwQ6BBoD+GPWh0dHA6Ly9sY3IuY2VydGlmaWNhZG9zLmNvbS5ici9yZXBvc2l0b3Jp
by9sY3Ivc2VyYXNhY2R2MS5jcmwwU6BRoE+GTWh0dHA6Ly9yZXBvc2l0b3Jpby5pY3BicmFzaWwu
Z292LmJyL2xjci9TZXJhc2EvcmVwb3NpdG9yaW8vbGNyL3NlcmFzYWNkdjEuY3JsMIGXBggrBgEF
BQcBAQSBijCBhzBHBggrBgEFBQcwAoY7aHR0cDovL3d3dy5jZXJ0aWZpY2Fkb2RpZ2l0YWwuY29t
LmJyL2NhZGVpYXMvc2VyYXNhY2R2MS5wN2IwPAYIKwYBBQUHMAGGMGh0dHA6Ly9vY3NwLmNlcnRp
ZmljYWRvZGlnaXRhbC5jb20uYnIvc2VyYXNhY2R2MTANBgkqhkiG9w0BAQUFAAOCAQEAc3n5rZzm
7/A85/0191Rdz23Upu33UPLhJBjyui5El6Dy9jKIZ8NBREnhRajnNW44R22EJX6hDyUycwS8xgvP
Yi/GmrtO+WQ88GpqesLtBIXKy1NJ1y4BKmRxBLbvfD9aHLC47dtbPwy3bC5ZFKMptkeswPpMz5ge
A4EbHyzbE+Dbdmvy07+4I/WYYliW7k02ym2jjJievLdHDjCdCYyrYRfDaM+ar/n7gsQUHJOd0CHe
5nBsDOLupkwbB9y8vi+vYNtFjMw+v4vtEK7cmlTYc/BitFE1Sbs0pTSFLZlacGR4hgXxXNi6aXtH
HxChfaOqyd2gL0EY5cacC5UWE6ndmg==</X509Certificate>
</X509Data>
</KeyInfo>
</Signature>

Pg. 35 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

3. Servios Web disponveis


A seguir so detalhados os servios web disponveis, conforme citado no item 2.1,
relacionando cada servio Web com seu respectivo XML Schema. O XML Schema define a estrutura
e formatao do arquivo XML que conter os dados a serem transmitidos. Esses documentos sero
enviados de forma textual (como um string) como parmetros do servio oferecido pelo servio
Web.

As tabelas que detalham cada XML Schema esto organizadas da seguinte forma:
(1)
# Nome Tipo Pai Ocor. Obr. Observao
(2) (3) (4) (5) (6) (7) (8)
(9) (10)

Legenda da tabela:
(1) Elemento;
(2) Nmero identificador do campo, quando este contiver subitens;
(3) Nome do campo;
(4) Nome do tipo do campo que pode ser do tipo primitivo, simples ou complexo;
(5) Indica qual o campo pai, para definio da hierarquia;
(6) Quantas vezes o campo se repete na estrutura de dados: Formato: x-y onde x a
quantidade mnima e y a quantidade mxima. Se a quantidade mxima for indefinida, ser
utilizado N no lugar do y;
(7) Indica se obrigatrio (valor 'S') ou opcional (valor 'N')
(8) Descreve alguma observao pertinente;
(9) Formato de grupo, utilizado para definio de uma escolha (ver prximo item);
(10) Identifica os campos ou grupos que faro parte de uma escolha (Choice).

3.1 Servios sobre lotes NFS-e


3.1.1 Envio de lote NFS-e
Esse servio Web permite o envio de um lote de Notas Fiscais de Servio eletrnicas, obtendo
como retorno um nmero de protocolo gerado para esta transao e a situao do lote. Quando
efetuada a recepo, o lote entra em uma fila para processamento. Posteriormente, so realizadas
de forma assncrona as validaes necessrias e a gerao das NFS-e's.

Pg. 36 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

Execuo
O servio ser executado pelo mtodo enviarLoteNotas passando a mensagem XML como
parmetro em conformidade com a estrutura definida na tabela a seguir.

envioLote
# Nome Tipo Pai Ocor. Obr. Observao
1 CNPJ TCnpj 1-1 S Prestador
2 dhTrans TDataHora 1-1 S Data da transmisso do lote
3 NFS-e NFS-e 1-999 N Todas as informaes de cada uma das
notas do lote, conforme o formato da tag
<NFSe> descrito na Seo 2.2.2.
4 Signature Signature 1-1 S Assinatura digital

No exemplo abaixo e em todos os seguintes, pode-se notar os atributos: version da tag


xml, que definido pelo padro da W3C e indica a verso do formato XML da W3C; versao da
tag envioLote, que indica a verso do formato XML para o servio Web envioLote do sistema
NFSe do Municpio de Caxias do Sul; e versao da tag infNFSe, que indica a verso do formato
XML para as informaes das NFSe do Municpio de Caxias do Sul.

Exemplo de XML
<?xml version="1.0" encoding="UTF-8"?>
<envioLote versao="1.0">
<CNPJ>49454600000119</CNPJ>
<dhTrans>2013-04-07 07:28:12</dhTrans>
<NFS-e>
<infNFSe versao="1.1">
<Id>
<cNFS-e>218736215</cNFS-e>
<mod>98</mod>
<serie>S</serie>
<nNFS-e>976</nNFS-e>
<dEmi>2013-04-07</dEmi>
<hEmi>06:15</hEmi>
<tpNF>1</tpNF>
<refNF>43494546000001199800S000000976218736215</refNF>
<tpImp>1</tpImp>
<tpEmis>N</tpEmis>
<cancelada>N</cancelada>
<canhoto>1</canhoto>
<ambienteEmi>2</ambienteEmi>
<formaEmi>2</formaEmi>
<empreitadaGlobal>2</empreitadaGlobal>
</Id>

Pg. 37 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

<prest>
<CNPJ>49454600000119</CNPJ>
<xNome>Silva e Silva Ltda</xNome>
<xFant>Silva e Silva</xFant>
<IM>23231</IM>
<xEmail>teste@teste.com</xEmail>
<xSite>www.sitedaempresa.com.br</xSite>
<end>
<xLgr>Rua Alfredo Chaves</xLgr>
<nro>1750</nro>
<xCpl>Sala</xCpl>
<xBairro>Centro</xBairro>
<cMun>4305108</cMun>
<xMun>Caxias do Sul</xMun>
<UF>RS</UF>
<CEP>95020460</CEP>
<cPais>01058</cPais>
<xPais>Brasil</xPais>
</end>
<fone>5421091919</fone>
<fone2>5499999999</fone2>
<IE>0291234567</IE>
<regimeTrib>3</regimeTrib>
</prest>
<TomS>
<CNPJ>99882491000109</CNPJ>
<xNome>Empresa Tomadora</xNome>
<ender>
<xLgr>Av Silva</xLgr>
<nro>131</nro>
<xCpl>Sala</xCpl>
<xBairro>Centro</xBairro>
<cMun>4305108</cMun>
<xMun>Caxias do Sul</xMun>
<UF>RS</UF>
<CEP>95020000</CEP>
<cPais>01058</cPais>
<xPais>Brasil</xPais>
</ender>
<xEmail>tomador@tomador.com.br</xEmail>
<IE>2132365544</IE>
<IM>64889</IM>
<fone>5435302020</fone>
<fone2>5499999999</fone2>
</TomS>
<dadosDaObra>
<xLogObra>Av Santos</xLogObra>
<xComplObra>Sala</xComplObra>
<vNumeroObra>320</vNumeroObra>
<xBairroObra>Centro</xBairroObra>
<xCepObra>95020460</xCepObra>

Pg. 38 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

<cCidadeObra>4305108</cCidadeObra>
<xCidadeObra>Caxias Do Sul</xCidadeObra>
<xUfObra>RS</xUfObra>
<cPaisObra>01058</cPaisObra>
<xPaisObra>Brasil</xPaisObra>
<numeroArt>123456789012</numeroArt>
<numeroCei>123456789012</numeroCei>
<numeroProj>846548</numeroProj>
<numeroMatri>8494546</numeroMatri>
</dadosDaObra>
<transportadora>
<xNomeTrans>Transportadora Ficticia LTDA</xNomeTrans>
<xCpfCnpjTrans>26578334000130</xCpfCnpjTrans>
<xInscEstTrans>1232185494</xInscEstTrans>
<xPlacaTrans>IBB6962</xPlacaTrans>
<xEndTrans>Av. Carlos Gomes</xEndTrans>
<cMunTrans>4305108</cMunTrans>
<xMunTrans>Caxias Do Sul</xMunTrans>
<xUfTrans>RS</xUfTrans>
<cPaisTrans>01058</cPaisTrans>
<xPaisTrans>Brasil</xPaisTrans>
<vTipoFreteTrans>0</vTipoFreteTrans>
</transportadora>
<det>
<nItem>1</nItem>
<serv>
<cServ>1505</cServ>
<cLCServ>1405</cLCServ>
<xServ>Pintura</xServ>
<localTributacao>4305108</localTributacao>
<localVerifResServ>1</localVerifResServ>
<uTrib>m2</uTrib>
<qTrib>30</qTrib>
<vUnit>100.00</vUnit>
<vServ>3000.00</vServ>
<vDesc>0.00</vDesc>
<vBCISS>3000.00</vBCISS>
<pISS>4.00</pISS>
<vISS>120.00</vISS>
<vBCINSS>0.00</vBCINSS>
<pRetINSS>0.00</pRetINSS>
<vRetINSS>0.00</vRetINSS>
<vRed>0.00</vRed>
<vBCRetIR>0.00</vBCRetIR>
<pRetIR>0.00</pRetIR>
<vRetIR>0.00</vRetIR>
<vBCCOFINS>0.00</vBCCOFINS>
<pRetCOFINS>0.00</pRetCOFINS>
<vRetCOFINS>0.00</vRetCOFINS>
<vBCCSLL>0.00</vBCCSLL>
<pRetCSLL>0.00</pRetCSLL>

Pg. 39 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

<vRetCSLL>0.00</vRetCSLL>
<vBCPISPASEP>0.00</vBCPISPASEP>
<pRetPISPASEP>0.00</pRetPISPASEP>
<vRetPISPASEP>0.00</vRetPISPASEP>
</serv>
</det>
<total>
<vServ>3000.00</vServ>
<vRedBCCivil>0.00</vRedBCCivil>
<vDesc>0.00</vDesc>
<vtNF>3000.00</vtNF>
<vtLiq>3000.00</vtLiq>
<Ret>
<vRetIR>0.00</vRetIR>
<vRetPISPASEP>0.00</vRetPISPASEP>
<vRetCOFINS>0.00</vRetCOFINS>
<vRetCSLL>0.00</vRetCSLL>
<vRetINSS>0.00</vRetINSS>
</Ret>
<vtLiqFaturas>3000.00</vtLiqFaturas>
<ISS>
<vBCISS>3000.00</vBCISS>
<vISS>120.00</vISS>
</ISS>
</total>
<faturas>
<fat>
<nItem>1</nItem>
<nFat>1</nFat>
<dVenc>2013-04-30</dVenc>
<vFat>3000.00</vFat>
</fat>
</faturas>
<infAdicLT>4305108</infAdicLT>
<infAdic>Esta nota apenas um exemplo de NFS-e \s\n
emitida em ambiente de homologao.</infAdic>
</infNFSe>
</NFS-e>
<Signature xmlns="http://www.w3.org/2000/09/xmldsig#">
<SignedInfo>
<CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/>
<SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1"/>
<Reference URI="">
<Transforms>
<Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"/>
<Transform Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/>
</Transforms>
<DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/>
<DigestValue>hsr+JtpASOG8Yf+gZt7BOuzGWeY=</DigestValue>
</Reference>
</SignedInfo>

Pg. 40 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

<SignatureValue>eKea3wK5XOdH+9KBNk/ZzeVa8tPLp5mllkeOXx+ABMCCiXh4xTRyshvCc+16VELCU+anY/3Ts
wzP
poxM3hSEct2kNfBYFnZVjXzUoD1Sl9rOAq2mj5Kbaft58fA/Q8JhVssgnCtLtd5itN59iHQh4MBF
40nX0tFXtJ4U9AsxNrM=</SignatureValue>
<KeyInfo>
<X509Data>
<X509SubjectName>
CN=SILVA e SILVA LTDA,OU=(EM BRANCO),OU=(EM BRANCO),OU=(EM BRANCO),OU=(EM BRANCO),
OU=(EM BRANCO),OU=49454600000119,OU=(EM BRANCO),O=ICP-Brasil,C=BR
</X509SubjectName>
<X509Certificate>MIIGTjCCBTagAwIBAgIICh7+zptO1n8wDQYJKoZIhvcNAQEFBQAwTDELMAkGA1UEBhMCQlI
xEzAR
BgNVBAoTCklDUC1CcmFzaWwxKDAmBgNVBAMTH1NFUkFTQSBDZXJ0aWZpY2Fkb3JhIERpZ2l0YWwg
djEwHhcNMTEwMTAzMTkzNTA0WhcNMTIwMTAzMTkzNTA0WjCB+DELMAkGA1UEBhMCQlIxEzARBgNV
BAoTCklDUC1CcmFzaWwxFDASBgNVBAsTCyhFTSBCUkFOQ08pMRgwFgYDVQQLEw8wMDAwMDEwMDE1
OTA3MTAxFDASBgNVBAsTCyhFTSBCUkFOQ08pMRQwEgYDVQQLEwsoRU0gQlJBTkNPKTEUMBIGA1UE
CxMLKEVNIEJSQU5DTykxFDASBgNVBAsTCyhFTSBCUkFOQ08pMRQwEgYDVQQLEwsoRU0gQlJBTkNP
KTE2MDQGA1UEAwwtR0VUTkVUIFRFQyBFTSBDQVBUIEUgUFJPQyBUUkFOU0FDT0VTIEhVQUggUy9B
MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQD4yxM5Zyhx2eyOMHVbhAPL/KABe8uwRoG5VJ4Y
4a44xjYXcvDxB5WHIxsnsuhCfdfpKUVZlZig7SH/s44qFG22J6t0mZzF1HJRaXroU1w8kVyIhTUt
bZLEvSzePRj/4CbbwZcFz3mTYCI01DeLdNTGJhBZf6seyevvqdjnLavSbQIDAQABo4IDCTCCAwUw
DgYDVR0PAQH/BAQDAgXgMB0GA1UdJQQWMBQGCCsGAQUFBwMCBggrBgEFBQcDBDAfBgNVHSMEGDAW
gBS3YKhb+bKmrgDtdOvVSsmWaGb1XDCBzAYDVR0RBIHEMIHBgShPQlJJR0FDQU9GSVNDQUxAR0VU
TkVULVRFQ05PTE9HSUEuQ09NLkJSoDgGBWBMAQMEoC8TLTA5MDExOTUzMTQ1MTM3MTQwMzQwMDAw
MDAwMDAwMDAwMDAwMDAwMDAwMDAwMKAnBgVgTAEDAqAeExxBTlRPTklPIENMQVVESU8gTVVOSVo
g
Qk9SR0VToBkGBWBMAQMDoBATDjA1MTI3NDM4MDAwMTU5oBcGBWBMAQMHoA4TDDAwMDAwMDAw
MDAw
MDBXBgNVHSAEUDBOMEwGBmBMAQIBBjBCMEAGCCsGAQUFBwIBFjRodHRwOi8vd3d3LmNlcnRpZmlj
YWRvZGlnaXRhbC5jb20uYnIvcmVwb3NpdG9yaW8vZHBjMIHwBgNVHR8EgegwgeUwSaBHoEWGQ2h0
dHA6Ly93d3cuY2VydGlmaWNhZG9kaWdpdGFsLmNvbS5ici9yZXBvc2l0b3Jpby9sY3Ivc2VyYXNh
Y2R2MS5jcmwwQ6BBoD+GPWh0dHA6Ly9sY3IuY2VydGlmaWNhZG9zLmNvbS5ici9yZXBvc2l0b3Jp
by9sY3Ivc2VyYXNhY2R2MS5jcmwwU6BRoE+GTWh0dHA6Ly9yZXBvc2l0b3Jpby5pY3BicmFzaWwu
Z292LmJyL2xjci9TZXJhc2EvcmVwb3NpdG9yaW8vbGNyL3NlcmFzYWNkdjEuY3JsMIGXBggrBgEF
BQcBAQSBijCBhzBHBggrBgEFBQcwAoY7aHR0cDovL3d3dy5jZXJ0aWZpY2Fkb2RpZ2l0YWwuY29t
LmJyL2NhZGVpYXMvc2VyYXNhY2R2MS5wN2IwPAYIKwYBBQUHMAGGMGh0dHA6Ly9vY3NwLmNlcnRp
ZmljYWRvZGlnaXRhbC5jb20uYnIvc2VyYXNhY2R2MTANBgkqhkiG9w0BAQUFAAOCAQEAc3n5rZzm
7/A85/0191Rdz23Upu33UPLhJBjyui5El6Dy9jKIZ8NBREnhRajnNW44R22EJX6hDyUycwS8xgvP
Yi/GmrtO+WQ88GpqesLtBIXKy1NJ1y4BKmRxBLbvfD9aHLC47dtbPwy3bC5ZFKMptkeswPpMz5ge
A4EbHyzbE+Dbdmvy07+4I/WYYliW7k02ym2jjJievLdHDjCdCYyrYRfDaM+ar/n7gsQUHJOd0CHe
5nBsDOLupkwbB9y8vi+vYNtFjMw+v4vtEK7cmlTYc/BitFE1Sbs0pTSFLZlacGR4hgXxXNi6aXtH
HxChfaOqyd2gL0EY5cacC5UWE6ndmg==</X509Certificate>
</X509Data>
</KeyInfo>
</Signature>
</envioLote>

Pg. 41 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

3.1.2 Confirmao de recebimento de lote NFS-e


Um arquivo XML em conformidade com a estrutura mostrada na tabela a seguir retornado
como resposta ao servio de envio de um lote de NFS-e. Com os dados ele traz o cdigo do lote
que pode ser usado pelo contribuinte para verificar a critica de processamento do lote
posteriormente.

confirmaLote
# Nome Tipo Pai Ocor. Obr. Observao
1 CNPJ TCnpj 1-1 S Prestador
2 cLote TString15 1-1 S Nmero do lote

3 dhRecbto TDataHora 1-1 S Data e hora de recebimento


4 sit TSituacaoLote 1-1 S Situao do lote:
100-Aceito
200-Rejeitado
5 mot TString100 1-1 S Motivo da rejeio do processamento do
lote
6 Signature Signature 1-1 S Assinatura digital

Exemplo de XML
<?xml version="1.0" encoding="UTF-8"?>
<confirmaLote versao="1.0" >
<CNPJ>49454600000119</CNPJ>
<cLote>13585</cLote>
<dhRecbto>2013-04-18 08:38:05</dhRecbto>
<sit>100</sit>
<mot></mot>
<Signature> </Signature>
</confirmaLote>

3.1.3 Pedido de status de um lote NFS-e


Esse servio permite que o contribuinte obtenha a crtica de um lote de NFS-e j enviado. Uma
vez que o processamento do lote tenha sido concludo, o contribuinte pode obter a crtica do lote
para verificar possveis erros de validao e/ou consultar o resultado do processamento. Na crtica
do lote, que retornada por este servio, so listados todos os erros encontrados do lote, caso
existam.

Pg. 42 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

Execuo
O servio executado pelo mtodo obterCriticaLote passando a mensagem XML como
parmetro, em conformidade com a estrutura definida na tabela a seguir.

pedidoStatusLote
# Nome Tipo Pai Ocor. Obr. Observao
1 CNPJ TCnpj 1-1 S Prestador
2 cLote TString15 1-1 S Nmero do lote
3 Signature Signature 1-1 S Assinatura digital

Exemplo de XML
<?xml version="1.0" encoding="UTF-8"?>
<pedidoStatusLote versao="1.0">
<CNPJ>49454600000119</CNPJ>
<cLote>13585</cLote>
<Signature> </Signature>
</pedidoStatusLote>

3.1.4 Resultado do pedido de status de um lote NFS-e


Um arquivo XML em conformidade com a estrutura mostrada na tabela a seguir retornado
como resposta ao servio de pedido de crtica de um lote de NFS-e. Ele contm o status de cada
uma das notas fiscais de servios eletrnicas que estavam contidas no lote processado.

resultadoLote
# Nome Tipo Pai Ocor. Obr. Observao
1 CNPJ TCnpj 1-1 S Prestador
2 cLote TString15 1-1 S Nmero do lote
3 NFSe 1-999 S Dado(s) da nota(s).
4 chvAcessoNFSe TChaveAcesso 3 0-1 S Chave de acesso
5 sit TSituacaoNota 3 1-1 S Situao da nota conforme
tabela da Seo 2.2

6 motivos 1-N S Motivos relativos situao da


nota
7 mot TString100 6 1-1 S Motivo relativo situao da
nota
8 Signature Signature 1-1 S Assinatura digital

Pg. 43 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

Exemplo de XML
<?xml version="1.0" encoding="UTF-8"?>
<resultadoLote versao="1.0" >
<CNPJ>49454600000119</CNPJ>
<cLote>13585</cLote>
<NFSe>
<chvAcessoNFSe>004945460000011998001000001001218286625</chvAcessoNFSe>
<sit>100</sit>
<motivos>
<mot>Nota fiscal 1001 aceita. Protocolo nr. 849973</mot>
</motivos>
</NFSe>
<Signature> </Signature>
</resultadoLote>

Em caso de lote aguardando processamento:

<?xml version='1.0' encoding='utf-8'?>


<resultadoLote versao="1.0" >
<CNPJ>49454600000119</CNPJ>
<cLote>19710</cLote>
<NFSe>
<sit>217</sit>
<motivos>
<mot>NFS-e(s) j recebida(s) e no processada(s).</mot>
</motivos>
</NFSe>
</resultadoLote>

3.1.5 Pedido de cancelamento de lote NFS-e


Esse servio permite que o contribuinte solicite o cancelamento de um lote de NFS-e j
enviado, mas que ainda no tenha sido processado. Caso o processamento do lote tenha sido j
concludo, o servio retornar uma mensagem de erro alertando para a impossibilidade de
cancelamento.
Execuo
O servio executado pelo mtodo cancelarLote passando a mensagem XML como
parmetro, em conformidade com a estrutura definida na tabela a seguir.
pedidoCancelamentoLote
# Nome Tipo Pai Ocor. Obr. Observao
1 CNPJ TCnpj 1-1 S Prestador
2 cLote TString15 1-1 S Nmero do lote
3 Signature Signature 1-1 S Assinatura digital

Pg. 44 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

Exemplo de XML
<?xml version="1.0" encoding="UTF-8"?>
<pedidoCancelamentoLote versao="1.0">
<CNPJ>49454600000119</CNPJ>
<cLote>13585</cLote>
<Signature> </Signature>
</pedidoCancelamentoLote>

3.1.6 Resultado do pedido de cancelamento de lote NFS-e


Um arquivo XML em conformidade com a estrutura mostrada na tabela a seguir retornado
como resposta ao servio de pedido de cancelamento de um lote de NFS-e. O arquivo contm o
status do lote processado.

confirmaCancelamentoLote
# Nome Tipo Pai Ocor. Obr. Observao
1 CNPJ TCnpj 1-1 S Prestador
2 cLote TString15 1-1 S Nmero do lote
3 dhRecbto TDataHora 1-1 S Data e hora
4 sit TSituacaoLote 1-1 S Situao do lote:
100-Aceito
200-Rejeitado
5 mot TString100 1-1 S Motivo da rejeio do cancelamento
do lote
6 Signature Signature 1-1 S Assinatura digital

Exemplo de XML
<?xml version="1.0" encoding="UTF-8"?>
<confirmaCancelamentoLote versao="1.0" >
<CNPJ>49454600000119</CNPJ>
<cLote>1230</cLote>
<dhRecbto>2013-04-18 16:15:12</dhRecbto>
<sit>200</sit>
<mot>Error1249 No foi possvel cancelar o lote: Cancelamento deste lote no permitido</mot>
<Signature> </Signature>
</confirmaCancelamentoLote>

Pg. 45 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

3.1.7 Pedido de um lote NFS-e


Esse servio permite que o contribuinte solicite um lote de NFS-e j enviado. Caso o lote no
exista, o servio retornar uma mensagem de erro alertando para este fato.

Execuo
O servio executado pelo mtodo obterLoteNotaFiscal passando a mensagem XML como
parmetro, em conformidade com a estrutura definida na tabela a seguir.
pedidoLoteNFSe
# Nome Tipo Pai Ocor. Obr. Observao
1 CNPJ TCnpj 1-1 S Prestador
2 notaInicial TNF 0-1 N Nota inicial
3 notaFinal TNF 0-1 N Nota final
4 emissaoInicial TData 0-1 N Data inicial
5 emissaoFinal TData 0-1 N Data final
6 serieNotaFiscal TSerie 0-1 N Serie
7 Signature Signature 1-1 S Assinatura digital

Exemplo de XML por nmero de NFSe


<?xml version="1.0" encoding="UTF-8"?>
<pedidoLoteNFSe versao="1.0">
<CNPJ>49454600000119</CNPJ>
<notaInicial>1001</notaInicial>
<notaFinal>1001</notaFinal>
<serieNotaFiscal>S</serieNotaFiscal>
<Signature> </Signature>
</pedidoLoteNFSe>

Exemplo de XML por perodo


<?xml version="1.0" encoding="UTF-8"?>
<pedidoLoteNFSe versao="1.0">
<CNPJ>49454600000119</CNPJ>
<emissaoInicial>2013-05-05</emissaoInicial>
<emissaoFinal>2013-05-07</emissaoFinal>
<Signature> </Signature>
</pedidoLoteNFSe>

Pg. 46 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

3.1.8 Resultado do pedido de um lote NFS-e


Um arquivo XML em conformidade com a estrutura mostrada na tabela a seguir retornado
como resposta ao servio de pedido de um lote de NFS-e. Contm o XML de cada uma das notas
solicitadas.
resPedidoLoteNFSe
# Nome Tipo Pai Ocor. Obr. Observao
1 CNPJ TCnpj 1-1 S Prestador
2 dhRecbto TDataHora 1-1 S Data e hora
4 NFS-e NFS-e 1-999 N Informaes sobre notas solicitadas,
usando tag <NFSe>, descrita na Seo
2.2.2, para cada nota
5 sit TSituacaoNot 1-1 S Situao do pedido de lote:
a 100-Aceito
200-Rejeitado
6 mot TString256 0-1 N Motivo da rejeio do pedido do lote
7 Signature Signature 1-1 S Assinatura digital

Exemplo de XML
<?xml version="1.0" encoding="UTF-8"?>
<resPedidoLoteNFSe versao="1.0">
<CNPJ>49454600000119</CNPJ>
<dhRecbto>2013-04-19 08:01:58</dhRecbto>
<NFS-e>
<!-- Aqui tem-se um trecho em XML em conformidade com a estrutura da tag <NFS-e> --!>
</NFS-e>
<sit>100</sit>
<Signature> </Signature>
</resPedidoLoteNFSe>

Pg. 47 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

3.2 Servios sobre uma NFS-e


3.2.1 Cancelamento de NFS-e
Esse servio permite que o contribuinte solicite o cancelamento de uma NFS-e j submetida.
Execuo
O servio executado pelo mtodo cancelarNotaFiscal passando a mensagem XML como
parmetro, em conformidade com a estrutura definida na tabela a seguir.
pedCancelaNFSe
# Nome Tipo Pai Ocor. Obr. Observao
1 CNPJ TCnpj 1-1 S Prestador
2 chvAcessoNFS-e TChaveAcesso 1-1 S Chave de acesso
3 motivo TMotCanc 1-1 S Motivo para o cancelamento
da nota, conforme quadro na
Seo 2.2.1.
4 Signature Signature 1-1 S Assinatura digital

Exemplo de XML
<?xml version="1.0" encoding="UTF-8"?>
<pedCancelaNFSe versao="1.0">
<CNPJ>49454600000119</CNPJ>
<chvAcessoNFS-e>434945460000011998000000976482769641</chvAcessoNFS-e>
<motivo>1</motivo>
<Signature> </Signature>
</pedCancelaNFSe>

Pg. 48 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

3.2.2 Resultado de cancelamento de NFS-e


Um arquivo XML em conformidade com a estrutura mostrada na tabela a seguir retornado
como resposta ao servio de pedido de cancelamento de uma NFS-e.

resCancelaNFSe
# Nome Tipo Pai Ocor. Obr. Observao
1 CNPJ TCnpj 1-1 S Prestador
2 chvAcessoNFS-e TChaveAcesso 1-1 S Chave de acesso
2 dhRecbto TDataHora 1-1 S Data e hora
3 nProt TString15 1-1 S Nmero do protocolo que
serve como comprovao
4 sit TSituacaoCancelament 1-1 S Situao do cancelamento
oNota da nota conforme tabela da
Seo 2.2.1
5 mot TString256 0-1 N Motivo da rejeio do
cancelamento da nota
6 Signature Signature 1-1 S Assinatura digital

Exemplo de XML
<?xml version="1.0" encoding="UTF-8"?>
<resCancelaNFSe versao="1.0" >
<CNPJ>49454600000119</CNPJ>
<chvAcessoNFS-e>434945460000011998000000976482769641</chvAcessoNFS-e>
<dhRecbto>2013-04-18 09:55:06</dhRecbto>
<nProt>849973</nProt>
<sit>100</sit>
<Signature> </Signature>
</resCancelaNFSe>

Pg. 49 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

3.2.3 Pedido de uma NFS-e


Esse servio permite que o contribuinte solicite as informaes de uma NFS-e j submetida.
Execuo
O servio executado pelo mtodo obterNotaFiscal passando a mensagem XML como
parmetro, em conformidade com a estrutura definida na tabela a seguir.

pedidoNFSe
# Nome Tipo Pai Ocor. Obr. Observao
1 CNPJ TCnpj 1-1 S Prestador
2 chvAcessoNFS-e TChaveAcesso 1-1 S Chave de acesso
3 Signature Signature 1-1 S Assinatura digital

Exemplo de XML
<?xml version="1.0" encoding="UTF-8"?>
<pedidoNFSe versao="1.0">
<CNPJ>49454600000119</CNPJ>
<chvAcessoNFS-e>434945460000011998000000976482769641</chvAcessoNFS-e>
<Signature> </Signature>
</pedidoNFSe>

3.2.4 Resultado de pedido de uma NFS-e


Um arquivo XML em conformidade com a estrutura mostrada na tabela a seguir retornado
como resposta ao servio de pedido de uma NFS-e. Contm todas as informaes da NFS-e
solicitada.
resPedidoNFSe
# Nome Tipo Pai Ocor. Obr. Observao
1 CNPJ TCnpj 1-1 S Prestador
2 chvAcessoNFS-e TChaveAcesso 1-1 S Chave de acesso
3 dhRecbto TdataHora 1-1 S Data e hora
4 NFS-e NFS-e 0-1 N Nota solicitada
5 sit TSituacaoNota 1-1 S Situao do pedido da nota:
100-Aceito
200-Rejeitado
6 mot TString256 0-1 N Motivo da rejeio do pedido
da nota
7 Signature Signature 1-1 S Assinatura digital

Pg. 50 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

Exemplo de XML
<?xml version="1.0" encoding="UTF-8"?>
<resPedidoNFSe versao="1.0">
<CNPJ>49454600000119</CNPJ>
<chvAcessoNFS-e>434945460000011998000000976482769641</chvAcessoNFS-e>
<dhRecbto>2013-04-18 10:49:59</dhRecbto>
<NFS-e>
<!-- Aqui tem-se as informaes em conformidade com a estrutura da tag <NFS-e> --!>
</NFS-e>
<sit>100</sit>
<Signature> </Signature>
</resPedidoNFSe>

3.2.5 Consulta sobre status de uma NFS-e


Esse servio permite que o contribuinte solicite o status de uma NFS-e j submetida.
Execuo
O servio executado pelo mtodo consultarNotaFiscal passando a mensagem XML como
parmetro, em conformidade com a estrutura definida na tabela a seguir.

pedConsultaTrans
# Nome Tipo Pai Ocor. Obr. Observao
1 CNPJ TCnpj 1-1 S Prestador
2 chvAcessoNFS-e TChaveAcesso 1-1 S Chave de acesso
3 Signature Signature 1-1 S Assinatura digital

Exemplo de XML
<?xml version="1.0" encoding="UTF-8"?>
<pedConsultaTrans versao="1.0">
<CNPJ>49454600000119</CNPJ>
<chvAcessoNFS-e>434945460000011998000000976482769641</chvAcessoNFS-e>
<Signature> </Signature>
</pedConsultaTrans>

Pg. 51 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

3.2.6 Resultado da consulta sobre status de uma NFS-e


Um arquivo XML em conformidade com a estrutura mostrada na tabela a seguir retornado
como resposta ao servio de consulta sobre o status de uma NFS-e.
resConsultaTrans
# Nome Tipo Pai Ocor. Obr. Observao
1 CNPJ TCnpj 1-1 S Prestador
2 chvAcessoNFS-e TChaveAcesso 1-1 S Chave de acesso
3 dhRecbto TDataHora 1-1 S Data e hora
4 nProt TString15 1-1 S Nmero do protocolo que
serve como comprovao
5 sitNFS-e TSituacaoNFSe 1-1 S Situao da NFS-e, conforme
tabela da Seo 2.2.1
6 sit TSituacaoNota 1-1 S Situao do pedido de
consulta da nota:
100-Aceito
200-Rejeitado
7 mot TString256 0-1 N Motivo da rejeio do pedido
de consulta da nota
8 Signature Signature 1-1 S Assinatura digital

Exemplo de XML
<?xml version="1.0" encoding="UTF-8"?>
<resConsultaTrans versao="1.0">
<CNPJ>49454600000119</CNPJ>
<chvAcessoNFS-e>434945460000011998000000976482769641</chvAcessoNFS-e>
<dhRecbto>2013-04-18 14:50:57</dhRecbto>
<nProt>849973</nProt>
<sitNFS-e>3</sitNFS-e>
<sit>100</sit>
<Signature> </Signature>
</resConsultaTrans>

Pg. 52 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

3.2.7 Pedido da imagem de uma NFS-e em formato PNG


Esse servio permite que o contribuinte solicite a imagem em formato PNG, codificada em
uma String Base64, de uma NFS-e j submetida e validada.
Execuo
O servio executado pelo mtodo obterNotasEmPNG passando a mensagem XML como
parmetro em conformidade com a estrutura definida na tabela a seguir.

pedidoNFSePNG
# Nome Tipo Pai Ocor. Obr. Observao
1 CNPJ TCnpj 1-1 S Prestador
2 notaInicial TNF 0-1 N Nota Inicial
3 notaFinal TNF 0-1 N Nota Final
4 emissaoInicial TData 0-1 N Data Inicial
5 emissaoFinal TData 0-1 N Data Final
6 serieNotaFiscal TSerie 0-1 N Serie
7 Signature Signature 1-1 S Assinatura digital

Exemplo de XML
<?xml version="1.0" encoding="utf-8"?>
<pedidoNFSePNG versao="1.0">
<CNPJ>49454600000119</CNPJ>
<notaInicial>1001</notaInicial>
<notaFinal>1001</notaFinal>
<emissaoInicial>2012-05-05</emissaoInicial>
<emissaoFinal>2012-05-07</emissaoFinal>
<serieNotaFiscal>PS</serieNotaFiscal>
<Signature>. . .</Signature>
</pedidoNFSePNG>

Pg. 53 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

3.2.8 Resultado do pedido da imagem de uma NFS-e em formato PNG


Um arquivo XML em conformidade com a estrutura mostrada na tabela a seguir retornado
como resposta ao servio de pedido de uma imagem de NFS-e. Caso a NFS-e no exista, o servio
retornar uma mensagem de erro alertando para este fato.

resPedidoLoteNFSePNG
# Nome Tipo Pai Ocor. Obr. Observao
1 CNPJ TCnpj 1-1 S Prestador
2 dhRecbto TDataHora 1-1 S Data e hora
3 NFS-ePNG TStringBase64 1-1 S Imagem em formato Base64 que pode ser
convertida para PNG
4 sit TSituacaoNota 1-1 S Situao da nota, conforme quadro da
Seo 2.2.1.
5 mot TString256 0-1 N Motivo da rejeio do pedido da imagem
da NFS-e
6 Signature Signature 1-1 S Assinatura digital

Exemplo de XML
<?xml version="1.0" encoding="UTF-8"?>
<resPedidoLoteNFSePNG versao="1.0" >
<CNPJ>49454600000119</CNPJ>
<dhRecbto>2013-04-19 11:08:15</dhRecbto>
<NFS-ePNG>
<!-- Contedo aqui um string em formato Base64 --!>
</NFS-ePNG>
<sit>100</sit>
<Signature> </Signature>
</resPedidoLoteNFSePNG>

3.2.9 Solicitao de Inutilizao de Numerao de NFS-e


Esse servio permite que o contribuinte solicite a inutilizao de nmeros de NFS-e. A
inutilizao obrigatria conforme Decreto n 17.137 de 26/08/14:

Art. 14. A numerao da NFS-e dever seguir a ordem crescente e sequencial.


I - o nmero da nota que for rejeitado no processamento do lote dever ser
reutilizado dentro da mesma data de emisso e, preferencialmente, dentro do
mesmo dia do lote original;

Pg. 54 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

II - no caso de impossibilidade de reutilizao de numerao, o contribuinte dever


usar o servio web de inutilizao de numerao, at o dia 15 (quinze) do ms
subsequente ao do fato gerador; e
III - as regras de reutilizao e inutilizao de numerao de NFS-e sero
estabelecidas em Manuais a serem aprovados em Instruo Normativa.

Execuo
O servio executado pelo mtodo inutilizacao passando a mensagem XML como parmetro,
em conformidade com a estrutura definida na tabela a seguir.

solicitacaoInutilizacao
# Nome Tipo Pai Ocor. Obr. Observao
1 numeroSolicitacao TNum 1-1 S Nmero que identifica uma
solicitao de inutilizao
2 cnpjContribuinte TCnpj 1-1 S Prestador que deseja
inutilizar numerao
3 dataSolicitacao TData 1-1 S Data da solicitao
4 horaSolicitacao THora 1-1 S Hora da solicitao
5 numerosInutilizados 1-1 S Lista das numeraes a
inutilizar
6 Inutilizar Atributos: 4 1-999 S Indicao de cada nmero e
numero - TNF srie a inutilizar
serie - TSerie
7 Signature Signature 1-1 S Assinatura digital

Exemplo de XML
<?xml version="1.0" encoding="UTF-8"?>
<solicitacaoInutilizacao versao="1.0">
<numeroSolicitacao>1</numeroSolicitacao>
<cnpjContribuinte>49454600000119</cnpjContribuinte>
<dataSolicitacao>2013-09-03</dataSolicitacao>
<horaSolicitacao>12:00</horaSolicitacao>
<numerosInutilizados>
<inutilizar numero=123456789 serie=S1></inutilizar>
<inutilizar numero=123456790 serie=S1></inutilizar>
<inutilizar numero=123456791 serie=S1></inutilizar>
</numerosInutilizados>
<Signature> </Signature>
</solicitacaoInutilizacao>

Pg. 55 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

3.2.10 Resultado de solicitao de inutilizao de numerao de NFS-e


Um arquivo XML em conformidade com a estrutura mostrada na tabela a seguir retornado
como resposta ao servio de solicitao de inutlizao de numerao de NFS-e. Contm todas as
informaes sobre a solicitao de inutilizao processada.

retornoSolicitacaoInutilizacao
# Nome Tipo Pai Ocor. Obr. Observao
1 numeroSolicitacao TNum 1-1 S Nmero que identifica uma
solicitao de inutilizao
2 cnpjContribuinte TCnpj 1-1 S Prestador que deseja
inutilizar numerao
3 dataRetornoSolicitac TData 1-1 S Data do retorno da
ao solicitao
4 horaRetornoSolicitac THora 1-1 S Hora do retorno da
ao solicitao
5 mensagem TString256 1 S Mensagem sobre o resultado
do processamento da
solicitao da inutilizao
6 protocolosInutiliza 0-1 N Lista das numeraes
o inutilizadas
7 inutilizado Atributos: 5 1-N S Indicao de cada nmero e
numero - TNF srie que foi inutilizado
serie - TSerie
8 Signature Signature 1-1 S Assinatura digital

Exemplo de XML com retorno do processamento de solicitao de inutilizao realizado com


sucesso
<?xml version="1.0" encoding="UTF-8"?>
<retornoSolicitacaoInutilizacao versao="1.0">
<numeroSolicitacao>1</numeroSolicitacao>
<cnpjContribuinte>49454600000119</cnpjContribuinte>
<dataSolicitacao>2013-09-03</dataSolicitacao>
<horaSolicitacao>12:00</horaSolicitacao>
<mensagem>Inutilizaes processadas com sucessos</mensagem>
<protocolosInutilizacao>
<inutilizado numero=123456789 serie=S1>000000005</inutilizado>
<inutilizado numero=123456790 serie=S1>000000006</inutilizado>
<inutilizado numero=123456791 serie=S1>000000007</inutilizado>
</protocolosInutilizacao>
<Signature> </Signature>
</retornoSolicitacaoInutilizacao>

Pg. 56 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

Exemplo de XML com retorno do processamento de solicitao de inutilizao realizado com


problemas
<?xml version="1.0" encoding="UTF-8"?>
<retornoSolicitacaoInutilizacao versao="1.0">
<numeroSolicitacao>2</numeroSolicitacao>
<cnpjContribuinte>49454600000119</cnpjContribuinte>
<dataSolicitacao>2013-09-04</dataSolicitacao>
<horaSolicitacao>13:00</horaSolicitacao>
<mensagem>Nmero no inutilizado, pois h erros no lote. Nmero [1234567816]; Srie
[T]</mensagem>
<mensagem>Nmero j uma nota fiscal vlida emitida em [0909/2013]. Nmero [1234567817]; Srie
[T]</mensagem>
<mensagem>Nmero no inutilizado, pois h erros no lote. Nmero [1234567818]; Srie
[T]</mensagem>
<Signature> </Signature>
</retornoSolicitacaoInutilizacao>

3.2.11 Pedido da imagem de uma NFS-e em formato PDF

Esse servio permite que o contribuinte solicite a imagem em formato PDF, codificada em uma
String Base64, de uma NFS-e j submetida e validada.
Execuo
O servio executado pelo mtodo obterNotasEmPDF passando a mensagem XML como
parmetro em conformidade com a estrutura definida na tabela a seguir.

pedidoNFSePDF
# Nome Tipo Pai Ocor. Obr. Observao
1 CNPJ TCnpj 1-1 S Prestador
2 notaInicial TNF 0-1 N Nota Inicial
3 notaFinal TNF 0-1 N Nota Final
4 emissaoInicial TData 0-1 N Data Inicial
5 emissaoFinal TData 0-1 N Data Final
6 serieNotaFiscal TSerie 0-1 N Serie
7 Signature Signature 1-1 S Assinatura digital

Pg. 57 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

Exemplo de XML
<?xml version="1.0" encoding="utf-8"?>
<pedidoNFSePDF versao="1.0">
<CNPJ>08967207000141</CNPJ>
<notaInicial>1000</notaInicial>
<notaFinal>1000</notaFinal>
<emissaoInicial>2015-04-01</emissaoInicial>
<emissaoFinal>2015-04-01</emissaoFinal>
<serieNotaFiscal>N1</serieNotaFiscal>
</pedidoNFSePDF>

3.2.12 Resultado do pedido da imagem de uma NFS-e em formato PDF


Um arquivo XML em conformidade com a estrutura mostrada na tabela a seguir retornado
como resposta ao servio de pedido de uma imagem de NFS-e. Caso a NFS-e no exista, o servio
retornar uma mensagem de erro alertando para este fato.

resPedidoLoteNFSePDF
# Nome Tipo Pai Ocor. Obr. Observao
1 CNPJ TCnpj 1-1 S Prestador
2 dhRecbto TDataHora 1-1 S Data e hora
3 NFS-ePDF TStringBase64 0-1 S Imagem em formato Base64 que pode ser
convertida para PDF
4 sit TSituacaoNota 1-1 S Situao da nota, conforme quadro da
Seo 2.2.1.
5 mot TString256 0-1 N Motivo da rejeio do pedido da imagem da
NFS-e
6 Signature Signature 1-1 S Assinatura digital

Exemplo de XML
<?xml version='1.0' encoding='utf-8'?>
<resPedidoLoteNFSePDF versao="1.0" >
<CNPJ>08967207000141</CNPJ>
<dhRecbto>2015-07-09 10:37:08</dhRecbto>
<NFS-ePDF>JVBE(. . . base64 . . .)PYm</NFS-ePDF>
<sit>100</sit>
</resPedidoLoteNFSePDF>

Pg. 58 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

4. Informaes complementares
4.1. Orientaes sobre o uso das tags da NFS-e
Nesta seo tem-se algumas orientaes a serem seguidas pelo prestador na gerao do
arquivo XML de NFS-e.

4.1.1. Informaes sobre tomador

No caso do pas do tomador ser diferente de Brasil (indicado atravs das tags <cPais> e <xPais>
dentro de <ender> de <TomS>, que fica em <infNFSe>), deve ser obrigatoriamente informado:

i) o CNPJ com valor zerado (tag <CNPJ>00000000000000</CNPJ> dentro da tag <TomS>, ou

ii) o CPF com valor zerado (tag <CPF>00000000000</CPF> dentro da tag <TomS>.

4.1.2. Informaes sobre servios

No caso de servios prestados com substituio tributria (ST), deve ser observado que as
informaes devem ser fornecidas utilizando a tag <ISSST> dentro da tag <det>, que serve para
detalhar cada item de servio prestado. A tag <det> fica dentro da tag <infNFSe> e pode se repetir
at 999 vezes.
Na tag <ISSST> de cada item de servio, pode ser indicado:

i) o valor da base de clculo de substituio tributria usando a tag <vBCST>;


ii) a alquota do ISSQN por ST usando a tag <pISSST>;
iii) o valor do ISSQN por ST usando a tag <vISSST>;
iv) o valor da reduo da base de clculo, se for o caso, usando a tag <vRedBCST>.

Alm disso, devem ser necessariamente fornecidas as totalizaes usando as tags <vBCSTISS>
(total da base de clculo de ISS por ST) e <vSTISS> (total do ISSQN por ST) dentro da tag <ISS>. A
tag <ISS> fica dentro da tag <total>, que serve para se indicar todas as totalizaes de uma NFS-e.

Pg. 59 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

4.1.3. Informaes sobre retenes

Para indicar retenes federais em cada item de servio prestado da NFS-e, podem ser
utilizadas as tags dentro da tag <serv>:

i) <vBCINSS>, <pRetINSS> e <vRetINNS> para base de clculo, percentual e valor da reteno de


INSS;
ii) <vBCRetIR>, <pRetIR> e <vRetIR> para base de clculo, percentual e valor da reteno de IR;
iii) <vBCCOFINS>, <pRetCOFINS> e <vRetCOFINS> para base de clculo, percentual e valor da
reteno de COFINS;

iv) <vBCCSLL>, <pRetCSLL> e <vRetCSLL> para base de clculo, percentual e valor da reteno de
CSLL;
v) <vBCPISPASEP>, <pRetPISPASEP> e <vRetPISPASEP> para base de clculo, percentual e valor da
reteno de PIS-PASEP.

Alm disso, obrigatrio utilizar a tag <Ret> dentro da tag <total> para indicar o valor total de
todas as retenes (<vRetIR>, <vRetPISPASEP>, <vRetCOFINS>, <vRetCSLL> e <vRetINSS>), que
tenham sido indicadas nos itens de servio da NFS-e.

Para indicar as descries de cada reteno federal devem ser utilizadas tags <infAdic>
conforme descrito na Seo 4.2 adiante.

4.1.4. Anulao e cancelamento de NFS-e

Em verses anteriores do processamento de NFS-e via servios web vinha sendo utilizado o
termo anulao para se referir ao processo de anular uma NFS-e j emitida e validada.

Este mesmo processo agora, nesta verso do Manual de Conectividade e, consequentemente,


no processamento realizado pelos servios web, passa a ser tratado pelo termo cancelamento.

Assim, as tags <anulada>, <motAnul> e <dataAnul> foram substitudas pelas tags <cancelada>,
<motCanc> e <dataCanc>, respectivamente. Alm disso, o servio web pedidoAnulaNotaFiscal
foi substitudo por pedCancelaNFSe e o XML de retorno deste servio web passou de
resPedidoAnulaNotaFiscal para resCancelaNFSe.

O efeito deste processo o mesmo de antes, sendo que na imagem da NFS-e agora aparece
uma marca d'gua com a palavra Cancelada ao invs de Anulada.

Pg. 60 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

4.2. Informaes Adicionais na NFS-e


Quando a NFS-e gerada on-line pelos prestadores, atravs de solicitao aos servios Web,
algumas informaes so inseridas automaticamente pelo sistema no quadro Informaes
Adicionais da nota, e outras podem ser digitadas no momento da emisso da NFS-e no Portal do
Contribuinte. Entretanto, no caso do XML da nota ser gerado pelo Sistema de Gesto Empresarial
(ERP) dos prestadores, estas informaes nunca sero inseridas de forma automtica, e, portanto,
devem ser todas includas no arquivo XML.
Para isto, existe a tag <infAdic>, que deve ser usada para informar os diversos textos a constar
na NFS-e, de acordo com cada situao que se apresenta, para cada contribuinte e/ou servio
prestado. Podem ser utilizadas N ocorrncias desta tag, conforme descrio do tipo de dados no
quadro infAdic, no item 2.2.2 deste manual.
Para realizar a quebra de linha em textos especificados utilizando a tag <infAdic> deve ser
utilizada a sequencia de caracteres '\s\n'. Por exemplo, na exibio da informao contida na tag:
<infAdic>Documento emitido por contribuinte enquadrado no regime de estimativa \s\n previsto no Art.
65, inciso II da LC n 12/1994 na redao dada pela LC n 217/2003</infAdic>

ocorrer a quebra de linha logo depois da palavra estimativa.

4.2.1. Informaes Adicionais obrigatrias na NFS-e

Nos seguintes casos, obrigatria a insero de tags <infAdic> no arquivo XML contendo o
texto das mensagens indicadas abaixo.

a) NFS-e com item de ISSQN retido:


Mensagem: O recolhimento do ISSQN de responsabilidade do tomador do servio.

Exemplo:
<infAdic>O recolhimento do ISSQN de responsabilidade do tomador do servio.</infAdic>

b) NFS-e com item que se trate de exportao de servio, com verificao de resultado no
exterior:
Mensagem: Exportao de servio

Neste caso, deve ser usada a tag

<infAdicES>S</infAdicES>

Dentro da tag <infNFSe> e assim, como se tem o valor S na tag <infAdicES>, ser includa
automaticamente a mensagem Exportao de Servio dentro do quadro de informaes
adicionais da imagem da nota.

Pg. 61 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

4.2.2. Informaes Adicionais para Uso por Situaes Excepcionais de Tributao

A mesma tag infAdic utilizada, tambm, para informar as situaes ditas excepcionais,
relacionadas tributao do contribuinte e/ou servio prestado. Sendo obrigatria a informao
dos textos sugeridos, quando aplicvel alguma excepcionalidade:

a) Prestador enquadrado no regime de estimativa


Mensagem: Documento emitido por contribuinte enquadrado no regime de estimativa previsto
no Art. NNN.NNN inciso bb da LC n NNN.NNN/AAAA na redao dada pela LC n NNN.NNN/AAAA

Exemplo:
<infAdic>Documento emitido por contribuinte enquadrado no regime de estimativa previsto no Art. 65,
inciso II da LC n 12/1994 na redao dada pela LC n 217/2003</infAdic>

b) Prestador enquadrado no regime de recolhimento por profissionais (fixo - PRF)


Mensagem: Documento emitido por contribuinte enquadrado no regime de tributao do ISSQN
de acordo com o n de profissionais, cfe. Processo n NNN

Exemplo:
<infAdic>Documento emitido por contribuinte enquadrado no regime de tributao do ISSQN de acordo
com o n de profissionais, cfe. Processo n 123</infAdic>

c) Prestador optante do SIMEI:


Mensagem: Documento emitido por Microempreendedor Individual SIMEI

Exemplo:
<infAdic>Documento emitido por Microempreendedor Individual - SIMEI</infAdic>

d) Prestador optante pelo Simples Nacional:


Mensagem: Documento emitido por ME ou EPP optante pelo Simples NacionaI.

Exemplo:
<infAdic>Documento emitido por ME ou EPP optante pelo Simples Nacional.</infAdic>

e) Prestador com imunidade de ISSQN


Mensagem: O servio prestado imune incidncia do ISSQN conforme processo n NNNN

Exemplo:
<infAdic>O servio prestado imune incidncia do ISSQN conforme processo n 12345</infAdic>

f) Prestador com iseno do ISSQN


Mensagem: O servio prestado isento incidncia do ISSQN conforme processo n NNNN

Pg. 62 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

Exemplo:
<infAdic>O servio prestado isento incidncia do ISSQN conforme processo n 12345</infAdic>

g) Prestador com exigibilidade de ISSQN suspensa


Mensagem: Contribuinte com exigibilidade suspensa quanto ao ISSQN devido para o servio
prestado conforme processo n NNNN.

Exemplo:
<infAdic>Contribuinte com exigibilidade suspensa quanto ao ISSQN conforme processo n 12345</infAdic>

Em todos os casos acima, NNNN representa o instrumento (legislao ou processo


administrativo) que autorizou a exceo e qqqq o nmero completo do respectivo instrumento.

4.2.3. Informaes Adicionais para Descries das Retenes Federais


A tag infAdic tambm deve ser utilizada para se informar as descries das retenes
federais, que tiverem sido especificadas nos itens de servio da NFS-e. Para cada reteno federal
que tenha sido indicada na NFS-e deve ser usada uma tag infAdic com a descrio da reteno,
apontando o tributo retido e que a reteno foi realizada de acordo com o definido na legislao
federal.

4.2.4. Informaes Adicionais para Esclarecimento ao Consumidor Lei n 12.741/2012

Como visto em Sees anteriores, o modelo de NFS-e adotado pelo Municpio de Caxias do Sul
oportuniza ao contribuinte o uso de tags especficas para se informar a carga tributria da NFS-e,
viabilizando assim o cumprimento do que determina a legislao de esclarecimento ao consumidor
sobre a carga tributria (Lei n 12.741/2012).

A tag <totalAproxTribServ>, dentro da tag <serv>, pode ser utilizada em cada item de servio
de uma NFS-e para destacar a tributao sobre ele e a tag <totalAproxTrib> usada, dentro da tag
<total>, para indicar a soma de todos os valores aproximados de tributos, indicados nos itens de
servio da NFS-e.
Vale ressaltar que,para as informaes indicadas com as tags <totalAproxTribServ> e
<totalAproxTrib> serem efetivamente exibidas na imagem da NFS-e, deve ser utilizado o valor 1
na tag <infAdicAT>, dentro da tag <infNFSe>.

Pg. 63 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

5. Informaes gerais sobre NFS-e


Nesta Seo so apresentadas algumas informaes gerais sobre a Nota Fiscal de Servios
eletrnica do Municpio de Caxias do Sul.

5.1. Gerao da NFS-e


A NFS-e um documento de existncia digital, gerado e armazenado eletronicamente,
utilizado para documentar as operaes de prestao de servio.
Dever ser emitida com base em leiaute estabelecido neste Manual de Conectividade, por
meio de software desenvolvido ou adquirido pelo contribuinte ou atravs do Portal da NFS-e
disponibilizado pela Administrao Tributria, observadas as formalidades legais pertinentes:
o arquivo digital da NFS-e ser gerado automaticamente quando a NFS-e for emitida
atravs do Portal da NFS-e; ou, quando a NFS-e for submetida por envio atravs de lote,
elaborado no padro XML apresentado neste Manual de Conectividade;
a numerao da NFS-e ser crescente e sequencial de 1 a 999.999.999, por
estabelecimento e por srie;
a NFS-e dever conter um cdigo numrico aleatrio, gerado pelo emitente, que compor
a chave de acesso de identificao da NFS-e, juntamente com a UF e CNPJ do emitente,
modelo, srie e nmero da NFS-e;
a NFS-e enviada por lote, via servio web, dever ser assinada pelo prestador, com
assinatura digital, certificada por entidade credenciada pela Infraestrutura de Chaves
Pblicas Brasileira - ICP-Brasil, contendo o n do CNPJ de qualquer dos estabelecimentos do
contribuinte, a fim de garantir a autoria do documento digital.
permitido ao contribuinte emitir uma NFS-e com mais de um item de servio/atividade na
mesma nota, desde que observadas as seguintes regras;
o ISSQM deve ser devido ao mesmo Municpio;
todos os servios devem estar sujeitos substituio tributria;
nenhum dos servios deve estar sujeito substituio tributria;
todos os servios devem estar enquadrados na mesma forma de tributao;
no se tratar de servio de empreitada global;
os servios devem ser prestados em uma mesma obra/local, no caso de construo civil;
itens com mesma alquota de tributao.

5.2. Impresso e imagem da NFS-e


O Municpio de Caxias do Sul RS autoriza que a NFS-e seja impressa em papel com o objetivo
de prover a necessidade de representaes impressas adicionais previstas na legislao e auxiliar a
escriturao das NFS-e pelos tomadores no credenciados como emitentes de NFS-e ou
estabelecidos em outros municpios.
A NFS-e emitida em ambiente de homologao sempre dever conter, sob forma de marca

Pg. 64 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

d'gua destacada, a frase NFSE EMITIDA NO AMBIENTE DE HOMOLOGAO ESTA NOTA NO


POSSUI VALIDADE FISCAL.

A NFS-e emitida em ambiente de produo poder ser enviada imediatamente aps a


prestao do servio. A disponibilizao pode ser por meio digital ou fsico/papel, dentro das
condies de acessibilidade e da necessidade do tomador.

A imagem da NFS-e emitida diretamente no Portal da NFS-e disponibilizada


automaticamente aps o seu envio, nos formatos xml, pdf e png; sendo facultado ainda ao
contribuinte o envio da mesma para o e-mail do tomador do servio.

Destaca-se que a imagem da NFS-e, inclusive quando enviada pelo servio web, encontra-se
disponvel na mensagem de retorno do lote, no formato Base64, conforme exemplo abaixo:

<?xml version="1.0" encoding="UTF-8"?>


<resPedidoLoteNFSePNG versao="1.0" >
<CNPJ>49454600000119</CNPJ>
<dhRecbto>2013-04-19 11:08:15</dhRecbto>
<NFSe-PNG>
<!-- Contedo aqui um string em formato Base64 !>
</NFSe-PNG>
<sit>100</sit>
</resPedidoLoteNFSePNG>

Independentemente do ambiente de emisso da NFS-e utilizado, a imagem da NFS-e deve


seguir os modelos autorizados pelo Municpio: NFS-e e NFFS-e (Instruo Normativa da NFS-e.).

Todos os ttulos e informaes dos campos constantes na NFS-e devem ser impressos de modo
que seus dizeres e indicaes estejam bem legveis.

5.3. Informaes e campos variveis na imagem da NFS-e


Existem algumas informaes e campos que podem variar na imagem da NFS-e dependendo
das opes escolhidas pelo contribuinte.

5.3.1. NFS-e x NFFS-e


Quando o contribuinte optar por utilizar o quadro fatura, dever substituir as expresses
Nota Fiscal de Servios Eletrnica e NFS-e por Nota Fiscal Fatura de Servios Eletrnica e
NFFS-e, respectivamente, em todos os locais da imagem da NFS-e. conforme Instruo
Normativa da NFS-e.

Pg. 65 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

5.3.2. Quadro Discriminao dos Servios


Sero suprimidos os campos Ret. ISS e Desconto Incondicional, quando no aplicveis. No
podero ser suprimidos os campos relativos s informaes de detalhamento do servio prestado,
alquota, valor unitrio, quantidade, valor do servio. A Figura abaixo ilustra o quadro de
discriminao dos servios.

5.3.3. Responsabilidades pelo recolhimento do ISSQN


O leiaute da NFS-e sofre alterao nos casos em que o ISSQN devido por substituio
tributria/retido.

Exemplo de NFSe- com ISSQN prprio:

Pg. 66 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

Trecho de XML correspondente imagem acima:

<NFS-e>
<infNFSe versao="1.1">
<Id> </Id>
<prest> </prest>
<TomS> </TomS>
<det>
<nItem>1</nItem>
<serv>
<cServ>1132</cServ>
<cLCServ>14.01</cLCServ>
<xServ>TESTE TESTE TESTE</xServ>
<localTributacao>4305108</localTributacao>
<uTrib>UN</uTrib>
<qTrib>1</qTrib>
<vUnit>10000.00</vUnit>
<vServ>8000.00</vServ>
<vDesc>2000.00</vDesc>
<vBCISS>8000.00</vBCISS>
<pISS>4.00</pISS>
<vISS>320.00</vISS>
<vBCINSS>8000.00</vBCINSS>
<pRetINSS>11.00</pRetINSS>
<vRetINSS>880.00</vRetINSS>
<vRed>0.00</vRed>
<vBCRetIR>8000.00</vBCRetIR>
<pRetIR>1.50</pRetIR>
<vRetIR>120.00</vRetIR>
<vBCCOFINS>8000.00</vBCCOFINS>
<pRetCOFINS>3.00</pRetCOFINS>
<vRetCOFINS>240.00</vRetCOFINS>
<vBCCSLL>8000.00</vBCCSLL>
<pRetCSLL>1.00</pRetCSLL>
<vRetCSLL>80.00</vRetCSLL>
<vBCPISPASEP>8000.00</vBCPISPASEP>
<pRetPISPASEP>0.65</pRetPISPASEP>
<vRetPISPASEP>52.00</vRetPISPASEP>
</serv>
</det>
<total>
<vServ>8000.00</vServ>
<vDesc>2000.00</vDesc>
<vtNF>8000.00</vtNF>
<vtLiq>6628.00</vtLiq>
<Ret>
<vRetIR>120.00</vRetIR>
<vRetPISPASEP>52.00</vRetPISPASEP>
<vRetCOFINS>240.00</vRetCOFINS>
<vRetCSLL>80.00</vRetCSLL>

Pg. 67 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

<vRetINSS>880.00</vRetINSS>
</Ret>
<ISS>
<vBCISS>8000.00</vBCISS>
<vISS>320.00</vISS>
</ISS>
</total>
<infAdicLT>4305108</infAdicLT>
<infAdic>Outras informaes adicionais podem ser includas pelo contribuinte</infAdic>
<infAdic>Reteno de IR: R$ 120,00</infAdic>
<infAdic>Reteno de PIS-PASEP: R$ 52,00</infAdic>
<infAdic>Reteno de COFINS: R$ 240,00</infAdic>
<infAdic>Reteno de CSLL: R$ 80,00</infAdic>
<infAdic>Reteno de INSS: R$ 880,00</infAdic>
</infNFSe>
</NFS-e>

Exemplo de NFSe- com ISSQN retido:

Pg. 68 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

Trecho de XML correspondente imagem acima:

<NFS-e>
<infNFSe versao="1.1">
<Id> </Id>
<prest> </prest>
<TomS> </TomS>
<det>
<nItem>1</nItem>
<serv>
<cServ>1132</cServ>
<cLCServ>14.01</cLCServ>
<xServ>TESTE TESTE TESTE</xServ>
<localTributacao>4305108</localTributacao>
<uTrib>UN</uTrib>
<qTrib>1</qTrib>
<vUnit>10000.00</vUnit>
<vServ>8000.00</vServ>
<vDesc>2000.00</vDesc>
<vBCINSS>8000.00</vBCINSS>
<pRetINSS>11.00</pRetINSS>
<vRetINSS>880.00</vRetINSS>
<vRed>0.00</vRed>
<vBCRetIR>8000.00</vBCIR>
<pRetIR>1.50</pRetIR>
<vRetIR>120.00</vRetIR>
<vBCCOFINS>8000.00</vBCCOFINS>
<pRetCOFINS>3.00</pRetCOFINS>
<vRetCOFINS>240.00</vRetCOFINS>
<vBCCSLL>8000.00</vBCCSLL>
<pRetCSLL>1.00</pRetCSLL>
<vRetCSLL>80.00</vRetCSLL>
<vBCPISPASEP>8000.00</vBCPISPASEP>
<pRetPISPASEP>0.65</pRetPISPASEP>
<vRetPISPASEP>52.00</vRetPISPASEP>
</serv>
<ISSST>
<vBCST>8000.00</vBCST>
<pISSST>4.00</pISSST>
<vISSST>320.00</vISSST>
</ISSST>
</det>
<total>
<vServ>8000.00</vServ>
<vDesc>2000.00</vDesc>
<vtNF>8000.00</vtNF>
<vtLiq>6308.00</vtLiq>
<Ret>
<vRetIR>120.00</vRetIR>
<vRetPISPASEP>52.00</vRetPISPASEP>

Pg. 69 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

<vRetCOFINS>240.00</vRetCOFINS>
<vRetCSLL>80.00</vRetCSLL>
<vRetINSS>880.00</vRetINSS>
</Ret>
<ISS>
<vBCSTISS>8000.00</vBCSTISS>
<vSTISS>320.00</vSTISS>
</ISS>
</total>
<infAdicLT>4305108</infAdicLT>
<infAdic>O recolhimento do ISSQN de responsabilidade do tomador do servio</infAdic>
<infAdic>Outras informaes adicionais podem ser includas pelo contribuinte</infAdic>
<infAdic>Reteno de IR: R$ 120,00</infAdic>
<infAdic>Reteno de PIS-PASEP: R$ 52,00</infAdic>
<infAdic>Reteno de COFINS: R$ 240,00</infAdic>
<infAdic>Reteno de CSLL: R$ 80,00</infAdic>
<infAdic>Reteno de INSS: R$ 880,00</infAdic>
</infNFSe>
</NFS-e>

5.4. Dados da obra


Os dados da obra, informados principalmente nos servios relacionados construo civil, so
de uso facultativo, tanto na estrutura do arquivo xml quanto na imagem da NFS-e. Sendo
pertinentes atividade do contribuinte e identificados no XML Schema, tais dados constaro no
rodap do quadro discriminao dos servios quando impressa a NFS-e.

5.5. Personalizaes da NFS-e


O Municpio autoriza a personalizao da imagem da NFS-e pelo contribuinte, devendo as
alteraes pretendidas estarem devidamente identificadas na estrutura do arquivo XML, conforme
descrito no Manual de Conectividade, e previamente cadastradas no Portal da NFS-e.

So permitidas as seguintes personalizaes, conjuntas ou separadamente:


incluso de logotipo de prestador (formato .png ou .jpeg), desde que sua incluso no
prejudique a exibio das informaes obrigatrias;
incluso de nome fantasia, e-mail, site, at dois telefones, CEP, inscrio estadual, inscrio
estadual de substituto tributrio;
incluso do quadro fatura;
incluso do quadro transportador;
incluso do quadro canhoto, podendo o contribuinte optar pela impresso do mesmo no
rodap ou no cabealho da NFS-e;
personalizao de mensagens no quadro informaes adicionais.

Pg. 70 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

5.6. Cancelamento da NFS-e


O prazo limite para cancelamento da NFS-e o dia 05 (cinco) do ms subsequente ao da
ocorrncia do fato gerador.

Destaca-se que o fato gerador do ISSQN a prestao do servio e que a incidncia do imposto
independe:

do recebimento do preo ou do resultado econmico da prestao;


da denominao dada ao servio prestado; ou
do cumprimento de quaisquer exigncias legais, regulamentares ou administrativas
relativas s atividades.

Assim, o fato do servio prestado no ser pago pelo tomador no ampara, tampouco motiva
ou justifica o cancelamento da NFS-e.

5.7. Tabelas auxiliares da NFS-e


O sistema da NFS-e se utiliza de tabelas auxiliares para os cdigos de municpios e UF, obtidos
a partir do IBGE, e de pases, obtidos a partir do BACEN.

5.7.1. Tabela de cdigo de municpios e UF - IBGE


Os campos de cdigos de municpios devem ser informados com a utilizao da tabela de
cdigos de Municpio mantida pelo IBGE disponvel em
ftp://geoftp.ibge.gov.br/organizacao_territorial/municipios_criados_e_instalados/

A seguinte codificao adotada pelo IBGE dever ser utilizada para representar o cdigo da UF:

Pg. 71 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

O cdigo de municpio composto de 7 dgitos numricos, com as duas primeiras


representando a UF. Os cdigos de municpio das capitais dos estados so:

Deve ser informado o cdigo 9999999 e o nome do municpio EXTERIOR para as operaes
que envolvam localidades do exterior.

Quando a operao envolver regies administrativas (por exemplo, cidades-satlites do DF),


deve ser considerado o municpio sede como localidade da operao.

Pg. 72 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

5.7.2. Tabela de cdigo de pas - BACEN

Para o preenchimento dos campos de cdigos de pases deve ser utilizada a tabela de pases
do Banco Central do Brasil - BACEN, disponvel em http://www.bcb.gov.br/Rex/Ftp/paises.txt

Exemplo de codificao:

5.8. Inutilizao de Numerao de NFS-e

O Fisco municipal de Caxias do Sul determina que a emisso das Notas Fiscais de Servios
eletrnicas deve manter a sequncia da numerao e a ordem cronolgica das mesmas. Para
tanto, caso haja alguma irregularidade em qualquer nota do lote, so definidas regras no
processamento de lotes de NFS-e para que se respeite esta determinao e no se tranque ou
prejudique o faturamento das empresas.

O nmero da nota que for rejeitada no processamento do lote dever ser reutilizado dentro da
mesma data de emisso e, preferencialmente, dentro do mesmo dia do lote original.

Caso este nmero no seja mais possvel reutilizar, o contribuinte dever usar o servio web de
inutilizao de numerao (descrito na Seo 3.2.9).

5.8.1. Regras para reutilizao de numerao rejeitada

As regras de reutilizao de nmero, que foi rejeitado durante um processamento de lote de


NFS-e, so:

1. O nmero no pode j ter sido inutilizado atravs da chamada do servio web de


inutilizao de numerao;
2. No pode existir nota fiscal com data de emisso superior a data de emisso da nota que
est reutilizando o nmero;
3. No pode existir nota fiscal com nmero maior que o nmero reutilizado e cuja data de
emisso seja menor que a data de emisso da nota que est reutilizando o nmero.

Seguem exemplos de situaes que ilustram o processo de controle sequencial de numerao:

Pg. 73 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

Cenrio 1:
a- Lote com notas 1, 2, 3
b- Crtica da nota 3 rejeitada
c- Notas 1 e 2 aprovadas
d- Lote no dia seguinte com notas 3, 4, 5
e- Notas aprovadas 3, 4, 5 (pois a nota rejeitada 3 era a ltima do dia anterior)

Anlise: neste cenrio, o contribuinte poderia utilizar a numerao "3", rejeitada


hipoteticamente no dia anterior, pois ela a ltima nota do dia. Nesta caso, sendo reutilizada a
numerao no dia posterior rejeio, a ordem cronolgica no quebrada.

Cenrio 2:
a- Lote com notas 1, 2, 3 com data de emisso 01/09/2013
b- Critica da nota 2 rejeitada
c- Notas 1 e 3 aprovadas
d- Lote no dia seguinte com notas 2, 4, 5, 6 emisso 02/09/2013
e- Notas aprovadas 4, 5, 6
f- Nota 2 rejeitada por estar fora da ordem cronolgica.

Anlise: neste cenrio, o contribuinte no conseguiria mais utilizar a numerao "2", visto que
j foram emitidas notas com data de emisso posterior e, por conseguinte, a numerao "2" no se
encaixaria mais na ordem cronolgica. Neste caso, o contribuinte deve inutilizar a numerao 2
via servio Web, com XML assinado.

5.8.2. Uso do servio Web para inutilizao de numerao

O uso do servio Web de inutilizao de numerao d-se atravs de arquivo XML assinado
digitalmente, tal como o lote de NFS-e, contendo o(s) nmero(s) e sua(s) respectiva(s) srie(s) a
ser(em) inutilizado(s). As regras de inutilizao de numerao a serem observadas so:

1. No pode existir nota fiscal validada e emitida com o nmero e srie a ser inutilizado;
2. No pode haver inutilizao anterior com o mesmo nmero e srie;
3. A srie do nmero a ser inutilizado deve estar autorizada ao prestador;
4. O lote de nmero(s) e srie(s) ser processado na sua totalidade. Caso haja um ou mais
erros, nenhum nmero do lote ser inutilizado;
5. A assinatura digital deve ser feita atravs de certificado vlido do prestador a exemplo da
NFS-e.

Pg. 74 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

Para a chamada do servio web, deve-se utilizar o XML com o layout descrito na Seo 3.2.9,
ilustrado pelo seguinte exemplo:

<?xml version="1.0" encoding="UTF-8"?>


<solicitacaoInutilizacao versao="1.0">
<numeroSolicitacao>1</numeroSolicitacao>
<cnpjContribuinte>12345678901234</cnpjContribuinte>
<dataSolicitacao>2013-09-03</dataSolicitacao>
<horaSolicitacao>12:00</horaSolicitacao>
<numerosInutilizados>
<inutilizar numero="123456789" serie="S1"/>
<inutilizar numero="123456790" serie="S1"/>
<inutilizar numero="123456791" serie="S1"/>
</numerosInutilizados>
<Signature></Signature>
</solicitacaoInutilizacao>

O retorno do servio Web, com o(s) protocolo(s) de inutilizao ou crtica(s), utiliza o layout
descrito na Seo 3.2.10, conforme ilustrado no exemplo a seguir:

<?xml version="1.0" encoding="UTF-8"?>


<retornoSolicitacaoInutilizacao>
<numeroSolicitacao>1</numeroSolicitacao>
<cnpjContribuinte>12345678901234</cnpjContribuinte>
<dataRetornoSolicitacao>2013-09-03</dataRetornoSolicitacao>
<horaRetornoSolicitacao>12:00</horaRetornoSolicitacao>
<mensagem>Inutilizaes processadas com sucesso</mensagem>
<protocolosInutilizacao>
<inutilizado numero="123456789" serie="S1">000000001</inutilizado>
<inutilizado numero="123456790" serie="S1">000000002</inutilizado>
<inutilizado numero="123456791" serie="S1">000000003</inutilizado>
</protocolosInutilizacao>
<Signature></Signature>
</retornoSolicitacaoInutilizacao>

Pg. 75 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

Caso ocorra algum problema no processamento da solicitao de inutilizao de numerao, o


retorno do servio Web, com o(s) protocolo(s) de inutilizao ou crtica(s) obtido como resposta
chamada do servio, em conformidade com o layout descrito na Seo 3.2.10. O exemplo a
seguir ilustra este tipo de retorno com problema no processamento:

<?xml version="1.0" encoding="UTF-8"?>


<retornoSolicitacaoInutilizacao>
<numeroSolicitacao>1</numeroSolicitacao>
<cnpjContribuinte>12345678901234</cnpjContribuinte>
<dataRetornoSolicitacao>2013-09-03</dataRetornoSolicitacao>
<horaRetornoSolicitacao>11:37</horaRetornoSolicitacao>
<mensagem>Nmero no inutilizado pois h erros no lote. Nmero [123456816]; Srie [T]</mensagem>
<mensagem>Nmero j uma nota fiscal vlida emitida em [09/09/2013]. Nmero [123456817]; Srie [T]</mensagem>
<mensagem>Nmero no inutilizado pois h erros no lote. Nmero [123456818]; Srie [T]</mensagem>
<Signature> ... </Signature>
</retornoSolicitacaoInutilizacao>

Pg. 76 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

6. Codificao das mensagens de erro e de aviso

Cd. Descrio Explicao

0203 Contribuinte no habilitado para Contribuinte no autorizado a emitir NFS-e.


emisso da NFS-e
0204 Contribuinte com IM informada O Contribuinte com inscrio municipal informada na tag <IM> de
no est autorizado a emitir NFS- <prest> no est autorizado a emitir NFS-e com a data de emisso,
e no ms competncia relativo especificada na tag <dEmi> de <Id>.
data de emisso
0207 CNPJ do prestador invlido O CNPJ do prestador de servios, indicado na tag <CNPJ> dentro de
<envioLote>, est invlido. Este CNPJ deve ter 14 dgitos, possuir
somente nmeros, sem pontos nem traos.
0208 CNPJ do tomador invlido O CNPJ do tomador indicado na tag <CNPJ> dentro de <TomS>, est
invlido. Este CNPJ deve ter 14 dgitos e possuir somente nmeros,
sem pontos nem traos.
0209 CPF do tomador invlido O CPF do tomador indicado na tag <CPF>, dentro de <TomS>, est
invlido. Este CPF deve ter 11 dgitos e possuir somente nmeros,
sem pontos nem traos.
0212 Data de emisso posterior data No so aceitas notas fiscais com data de emisso posterior data
de transmisso do lote de transmisso do lote.
1101 Erro de parser O arquivo enviado no um arquivo XML vlido, ou possui algum
problema que impede que o arquivo seja lido. Exemplo:
<cNFS-e>658321491
<mod>98</mod>
<serie>S</serie>
Neste exemplo, foi colocada uma tag <cNFS-e> e no foi colocada a
tag </cNFS-e> correspondente.
1102 Erro ao processar arquivo XML Similar ao erro 1101, mas se tratando de problemas mais genricos
no arquivo submetido, como, por exemplo, um arquivo de um tipo
diferente de .xml
1103 Erro de I/O ao ler arquivo xml Houve um problema interno no servidor que impediu que o arquivo
fosse lido. O lote dever ser resubmetido.
1104 Erro Geral processando arquivo Houve um problema interno no servidor que impediu o
xml processamento do lote. O lote dever ser resubmetido.
1105 Tag invlida O arquivo XML no est no formato exigido pelo sistema, ou seja,
h uma tag com descrio no correspondente ao schema.
1106 TAG root NFS-e no encontrada O arquivo XML no est no formato exigido pelo sistema. Cada nota
fiscal deve iniciar com a tag <NFS-e>.
1107 Cdigo numrico aleatrio da Campo Cdigo numrico aleatrio da nota fiscal, especificado
chave de acesso invlido pela tag <cNFS-e>, dentro de <Id>, deve possuir apenas nmeros.

Pg. 77 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

1108 Nmero da nota fiscal invlido. O nmero da nota fiscal, indicado na tag <nNFS-e> dentro de <Id>
Este campo precisa ser numrico. de <infNFSe>, deve conter apenas dgitos entre 0 e 9, sem
pontuao, nem espaos.
1109 Data de emisso invlida A data de emisso da nota fiscal, indicada na tag <dEmi> dentro de
<Id> de <infNFSe>, deve estar no formato AAAA-MM-DD, incluindo
os hfens.
1111 Tipo de documento fiscal O campo tipo de documento, indicado na tag <tpNF> dentro de
invlido <Id>, deve ser um numrico. No caso de Caxias do Sul, o valor deve
ser sempre 1 para indicar nota de sada.
1113 Chave de acesso invlida A nica parte da chave de acesso, indicada na tag <refNF> dentro de
<Id> de <infNFSe>, que aceita letras a srie da nota, nos
caracteres 19, 20 e 21. Todas as demais posies da chave tm de
ser numricas.
1114 Chave de acesso com menos de A chave de acesso, indicada na tag <refNF> dentro de <Id> de
39 dgitos <infNFSe>, deve ter obrigatoriamente 39 caracteres.
1115 Tipo de documento fora da faixa O campo tipo de documento, indicado na tag <tpNF> dentro de <Id>
(0 ou 1) de <infNFSe>, deve ser 0 ou 1. No caso de Caxias do Sul, o valor
deve ser sempre 1 para indicar nota de sada.
1116 Formato de impresso incorreto O campo formato de impresso, indicado na tag <tpImp> dentro de
(deve ser informado 1) <Id> de <infNFSe>, deve ser 1. No caso de Caxias do Sul, o valor
deve ser sempre 1 para indicar formato retrato.
1117 Formato de impresso invlido O campo formato de impresso, indicado na tag <tpImp> dentro de
<Id> de <infNFSe>, deve ter 1 (um) dgito.
1118 Forma de emisso fora da faixa Forma de emisso, indicado na tag <tpEmis> dentro de <Id> de
(N ou C) <infNFSe>, deve ser N ou C.
1121 Hora de emisso invlida Campo hora da emisso, indicado na tag <hEmi> dentro de <Id> de
<infNFSe>, no contm um valor vlido para hora. Ver formato de
hora, na tabela de tipos de dados do Manual de Conectividade.
1123 Cdigo do municpio do O cdigo do municpio, indicado na tag <cMun> dentro de <end>,
prestador invlido no foi encontrado na tabela de cdigos de municpios do cadastro
do IBGE.
1124 CEP do prestador invlido O CEP, indicado na tag <CEP> dentro de <end>, deve conter
somente nmeros
1125 Cdigo do pas do prestador Cdigo do pas indicado na tag <cPais> dentro de <end>, deve
invlido conter somente nmeros e pertencer tabela pases do Banco
Central.
1126 CNPJ informado juntamente com O tomador da nota fiscal no pode ter indicados CNPJ e CPF
CPF concomitantemente, indicados nas tags <CNPJ> e <CPF> dentro de
<TomS>. Informar apenas um dos dois campos.
1129 Cdigo do municpio do tomador O cdigo do municpio, indicado na tag <cMun> dentro de <ender>,
invlido deve pertencer a tabela de cdigos de municpios do IBGE.
1130 CEP do tomador invlido O CEP do tomador, indicado na tag <CEP> dentro de <ender>, deve
conter somente nmeros.

Pg. 78 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

1131 Cdigo do pas do tomador Cdigo do pas, indicado na tag <cPais> dentro de <ender>, deve
invlido conter somente nmeros e pertencer tabela de pases do BACEN.
1132 Quantidade do item invlida O campo quantidade do item, indicado na tag <qTrib> dentro de
<serv>, deve ser um valor numrico usando ponto . como
separador decimal.
1133 Valor do servio do item invlido O campo valor do servio do item, indicado na tag <vServ> dentro
de <serv>, deve ser um valor numrico usando ponto . como
separador decimal.
1134 Valor do desconto incondicional O campo desconto incondicional do item, indicado na tag <vDesc>
invlido dentro de <serv>, deve ser um valor numrico usando ponto .
como separador decimal.
1135 Base clculo do ISSQN invlido O campo Base de calculo do ISSQN do item, indicado na tag
<vBCISS> dentro de <serv>, deve ser um valor numrico usando
ponto . como separador decimal.
1136 Alquota do ISSQN invlida O campo alquota do ISSQN do item, indicado na tag <pISS>
dentro de <serv>, deve ser um valor numrico usando ponto .
como separador decimal
1137 Valor do ISSQN invlido O campo valor do ISSQN do item, indicado na tag <vISS> dentro
de <serv>, deve ser um valor numrico usando ponto . como
separador decimal.
1138 Percentual de reteno do IR O campo percentual reteno IR, indicado na tag <pRetIR> dentro
invlido de <serv>, deve ser um valor numrico usando ponto . como
separador decimal.
1139 Valor de reteno do IR invlido O campo valor reteno IR, indicado na tag <vRetIR> dentro de
<serv>, deve ser um valor numrico usando ponto . como
separador decimal.
1140 Percentual de reteno do O campo percentual retencao PIS/PASEP, indicado na tag
PIS/PASEP invlido <pRetPISPASEP> dentro de <serv>, deve ser um valor numrico
usando ponto . como separador decimal.
1141 Valor de reteno do PIS-PASEP O campo valor de Reteno PIS/PASEP, indicado na tag
invlido <vRetPISPASEP> dentro de <serv>, deve ser um valor numrico
usando ponto . como separador decimal.
1142 Percentual de reteno do O campo percentual reteno COFINS, indicado na tag
COFINS invlido <pRetCOFINS> dentro de <serv>, deve ser um valor numrico
usando ponto . como separador decimal.
1143 Valor de reteno do COFINS O campo Valor reteno COFINS, indicado na tag <vRetCOFINS>
invlido dentro de <serv>, deve ser um valor numrico usando ponto .
como separador decimal.
1144 Percentual de reteno do CSLL O campo percentual reteno CSLL, indicado na tag <pRetCSLL>
invlido dentro de <serv>, deve ser um valor numrico usando ponto .
como separador decimal.
1145 Valor de reteno do CSLL O campo Valor reteno CSLL, indicado na tag <vRetCSLL> dentro
invlido de <serv>, deve ser um valor numrico usando ponto . como
separador decimal.

Pg. 79 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

1148 Valor da reduo da base de O campo Valor da reduo de base de clculo para ISSQN retido
clculo do ISSQN retido invlido do item, indicado na tag <vRedBCST> dentro de <ISSST>, deve ser
um valor numrico usando ponto . como separador decimal.
1149 Valor da base de clculo do O campo Valor da base de clculo do ISSQN retido do item,
ISSQN retido invlido indicado na tag <vBCST> dentro de <ISSST>, deve ser um valor
numrico usando ponto . como separador decimal.
1150 Alquota do ISSQN retido invlido O campo Alquota do ISSQN retido do item, indicado na tag
<pISSST> dentro de <ISSST>, deve ser um valor numrico usando
ponto . como separador decimal.
1151 Valor do ISSQN retido invlido O campo Valor do ISSQN retido do item, indicado na tag <vISSST>
dentro de <ISSST>, deve ser um valor numrico usando ponto .
como separador decimal.
1152 Total da base de clculo do ISSQN O campo Valor total da base de clculo do ISSQN, indicado na tag
prprio invlido <vBCISS> dentro da tag <ISS> de <total>, deve ser um valor
numrico usando ponto . como separador decimal.
1153 Total do ISSQN prprio invlido O campo Valor do ISSQN invlido, indicado na tag <vISS> dentro
da tag <ISS> de <total>, deve ser um valor numrico usando ponto
. como separador decimal.
1154 Total da base de clculo do retido O campo Base de clculo ISSQN retido, indicado na tag
invlido <vBCSTISS> dentro da tag <ISS> de <total>, deve ser um valor
numrico usando ponto . como separador decimal.
1155 Total do ISSQN retido invlido O campo Valor total ISSQN retido, indicado na tag <vSTISS> dentro
da tag <ISS> de <total>, deve ser um valor numrico usando ponto
. como separador decimal.
1157 Total do desconto incondicional O campo Valor total de desconto, indicado na tag <vDesc> de
dos itens da nota fiscal invlido <total>, deve ser um valor numrico usando ponto . como
separador decimal.
1158 Valor total da nota fiscal invlido O campo Valor total da nota, indicado na tag <vtNF> de <total>,
(valor total dos itens de servios deve ser um valor numrico usando ponto . como separador
da nota, considerando valor decimal.
unitrio x quantidade desconto
incondicional = valor do item de
servio)
1159 Nota fiscal j foi emitida J existe uma nota fiscal validada com este nmero, indicado na tag
<nNFS-e> dentro de <Id>.
1160 Erro Interno: No foi possvel Ocorreu um erro no processamento do lote. O lote deve ser enviado
gravar informaes na base de novamente, pois pode ter sido um problema intermitente. Caso
dados da Prefeitura persista o erro, abrir chamado no SAC da Prefeitura (menu
Atendimento no Portal do Contribuinte), que o problema ser
encaminhado para a rea tcnica da equipe do sistema NFS-e.
1161 TAG </NFS-e> no encontrada Formato do XML invlido. Existe uma tag <NFS-e> dentro de outra
tag ou no foi fechada a tag anterior com </NFS-e>

Pg. 80 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

1168 Valor da fatura invlido Campo valor da fatura, indicado na tag <vFat> de <fat>, dentro de
<faturas> de <infNFSe>, deve conter somente nmeros usando
ponto . como separador decimal.
1171 Data vencimento na fatura Campo vencimento da fatura, indicado na tag <dVenc> de <fat>,
invlida deve estar no formato AAAA-MM-DD
1174 Data de emisso fora do perodo No possvel emitir notas fiscais com data de um perodo para o
permitido qual j tenha sido emitido guia de arrecadao parcial ou
totalizadora.
1175 Campo cancelada deve conter O campo nota cancelada indicado na tag <cancelada> dentro de
somente S ou N <Id> de <infNFSe>, deve conter S ou N.
1177 O CNPJ do prestador no confere O remetente do lote, identificado pela tag <CNPJ> dentro de
com o CNPJ do remetente do <envioLote>, deve ser tambm o prestador de servio identificado
lote. Assinatura do lote invlida. pela assinatura digital utilizada no lote.
1178 Valor unitrio do servio invlido. O campo Valor unitrio do servio do item, indicado na tag
<vUnit> de <serv>, deve ser um valor numrico usando ponto .
como separador decimal.
1179 Total lquido nota fiscal invlido O campo Valor liquido total da nota, indicado na tag <vtLiq> de
<total>, deve ser um valor numrico usando ponto . como
separador decimal.
1181 Item Rejeitado: Nota fiscal Esta mensagem precede qualquer outra mensagem com erro, que
nmero rejeitada. Por favor, tenha feito com que a NFS-e tenha sido rejeitada.
verifique a lista de motivos.
1183 Alquota de reteno do INSS O campo Alquota de reteno do INNS, indicado na tag
invlida <pRetINSS> de <serv>, deve ser um valor numrico usando ponto .
como separador decimal.
1184 Valor de reteno do INSS O campo Valor de reteno do INSS, indicado na tag <vRetINSS>
invlido de <serv>, deve ser um valor numrico usando ponto . como
separador decimal.
1185 Valor total de reteno do INSS O campo Valor total de reteno do INSS, indicado na tag
invlido <vRetINSS> dentro da tag <Ret> de <total>, deve ser um valor
numrico usando ponto . como separador decimal.
1187 Data de cancelamento invlida A data, indicada na tag <dataCanc> dentro de <Id> de <infNFSe>,
deve estar no formato AAAA-MM-DD
1188 Nmero do RPS invlido O nmero informado do RPS no vlido.
1190 RPS j existe no sistema O RPS submetido j existe com este nmero e srie.
1191 Alquota de reteno do IR O campo Alquota de reteno do IR, indicado na tag <pRetIR> de
invlida <serv>, deve ser um valor numrico usando ponto . como
separador decimal.
1192 Valor de reteno do IR invlido O campo Valor de reteno do IR, indicado na tag <vRetIR> de
<serv>, deve ser um valor numrico usando ponto . como
separador decimal.

Pg. 81 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

1193 Alquota de reteno de COFINS O campo Alquota de reteno de COFINS, indicado na tag
invlida <pRetCOFINS> de <serv>, deve ser um valor numrico usando
ponto . como separador decimal.
1194 Valor de reteno de COFINS O campo Valor de reteno de COFINS, indicado na tag
invlido <vRetCOFINS> de <serv>, deve ser um valor numrico usando ponto
. como separador decimal.
1195 Alquota de reteno de CSLL O campo Alquota de reteno de CSLL, indicado na tag
invlida <pRetCSLL> de <serv>, deve ser um valor numrico usando ponto .
como separador decimal.
1196 Valor de reteno de CSLL O campo Valor de reteno de CSLL, indicado na tag <vRetCSLL>
invlido de <serv>, deve ser um valor numrico usando ponto . como
separador decimal.
1197 Alquota de reteno do O campo Alquota de reteno de PIS/PASEP, indicado na tag
PIS/PASEP invlida <pRetPISPASEP> de <serv>, deve ser um valor numrico usando
ponto . como separador decimal.
1198 Valor de reteno do PIS/PASEP O campo Valor de reteno do PIS-PASEP, indicado na tag
invlido <vRetPISPASEP> de <serv>, deve ser um valor numrico usando
ponto . como separador decimal.
1200 Valor de reduo da base de O campo Valor de reduo da base de clculo, indicado na tag
clculo invlida <vRed> de <serv>, deve ser um valor numrico usando ponto .
como separador decimal.
1201 Data de emisso do RPS Papel O campo Data de emisso do RPS papel, indicado na tag
invlida ou no informada <dataEmissaoRpsPapel> dentro de <Id> em <infNFSe>, est invlido
ou vazio.
1203 Srie do RPS em Papel invlida. O campo Srie do RPS papel, indicado na tag <serierps> dentro de
Deve conter uma letra e um <Id> em <infNFSe>, est invlido. Deve conter uma letra e um
nmero nmero.
1212 Assinatura invlida A assinatura digital na tag <Signature> do arquivo est:
- Diferente da estrutura do schema demonstrado na sesso 2.3.3;
- O Arquivo sofreu algum tipo de modificao aps assinatura,
sendo assim o hash do arquivo assinado no o mesmo hash do
arquivo atual. Assim depois de assinado, deve ser evitada qualquer
operao no arquivo que possa causar alguma alterao nele.
1249 No foi possvel cancelar o lote A requisio de cancelamento de lote no foi permitida, devido o
de NFS-e lote j estar em processamento ou j ter sido processado.

Pg. 82 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

1281 Assinatura invlida: {mensagem Onde {mensagem do problema encontrado} pode ser:
do problema encontrado} a) "Nenhum certificado encontrado" - Caso o certificado no tenha
chave privada;
b) "Certificado expirado: " - Caso o certificado tenha expirado;
c) "Certificado ainda no vlido " - Caso o certificado ainda no
tenha validade;
d) "Certificado revogado";
e) "Certificadora raiz no ICP-Brasil - Caso o certificado no seja
raiz ICP-Brasil
f) "Certificado da cadeia no encontrado no JKS" - Cadeia
certificadora no localizada nos certificados confiveis
g) "No encontrado certificado do emissor" - Caso o emissor do
certificado no seja confivel.
1309 Campo srie no informado obrigatrio que a srie seja informada na tag <serie> dentro de
<Id> de <infNFSe>.
1310 Srie no autorizada para este A srie, indicada na tag <serie> dentro de <Id> de <infNFSe> da nota
prestador fiscal no est autorizada pelo Municpio para o contribuinte.
1311 O Local da prestao dos servios Os contedos das tags <xCidadeObra> e <xUFObra> dentro da tag
deve ser o mesmo do Local da <dadosDaObra> devem corresponder ao informado pela tag
tributao <localTributacao> dentro da tag <serv>.
1312 No possvel incluir na mesma Os servios indicados pelas tags <cServ> dentro de <serv> no
NFS-e itens com tributao em podem ser includos na mesma NFS-e por serem tributados em
diferentes municpios municpios distintos.
3450 Atividade no autorizada para O cdigo de atividade utilizado no item da nota, indicado na tag
este contribuinte <cServ> de <serv>, no est autorizado para o contribuinte.
possvel consultar a lista de cdigos autorizados para a(s)
empresa(s) em: https://nfse.caxias.rs.gov.br/site/consultar-
atividades/
3452 Atividade com alquota incorreta A alquota, indicada na tag <pISS> de <serv>, informada para o item
do servio est incorreta.
3453 Erro ao salvar NFS-e Ocorreu um erro interno ao salvar a nota fiscal. O lote deve ser
resubmetido, pois pode tratar-se de um problema intermitente.
Caso o erro persista, registrar chamado SAC (menu Atendimento do
Portal do Contribuinte), que a equipe tcnica do sistema NFS-e ser
acionada.
3454 Tipo de frete invlido O campo Tipo de frete, indicado na tag <vTipoFreteTrans> de
<transportadora>, deve conter apenas nmeros.
3455 Data de emisso no informada Deve ser obrigatoriamente informada a data de emisso da nota
atravs da tag <dEmi> dentro de <Id> de <infNFSe>.
3456 Data de emisso da nota est Somente podem ser emitidas notas no perodo permitido pelo
fora do perodo permitido Municpio, isto , at o dia (5) de cada ms, se o fato gerador
ocorreu no ms imediatamente anterior.
3458 O prestador no pode emitir O prestador no est autorizado a emitir notas tendo o seu prprio
notas para si prprio CNPJ como tomador.

Pg. 83 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

3459 Descrio da atividade no Deve ser informada a descrio da atividade no item de servio
informada atravs da tag <xServ> de <serv>.
3460 Atividade no permite A atividade informada, atravs da tag <cServ> de <serv>, no
substituio tributria permite que seja utilizada substituio tributria para o item.
3461 Contribuinte no autorizado a O prestador, indicado na tag <CNPJ> de <prest>, no est autorizado
emitir NFS-e neste perodo pelo Municpio a emitir NFS-e no perodo informado.
3462 CNPJ do Prestador no informado O CNPJ do prestador obrigatrio e deve sempre ser informado
atravs da tag <CNPJ> de <prest>.
3463 Item de servio no informado Toda nota deve ter pelo menos um item de servio, ou seja, deve
existir pelo menos uma tag <det> dentro de <infNFSe>.
3464 CNPJ/CPF do Tomador no obrigatrio informar o tomador, atravs da tag <CNPJ> ou <CPF>
informado de <TomS>.
3465 Local de tributao no O local de tributao obrigatrio e deve ser sempre informado
informado atravs da tag <localTributacao> dentro de <serv>.
3466 Nome do tomador no Deve ser informado tambm o nome do tomador atravs da tag
informado <xNome> de <TomS>, caso o CNPJ ou CPF dele tenha sido
informado.
3469 UF do tomador no informado A UF de tomador obrigatria (caso tenha sido informado o CNPJ
ou CPF do tomador), devendo ser indicada atravs da tag <UF>
dentro de <ender> de <TomS>.
3471 Cidade do tomador no A cidade do endereo do tomador obrigatria (caso tenha sido
informado informado o CNPJ ou CPF do tomador), devendo ser indicada
atravs das tags <cMun> e <xMun> dentro de <ender> de <TomS>.
3472 Lei veda substituio tributria No permitido emitir nota fiscal com substituio tributria
para Pessoa Fsica quando o tomador pessoa fsica.
3473 Valor de reduo da base de O campo, indicado na tag <vRedBCCivil> de <total>, deve ser um
clculo da construo civil valor numrico usando ponto . com separador decimal.
invlido
3474 Atividade vinculada a esta nota A atividade indicada atravs da tag <cServ> em <serv> no permite
fiscal no permite Empreitada que a nota seja de Empreitada Global.
Global
3475 O tomador desta nota Todos os itens da nota devem ser com substituio tributria por
substituto tributrio, deve conta do tipo de tomador que foi indicado na nota.
obrigatoriamente reter o imposto
em todos os itens da nota
3476 NFS-e com Reduo na Base de Quando uma nota possui reduo da base de clculo da construo
Clculo de Construo Civil no civil somente pode ser includo um item de servio na nota.
pode possuir mais que um item
de servio
3478 NFS-e com Reduo na Base de O valor indicado na nota, atravs da tag <vRedBCCivil> de <total>,
Clculo de Construo Civil est acima do valor mximo permitido, conforme legislao vigente.
ultrapassou o valor mximo
permitido

Pg. 84 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

3479 Valor lquido da nota fiscal no O valor total lquido da nota, indicado na tag <vtLiq> de <total>,
pode ser negativo deve ser um nmero positivo.
3480 Valor total da fatura deve ser O valor da fatura, indicado na tag <vtLiqFaturas> dentro de <total>
maior que zero de <infNFSe>, deve ser um nmero positivo.
3481 Valor total da nota fiscal no O valor total da nota, indicado na tag <vtNF> de <total>, deve ser
pode ser negativo um nmero positivo.
3482 Valor do item deve ser maior que O valor do item de servio, indicado na tag <vServ> de <serv>, deve
zero ser um nmero maior que zero.
3483 Valor total da nota deve ser O valor total da nota, indicado na tag <vtNF> de <total>, deve ser
maior que zero um nmero maior que zero.
3484 Alquotas dos itens devem variar As alquotas dos itens de servio, indicadas usando tag <pISS> de
entre 0% a 5% <serv>, devem estar entre 0% e 5%.
3485 Alquotas dos itens devem variar As alquotas dos itens de servio, indicadas usando tag <pISS> de
entre 2% a 5% <serv>, devem estar entre 2% e 5%.
3486 Alquotas dos itens devem ser As alquotas dos itens de servio, indicadas usando tag <pISS> de
zeradas, devido situao <serv>, devem estar zeradas.
excepcional vinculada ao
contribuinte
3487 Item com situao excepcional Como o item de servio indicado na nota atravs da tag <det> de
vinculada. Nota no gera ISSQN a <infNFSe> tem uma situao excepcional vinculada, no gerado
recolher ISS a recolher.
3488 O valor da fatura deve ser maior Os valores das faturas, indicadas usando tag <vFat> dentro de <fat>
que zero de <faturas>, devem ser maiores que zero.
3490 A NFS-e no pode conter itens Em uma mesma nota no podem ser indicados itens de servio,
com situaes tributrias atravs de tag <det> de <infNFSe>, que tenham situao tributrias
distintas distintas (estimativa, imunidade, iseno, exigibilidade suspensa,
recolhimento por profissionais)
3491 O valor da reduo da base de O valor da reduo da base de clculo do item de servio, indicada
clculo do item ultrapassou o atravs da tag <vRed> de <serv>, ultrapassou o limite permitido
limite permitido para o item.
3492 No permitido atribuir reduo A atividade, indicada na tag <cServ> de <serv>, no permite
na base de clculo para esse item reduo de sua base de clculo.
de servio
3493 Data de emisso da Nota Fiscal A data de emisso, indicada na tag <dEmi> dentro de <Id> de
est fora do perodo autorizado <infNFSe>, est fora do perodo autorizado para este prestador.
pelo Municpio
3494 Numerao da Nota Fiscal O nmero da NFS-e, indicado na tag <nNFS-e> dentro de <Id> de
bloqueada pelo Municpio <infNFSe>, est fora do intervalo de numerao autorizado.
3495 No permitido emitir notas A data de emisso, indicada na tag <dEmi> dentro de <Id> de
com data futura <infNFSe>, posterior data atual.

Pg. 85 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

3496 Inscrio municipal do prestador A inscrio municipal, indicada na tag <IM> dentro de <prest> de
no confere com a informao <infNFSe>, no confere com a informao constante no Cadastro
constante no Cadastro Econmico do Municpio.
Econmico do Municpio.
3497 Hora da emisso no informada A hora de emisso, indicada na tag <hEmi> dentro de <Id> de
<infNFSe>, no foi informada.
3498 Razo social do prestador no A razo social do prestador obrigatria, e deve ser indicada na tag
informada <xNome> dentro de <prest> de <infNFSe>
3499 Logradouro do prestador no O logradouro do prestador obrigatrio e deve ser indicado na tag
informado <xLgr> dentro de <end>, que faz parte de <prest> de <infNFSe>.

3500 CEP do prestador no informado O CEP do prestador obrigatrio e deve ser indicado na tag <CEP>
dentro de <end>, que faz parte de <prest> de <infNFSe>.
3503 Municpio do prestador no O municpio do prestador obrigatrio, e deve ser indicado nas tags
informado <cMun> e <xMun> dentro de <end>, que faz parte de <prest> de
<infNFSe>.
3504 UF do prestador no informada A UF do prestador obrigatria, e deve ser indicada na tag <UF>
dentro de <end>, que faz parte de <prest> de <infNFSe>
3505 Pas do tomador no informado O pas do tomador obrigatrio, e deve ser, indicado nas tags
<cPais> e <xPais> dentro de <ender>, que faz parte de <TomS> de
<infNFSe>. Se o pas do tomador for diferente de Brasil, a tag
<CNPJ> deve vir com valor 00000000000000 ou a tag <CPF> com
valor 00000000000.
3506 Nmero no endereo do O nmero no endereo do tomador, indicado na tag <Nro> dentro
tomador invlido de <ender>, que faz parte de <TomS> de <infNFSe>, no vlido.
3507 CEP do tomador invlido O CEP do tomador, indicado na tag <CEP> dentro de <ender>, que
faz parte de <TomS> de <infNFSe>, no vlido.
3508 Nmero no endereo do O nmero no endereo do prestador, indicado na tag <Nro> dentro
prestador invlido de <end>, que faz parte de <prest> de <infNFSe>, no vlido.
3510 Nmero da ART invlido O nmero da ART da obra, indicado na tag <numeroArt> dentro de
<Id> de <infNFSe>, no vlido.
3511 Nmero da CEI invlido O nmero da CEI da obra, indicado na tag <numeroCei> dentro de
<Id> de <infNFSe>, no vlido.
3512 Nmero da Matrcula no registro O nmero da matrcula da obra, indicada na tag <numeroMatri>
de imveis invlido dentro de <Id> de <infNFSe>, no vlida.
3513 Nmero no endereo do local da O nmero no endereo do local da obra, indicado na tag
obra invlido <vNumeroObra> dentro de <dadosDaObra> de <infNFSe>, no
vlido.
3514 CEP do local da obra invlido O CEP do local da obra, indicado na tag <vCepObra> dentro de
<dadosDaObra> de <infNFSe>, no vlido.

Pg. 86 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

3515 Local de tributao para o(s) O item de servio, informado nas tags <serv> dentro de <det> de
item(ns) de servio(s) indicado(s) <infNFSe>, deve ter como local de tributao (tag <localTributacao>
nesta NFS-e o municpio da dentro de <serv>), o municpio da sede do prestador.
sede do prestador
3516 UF do local da obra no vlida A UF do local da obra, indicada na tag <vUfObra> dentro de
<dadosDaObra> de <infNFSe>, no vlida.
3517 Cidade do Local da Obra no A cidade do local da obra, indicada na tag <vCidadeObra> dentro de
vlida ou no pertence ao Estado <dadosDaObra> de <infNFSe>, no vlida ou no pertence ao
informado. Estado informado.
3518 UF do tomador no vlida A UF do tomador, indicada na tag <UF> dentro de <ender>, que faz
parte de <TomS> de <infNFSe>, no vlida.
3519 Cidade do tomador no vlida A cidade do tomador, indicada nas tags <cMun> e <xMun> dentro
ou no pertence ao Estado de <ender>, que faz parte de <TomS> de <infNFSe>, no vlida ou
informado. no pertence ao Estado informado.
3520 UF da transportadora no A UF da transportadora, indicada na tag <xUfTrans> dentro de
vlida <transportadora> de <infNFSe>, no vlida.
3521 Cidade da transportadora no A Cidade da transportadora, indicada na tag <xMunTrans> dentro
vlida ou no pertence ao Estado de <transportadora> de <infNFSe>, no vlida ou no pertence ao
informado Estado informado.
3523 Campo Valor Servio (valor O valor do item de servio, indicado na tag <vServ> dentro de
unitrio x quantidade <serv> que fica dentro da tag <det> de <infNFSe>, est incorreto.
desconto) do item est incorreto
3524 Base de clculo do ISSQN do item O valor da base de clculo do item de servio, indicado na tag
(valor unitrio x quantidade <vBCISS> dentro de <serv> que fica dentro da tag <det> de
desconto incondicional reduo <infNFSe>, est incorreto.
de base de clculo da construo
civil demais redues) est
incorreta
3525 Valor ISSQN do item (Base de O valor do ISSQN do item de servio, indicado na tag <vISS> dentro
clculo do ISSQN x alquota) est de <serv> que fica dentro da tag <det> de <infNFSe>, est incorreto.
incorreto
3526 Valor da reteno do IR do item O valor da reteno do IR, indicado na tag <vRetIR> dentro de
(base de clculo IR x alquota) <serv> que fica dentro da tag <det> de <infNFSe>, est incorreto.
est incorreto
3527 Valor de Reteno de IR superior O valor da reteno de IR, indicado na tag <vRetIR> dentro de
ao valor total do item <serv> que fica dentro da tag <det> de <infNFSe>, est com um
valor superior ao valor total de servios do item.
3529 Valor da base de clculo da O valor da base de clculo para reteno de IR, indicado na tag
reteno IR invlido <vBCRetIR> dentro de <serv> que fica dentro da tag <det> de
<infNFSe>, invlido.
3530 Valor da base de clculo da O valor da base de clculo para reteno de CSLL, indicado na tag
reteno CSLL invlido <vBCCSLL> dentro de <serv> que fica dentro da tag <det> de
<infNFSe>, invlido.

Pg. 87 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

3531 Valor da base de clculo da O valor da base de clculo para reteno de PIS-PASEP, indicado na
reteno PIS/PASEP invlido tag <vBCPISPASEP> dentro de <serv> que fica dentro da tag <det>
de <infNFSe>, invlido.
3532 Valor da base de clculo da O valor da base de clculo para reteno de INSS, indicado na tag
reteno INSS invlido <vBCINSS> dentro de <serv> que fica dentro da tag <det> de
<infNFSe> invlido.
3533 Valor da base de clculo da O valor da base de clculo para reteno de COFINS, indicado na tag
reteno COFINS invlido <vBCCOFINS> dentro de <serv> na tag <det> de <infNFSe>,
invlido.
3534 Valor da reteno de PIS/PASEP O valor da reteno de PIS/PASEP, indicado na tag <vRetPISPASEP>
do item est incorreto (base de dentro de <serv> que fica dentro da tag <det> de <infNFSe>, est
clculo PIS/PASEP x alquota) incorreto.
3535 Valor da reteno de PIS/PASEP O valor da reteno de PIS-PASEP, indicado na tag <vRetPISPASEP>
superior ao valor total do item dentro de <serv> que fica dentro da tag <det> de <infNFSe>, est
com um valor superior ao valor total de servios do item.
3537 Valor da reteno de COFINS O valor da reteno de COFINS, indicado na tag <vRetCOFINS>
(base de clculo COFINS x dentro de <serv> que fica dentro da tag <det> de <infNFSe>, est
alquota) est incorreto incorreto.
3538 Valor da reteno de COFINS O valor da reteno de COFINS, indicado na tag <vRetCOFINS>
superior ao valor total do item dentro de <serv> que fica dentro da tag <det> de <infNFSe>, est
com um valor superior ao valor total do item.
3540 Valor da reteno de INSS do O valor da reteno de INSS, indicado na tag <vRetINSS> dentro de
item (base de clculo INSS x <serv> que fica dentro da tag <det> de <infNFSe>, est incorreto.
alquota) est incorreto
3541 Valor da reteno de INSS O valor da reteno de INSS, indicado na tag <vRetINSS> dentro de
superior ao valor total do item <serv> que fica dentro da tag <det> de <infNFSe>, est com valor
superior ao valor total do item.
3543 Valor da reteno de CSLL do O valor da reteno de CSLL, indicado na tag <vRetCSLL> dentro de
item (base de clculo CSLL x <serv> que fica dentro da tag <det> de <infNFSe>, est incorreto.
alquota) est incorreto
3544 Valor da reteno da CSLL O valor da reteno de CSLL, indicado na tag <vRetCSLL> dentro de
superior ao valor total do item <serv> que fica dentro da tag <det> de <infNFSe>, est com um
valor superior ao valor total do item.
3546 Valor total da reteno do IR no O valor total da reteno de IR, indicado na tag <vRetIR> dentro de
corresponde soma das <Ret> que fica dentro da tag <total> de <infNFSe>, est incorreto.
respectivas retenes dos itens
3547 Valor total de reteno PIS/PASEP O valor total da reteno de PIS/PASEP, indicado na tag
no corresponde soma das <vRetPISPASEP> dentro de <Ret> que fica dentro da tag <total> de
respectivas retenes dos itens <infNFSe>, est incorreto.
3548 Valor total de reteno da O valor total da reteno de COFINS, indicado na tag <vRetCOFINS>
COFINS no corresponde soma dentro de <Ret> que fica dentro da tag <total> de <infNFSe>, est
das respectivas retenes dos incorreto.
itens

Pg. 88 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

3549 Valor total de reteno CSLL no O valor total da reteno de CSLL, indicado na tag <vRetCSLL>
corresponde soma das dentro de <Ret> que fica dentro da tag <total> de <infNFSe>, est
respectivas retenes dos itens incorreto.
3550 Valor total de reteno do INSS O valor total da reteno de INSS, indicado na tag <vRetINSS>
no corresponde soma das dentro de <Ret> que fica dentro da tag <total> de <infNFSe>, est
respectivas retenes nos itens incorreto.
3551 Valor de reteno do IR Valor de reteno do IR no informado nas totalizaes (tag
informado no(s) item(ns) de <vRetIR> dentro de <Ret> que fica dentro da tag <total> de
servio e no informado nas <infNFSe>).
totalizaes
3552 Valor de reteno do PIS/PASEP Valor de reteno do PIS-PASEP no informado nas totalizaes (tag
informado no(s) item(ns) de <vRetPISPASEP> dentro de <Ret> que fica dentro da tag <total> de
servio e no informado nas <infNFSe>).
totalizaes
3553 Valor de reteno da COFINS Valor de reteno da COFINS no informado nas totalizaes (tag
informado no(s) item(ns) de <vRetCOFINS> dentro de <Ret> que fica dentro da tag <total> de
servio e no informado nas <infNFSe>).
totalizaes
3554 Valor de reteno da CSLL Valor de reteno de CSLL no informado nas totalizaes
informado no(s) item(ns) de (<vRetCSLL> dentro de <Ret> que fica dentro da tag <total> de
servio e no informado nas <infNFSe>).
totalizaes
3555 Valor de reteno do INSS Valor de reteno do INSS no informado nas totalizaes (tag
informado no(s) item(ns) de <vRetINSS> dentro de <Ret> que fica dentro da tag <total> de
servio e no informado nas <infNFSe>).
totalizaes
3556 O campo Valor do ISSQN prprio O valor total de ISSQN, informado na tag <vISS> dentro de <ISS>,
(R$) no corresponde soma que fica dentro de <total> de <infNFSe>, no corresponde ao
dos valores informado nos itens. somatrio dos valores informados nos itens de servio nas tags
<det> da nota.
3557 O campo Valor do ISSQN Retido O valor total de ISSQN retido, informado na tag <vSTISS> dentro de
(R$) no corresponde soma <ISS>, que fica dentro de <total> de <infNFSe>, no corresponde ao
dos valores informados nos itens. somatrio dos valores informados nos itens de servio nas tags
<det> da nota.
3558 Valor total de ISSQN no confere O valor total de ISSQN, informado na tag <vISS> dentro de <ISS>,
com as informaes constantes que fica dentro de <total> de <infNFSe>, no est correto em se
na reduo na base de clculo da considerando os valores informados na reduo da base de clculo
construo civil da construo civil indicada na tag <vRedBCCivil> dentro de <total>
de <infNFSe>.
3559 A soma dos valores de servio O campo valor total da NFS-e, informado na tag <vServ> dentro de
por item (valor unitrio x <total> de <infNFSe>, no corresponde ao somatrio dos valores
quantidade desconto informados nos itens de servio.
incondicional) est incorreta

Pg. 89 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

3560 Valor lquido da nota no est O valor lquido da NFS-e, informado na tag <vtLiq> dentro de
correto <total> de <infNFSe>, est incorreto
3561 Erro na sequncia numrica da O nmero da NFS-e, indicado na tag <nNFS-e> dentro de <Id> de
NFS-e <infNFS-e>, deve ser sequencial e crescente.
3562 No possvel emitir uma NFS-e A situao da nota, indicada na tag <cancelada> dentro de <Id> de
cancelada <infNFS-e>, est com 'S' e a nota ainda no foi emitida. Esta tag
serve apenas para indicar se uma nota se encontra cancelada,
quando se solicita o arquivo XML dela.
3563 O arquivo XML submetido excede A quantidade mxima permitida de 50 notas por lote.
o limite de 50 NFS-e por lote.
3564 Sequncia de numerao do RPS O nmero informado do RPS no obedece a numerao sequencial
est invlida. crescente.
3566 Cidade do prestador no confere A cidade do prestador, indicada nas tags <cMun> e <xMun> dentro
com o dado constante no de <end>, que fica dentro da tag <prest> da <infNFSe>, no confere
Cadastro Econmico do com a cidade constante no Cadastro Econmico do Municpio. Ser
Municpio sempre Caxias do Sul.
3567 UF do prestador no confere com A UF do prestador, indicado na tag <UF> dentro de <end>, que fica
o dado constante no Cadastro dentro da tag <prest> da <infNFSe>, no confere com a UF
Econmico do Municpio constante no Cadastro Econmico do Municpio.
3568 Valor total das faturas no O valor total das faturas, correspondente ao somatrio dos valores
confere com o valor lquido da indicados pelas tags <vFat> dentro de <fat> que fica dentro de
nota. <faturas> em <infNFSe>, no coincide com o valor lquido total da
nota indicado na tag <vtLiq> de <total> dentro de <infNFSe>.
3569 No permitido substituio Se as tags <cPais> e <xPais>, dentro da tag <ender> de <TomS> que
tributria para tomadores de fica dentro de <infNFSe>, indicarem um pais diferente do Brasil, os
servio do exterior. servios indicados pela tag <Serv> no podem ter substituio
tributria.
3571 Cdigo do Municpio do O cdigo do IBGE do municpio do prestador indicado na tag
Prestador est incorreto. <cMun> dentro da tag <end> de <prest> que fica dentro de
<infNFSe> est incorreto.
3572 Cdigo do Municpio do Tomador O cdigo do IBGE do municpio do tomador indicado na tag <cMun>
est incorreto dentro da tag <ender> de <TomS> est incorreto.
3574 Cdigo do Municpio do Tomador O cdigo do IBGE do municpio do tomador indicado na tag <cMun>
no foi informado dentro da tag <ender> de <TomS> no foi informado ou deve estar
faltando esta tag <cMun> na NFSe submetida. Esta validao
somente aplicada para tomadores que no tenham CPF
informado.
3575 Tipo de emisso no pode ser O valor da tag <tpEmis> dentro de <Id> da <infNFSe> deve ser
contingncia obrigatoriamente igual a 'N' para uma NFS-e emitida online via
Portal da Prefeitura ou via servio Web.
3576 Tipo de emisso deve ser de O valor da tag <tpEmis> dentro de <Id> de <infNFSe> deve ser
contingncia obrigatoriamente igual a 'C' para uma NFS-e emitida atravs do uso
do RPS.

Pg. 90 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

3577 Cdigo do Pas do Prestador est O cdigo do BACEN do pas do prestador indicado na tag <cPais>
incorreto dentro da tag <end> de <emit> est incorreto.

3578 Cdigo do Pas do Tomador est O cdigo do BACEN do pas do tomador indicado na tag <cPais>
incorreto dentro da tag <ender> de <TomS> est incorreto.
3579 O campo UF deve ser informado A UF do tomador, indicada na tag <UF> dentro de <ender>, que faz
com 'EX' para tomadores do parte de <TomS> de <infNFSe>, deve ter o valor fixo 'EX' para
exterior tomadores que sejam do exterior.
3580 O campo UF deve ser informado A UF do local da obra, indicada na tag <vUfObra> dentro de
com 'EX' para o local da obra no <dadosDaObra> de <infNFSe>, deve ter o valor fixo 'EX' para locais
exterior no exterior.
3581 Data de vencimento da fatura A data de vencimento indicada pela tag <dVenc> da tag <fat>, que
no pode ser anterior a data da fica dentro da tag <faturas> de <infNFSe> no pode ser anterior a
emisso da NFS-e. data de emisso da NFSe.
3582 No possvel registrar o mesmo O nmero da fatura indicado pela tag <nFat> da tag <fat>, que fica
nmero para faturas distintas dentro da tag <faturas> de <infNFSe> no pode ser repetido em
uma mesma NFSe.
3583 Base de clculo total no confere O valor indicado pela tag <vBCISS> (no caso de imposto prprio) ou
com as informaes passadas na pela tag <vBCSTISS> (no caso de imposto retido) dentro da tag <ISS>
reduo na base de clculo da de <total>, que fica dentro de <infNFSe>, no corresponde aos
construo civil valores informados na reduo da base de clculo da construo
civil indicada na tag <vRedBCCivil> dentro de <total> de <infNFSe>.
3586 Cdigo da UF do Prestador est O cdigo da UF do municpio do prestador indicado pelo dois
invlido primeiros algarismos do valor na tag <cMun> dentro da tag <end>
de <prest> que fica dentro de <infNFSe> no um cdigo vlido.
3587 Cdigo do Municpio do O cdigo da UF municpio do prestador indicado pelos dois
Prestador est incorreto primeiros algarismos do valor na tag <cMun> dentro da tag <end>
de <prest> que fica dentro de <infNFSe> no corresponde UF do
municpio indicado pelos demais cinco algarismos da tag <cMun>.
3588 Cdigo da UF do Tomador est O cdigo da UF do municpio do tomador indicado pelo dois
invlido. primeiros algarismos do valor na tag <cMun> dentro da tag <ender>
de <TomS> que fica dentro de <infNFSe> no um cdigo vlido.
3589 Cdigo do Municpio do Tomador O cdigo da UF municpio do tomador indicado pelos dois primeiros
est incorreto algarismos do valor na tag <cMun> dentro da tag <ender> de
<TomS> que fica dentro de <infNFSe> no corresponde UF do
municpio indicado pelos demais cinco algarismos da tag <cMun>.
3590 Motivo de cancelamento A tag <motCanc>, dentro de <Id> de <infNFSe>, deve ser numrica
incorreto com valor 1 ou 2.
3591 Placa de veculo invlida para a A tag <xPlacaTrans>, dentro de <transportadora> de <infNFSe>,
transportadora deve respeitar o modelo definido pelo tipo TplacaVeic mostrado na
Seo 2.2.1. deste Manual.
3592 O valor total lquido da fatura O valor da tag <vtLiqFaturas> deve ser igual a soma de todos os
deve ser igual a soma dos valores valores das tags <vFat> que esto dentro de <fat> de <faturas>.
das faturas

Pg. 91 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

3593 O cdigo do municpio do local O cdigo de municpio informado na tag <infAdicLT> no foi
de tributao invlido encontrado na tabela do IBGE.
3594 O municpio do local de O cdigo de municpio informado na tag <infAdicLT> deveria ser
tributao informado nos igual ao cdigo de municpio informado na tag <localTributacao>.
servios no confere com o
municpio informado para as
informaes adicionais
3595 O cdigo de municpio do local O cdigo do municpio informado na tag <localTributacao> no foi
de tributao informado no encontrado na tabela do IBGE.
servio invlido
3596 O modelo da NFS-e informado O valor da tag <mod> dentro de <Id> de <infNFSe> deve ser 98.
est incorreto
3597 A indicao do canhoto est O valor da tag <canhoto> dentro de <Id> de <infNFSe> deve ser
incorreta numrico e pode ser 0, 1 ou 2.
3598 Forma da NFS-e informada est O valor da tag <formaEmi> dentro de <Id> de <infNFSe> deve ser
incorreta numrico e pode ser 1, 2, 3 ou 4.
3599 Ambiente de emisso informado O valor da tag <ambienteEmi> dentro de <Id> de <infNFSe> deve
est incorreto ser numrico e pode ser 1 ou 2.
3600 Telefone 1 do prestador est O formato do telefone na tag <fone>, dentro de <prest> de
incorreto <infNFSe>, deve respeitar o formato indicado na tabela da Seo 2.2
3601 Telefone 2 do prestador est O formato do telefone na tag <fone2>, dentro de <prest> de
incorreto <infNFSe>, deve respeitar o formato indicado na tabela da Seo
2.2.
3602 Telefone 1 do tomador est O formato do telefone na tag <fone>, dentro de <TomS> de
incorreto <infNFSe>, deve respeitar o formato indicado na tabela da Seo
2.2.
3603 Telefone 2 do tomador est O formato do telefone na tag <fone2>, dentro de <TomS> de
incorreto <infNFSe>, deve respeitar o formato indicado na tabela da Seo
2.2.
3604 Inscrio municipal de O valor da tag <IME>, dentro de <TomS> de <infNFSe>, deve ser
contribuinte eventual est numrico,
incorreta
3605 Regime tributrio no confere O regime tributrio informado na tag <regimeTrib>, dentro de
com o cadastro do contribuinte <prest> de <infNFSe>, no o mesmo que est no cadastro do
contribuinte.
3606 O Regime tributrio est O valor da tag <regimeTrib>, dentro de <prest> de <infNFSe>, deve
incorreto ser numrico e pode ser 1, 2 ou 3.
3607 Dados do Obra informados esto Quando informado os dados da obra na tag <dadosDaObra>, dentro
incompletos de <infNFSe>, so obrigatrios informar logradouro, cidade, estado
e pais (tanto o cdigo quanto a descrio).
3608 CNPJ/CPF da transportadora O valor da tag <xCpfCnpjTrans> no um CNPJ ou CPF vlido.
incorreto

Pg. 92 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

3609 Nos dados da transportadora Pelo menos o valor da tag <xNomeTrans>, dentro da tag
deve constar pelo menos o nome <transportadora> de <infNFSe> deve ser informado.
dela
3610 O cdigo do municpio da O valor da tag <cMunTrans>, dentro de <transportadora> de
transportadora est incorreto <infNFSe>, no consta na tabela do IBGE.
3611 O cdigo do Pais da O valor da tag <cPaisTrans>, dentro de <transportadora> de
transportadora est incorreto <infNFSe>, no consta na tabela do BACEN.
3613 A unidade do servio deve ser O valor da tag <uTrib>, dentro de <serv> de <det> em <infNFSe>,
informada deve ser informado,
3614 Base de clculo, alquota e valor Caso no seja um contribuinte optante do Simples Nacional,
ISS devem ser informados obrigatrio informar as tags <vBCISS>, <pISS> e <vISS>.
3615 Lei veda reteno federal para Caso o tomador seja pessoa fsica, a nota fiscal no pode possuir
tomador pessoa fsica retenes federais.
3616 Verso do XML da NFS-e no A verso do formato XML indicada pelo atributo <versao> de
suportada <infNFSe> no suportada pelo sistema NFSe.
3617 Nmero do item da fatura O valor da tag <nItem>, dentro de <fat> de <faturas>, deve ser
obrigatrio informado.
3618 Lei veda substituio tributria Caso o tomador seja do exterior, nenhum dos itens de servio da
para tomadores do exterior nota fiscal pode possuir substituio tributria.
3619 No possvel cancelar esta nota No possvel cancelar esta nota fiscal devido a mesma j estar
fiscal devido a mesma j estar cancelada.
cancelada
3620 No possvel cancelar esta nota No possvel cancelar esta nota fiscal por conta de se ter
fiscal por conta de se ter ultrapassado o perodo permitido.
ultrapassado o perodo permitido
3621 No possvel cancelar esta NFS- No possvel cancelar esta NFS-e devido haver uma guia de
e devido haver uma guia de arrecadao atrelada a ela. O cancelamento pode ser realizado no
arrecadao atrelada a ela portal, depois de se ter excluda a guia de arrecadao, no caso de a
guia ainda no ter sido paga.
3622 O motivo do cancelamento deve O valor da tag <motCanc>, dentro de <id> de <infNFSe>, deve ser
ser informado. informado.
3623 Situao cadastral do prestador Situao cadastral do prestador de servios perante o Municpio
de servios perante o Municpio impede a emisso de NFS-e.
impede a emisso de NFS-e
3624 O campo Empreitada Global est O valor da tag <empreitadaGlobal>, dentro de <Id> de <infNFSe>,
incorreto deve ser S ou N.
3625 O campo de verificao para O valor da tag <localVerifResServ> dentro da tag <serv> de <det>
tributao no exterior est deve possuir 1 ou 2.
incorreto
3626 A Lei Complementar informada O valor da tag <cLCServ>, dentro da tag <serv> de <det> em
no servio est incorreta <infNFSe>, est incorreta.

Pg. 93 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

3628 O local de verificao do O valor indicado na tag <localVerifResServ>, dentro da tag <serv> de
resultado da prestao de servio <det> de <infNFSe>, est inconsistente com o valor da tag
no exterior est divergente entre <infAdicES> dentro da tag <infNFSe>.
o indicado no servio e para as
informaes adicionais
3629 O nmero do item da fatura est O valor da tag <nItem>, dentro de <fat> da tag <faturas> em
incorreto <infNFSe>, est incorreto.
3630 A forma de emisso informada O valor da tag <formaEmi>, dentro de <infNFSe>, est inconsistente
no confere com a forma com a forma efetivamente utilizada para submisso da NFS-e.
utilizada efetivamente utilizada
na emisso da NFS-e
3631 O ambiente de emisso O valor da tag <ambienteEmi>, dentro de <infNFSe>, est
informado no confere com o inconsistente com o ambiente efetivamente utilizado para a
ambiente efetivamente utilizado submisso da NFS-e.
para a emisso da NFS-e
3632 O local de tributao dos itens de O valor da tag <localTributacao>, dentro da tag <serv> de <det> de
servio devem ser os mesmos <infNFSe>, devem ser o mesmo para todos os servios em uma
mesma NFS-e.
3633 O local de tributao a ser O valor da tag <infAdicLT>, dentro de <infNFSe>, deve ser
exibido nas informaes informado.
adicionais no foi informado.
3634 A reduo da base de clculo A reduo da base de clculo para construo civil no pode ser
para construo civil no pode informada nesta NFS-e, pois a tag <empreitadaGlobal>, dentro de
ser informada devido a NFS-e <infNFSe> est com valor 2.
no ser de Empreitada Global
3635 O valor total de base de clculo O valor indicado na tag <vBCISS> de <ISS> dentro da tag <total> de
do imposto prprio no confere <infNFSe> est diferente da soma dos valores informados nas tags
com as bases de clculos <vBCISS> de <serv> dentro da tag <det> de <infNFSe>.
informadas nos itens
3636 O valor total de base de clculo O valor indicado na tag <vBCSTISS> de <ISS> dentro da tag <total>
do imposto retido no confere de <infNFSe> est diferente da soma dos valores informados nas
com as bases de clculos tags <vBCST> de <ISSST> dentro da tag <det> de <infNFSe>.
informadas nos itens
3639 A NFS-e no pode ter itens com Em uma mesma NFS-e no pode existir um item de servio com a
local de verificao do resultado tag <localVerifResServ> com valor igual a 1 (no Brasil) e outro item
do servio no Exterior e outros de servio com esta tag com valor 2 (Exterior).
itens com local de verificao do
resultado do servio no Brasil
3640 Alquota deve ser zerada quando Caso a tag <localVerifResServ> tenha valor 2 (Exterior), o valor da
o local de verificao do tag <pISS> de <serv> dentro da tag <det> de <infNFSe> deve ter
resultado do servio for no valor zero.
exterior

Pg. 94 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

3641 A NFS-e pode ter itens de servio O pas do endereo do tomador de servio, indicado nas tags
com local de verificao de <cPais> e <xPais> dentro de <ender> de <TomS>, deve ser um pas
resultado do servio no exterior diferente de Brasil para que se possa indicar itens de servio com
apenas quando o tomador do verificao de resultado do servio no exterior.
exterior
3642 O local de tributao no deve A tag <localTributacao> dentro da tag <serv> de <det> em
ser informado para uma NFS-e <infNFSe> e infAdicLT no deve ser informada para NFS-e que tenha
com item de servio com local de um item de servio com tag <localVerifResServ> tendo valor igual a
verificao do resultado do 2, indicando servio com local de verificao de resultado do servio
servio no exterior no exterior.
3643 A NFS-e no pode possuir A alquota dos servios em uma mesma NFS-e, indicada na tag
item(ns) com alquotas distintas <pISS> dentro de <serv> de <det> em <infNFSe> no podem ter
valores diferentes.
3644 A tag <dhTrans> deve conter o A data de transmisso indicada na tag <dhTrans> deve obedecer o
formato AAAA-MM-DD formato indicado.
HH:MM:SS
3645 Inscrio municipal do tomador A inscrio municipal do tomador, indicada na tag <IM> dentro de
invlida <TomS> de <infNFSe> est com um valor invlido.
3646 Inscrio estadual do tomador A inscrio estadual do tomador, indicada na tag <IE> dentro de
invlida <TomS> de <infNFSe> est com um valor invlido.
3647 Situao cadastral do prestador O prestador deve entrar em contato com o Fisco do Municpio, pois
de servios perante o Municpio est bloqueada para ele a possibilidade de cancelamento de NFS-e.
impede o cancelamento de NFS-e
3678 Tipo de vencimento da fatura A tag <tipoVencFat>, dentro da tag <fat> de <faturas>, deve ter um
invlido dos seguintes valores: 1 para indicar Data Certa, 2 para indicar
Apresentao, 3 para indicar vista e 4 para Outros.
3679 O campo data de vencimento Caso a tag <tipoVencFat>, dentro da tag <fat> de <faturas>, tenha o
obrigatrio quando o tipo de valor 1, a tag <dVenc>, dentro da tag <fat> de <faturas>, deve ser
vencimento 'Data certa' obrigatoriamente informada.
3680 O campo descrio obrigatrio Caso a tag <tipoVencFat>, dentro da tag <fat> de <faturas>, tenha o
quando o tipo de vencimento valor 4, a tag <descTipoVencFat>, dentro da tag <fat> de <faturas>,
'Outros' deve ser obrigatoriamente informada.
3681 Alquotas dos itens devem ser O valor da tag <pISS> dentro da tag <serv> de <det> devem ser zero,
zeradas, devido o contribuinte caso o contribuinte seja optante do Simples Nacional.
ser Optante pelo Simples
Nacional
3682 Nmero da nota fiscal j est O nmero da nota fiscal, indicado na tag <nFSE-e> dentro da tag
inutilizado <Id> de <infNFSe>, corresponde a uma nota que j foi inutilizada.
3683 Nmero de nota fiscal no pode O nmero da nota fiscal, indicado na tag <nFSE-e> dentro da tag
ser utilizada com esta emisso. J <Id> de <infNFSe>, no pode mais ser utilizado, devendo ser
existem notas com data superior inutilizado at o encerramento do ms competncia
a esta correspondente, pois j existem notas vlidas com data de emisso
superior ao da data de emisso da nota fiscal que no foi validada e
que assim precisa ser inutilizada.

Pg. 95 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.5

3684 Nmero de nota fiscal no pode O nmero da nota fiscal, indicado na tag <nFSE-e> dentro da tag
ser utilizada com esta emisso. J <Id> de <infNFSe>, no pode mais ser utilizado, devendo ser
existe nota com nmero maior e inutilizado at o encerramento do ms competncia
data menor que esta correspondente, pois j existem notas vlidas com nmero maior do
que o desta nota fiscal, que assim precisa ser inutilizada.

3685 Item da nota fiscal com base de Dentro da tag <serv> de <det> foi includa incorretamente uma tag
clculo de imposto prprio, <vBCISS>. Por se tratar de nota fiscal com itens de servio de
sendo o item de substituio imposto retido (possui tag <ISSST> dentro da tag <det>), no
tributria deveria ter sido includa tag <vBCISS> no item de servio.
3686 No permitido ter base de Dentro da tag <ISS> da tag <total> devem constar apenas as tags
clculo de imposto prprio e para indicao de imposto prprio (<vBCISS> e <vISS>) ou de
imposto retido na totalizao da imposto retido (<vBCSTISS> e <vSTISS>).
mesma nota
3687 No permitido informar a base Os contribuintes optantes do Simples Nacional no devem informar
de clculo de imposto prprio a tag <vBCISS> dentro da tag <serv> de cada item de servio ou se
para contribuintes Optantes pelo informar deve ser com valor zero.
Simples Nacional
3696 O campo 'Local da Obra' O servio informado exige que seja includa a tag <dadosDaObra>
obrigatrio para este tipo de com todas as informaes obrigatrias sobre o local da obra.
servio

Pg. 96 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.4

7. Glossrio

Termo Conceito
ABRASF Associao Brasileira de Secretrios e Dirigentes de Finanas dos Municpios das Capitais
ABRASF tem o intuito de aperfeioar a gesto financeira e tributria dos municpios,
desenvolvendo atividades de pesquisa, estudos e projetos voltados para o seguimento.
ART Anotao de Responsabilidade Tcnica
Assinatura Digital Cdigo de criptografia (chave privada) anexado ou logicamente associado a uma mensagem
eletrnica que permite de forma nica e exclusiva a comprovao da autoria de um determinado
conjunto de dados de computador (um arquivo, um e-mail ou uma transao). A assinatura digital
comprova que a pessoa criou ou concorda com um documento assinado digitalmente, como a
assinatura de prprio punho comprova a autoria de um documento escrito. A verificao da
origem do dado feita com a chave pblica do remetente.
BACEN (BD ou BCB) Banco Central do Brasil (BC ou BACEN e, mais atualmente, BCB) autarquia federal integrante do
Sistema Financeiro Nacional, sendo vinculado ao Ministrio da Fazenda do Brasil.
Cadastro de Pessoas Registro de cidados brasileiros ou estrangeiros legais e armazena informaes pessoais do
Fsicas - CPF contribuinte no sistema da Receita Federal do Brasil.
Cadastro Econmico o banco de dados que contm as informaes e registros dos contribuintes do ISSQN do
Municpio de Caxias do Sul.
Cadastro Nacional de Compreende as informaes cadastrais das entidades de interesse das administraes tributrias
Pessoa Jurdica - CNPJ da Unio, dos Estados, do Distrito Federal e dos Municpios. A administrao do CNPJ compete
Receita Federal do Brasil.
CEI Cadastro Especfico do INSS
Certificao Digital a atividade de reconhecimento em meio eletrnico, que se caracteriza pelo estabelecimento de
uma relao nica, exclusiva e intransfervel entre uma chave de criptografia, inserida em um
Certificado Digital; uma pessoa fsica, jurdica, mquina ou aplicao e a Autoridade Certificadora.
Certificado Digital (1) um documento contendo dados de identificao da pessoa ou instituio que deseja, por
meio deste, comprovar, perante terceiros, a sua prpria identidade. Serve igualmente para
conferir a identidade de terceiros.
(2) um conjunto de dados de computador, gerados em observncia Recomendao
Internacional ITU-T X.509, que se destina a registrar, de forma nica, exclusiva e intransfervel, a
relao existente entre uma chave de criptografia, uma pessoa fsica, jurdica, mquina ou
aplicao e a Autoridade Certificadora. O Certificado Digital pode ser armazenado em um
software ou em um hardware.
Declarao Mensal de Sistema destinado ao preenchimento e transmisso de dados relativos aos servios prestados e
Servios Eletrnica - tomados; apurao do ISS a recolher e gerao das respectivas guias de recolhimento.
DMS-e
Declarao Mensal de Obrigao tributria de natureza acessria, que tem por objetivo a apresentao de informaes
Servios - DMS pelas empresas prestadoras e tomadoras de servios, que esto no campo de incidncia do
ISSQN.

Pg. 97 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.4

ERP Sistemas Integrados de Gesto Empresarial (SIGE ou SIG), em ingls Enterprise Resource Planning
(ERP), so sistemas de informao que integram todos os dados e processos de uma organizao
em um nico sistema. A integrao pode ser vista sob a perspectiva funcional (sistemas de:
finanas, contabilidade, recursos humanos, fabricao, marketing, vendas, compras, etc.) e sob a
perspectiva sistmica (sistema de processamento de transaes, sistemas de informaes
gerenciais, sistemas de apoio a deciso, etc.). Os ERP's, em termos gerais, so plataformas de
software desenvolvidos para integrar os diversos departamentos de uma empresa, possibilitando
a automao e armazenamento de todas as informaes de negcios.
Hash o resultado da ao de algoritmos que fazem o mapeamento de uma sequncia de bits de
tamanho arbitrrio para uma sequncia de bits de tamanho fixo menor - conhecido como
resultado hash - de forma que seja muito difcil encontrar duas mensagens produzindo o mesmo
resultado hash (resistncia coliso), e que o processo reverso tambm no seja realizvel (dado
um hash, no possvel recuperar a mensagem que o gerou).
HTTPS HTTPS (HyperText Transfer Protocol Secure), uma implementao do protocolo HTTP sobre uma
camada SSL ou do TLS. Essa camada adicional permite que os dados sejam transmitidos atravs
de uma conexo criptografada e que se verifique a autenticidade do servidor e do cliente, por
meio de certificados digitais. O protocolo HTTPS normalmente utilizado quando se deseja
evitar que a informao transmitida entre o cliente e o servidor seja visualizada por terceiros,
como por exemplo no caso de compras on-line. Nas URLs dos stios o incio ficaria 'https://'.
IBGE Instituto Brasileiro de Geografia e Estatstica - IBGE uma fundao pblica da administrao
federal brasileira, criado em 1934 e instalado em 1936 com o nome de Instituto Nacional de
Estatstica. O nome atual data de 1938. O IBGE tem atribuies ligadas s geocincias e
estatsticas sociais, demogrficas e econmicas, o que inclui realizar censos e organizar as
informaes obtidas nesses censos, para suprir rgos das esferas governamentais federal,
estadual e municipal, e para outras instituies e o pblico em geral.
ICP-Brasil Infraestrutura de Chaves Pblicas Brasileira - ICP-Brasil, instituda a partir da medida provisria
2.200/2001, composta de entidades pblicas e privadas, homologadas pela comisso de
certificados digitais, que podem ser utilizadas para a conferncia de assinaturas digitais,
conferindo-lhes validade jurdica. um conjunto de tcnicas, arquitetura, organizao, prticas e
procedimentos, implementados pelas organizaes governamentais e privadas brasileiras que
suportam, em conjunto, a implementao e a operao de um sistema de certificao, com o
objetivo de estabelecer os fundamentos tcnicos e metodolgicos de um sistema de certificao
digital, baseado em criptografia de chave pblica, garantir a autenticidade, a integridade e a
validade jurdica de documentos em forma eletrnica, das aplicaes de suporte e das aplicaes
habilitadas que utilizem certificados digitais, bem como a realizao de transaes eletrnicas
seguras.
Inscrio Estadual - Cdigo numrico identificador de cada pessoa fsica ou jurdica utilizado pelas secretarias de
IE fazenda e de finanas estaduais do Brasil. Cdigo numrico identificador de pessoa fsica ou
jurdica, utilizado pelas secretarias de fazenda e de finanas estaduais do Brasil.
Inscrio Municipal - Cdigo numrico identificador de pessoa fsica ou jurdica, utilizado pelas secretarias municipais
IM de fazenda e de finanas do Brasil.
ISSQN Imposto Sobre Servios de Qualquer Natureza ISSQN o imposto de competncia dos
Municpios e do Distrito Federal, por fora da CF, art 156, III, que tem como fato gerador a
prestao dos servios constantes da lista anexa Lei Complementar 116/2003.
Imunidade Ocorre quando a regra constitucional impede a incidncia da regra jurdica de tributao.
Iseno a dispensa do pagamento do tributo, concedido de forma geral ou especfica, por fora de Lei. A
lei isentiva poder estipular prazo e condies para sua concesso.

Pg. 98 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.4

Lote de RPS Quantidade de RPS (veja Recibo Provisrio de Servios) que ser enviada conjuntamente
Administrao Tributria Municipal para validao, processamento e gerao das respectivas NFS-
e (veja Nota Fiscal de Servios Eletrnica).
No incidncia Servios no previstos em lei complementar que autorize sua tributao.
Nota Fiscal de um documento de existncia exclusivamente digital, gerado e armazenado eletronicamente
Servios Eletrnica - pela Administrao Tributria Municipal ou por outra entidade conveniada, para documentar as
NFS-e operaes de prestao de servios.
Portal do Portal de acesso do contribuinte para os servios de emisso, transmisso por lote e consulta de
Contribuinte NFS-e.
Prestador de Servios Aquele que desenvolve a atividade de prestar servio de modo permanente ou temporrio.
(ou apenas Prestador)
PRF Recolhimento do ISS com base no nmero de profissionais. (Art. 62 2o da Lei Complementar no
12/1994 na redao dada pela Lei Complementar no 217/2003) .
Processo Assncrono Um processo assncrono ser executado em um momento posterior ao recebimento da requisio
pelo responsvel em process-la. Um processo assncrono no necessita que o transmissor e o
receptor da requisio estejam conectados durante todo o processo. O sistema que ir processar
a requisio pode escolher o melhor momento para execuo da atividade, sem exceder os
recursos disponveis (conexo, processador, memria) e sem colocar em risco os servios
concorrentes do servidor.
Processo Sncrono Um processo sncrono ser executado no momento do envio da requisio, esse tipo de processo
exige uma conexo ativa durante o envio da requisio, processamento e recebimento da
resposta. Por exemplo, ao enviar uma requisio de consulta de uma nota fiscal a um servio
sncrono, o processamento se dar assim que a requisio for recebida e a resposta ser
retornada assim que a nota tiver sido localizada na base de dados. Dependendo da velocidade da
conexo e dos recursos disponveis no servidor (memria, processador), esta resposta poder ser
imediata ou durar alguns segundos.
Recibo Provisrio de o documento fornecido pelo contribuinte ao tomador do servio com os dados de uma
Servios - RPS prestao que devero ser informados ou transmitidos posteriormente ao Administrao
Tributria Municipal quando no for possvel a gerao imediata da respectiva NFS-e.
SEFAZ/RS Trata-se da Secretaria da Fazenda do Rio Grande do Sul, que tem sua sede em Porto Alegre, mas
est presente em todo o Estado atuando atravs de suas reparties. Sua estrutura bsica est
disposta no Decreto 47.590 de 2010, que tambm define suas reas de competncia.
Servio no tributado Prestao de servio cuja incidncia de ISSQN no est prevista em lei municipal.
Servio tributado o servio tributvel previsto em lei municipal que crie para o contribuinte a obrigao tributria
de recolher o ISSQN.
Servio tributvel Servios previstos em lei complementar , cujo direito de tributar compete aos Municpios.
Simples Nacional (SN) Regime nico de arrecadao de impostos e contribuies federais, estaduais e municipais,
institudo pela Lei Complementar 123/2006.
SOAP SOAP (acrnimo do ingls Simple Object Access Protocol) um protocolo para intercmbio de
mensagens entre programas de computador. Geralmente servidores SOAP so implementados
utilizando-se servidores HTTP pr-existentes, embora isto no seja uma restrio para
funcionamento do protocolo. As mensagens SOAP so documentos XML que aderem a uma
especificao fornecida pelo rgo W3C.

Pg. 99 de 100
MANUAL DE CONECTIVIDADE DA
NFS-e
Verso 1.6.4

SSL a sigla de Secure Socket Layer, trata-se de um protocolo criptogrfico que agrega segurana de
comunicao na Internet para servios como e-mail (SMTP), navegao por pginas (HTTP) e
outros tipos de transferncia de dados. SSL prov a privacidade e a integridade de dados entre
duas aplicaes que se comuniquem pela Internet. Isto ocorre atravs da autenticao das partes
envolvidas e da cifra dos dados transmitidos entre as partes.
Tomador de servios O destinatrio do servio prestado.
UDDI Sigla de Universal Description Discovery and Integration, um servio de diretrio onde se pode
registrar (publicar) e buscar (descobrir) por servios Web. Trata-se de uma tecnologia
independente de plataforma para descrever e integrar os servios de negcios usando a internet.
A comunicao realizada atravs do SOAP e as interfaces servios web so descritas por WSDL.
UTF-8 Unicode Transformation Format de 8 bits, um tipo de codificao Unicode de comprimento
varivel (entre um e quatro bytes), que pode representar qualquer caracter universal padro do
Unicode, sendo tambm compatvel com o padro ASCII.
W3C World Wide Web Consortium um consrcio de empresas de tecnologia, fundado para levar a
Web ao seu potencial mximo, por meio do desenvolvimento de protocolos comuns e fruns
abertos que promovem sua evoluo e asseguram a sua interoperabilidade. O W3C desenvolve
tecnologias denominadas padres da web para a criao e interpretao dos contedos para a
Web. Stios da Web desenvolvidos segundo esses padres podem ser acessados e visualizados por
qualquer pessoa ou tecnologia, independente de hardware ou software utilizados, de maneira
rpida e compatvel com os novos padres e tecnologias que possam surgir com a evoluo da
internet.
Web service Web service uma soluo utilizada na integrao de sistemas e na comunicao entre
aplicaes diferentes. Com esta tecnologia possvel que novas aplicaes possam interagir com
aquelas que j existem e que sistemas desenvolvidos em plataformas diferentes sejam
compatveis.
WS-I Web Services Interoperability um consrcio de empresas fundado em fevereiro de 2002, que
rene mais de 100 empresas, com o objetivo de assegurar a interoperabilidade entre os
equipamentos em sistemas baseados em servios Web.
WSDL a sigla de (Web Service Description Language), padro baseado em XML para descrever o
servio, que traz os mtodos do web service. Funciona como uma espcie de Type Library do
Web Service, alm de ser usado para a validao das chamadas dos mtodos.
XML XML (Extensible Markup Language) uma recomendao da W3C para gerar linguagens de
marcao para necessidades especiais. Seu propsito principal a facilidade de
compartilhamento de informaes atravs da Internet.
XSD Sigla de XML Schema Definition, uma linguagem baseada no formato XML para definio de
regras de validao (esquemas) em documentos no formato XML.

Pg. 100 de 100

También podría gustarte