Manual Webservice Nfse

Manual de Utilizao do Web Service
Revisado em: 3/10/2012

Verso da ABRASF: 1.00
Verso: 1.08

Pgina 1 de 62

Nota Fiscal de Servios Eletrnica - NFSE

NOTA FISCAL DE SERVIOS
ELETRNICA NFSE



Verso: 1.08

Pgina 2 de 62

Sumrio
1. INTRODUO ............................................................................................................ 4
1.1. NOTA FISCAL DE SERVIOS ELETRNICA - NFS-E....................................... 4
1.2. RECIBO PROVISRIO DE SERVIO RPS ..................................................... 4
2. ARQUITETURA DE COMUNICAO COM O CONTRIBUINTE ............................... 6
2.1. MODELO CONCEITUAL...................................................................................... 6
2.1.1. Recepo e Processamento de Lote de RPS ................................................... 6
2.1.2. Consulta de Situao de Lote de RPS .............................................................. 7
2.1.3. Consulta de NFS-e por RPS ............................................................................. 7
2.1.4. Consulta de Lote de RPS ................................................................................. 8
2.1.5. Consulta de NFS-e ........................................................................................... 9
2.1.6. Cancelamento de NFS-e .................................................................................. 9
2.2. PADRES TCNICOS ...................................................................................... 10
2.2.1. Padro de Comunicao ................................................................................ 10
2.2.2. Padro de Certificado Digital .......................................................................... 11
2.2.3. Padro de Assinatura Digital .......................................................................... 12
2.2.4. Validao de Assinatura Digital pelo Sistema NFS-e ..................................... 14
2.2.5. Uso de Assinatura com Certificado Digital ...................................................... 15
2.3. PADRO DAS MENSAGENS XML ................................................................... 15
2.3.1. rea do Cabealho ......................................................................................... 15
2.3.2. Validao da estrutura das Mensagens XML ................................................. 16
2.3.3. Schemas XML (arquivos XSD) ....................................................................... 17
2.3.4. Verso dos Schemas XML ............................................................................. 17
2.4. AMBIENTE DE HOMOLOGAO ..................................................................... 17
3. ESTRUTURA DE DADOS DO WEB SERVICE ........................................................ 19
3.1. MODELO OPERACIONAL ................................................................................. 19
3.1.1. Servios Sncronos ......................................................................................... 19
3.1.2. Servios Assncronos ..................................................................................... 20
3.2. FORMATOS E PADRES UTILIZADOS ........................................................... 21
3.3. TIPOS SIMPLES ................................................................................................ 23
3.4. TIPOS COMPLEXOS ......................................................................................... 25


Verso: 1.08

Pgina 3 de 62

3.5. SERVIOS ......................................................................................................... 34
3.5.1. Verso do Sistema .......................................................................................... 35
3.5.2. Recepo de Lote RPS .................................................................................. 35
3.5.3. Consulta de Situao de Lote de RPS ............................................................ 37
3.5.4. Consulta de NFS-e por RPS ........................................................................... 38
3.5.5. Consulta de NFS-e ......................................................................................... 40
3.5.6. Consulta de Lote de RPS ............................................................................... 42
3.5.7. Cancelamento NFS-e ..................................................................................... 44
3.5.8. Gerar NFS-e ................................................................................................... 45
Mtodo: GeraNfse ............................................................................................................ 45
4. ANEXOS ................................................................................................................... 48
4.1. TABELA DE ERROS .......................................................................................... 48
4.2. TABELA DE ALERTAS ...................................................................................... 54
4.3. TABELA DE MENSAGENS PERSONALIZADAS .............................................. 55
5. VERSES DO MANUAL .......................................................................................... 60
5.1. ATUALIZAES ................................................................................................ 60


Verso: 1.08

Pgina 4 de 62

1. INTRODUO
Este manual tem como objetivo apresentar as especificaes e critrios tcnicos
necessrios para utilizao do Web Service disponibilizado pelas Secretarias Municipais
de Fazenda para as empresas prestadoras e/ou tomadoras de servios.
Atravs do Web Service as empresas podero integrar seus prprios sistemas de
informaes com o Sistema de Notas Fiscais de Servio Eletrnicas das Secretarias
Municipais de Fazenda. Desta forma, consegue-se automatizar o processo de gerao,
consulta e cancelamento de NFS-e.
O Web Service e todos os seus servios, referenciados nesse documento, so
baseados no modelo nacional de NFS-e, definido pela Associao Brasileira de
Secretrios e Dirigentes das Finanas dos Municpios das Capitais (ABRASF) e pela
Receita Federal do Brasil (RFB).

1.1. NOTA FISCAL DE SERVIOS ELETRNICA - NFS-E
A Nota Fiscal de Servios Eletrnica (NFS-e) um documento de existncia
exclusivamente digital, gerado e armazenado eletronicamente pela prefeitura ou por outra
entidade conveniada, para documentar as operaes de prestao de servios.
A gerao da NFS-e ser feita, automaticamente, por meio de servios
informatizados, disponibilizados aos contribuintes. Para que sua gerao seja efetuada,
dados que a compem sero informados, analisados, processados, validados e, se
corretos, geraro o documento.
A responsabilidade pelo cumprimento da obrigao acessria de emisso da NFS-
e e pelo correto fornecimento dos dados secretaria, para a gerao da mesma, do
contribuinte.

1.2. RECIBO PROVISRIO DE SERVIO RPS
A NFS-e somente ser gerada atravs dos servios informatizados disponibilizados
pelas Secretarias Municipais de Fazenda. Esse tipo de servio seguido de alguns riscos
inerentes ininterrupta disponibilidade, podendo, portanto, em alguns momentos tornar-
se indisponvel.


Verso: 1.08

Pgina 5 de 62

Visando manter as atividades dos contribuintes ininterruptas, independente de os
servios informatizados disponibilizados pelas Secretarias Municipais de Fazenda
estarem disponveis, foi criado o Recibo Provisrio de Servios (RPS), que um
documento de posse e responsabilidade do contribuinte, que dever ser gerado
manualmente ou por alguma aplicao local, possuindo uma numerao sequencial
crescente e devendo ser convertido em NFS-e no prazo estipulado pela legislao
tributria municipal.


Verso: 1.08

Pgina 6 de 62

2. ARQUITETURA DE COMUNICAO COM O CONTRIBUINTE
2.1. MODELO CONCEITUAL
Atravs do Web Service, o Sistema de Notas Fiscais de Servio Eletrnicas das
Secretarias Municipais de Fazenda disponibilizar servios que podero ser acessados
pelos sistemas dos contribuintes. A seguir, esto resumidos os servios disponveis e
suas respectivas funcionalidades bsicas.

2.1.1. Recepo e Processamento de Lote de RPS
Esse servio compreende a recepo do Lote de RPS, a resposta com o nmero
do protocolo gerado para esta transao e o processamento do lote. Quando efetuada a
recepo, o Lote entrar na fila para processamento posterior onde sero feitas as
validaes necessrias e gerao das NFS-e.

XML de Envio validado pelo arquivo: servico_enviar_lote_rps_envio.xsd
XML de Resposta validado pelo arquivo:
servico_enviar_lote_rps_resposta.xsd

Passos para execuo
1. A aplicao acessa o servio de Recepo e Processamento de Lote de RPS
enviando o lote (fluxo b).
2. A requisio recebida pelo servidor do Web Service que grava as
informaes recebidas e gera o nmero de protocolo de recebimento (fluxo c).
3. O Web Service retorna uma mensagem com o resultado do processamento do
servio (fluxo d).


Verso: 1.08

Pgina 7 de 62

2.1.2. Consulta de Situao de Lote de RPS
Esse servio efetua a consulta da situao de um Lote de RPS j enviado.

XML de Envio validado pelo arquivo: servico_consultar_situacao_lote_rps_envio.xsd
XML de resposta validado pelo arquivo:
servico_consultar_situacao_lote_rps_resposta.xsd

Passos para execuo
1. A aplicao acessa o servio de Consulta de Situao de Lote de RPS e submete
os dados para processamento (fluxo 2.b).
2. A requisio recebida pelo servidor do Web Service, que verifica os dados
preenchidos e identifica o status do lote (fluxos 2.c e 2.d). O Web Service
retorna uma mensagem com o resultado do processamento do servio (fluxo 2.e).

2.1.3. Consulta de NFS-e por RPS
Esse servio efetua a consulta de uma NFS-e a partir do nmero de RPS que a
gerou.

XML de Envio validado pelo arquivo: servico_consultar_nfse_rps_envio.xsd
XML de Resposta validado pelo arquivo: servico_consultar_nfse_rps_resposta.xsd


Verso: 1.08

Pgina 8 de 62

Passos para execuo
1. A aplicao acessa o servio de Consulta de NFS-e por RPS e submete os dados
para processamento (fluxo 2.b).
preenchidos e identifica a NFS-e correspondente (fluxos 2.c e
2.d).
servio (fluxo 2.e).

2.1.4. Consulta de Lote de RPS
Esse servio permite ao contribuinte obter as NFS-e que foram geradas a partir do
Lote de RPS enviado, quando o processamento ocorrer sem problemas; ou obter a lista
de erros e/ou inconsistncias encontradas nos RPS.
Na validao do lote, devem ser retornados todos os erros verificados.
Excepcionalmente, havendo uma excessiva quantidade de erros, poder ser definido um
limitador para a quantidade de erros retornados.

XML de Envio validado pelo arquivo: servico_consultar_lote_rps_envio.xsd
XML de Resposta validado pelo arquivo: servico_consultar_lote_rps_resposta.xsd

Passos para execuo
1. A aplicao acessa o servio de Consulta de Lote de RPS e submete os dados
para processamento (fluxo b).
preenchidos e identifica as NFS-e correspondentes (fluxos c e d).


Verso: 1.08

Pgina 9 de 62

3. O Web Service retorna uma mensagem (a estrutura com a lista da NFS-e geradas
ou as mensagens de erro) com o resultado do processamento do servio (fluxo
e).

2.1.5. Consulta de NFS-e
Esse servio permite a obteno de determinada NFS-e j gerada.

XML de Envio validado pelo arquivo: servico_consultar_nfse_envio.xsd
XML de Resposta validado pelo arquivo: servico_consultar_nfse_resposta.xsd

Passos para execuo
1. A aplicao acessa o servio de Consulta de NFS-e e submete os dados para
processamento ().
preenchidos e identifica as NFS-e correspondentes.
servio.

2.1.6. Cancelamento de NFS-e
Esse servio permite o cancelamento direto de uma NFS-e sem substituio da
mesma por outra.


Verso: 1.08

Pgina 10 de 62


XML de Envio validado pelo arquivo: servico_cancelar_nfse_envio.xsd
XML de Resposta validado pelo arquivo: servico_cancelar_nfse_resposta.xsd
Passos para execuo
1. A aplicao acessa o servio de Cancelamento de NFS-e e submete os dados
para processamento (fluxo 2.b).
preenchidos, identifica a NFS-e correspondente e efetua o seu cancelamento (fluxo
2.c).
servio (fluxo 2.d).

2.2. PADRES TCNICOS

2.2.1. Padro de Comunicao
O meio fsico de comunicao utilizado entre os sistemas de informao dos
contribuintes e o Sistema de Notas Fiscais de Servio Eletrnicas das Secretarias
Municipais de Fazenda ser a Internet, com o uso do protocolo SSL, que alm de garantir
um duto de comunicao seguro na Internet, permite a identificao do servidor e do


Verso: 1.08

Pgina 11 de 62

cliente atravs de certificados digitais, eliminando a necessidade de identificao do
usurio atravs de nome ou cdigo de usurio e senha.
O modelo de comunicao segue o padro de Web Services definido pelo WS-I
Basic Profile.
A troca de mensagens entre o Web Service do Sistema de Notas Fiscais de
Servio Eletrnicas das Secretarias Municipais de Fazenda e o sistema do contribuinte
ser realizada no padro SOAP, com troca de mensagens XML no padro
Style/Enconding: Document/Literal, wrapped. A opo wrapped representa a chamada
aos mtodos disponveis com a passagem de mais de um parmetro. Para descrever os
servios disponibilizados, ser utilizado um documento WSDL (Web Service Description
Language). O WSDL o padro recomendado para descrio de servios SOAP.

As chamadas aos servios sero feitas enviando como parmetro um documento
XML a ser processado pelo sistema. Esse documento no far parte da descrio do
servio (arquivo WSDL), e o formato do XML correspondente ao servio dever ser
consultado nesse manual de integrao, seo 3.5.

2.2.2. Padro de Certificado Digital
Os certificados digitais utilizados no sistema de Notas Fiscais de Servio
Eletrnicas, das Secretarias Municipais de Fazenda, sero emitidos por Autoridade
Certificadora credenciada pela Infraestrutura de Chaves Pblicas Brasileira ICP-Brasil,
de pessoa fsica ou jurdica, dos tipos A1, A3 ou certificado de servidor (hbrido).
Para a assinatura digital dos documentos envolvidos aceitar-se- que o certificado
digital seja de quaisquer dos estabelecimentos da empresa.


Verso: 1.08

Pgina 12 de 62

Os certificados digitais sero exigidos em 2 (dois) momentos distintos para a
integrao entre o sistema do contribuinte e o Web Service das Secretarias Municipais de
Fazenda:
Assinatura de Mensagens: O certificado digital utilizado para essa funo dever
conter o CNPJ do estabelecimento emissor da NFS-e ou o CNPJ do estabelecimento
matriz. O certificado digital dever ter o uso da chave previsto para a funo de
assinatura digital, respeitando a Poltica do Certificado.
Transmisso (durante a transmisso das mensagens entre os servidores do
contribuinte e os servios disponibilizados pelas Secretarias Municipais de
Fazenda): O certificado digital utilizado para identificao do aplicativo do
contribuinte dever conter o CNPJ do responsvel pela transmisso das
mensagens, mas no necessita ser o mesmo CNPJ do estabelecimento emissor da
NFS-e, devendo ter a extenso extended Key Usage com permisso de
"Autenticao Cliente".

2.2.3. Padro de Assinatura Digital
As mensagens enviadas aos servios disponibilizados pelas Secretarias Municipais
de Fazenda so documentos eletrnicos elaborados no padro XML e devem ser
assinados digitalmente com um certificado digital que contenha o CNPJ do
estabelecimento matriz ou o CNPJ do estabelecimento emissor da NFS-e objeto do
pedido.
Para garantir minimamente a integridade das informaes prestadas e a correta
formao dos arquivos XML, o contribuinte dever submeter s mensagens XML para
validao pela linguagem de Schema do XML (XSD XML Schema Definition),
disponibilizada pelas Secretarias Municipais de Fazenda antes de seu envio.
Os elementos abaixo esto presentes dentro do Certificado do contribuinte
tornando desnecessria a sua representao individualizada no arquivo XML. Portanto, o
arquivo XML no deve conter os elementos:
<X509SubjectName>
<X509IssuerSerial>
<X509IssuerName>


Verso: 1.08

Pgina 13 de 62

<X509SerialNumber>
<X509SKI>
Deve-se evitar o uso das TAGs abaixo, pois as informaes sero obtidas a partir
do Certificado do emitente:
<KeyValue>
<RSAKeyValue>
<Modulus>
<Exponent>
O Projeto NFS-e utiliza um subconjunto do padro de assinatura XML definido pelo
http://www.w3.org/TR/xmldsig-core/, que tem o seguinte leiaute:

# CAMPO ELEMENTO PAI TIPO DESCRIO OC.
XS01 Signature Raiz
XS02 Id A XS01 C 1-1
XS03 SignedInfo G XS01 Grupo da Informao da
assinatura
1-1
XS04 Canonicalization
Method
G XS03 Grupo do Mtodo de
Canonicalizao
1-1
XS05 Algorithm A XS04 C Atributo Algorithm de
CanonicalizationMethod:
http://www.w3.org/TR/2001/
REC-xml-c14n-
20010315
1-1
XS06 SignatureMethod G XS03 Grupo do Mtodo de
Assinatura
1-1
SignedInfo:
http://www.w3.org/2000/09/
xmldsig#rsa-sha1
1-1
XS08 Reference G XS03 Grupo do Mtodo de
Reference
1-1
XS09 URI A XS08 C Atributo URI da tag Reference 1-1
XS10 Transforms G XS08 Grupo do algorithm de
Transform
1-1
XS11 Unique_Transf_A
lg
RC XS10 Regra para o atributo
Algorithm do Transform ser
nico
1-1
XS12 Transform G XS10 Grupo de Transform 2-2
XS13 Algorithm A XS12 C Atributos vlidos Algorithm do
Transform:
http://www.w3.org/TR/2001/
REC-xml-c14n-20010315
xmldsig#envelopedsignature
1-1
XS14 Xpath E XS12 C Xpath 0-N


Verso: 1.08

Pgina 14 de 62

XS15 DigestMethod G XS08 Grupo do Mtodo de
DigestMethod
1-1
DigestMethod:
xmldsig#sha1
1-1
XS17 DigestValue E XS08 C Digest Value (Hash SHA-1
Base64)
1-1
XS18 SignatureValue G XS01 Grupo do Signature Value 1-1
XS19 KeyInfo G XS01 Grupo do KeyInfo 1-1
XS20 X509Data G XS19 Grupo X509 1-1
XS21 X509Certificate E XS20 C Certificado Digital x509 em
Base64b
1-1

2.2.4. Validao de Assinatura Digital pelo Sistema NFS-e
Para a validao da assinatura digital, seguem as regras que sero adotadas pelas
Secretarias Municipais de Fazenda:
1. Extrair a chave pblica do certificado;
2. Verificar o prazo de validade do certificado utilizado;
3. Montar e validar a cadeia de confiana dos certificados validando tambm a LCR
(Lista de Certificados Revogados) de cada certificado da cadeia;
4. Validar o uso da chave utilizada (Assinatura Digital) de tal forma a aceitar
certificados somente do tipo A (no sero aceitos certificados do tipo S);
5. Garantir que o certificado utilizado de um usurio final e no de uma Autoridade
Certificadora;
6. Adotar as regras definidas pelo RFC 3280 para LCRs e cadeia de confiana;
7. Validar a integridade de todas as LCR utilizadas pelo sistema;
8. Prazo de validade de cada LCR utilizada (verificar data inicial e final).

A forma de conferncia da LCR fica a critrio de cada Secretaria Municipal de
Fazenda, podendo ser feita de 2 (duas) maneiras: On-line ou Download peridico. As
assinaturas digitais das mensagens sero verificadas considerando o horrio fornecido
pelo Observatrio Nacional.


Verso: 1.08

Pgina 15 de 62

2.2.5. Uso de Assinatura com Certificado Digital
Para garantir a autenticidade dos dados gerados, algumas informaes devero
ser assinadas digitalmente. Abaixo segue as informaes que devero ser assinadas e
quem dever faz-lo em cada momento:
O RPS, pelo contribuinte, antes do envio do mesmo atravs do Lote de RPS;
O Lote de RPS, pelo contribuinte, antes do envio do mesmo;
A NFS-e:
o Pela prefeitura e pelo contribuinte, quando gerada pela Aplicao On Line;
o Pela prefeitura nos demais casos;
O Pedido de cancelamento da NFS-e, pelo contribuinte;
A Confirmao de cancelamento da NFS-e, pela prefeitura;

2.3. PADRO DAS MENSAGENS XML
A especificao adotada para as mensagens XML a recomendao W3C para
XML 1.0, disponvel em www.w3.org/TR/REC-xml e a codificao dos caracteres ser em
UTF-8.

As chamadas dos Web Services disponibilizados pelas Secretarias Municipais de
Fazenda e os respectivos resultados do processamento so realizadas atravs das
mensagens com o seguinte padro:
rea de Cabealho estrutura XML padro para todas as mensagens de
chamada e retorno de resultado dos Web Services disponibilizados pelas
Secretarias Municipais de Fazenda, que contm os dados de controle da
mensagem. A rea de cabealho est sendo utilizada para armazenar a verso do
leiaute da estrutura XML informado na rea de dados.
rea de Dados estrutura XML varivel definida na documentao do Web
Service acessado.

2.3.1. rea do Cabealho
Abaixo, o leiaute da rea de Cabealho padro:
# CAMPO ELEMENTO PAI TIPO TAM. DESCRIO OC.


Verso: 1.08

Pgina 16 de 62

1 cabealho G TAG raiz do cabealho da
mensagem.
1-1
verso A 1 N 4 Verso do leiaute. 1-1
2 versaoDados E 1 N 4 O contedo deste campo indica a
verso do leiaute XML da estrutura
XML informada na rea de dados da
mensagem.
1-1

O campo versaoDados deve conter a informao da verso do leiaute da estrutura
XML armazenada na rea de dados da mensagem.
A estrutura XML armazenada na rea de dados est definida na documentao do
Web Service acessado.

2.3.2. Validao da estrutura das Mensagens 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. Neste manual
utilizaremos a nomenclatura Schema XML para nos referir a arquivo XSD.
Um Schema XML define o contedo de uma mensagem XML, descrevendo os
seus atributos, 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 as 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.
A primeira condio para que a mensagem XML seja validada com sucesso que
ela seja submetida ao Schema XML correto.
Assim, os sistemas de informao dos contribuintes devem estar preparados para
gerar mensagens XML em seus respectivos Schemas XML em vigor.


Verso: 1.08

Pgina 17 de 62

2.3.3. Schemas XML (arquivos XSD)
O Schema XML (arquivo XSD) correspondente a cada uma das mensagens XML
de pedido e de retorno utilizadas pelo Web Service pode ser obtido na internet acessando
o Portal do Sistema de Notas Fiscais de Servio Eletrnicas das Secretarias Municipais
de Fazenda.

2.3.4. Verso dos Schemas XML
Toda mudana de layout das mensagens XML do Web Service implica na
atualizao do seu respectivo Schema XML.
A identificao da verso dos Schemas XML ser realizada com o acrscimo do
nmero da verso com dois dgitos no nome do arquivo XSD precedida da literal _v,
como segue:
<Nome do Arquivo>_v<Nmero da Verso>.xsd
Exemplo:
tipos_nfse_v01.xsd
A maioria dos Schemas XML definidos para a utilizao do Web Service do
Sistema de Notas Fiscais de Servio Eletrnicas das Secretarias Municipais de Fazenda
utilizam as definies de tipos simples ou tipos complexos que esto definidos em outros
Schemas XML, nestes casos, a modificao de verso do Schema bsico ser
repercutida no Schema principal.
As modificaes de layout das mensagens XML do Web Service podem ser
causadas por necessidades tcnicas ou em razo da modificao de alguma legislao.
As modificaes decorrentes de alterao da legislao devero ser implementadas nos
prazos previstos no ato normativo que introduziu a alterao. As modificaes de ordem
tcnica sero divulgadas pelas Secretarias Municipais de Fazenda e podero ocorrer
sempre que se fizerem necessrias.

2.4. AMBIENTE DE HOMOLOGAO
Para testar os servios Web Services publicados, h um ambiente de
homologao, onde o usurio poder utilizar por tempo indeterminado.


Verso: 1.08

Pgina 18 de 62

O usurio realizar um cadastro e criar uma senha de acesso. A credencial do
usurio, CNPJ e senha, sero solicitadas no momento de consumir um servio ou acessar
o ambiente de homologao.
As notas fiscais emitidas no ambiente de homologao no tm nenhuma
validao fiscal.
Seguem abaixo os links de cadastro e de homologao.
Link de cadastro: http://187.45.245.217/nfse_homologacao/
Link de homologao: http://187.45.245.217/ws_nfse/nfseservice.svc
Observao: Caso as funcionalidades sejam implementadas por empresas de
desenvolvimento de software, no necessrio o cadastro de todas as empresas que
utilizaro as funcionalidades publicadas, visto que as regras de negcios so idnticas.


Verso: 1.08

Pgina 19 de 62

3. ESTRUTURA DE DADOS DO WEB SERVICE
Existir um nico Web Service com todos os servios apresentados no item 2.1. O
fluxo de comunicao sempre iniciado pelo sistema do contribuinte atravs do envio de
uma mensagem XML ao Web Service com o pedido do servio desejado.

3.1. MODELO OPERACIONAL
A forma de processamento das solicitaes de servios no projeto Nota Fiscal de
Servios Eletrnica pode ser sncrona, caso o atendimento da solicitao de servio seja
realizada 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. Nesta situao torna-se necessria a realizao de
mais uma conexo para a obteno do resultado do processamento.
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 sero implementados da seguinte forma:
SERVIO IMPLEMENTAO
Recepo e Processamento de Lote de RPS Assncrona
Consulta de Situao de Lote de RPS Sncrona
Consulta de NFS-e por RPS Sncrona
Consulta de Lote de RPS Sncrona
Consulta de NFS-e Sncrona
Cancelamento de NFS-e Sncrona

3.1.1. Servios Sncronos
As solicitaes de servios de implementao sncrona so processadas
imediatamente e o resultado do processamento obtido em uma nica conexo.
Abaixo, o fluxo simplificado de funcionamento:


Verso: 1.08

Pgina 20 de 62

Etapas do processo ideal:
1. O aplicativo do contribuinte inicia a conexo enviando uma mensagem de
solicitao de servio para o Web Service;
2. O Web Service recebe a mensagem de solicitao de servio e encaminha ao
aplicativo da NFS-e que ir processar o servio solicitado;
3. O aplicativo da NFS-e recebe a mensagem de solicitao de servios e realiza o
processamento, devolvendo uma mensagem de resultado do processamento ao
Web Service;
4. O Web Service recebe a mensagem de resultado do processamento e o
encaminha ao aplicativo do contribuinte;
5. O aplicativo do contribuinte recebe a mensagem de resultado do processamento e
caso no exista outra mensagem, encerra a conexo.

3.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.
Abaixo, o fluxo simplificado de funcionamento:

Etapas do processo ideal:
Solicitao e processamento:
1. O aplicativo do contribuinte inicia a conexo enviando uma mensagem de
solicitao de servio para o Web Service de recepo de solicitao de servios;
2. O Web Service de recepo de solicitao de servios recebe a mensagem de
solicitao de servio e a coloca na fila de servios solicitados, acrescentando o
CNPJ do transmissor obtido do certificado digital do transmissor;


Verso: 1.08

Pgina 21 de 62

3. O Web Service de recepo de solicitao de servios retorna o protocolo da
solicitao de servio e a data e hora de gravao na fila de servios solicitados ao
aplicativo do contribuinte;
4. O aplicativo do contribuinte recebe o protocolo;
5. Na estrutura interna do aplicativo de NFS-e a solicitao de servios retirada da
fila de servios solicitados pelo aplicativo da NFS-e em momento especfico,
definido pela equipe tcnica da NFS-e;
6. O servio solicitado processado pelo aplicativo da NFS-e e o resultado do
processamento colocado na fila de servios processados;

Obteno do resultado do servio:
7. O aplicativo do contribuinte, atravs do protocolo recebido, envia uma consulta ao
servio que retornar o resultado do processamento daquele protocolo, iniciando
uma conexo com o Web Service;
8. O Web Service recebe a mensagem de consulta e localiza o resultado de
processamento da solicitao de servio;
9. O Web Service devolve o resultado do processamento ao aplicativo contribuinte;
10. O aplicativo do contribuinte recebe a mensagem de resultado do processamento e,
caso no exista outra mensagem, encerra a conexo.

3.2. FORMATOS E PADRES UTILIZADOS
Abaixo segue algumas formataes de dados que devem ser seguidas para
gerao correta na estrutura dos arquivos.
FORMATO OBSERVAO
Data (date) Formato: AAAA-MM-DD
onde:
AAAA = ano com 4 caracteres
MM = ms com 2 caracteres
DD = dia com 2 caracteres
Data/Hora (datetime) Formato AAAA-MM-DDTHH:mm:ss
onde:
AAAA = ano com 4 caracteres
MM = ms com 2 caracteres
DD = dia com 2 caracteres
T = caractere de formatao que deve existir separando a data da
hora
HH = hora com 2 caracteres


Verso: 1.08

Pgina 22 de 62

mm: minuto com 2 caracteres
ss: segundo com 2 caracteres
Valores Decimais
(decimal)
Formato: 0.00
No deve ser utilizado separador de milhar. O ponto (.) deve ser
utilizado
para separar a parte inteira da fracionria.
Exemplo:
48.562,25 = 48562.25
1,00 = 1.00 ou 1
0,50 = 0.50 ou 0.5
Valores Percentuais
(decimal)
Formato 00.00
O formato em percentual presume o valor percentual em sua forma
fracionria, contendo 5 dgitos. O ponto (.) separa a parte inteira da
fracionria.
Exemplo:
62% = 62.00
15% = 15.00
25,32 = 25.32

No deve ser inserido caractere no significativo para preencher o tamanho
completo do campo, ou seja, zeros antes de nmero ou espao em branco aps cadeia
de caracteres. A posio do campo definida na estrutura do documento XML atravs de
TAGs (<tag>contedo</tag>).
A regra constante do pargrafo anterior dever estender-se para os campos onde
no h indicao de obrigatoriedade e que, no entanto, seu preenchimento torna-se
obrigatrio por estar condicionado legislao especfica ou ao negcio do contribuinte.
Neste caso, dever constar a TAG com o valor correspondente e, para os demais
campos, devero ser eliminadas as TAGs.
Para reduzir o tamanho final do arquivo XML da NFS-e alguns cuidados de
programao devero ser assumidos:
no incluir "zeros no significativos" para campos numricos;
no incluir "espaos" no incio ou no final de campos numricos e alfanumricos;
no incluir comentrios no arquivo XML;
no incluir anotao e documentao no arquivo XML (TAG annotation e TAG
documentation);
no incluir caracteres de formatao no arquivo XML ("line-feed", "carriage return",
"tab", caractere de "espao" entre as TAGs).
As TAGs que permitirem valores nulos devem ser omitidas da estrutura XML a ser
enviada.


Verso: 1.08

Pgina 23 de 62

3.3. TIPOS SIMPLES
A seguir encontra-se a tabela com a lista dos tipos simples que sero utilizados
como tipos de dados. A tabela est dividida em 4 colunas, a saber:
Campo: nome do tipo simples;
Tipo: tipo primitivo de dados utilizados pelo campo:
o C: Caractere;
o N: Nmero;
o D: Data ou Data/Hora;
Descrio: descreve informaes sobre o campo;
Tam.: tamanho do campo:
o Quando for caracteres o tamanho define a quantidade mxima de
caracteres que o texto poder ter;
o 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, 15
dgitos;
Nmero fracionrio, que define o total de dgitos e quantos deles
sero designados para a parte fracionria. Exemplo: 15,2
significa que o nmero poder ter, no mximo, 15 dgitos sendo 2
deles a identificao da parte fracionria. A parte fracionria no
obrigatria quando assim definido;
o Quando for data, no haver definio de tamanho.

CAMPO TIPO TAM. DESCRIO
tsNumeroNfse N 15 Nmero da Nota Fiscal de Servio Eletrnica,
formado pelo ano com 04 (quatro) dgitos e um nmero
sequencial com 11 posies Formato
AAAANNNNNNNNNNN
tsCodigoVerificacao C 9 Cdigo de verificao do nmero da nota
tsStatusRps N 1 Cdigo de status do RPS
1 Normal
2 Cancelado
tsStatusNfse N 1 Cdigo de status da NFS-e
1 Normal
2 Cancelado


Verso: 1.08

Pgina 24 de 62

tsNaturezaOperacao N 2 Cdigo de natureza da operao
1 Tributao no municpio
2 - Tributao fora do municpio
3 Iseno
4 Imune
5 Exigibilidade suspensa por deciso judicial
6 Exigibilidade suspensa por procedimento
administrativo
tsRegimeEspecialTributacao N 2 Cdigo de identificao do regime especial de
tributao
1 Microempresa municipal
2 Estimativa
3 Sociedade de profissionais
4 Cooperativa
5 Microempresrio Individual (MEI)
6 Microempresrio e Empresa de Pequeno Porte
(ME EPP)
tsSimNao N 1 Identificao de Sim/No
1 Sim
2 No
tsQuantidadeRps N 4 Quantidade de RPS do Lote
tsNumeroRps N 15 Nmero do RPS
tsSerieRps C 5 Nmero de srie do RPS
tsTipoRps N 1 Cdigo de tipo de RPS
1 RPS
2 Nota Fiscal Conjugada (Mista)
3 Cupom
tsOutrasInformacoes C 255 Informaes adicionais ao documento
tsValor N 15,2 Valor monetrio.
Formato: 0,000.00 (ponto separando casa decimal, vrgula
separando casa do milhar)

tsItemListaServico C 5 Cdigo de item da lista de servio
tsCodigoCnae N 7 Cdigo CNAE
tsCodigoTributacao C 20 Cdigo de Tributao
tsAliquota N 5,4 Valor percentual
tsDiscriminacao C 200 Discriminao do contedo da NFS-e
tsCodigoMunicipioIbge N 7 Cdigo de identificao do municpio conforme tabela do
IBGE. Caso seja de fora do pas, colocar 99999.
tsIncricaoMunicipal C 15 Nmero de inscrio municipal
tsInscricaoEstadual C 20 Nmero de Inscrio Estadual
tsRazaoSocial C 115 Razo Social do contribuinte
tsNomeFantasia C 115 Nome fantasia do contribuinte
tsCnpj C 14 CNPJ do contribuinte
tsEndereco C 125 Endereo do contribuinte
tsNumeroEndereco C 10 Nmero do endereo
tsComplementoEndereco C 60 Complemento de endereo
tsBairro C 60 Bairro do contribuinte
tsUf C 2 Sigla da unidade federativa. Caso seja de fora do pas,
colocar EX.
tsCep N 8 Nmero do CEP do contribuinte
tsEmail C 80 E-mail do contribuinte
tsTelefone C 15 Telefone do contribuinte
tsCpf C 11 CPF do contribuinte
tsIndicacaoCpfCnpj N 1 Indicador de uso de CPF ou CNPJ


Verso: 1.08

Pgina 25 de 62

1 CPF
2 CNPJ
3 No Informado
tsCodigoObra C 15 Cdigo de Obra
tsArt C 15 Cdigo ART
tsNumeroLote N 15 Nmero do Lote de RPS
tsNumeroProtocolo C 50 Nmero do protocolo de recebimento do RPS
tsSituacaoLoteRps N 1 Cdigo de situao de lote de RPS
1 No Recebido
2 No Processado
3 Processado com Erro
4 Processado com Sucesso
tsCodigoMensagemAlerta C 4 Cdigo de mensagem de retorno de servio
tsDescricaoMensagemAlerta C 200 Descrio da mensagem de retorno de servio
tsCodigoCancelamentoNfse C 4 Motivo do Cancelamento da NFS-e
1 Lanamento Indevido
2 Erro de digitao
tsIdTag C 255 Atributo de identificao da tag a ser assinada no
documento XML
P1 C 14 CNPJ do contribuinte, apenas nmero.
P2 C 20 Senha do contribuinte
tsLink C 200 Disponibilizado para a impresso da NFS-e. Em breve

3.4. TIPOS COMPLEXOS
A seguir sero detalhadas as tabelas de cada tipo composto e seus campos. A
tabela est dividida da seguinte forma:
(1) (2)
CAMPO TIPO TAM. DESCRIO OC.
(3) (4) (5) (6) (7) (8)
(4) (5) (6) (7) (8)

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 de um tipo simples ou complexo;
6. Tamanho do campo. Quantidade mxima de caracteres ou preciso numrica,
dependendo do tipo de informao.
7. Descrio do campo.
8. Ocorrncia. Nmero de vezes que a informao pode ser apresentada.
0-1 No obrigatrio


Verso: 1.08

Pgina 26 de 62

0-N No obrigatrio, mas pode ser apresentada muitas vezes
1-1 Obrigatrio.
1-2 Obrigatrio, pode ser apresentada uma ou duas vezes.
1-N Obrigatrio, pode ser apresentada uma ou mais vezes.

TABELAS PARA TIPOS COMPLEXOS
tcCpfCnpj Representa CPF/CNPJ.
Choice Cpf C 11 Nmero do Cpf. 1-1
Cnpj C 14 Nmero do Cnpj. 1-1

tcEndereco Conjunto de dados de identificao completa do endereo.
Endereco C 125 Endereo. 0-1
Numero C 10 Nmero do endereo. 0-1
Complemento C 60 Complemento do Endereo. 0-1
Bairro C 60 Nome do bairro. 0-1
CodigoMunicipio N 7 Cdigo de identificao do municpio conforme tabela do
IBGE.
0-1
Uf C 2 Sigla da unidade federativa. 0-1
Cep C 8 Nmero do CEP. 0-1

tcContato Representa forma de contato com a pessoa (fsica/jurdica).
Telefone C 11 Telefone para contato. 0-1
Email C 80 E-mail para contato. 0-1

tcIdentificacaoOrgaoGerador Conjunto de dados de identificao de rgo gerador.
CodigoMunicipio N 7 Cdigo de identificao do municpio conforme tabela do
IBGE.
1-1
Uf C 2 Sigla da unidade federativa. 1-1

tcIdentificacaoRps Conjunto de dados de identificao do RPS.
Numero N 15 Nmero do RPS. 1-1
Serie C 5 Nmero de srie do RPS. 1-1
Tipo N 1 Cdigo de tipo de RPS.
1 RPS
2 Nota Fiscal Conjugada (Mista)
3 Cupom
1-1

tcIdentificacaoPrestador Conjunto de dados de identificao do prestador de servio.
Cnpj C 14 Nmero do CNPJ do prestador. 1-1
InscricaoMunicipal C 15 Nmero de Inscrio Municipal do prestador. 0-1


Verso: 1.08

Pgina 27 de 62


tcIdentificacaoTomador Conjunto de dados de identificao do tomador de servio.
CpfCnpj tcCpfCnpj Caso Tomador no identificado, preencher com 11
zeros.
1-1
InscricaoMunicipal C 15 Nmero de Inscrio Municipal do tomador. 0-1
InscricaoEstadual C 20 Nmero de Inscrio Estadual do tomador. 0-1

tcDadosTomador Conjunto de dados do tomador de servio.
IdentificacaoTomador tcIdentificacaoTomador Conjunto de dados de identificao do
tomador de servio.
1-1
RazaoSocial C 115 Razo Social do tomador. 0-1
Endereco tcEndereco Conjunto de dados de identificao
completa do endereo.
Se tomador for jurdico, preencher
todos os campos do endereo.
Caso contrrio, preencher apenas o
campo Razo Social.
0-1
Contato tcContato Representa forma de contato com a
pessoa (fsica/jurdica).
0-1

tcIdentificacaoIntermediarioServico Conjunto de dados de identificao do intermedirio do
servio.
RazaoSocial C 115 Razo Social do intermedirio. 1-1
CpfCnpj tcCpfCnpj Representa CPF/CNPJ do intermedirio. 1-1
InscricaoMunicipal C 15 Nmero de Inscrio Municipal do intermedirio. 0-1

tcValores Conjunto de valores que compe o documento fiscal.
ValorServicos N 15,2 Valor dos servios em R$. 1-1
ValorDeducoes N 15,2 Valor das dedues para Reduo da Base de Clculo
em R$.
0-1
ValorPis N 15,2 Valor da reteno do PIS em R$. Informao
declaratria.
0-1
ValorCofins N 15,2 Valor da reteno do COFINS em R$. Informao
declaratria.
0-1
ValorInss N 15,2 Valor da reteno do INSS em R$. Informao
declaratria.
0-1
ValorIr N 15,2 Valor da reteno do IR em R$. Informao
declaratria.
0-1
ValorCsll N 15,2 Valor da reteno do CSLL em R$. Informao
declaratria.
0-1
IssRetido N 1 1 Sim; 2 No
Caso Sim, o valor do IssRetido dever ser igual ao
ValorIss e exibir o ValorIssRetido.
Caso No, no exibir ValorIssRetido.
1-1
ValorIss N 15,2 Valor do ISS. 0-1
OutrasRetencoes N 15,2 Valor de outras retenes. 0-1
BaseCalculo N 15,2 (Valor dos servios Valor das dedues descontos
incondicionados).
0-1
Aliquota N 15,2 Valor percentual. 0-1


Verso: 1.08

Pgina 28 de 62

ValorLiquidoNfse N 15,2 (ValorServicos ValorPIS ValorCOFINS
ValorINSS ValorIR ValorCSLL utrasRetenoes
ValorISSRetido - DescontoIncondicionado -
DescontoCondicionado).
0-1
ValorIssRetido N 15,2 Valor do ISS Retido. 0-1
DescontoCondicionado N 15,2 Valor do Desconto Condicionado. 0-1
DescontoIncondicionado N 15,2 Valor do Desconto Incondicionado. 0-1

tcDadosServico Conjunto de dados que compe o servio prestado.
Valores tcValores Conjunto de valores que compe o
documento fiscal.
1-1
ItemListaServico C 5 Cdigo de item da lista de servio. 1-1
CodigoCnae N 7 Cdigo CNAE. 0-1
CodigoTributacaoMunicipio C 20 Cdigo de Tributao. 1-1
Discriminacao C 200 Discriminao do contedo da NFS-e. 1-1
CodigoMunicipio N 7 Cdigo de identificao do municpio
conforme tabela do IBGE. Preencher com 5
noves para servio prestado no exterior.
1-1
ItensServico tcItemServico 1-N

tcDadosConstrucaoCivil Conjunto de dados para identificao de construo civil.
CodigoObra C 15 Cdigo de Obra. 1-1
Art C 15 Cdigo ART. 1-1

tcDadosPrestador Conjunto de dados do prestador do servio.
IdentificacaoPrestador tcIdentificacao
Prestador
Conjunto de dados de identificao do prestador
de servio.
1-1
RazaoSocial C 115 Razo Social do prestador. 1-1
NomeFantasia C 115 Nome Fantasia do prestador. 0-1
Endereco tcEndereco Conjunto de dados de identificao completa do
endereo.
1-1
Contato tcContato Representa forma de contato com a pessoa
(fsica/jurdica).
0-1

tcInfRps Conjunto de dados informativos do Recibo Provisrio de Servio (RPS).
Id C 255 Atributo de identificao da tag a ser
assinada no documento XML.

IdentificacaoRps tcIdentificacaoRps Conjunto de dados de identificao
do RPS.
1-1
DataEmissao D Data da Emisso.
Formato AAAA-MM-DDTHH:mm:ss
1-1
NaturezaOperacao N 2 Cdigo de natureza da operao.
2 Tributao fora do municpio
3 Iseno
4 Imune
5 Exigibilidade suspensa por
deciso judicial
1-1


Verso: 1.08

Pgina 29 de 62

procedimento administrativo
RegimeEspecialTributacao N 2 Cdigo de identificao do regime
especial de tributao.
2 Estimativa
4 Cooperativa
6 Microempresrio e Empresa de
Pequeno Porte (ME EPP)
0-1
OptanteSimplesNacional N 1 Identificao de Sim/No
1 Sim; 2 No
1-1
IncentivadorCultural N 1 Identificao de Sim/No
1 Sim; 2 No
1-1
Status N 1 Cdigo de status do RPS
1 Normal; 2 Cancelado
1-1
RpsSubstituido tcIdentificacaoRps Conjunto de dados de identificao
do RPS.
0-1
OutrasInformacoes C 255 Informaes Adicionais ao
Documento.
0-1
Servico tcDadosServico Conjunto de dados que compe o
servio prestado.
1-1
Prestador tcIdentificacaoPrest
ador
Conjunto de dados de identificao
do prestador de servio.
1-1
Tomador tcDadosTomador Conjunto de dados do tomador de
servio.
1-1
IntermediarioServico tcIdentificacaoInter
mediarioServico
do intermedirio do servio.
0-1
ConstrucaoCivil tcDadosContrucao
Civil
Conjunto de dados para identificao
de construo civil.
0-1

tcRps Representa a estrutura do Recibo Provisrio de Servio (RPS) assinada.
InfRps tcInfRps Conjunto de dados informativos do Recibo
Provisrio de Servio (RPS).
1-1
Signature dsig:Signature 0-1

tcIdentificacaoNfse Representa dados que identificam uma Nota Fiscal de Servios Eletrnica.
Numero N 15 Nmero da Nota Fiscal de Servio Eletrnica -
Formato AAAANNNNNNNNNNN.
1-1
Cnpj C 14 CNPJ. 1-1
InscricaoMunicipal C 15 Nmero de inscrio municipal. 0-1
CodigoMunicipio N 7 Cdigo de identificao do municpio conforme
tabela do IBGE.
1-1

tcInfNfse Representa os dados informativos da Nota Fiscal de Servios Eletrnica.
1-1
Numero N 15 Nmero da Nota Fiscal de Servio
Eletrnica - Formato
AAAANNNNNNNNNNN.
1-1


Verso: 1.08

Pgina 30 de 62

CodigoVerificacao C 9 Cdigo de verificao do nmero da
nota.
1-1
DataEmissao D Data e Hora da Emisso.
0-1
do RPS.
0-1
DataEmissaoRps D Data da Emisso do RPS.
Formato: AAAA-MM-DD
1-1
NaturezaOperacao N 2 Cdigo de natureza da operao
3 Iseno
4 Imune
deciso judicial
0-1
especial de tributao
2 Estimativa
4 Cooperativa
6 Microempresrio e Empresa de
Pequeno Porte (ME EPP)
1-1
1 Sim
2 No
1-1
IncetivadorCultural N 1 Identificao de Sim/No
1 Sim
2 No
1-1
Competencia D Formato: AAAA-MM-DD 0-1
NfseSubstituida N 15 Nmero da Nota Fiscal de Servio
Eletrnica - Formato
AAAANNNNNNNNNNN.
1-1
servio prestado.
0-1
ValorCredito N 15,2 Valor monetrio.
Formato: 0,000.00 (ponto separando
casa decimal, vrgula separando
casa do milhar)
1-1
PrestadorServico tcDadosPrestador Conjunto de dados do prestador do
servio.
1-1
TomadorServico tcDadosTomador Conjunto de dados do tomador de
servio.
0-1
IntermediarioServico tcIdentificacaoInter
mediarioServico
1-1
OrgaoGerador tcIdentificacaoOrga
oGerador
de rgo gerador.
0-1
Civil
Conjunto de dados para identificao
de construo civil.
1-1


Verso: 1.08

Pgina 31 de 62

tcNfse Representa a estrutura da Nota Fiscal de Servios Eletrnica assinada.
InfNfse tcInfNfse Representa os dados informativos da Nota Fiscal
de Servios Eletrnica.
1-1
Signature Dsig:Signature 1-2

tcInfPedidoCancelamento Representa a estrutura de dados do pedido de cancelamento enviado
pelo prestador ao cancelar uma Nota Fiscal de Servios Eletrnica.

IdentificacaoNfse tcIdentificacaoNfse Representa dados que identificam uma
Nota Fiscal de Servios Eletrnica.
1-1
CodigoCancelamento C 4 Cdigo de cancelamento com base na
tabela de Erros e alertas.
0-1

tcPedidoCancelamento Representa a estrutura de Pedido de Cancelamento da Nota Fiscal de
Servios Eletrnica assinada.
InfPedidoCancelamento tcIdentificacaoNfse Representa dados que identificam uma
Nota Fiscal de Servios Eletrnica.
1-1
Signature Dsign:Signature 1-1

tcInfConfirmacaoCancelamento Representa a estrutura de dados da confirmao de
cancelamento da Nota Fiscal de Servios Eletrnica feito pelo Fisco Municipal.
Sucesso boolean Sucesso da operao. 1-1
DataHora D Data e hora.
1-1

tcConfirmacaoCancelamento Representa a estrutura de Confirmao de Cancelamento da Nota
Fiscal de Servios Eletrnica assinada.
Id C 255 Atributo de identificao da tag a
ser assinada no documento XML.

Pedido tcPedidoCancelamen
to
Representa a estrutura de Pedido
de Cancelamento da Nota Fiscal
de Servios Eletrnica assinada.
1-1
InfConfirmacaoCancelamento tcInfConfirmacaoCan
celamento
Representa a estrutura de dados
da confirmao de cancelamento
da Nota Fiscal de Servios
Eletrnica feito pelo Fisco
Municipal.
1-1

tcCancelamentoNfse Representa os dados de registro de substituio de NFS-e.
Confirmacao tcConfirmacaoCance
lamento
Representa a estrutura de
Confirmao de Cancelamento da
Nota Fiscal de Servios
Eletrnica assinada.

Signature Dsig:Signature 1-1


Verso: 1.08

Pgina 32 de 62

tcInfSubstituicaoNfse Representa a estrutura completa (pedido + confirmao) de cancelamento
de NFS-e.
Id C 255 Atributo de identificao da tag a ser assinada
no documento XML.

NfseSubstituidora N 15 Nmero da Nota Fiscal de Servio Eletrnica -
Formato AAAANNNNNNNNNNN.
1-1

tcSubstituicaoNfse Representa a estrutura de substituio de NFS-e.
SubstituicaoNfse tcInfSubstituicaoNfse Representa a estrutura completa
(pedido + confirmao) de
cancelamento de NFS-e.
1-1

tcCompNfse Representa a estrutura de compartilhamento de dados de uma NFS-e.
Nfse tcNfse Representa a estrutura da Nota Fiscal de
Servios Eletrnica assinada.
1-1
NfseCancelamento tcCancelamentoNfse Representa os dados de registro de
substituio de NFS-e.
0-1
NfseSubstituicao tcSubstituicaoNfse Representa a estrutura de substituio de
NFS-e.
0-1

ListaMensagemRetorno Representa a estrutura de mensagem de retorno de servio.
MensagemRetorno tcMensagemRetorno Representa a estrutura de mensagem de
retorno de servio.
1-N

tcMensagemRetornoLote Representa a estrutura de mensagem de retorno de servio.
do RPS.
1-1
Codigo C 4 Cdigo de mensagem de retorno
de servio.
1-1
Mensagem C 200 Descrio da mensagem de retorno
de servio.
1-1

tcLoteRps Conjunto de dados para a identificao do Lote RPS.
Id C 255 Atributo de identificao da tag a ser assinada no
documento XML.

NumeroLote N 15 Nmero do Lote de RPS. 1-1
Cnpj C 14 CNPJ do contribuinte. 1-1
InscricaoMunicipal C 15 Nmero de Inscrio Municipal. 1-1
QuantidadeRps N 4 Quantidade de RPS do Lote. 1-1
ListaRps tcRps Representa a estrutura do Recibo Provisrio de
Servio (RPS) assinada.
1-N


Verso: 1.08

Pgina 33 de 62

tcItemServico
Descricao C 200 Descrio do servio. 1-1
Quantidade N 7 Quantidade de itens. 1-1
ValorUnitario N 15,2 Valor unitrio de cada servio. 1-1

ddDuasStrings
P1 P1 14 CNPJ do contribuinte, apenas nmeros. 1-1
P2 P2 20 Senha do contribuinte. 1-1

tcInfNovaNfse Conjunto de dados de descrio da NFS-e
Id C 255 Atributo de identificao da tag a
ser assinada no documento XML.

NaturezaOperacao N 2 Cdigo de natureza da operao.
3 Iseno
4 Imune
deciso judicial
1-1
especial de tributao
2 Estimativa
4 Cooperativa
5 Microempresrio Individual
(MEI)
6 Microempresrio e Empresa
de Pequeno Porte (ME EPP)
0-1
1 Sim
2 No
1-1
IncetivadorCultural N 1 Identificao de Sim/No
1 Sim
2 No
1-1
Status N 1 Cdigo de status da NFS-e
1 Normal
2 Cancelado
1-1
Competencia D Formato: AAAA-MM-DD 1-1
NfseSubstituida N 15 Nmero da Nota Fiscal de
Servio Eletrnica - Formato
AAAANNNNNNNNNNN.
0-1
OutrasInformacoes C 255 Informaes adicionais ao
documento.
0-1
servio prestado.
1-1
Tomador tcDadosTomador Conjunto de dados do tomador de
servio.
1-1
IntermediarioServico tcIdentificacaoIntermedi Conjunto de dados de 0-1


Verso: 1.08

Pgina 34 de 62

arioServico identificao do intermedirio do
servio.
ConstrucaoCivil tcDadosConstrucaoCivil Conjunto de dados para
identificao de construo civil.
0-1

tcIdentNovaNfse Identificao da NFS-e
IdentificacaoPrestador tcIdentificacaoPrestador Conjunto de dados de identificao
1-1
Numero N 15 Nmero da NFS-e. 1-1
Serie C 5 Nmero de srie da nota. 1-1
CodigoVerificacao C 9 Cdigo de verificao do nmero
da nota.
1-1
DataEmissao D Data da Emisso.
1-1
Link C 200 Disponibilizado para a impresso
da NFS-e.
0-1

tcRespostaIdentNovaNfse - Representa a estrutura de mensagem de retorno da NFS-e
IdentificacaoNfse tcIdentNovaNfse Identificao da NFS-e 1-1

3.5. SERVIOS
A seguir esto os servios disponveis, conforme descritos no item 2.1, no Web
Service e seus XML Schema. O XML Schema define a estrutura e formatao do arquivo
XML que conter os dados a serem trafegados. Esses documentos sero enviados de
forma textual (como uma string) como parmetros do servio oferecido pelo Web Service,
como descrito em 2.2.1.
As tabelas que detalham cada XML Schema esto divididas da seguinte forma:
# NOME TIPO PAI DESCRIO OC.
(1) (2) (3) (4) (5) (6)
(7) (8)

1. Nmero identificador do campo, quando este contiver subitens;
2. Nome do campo;
3. Nome do tipo do campo que pode ser tipo primitivo, simples ou complexo;
4. Indica quem o campo pai, para definio da hierarquia;
5. Descreve alguma observao pertinente;
6. Quantas vezes o campo se repete na estrutura de dados:


Verso: 1.08

Pgina 35 de 62

a. Formato: z-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. Formato de grupo, utilizado para definio de uma escolha (ver prximo item);
8. Identifica os campos ou grupos que faro parte de uma escolha (Choice).

3.5.1. Verso do Sistema
Mtodo: Versao
Esse servio ser executado atravs da chamada do mtodo Versao, no sendo
necessria a passagem de parmetros. O servio retorna uma cadeia de caractere com a
identificao da verso do sistema. O servio tambm pode ser utilizado para verificar a
conectividade.

3.5.2. Recepo de Lote RPS
Mtodo: RecepcionarLoteRps
Esse servio ser executado, inicialmente, atravs da chamada ao mtodo
RecepcionarLoteRps, passando a mensagem XML como parmetro com a estrutura
definida na tabela que segue.
# CAMPO TIPO PAI DESCRIO OC.
1 EnviarLoteRpsEnvio 1-1
LoteRps tcLoteRps 1 Conjunto de dados para a identificao do
Lote RPS.
1-1
Signature dsig:Signature 1 0-1
2 pParam ddDuasStrings 1-1

Nmero mximo de cem notas vo ser consultada de cada vez a partir do nmero
passado no parmetro pConsultarNfseEnvio.NumeroNfse dentro do perodo em que os
RPS foram convertidos e especificado na propriedade
pConsultarNfseEnvio.PeriodoEmissao. Campos Tomador e IntermediarioServico so
opcionais na pesquisa se no houver notas. A propriedade
retConsultarNfseResposta.Item.CompNfse recebe null ( tag sem vazia )
ConsultarNfse(ConsultarNfseEnvio pConsultarNfseEnvio).


Verso: 1.08

Pgina 36 de 62

Utilizao do Mtodo
Inicialmente a Signature e Id no esto sendo usados, tendo como segundo
parmetro ddDuasStrings.

Em resposta a chamada do servio ser devolvida a estrutura definida na tabela a
seguir.
1 EnviarLoteRps
Resposta
1-1
NumeroLote N 1 Nmero da Nota Fiscal de Servio
Eletrnica - Formato
AAAANNNNNNNNNNN.
Choice 1-1
DataRecebime
nto
D 1 Data e hora.
Protocolo C 1 Nmero do protocolo de recebimento do


Verso: 1.08

Pgina 37 de 62

RPS.
2 ListaMensage
mRetorno
ListaMensagem
Retorno
1 Representa a estrutura de mensagem de
retorno de servio.
1-1

O lote ser processado posteriormente, sendo o seu resultado disponibilizado para
consulta.
Utilizao do Mtodo

3.5.3. Consulta de Situao de Lote de RPS
Mtodo: ConsultarSituacaoLoteRps
Esse servio ser executado atravs da chamada ao mtodo
ConsultarSituacaoLoteRps, passando a mensagem XML como parmetro com a
estrutura definida na tabela que segue.
1 ConsultarSituacaoLoteRpsEnvio 1-1
Prestador tcIdentificacao
Prestador
1 Conjunto de dados de identificao
1-1
Protocolo C 1 Nmero do protocolo de
recebimento do RPS
1-1



Verso: 1.08

Pgina 38 de 62

Utilizao do Mtodo

seguir.
1 ConsultarSituacaoLo
teRpsResposta
1-1
NumeroLote N 1 Nmero do Lote de RPS Choice 1-1
Situao N 1 Cdigo de situao de lote de RPS
1 No Recebido
2 No Processado
3 Processado com Erro
4 Processado com Sucesso
2 ListaMensagemRetor
no
ListaMensagem
Retorno
1 Representa a estrutura de
mensagem de retorno de servio.
1-1

Utilizao do Mtodo

3.5.4. Consulta de NFS-e por RPS
Mtodo: ConsultarNfsePorRps
Esse servio ser executado atravs da chamada ao mtodo
ConsultarNfsePorRps, passando a mensagem XML como parmetro com a estrutura
definida na tabela que segue.


Verso: 1.08

Pgina 39 de 62

1 ConsultarNfseRpsEnvio
IdentificacaoRps tcIdentificacao
Rps
1 Conjunto de dados de identificao do
RPS.
1-1
Prestador tcIdentificacao
Prestador
prestador de servio.
1-1


Utilizao do Mtodo

seguir.
1 ConsultarNfseRps
Resposta

CompNfse tcCompNfse 1 Representa a estrutura de
compartilhamento de dados de uma
NFS-e.
Choice 1-1
2 ListaMensagemR
etorno
ListaMensagem
Retorno
1 Representa a estrutura de mensagem
de retorno de servio.
1-1


Verso: 1.08

Pgina 40 de 62

Utilizao do Mtodo

3.5.5. Consulta de NFS-e
Mtodo: ConsultarNfse
Esse servio ser executado atravs da chamada ao mtodo ConsultarNfse,
passando a mensagem XML como parmetro com a estrutura definida na tabela que
segue.
1 ConsultarNfseEnvio 1-1
Prestador tcIdentificacaoPrestador 1 Conjunto de dados de identificao
1-1


Verso: 1.08

Pgina 41 de 62

NumeroNfse N 1 Nmero da Nota Fiscal de Servio
Eletrnica - Formato
AAAANNNNNNNNNNN.
0-1
2 PeriodoEmissao PeriodoEmissao 1 0-1
DataInicial D 1 Data inicial da consulta Nfse.
Formato: AAAA-MM-DD
1-1
DataFinal D 1 Data final da consulta Nfse. 1-1
Tomador tcIdentificacaoTomador 1 Conjunto de dados de identificao
do tomador de servio.
1-1
IntermediarioServico tcIdentificacaoIntermedi
arioServico
1 Conjunto de dados de identificao
0-1


Utilizao do Mtodo


Verso: 1.08

Pgina 42 de 62

seguir.
1 ConsultarNfse
Resposta
1-1
2 ListaNfse 1 Choice 1-1
0-N CompNfse tcCompNfse 2 Representa a estrutura de
compartilhamento de dados de uma NFS-e.
3 ListaMensage
mRetorno
ListaMensage
mRetorno
retorno de servio.
1-1

Utilizao do Mtodo

3.5.6. Consulta de Lote de RPS
Mtodo: ConsultarLoteRps
Esse servio ser executado atravs da chamada ao mtodo ConsultarLoteRps,
segue.
1 ConsultarLoteRpsEnvio 1-1
Prestador tcIdentificacaoPrest
ador
1 Conjunto de dados de
identificao do prestador de
servio.
1-1
Protocolo C 1 Nmero do protocolo de
recebimento do RPS
1-1



Verso: 1.08

Pgina 43 de 62


Utilizao do Mtodo

seguir.
1 ConsultarLoteRps
Resposta
1-1
2 ListaNfse 1 Choice 1-1
CompNfse tcCompNfse 2 Representa a estrutura de
compartilhamento de dados de uma NFS-
e.
1-N
3 ListaMensagemR
etorno
ListaMensag
emRetorno
retorno de servio.
1-1

Utilizao do Mtodo


Verso: 1.08

Pgina 44 de 62

tcCancelamentoNfse ser exibido quando um arquivo RPS retornado for cancelado.
tcSubstituicaoNfse ser exibido quando um arquivo RPS retornado for substitudo.

3.5.7. Cancelamento NFS-e
Mtodo: CancelarNfse
Esse servio ser executado atravs da chamada ao mtodo CancelarNfse,
segue.
1 CancelarNfseEnvio 1-1
Pedido tcPedidoCancelamento 1 Representa a estrutura de Pedido
de Cancelamento da Nota Fiscal
de Servios Eletrnica assinada.
1-1


Utilizao do Mtodo

* Campos no obrigatrios.


Verso: 1.08

Pgina 45 de 62

seguir.
1 CancelarNfse
Resposta

Cancelamento tcCancelamento
Nfse
1 Representa os dados de registro de
substituio de NFS-e.
Choice 1-1
2 ListaMensage
mRetorno
ListaMensagem
Retorno
retorno de servio.
1-1

Utilizao do Mtodo

* Campos no obrigatrios.

3.5.8. Gerar NFS-e
Mtodo: GeraNfse
Esse servio ser executado, inicialmente, atravs da chamada ao mtodo
GerarNfse, passando a mensagem XML como parmetro com a estrutura definida na
tabela que segue.
1 GerarNovaNfseEnvio 1-1
2 Prestador tcIdentificacaoPrest
ador
prestador de servio.
1-1
2 InformacaoNfse tcInfNovaNfse 1 Conjunto de dados de descrio da NFS-
e
1-1
Servico tcDadosServico 2 Conjunto de dados que compe o servio
prestado.
1-1
Tomador tcDadosTomador 2 Conjunto de dados do tomador de
servio.
1-1
IntermediarioServico tcIdentificacaoInter 2 Conjunto de dados de identificao do 0-1


Verso: 1.08

Pgina 46 de 62

mediarioServico intermedirio do servio.
Civil
2 Conjunto de dados para identificao de
construo civil.
0-1
Signature dsig:Signature 1 0-1


Utilizao do Mtodo
Inicialmente a Signature e Id no esto sendo usados, tendo como segundo
parmetro ddDuasStrings.


Verso: 1.08

Pgina 47 de 62

seguir.
1 GerarNovaNfse
Resposta

NovaNfse tcRespostaIdent
NovaNfse
de retorno da NFS-e.
Choice 1-1
2 ListaMensagem
Retorno
ListaMensagem
Retorno
de retorno de servio.
1-1

Utilizao do Mtodo


Verso: 1.08

Pgina 48 de 62

4. ANEXOS
4.1. TABELA DE ERROS
CD MENSAGEM SOLUO
E1 Assinatura do Hash no confere. Reenvie assinatura do Hash conforme algoritmo
estabelecido no Manual de Instruo da NFS-e.
E2 Ms de competncia superior ao de
emisso do RPS ou da Nota.
Informe um ms de competncia inferior ou igual ao
de emisso do RPS ou da Nota.
E3 Natureza da operao no informada. Utilize um dos tipos: 01 Tributao no municpio;
02 Tributao fora do municpio; 03 Iseno; 04
Imune; 05 Exigibilidade suspensa por deciso
judicial; 06 Exigibilidade suspensa por rocedimento
administrativo.
E4 Esse RPS no foi enviado para a nossa
base de dados.
Envie o RPS para emisso da NFS-e.
E5 O nmero da NFS-E substituda informado
no existe na base de dados do municpio.
Informe um nmero de NFS-E substituda que j
tenha sido emitida.
E6 Essa NFS-e no pode ser cancelada
atravs desse servio, pois h crdito
Informado.
O cancelamento de uma NFS-e com crdito deve
ser feito atravs de processo administrativo aberto
em uma repartio fazendria.
E7 Essa NFS-e j foi substituda. Confira e informe novamente os dados da NFS-e
que deseja substituir.
E8 Campo de optante pelo simples nacional
no informado.
Utilize um dos tipos: 1 Sim; 2 - No.
E9 Campo de incentivador cultural no
informado.
E10 RPS j informado. Para essa Inscrio Municipal/CNPJ j existe um
RPS informado com o mesmo nmero, srie e tipo.
E11 Nmero do RPS no informado. Informe o nmero do RPS.
E12 Tipo do RPS no informado. Informe o tipo do RPS.
E13 Campo tipo do RPS invlido. Utilize um dos tipos especificados: 1 - RPS', 2 -
RPSC ou 3 - RPSM.
E14 Data da emisso do RPS no informada. Informe a Data da emisso do RPS no formato Date.
E15 Data da emisso do RPS invlida. Informe a Data da emisso do RPS no formato Date.
E16 A data da emisso do RPS no poder ser
superior data de hoje.
Informe uma data de emisso de RPS vlida.
E17 A data da emisso do RPS no poder ser
inferior data de habilitao do prestador
para emisso da NFS-e.
Informe uma data de emisso de RPS vlida.
E18 O valor dos servios dever ser superior a
R$ 0,00 (zero).
No permitido envio de valor de servios igual a
zero.
E19 O valor das dedues dever ser inferior ou
igual ao valor dos servios.
No permitido valor de deduo superior ao valor
de servios.
E20 O valor das dedues dever ser superior
ou igual a R$ 0,00 (zero).
No permitido valor de deduo inferior a zero
(negativo).
E21 O valor dos descontos dever ser inferior
ou igual ao valor dos servios.
No permitido valor de desconto superior ao valor
de servios.
E22 O valor dos descontos dever ser superior
ou igual a R$ 0,00 (zero).
No permitido valor de desconto inferior a zero
(negativo).
E23 O valor do PIS dever ser superior ou igual
a R$ 0,00 (zero).
No permitido valor de reteno inferior a zero
(negativo).
E24 O valor do INSS dever ser superior ou
igual a R$ 0,00 (zero).
(negativo).


Verso: 1.08

Pgina 49 de 62

E26 O valor do IR dever ser superior ou igual a
R$ 0,00 (zero).
(negativo).
E27 O valor da CSLL dever ser superior ou
igual a R$ 0,00 (zero).
(negativo).
E28 Item da lista de servio informado
incompatvel com a informao de optante
pelo simples nacional
Consulte a legislao vigente para saber se o item
informado permite a opo pelo simples nacional.
E29 O cdigo de servio prestado no permite
reteno de ISS.
Altere o campo "ISS Retido" para: 2 (Nota Fiscal sem
ISS Retido).
E30 Item da lista de servio inexistente. Consulte a legislao vigente para saber o item da
lista de servio que dever ser informado neste
campo.
E31 Item da lista de servio no informado para
a operao.
Informe o item relativo ao servio prestado nessa
operao.
E32 Cdigo CNAE informado incompatvel
com a informao de optante pelo simples
nacional
Consulte a legislao vigente para saber se o cdigo
E33 Cdigo CNAE inexistente. Consulte a legislao vigente para saber o cdigo
CNAE que dever ser informado neste campo.
E34 Cdigo de tributao informado
incompatvel com a informao de optante
pelo simples nacional.
Consulte a legislao vigente para saber se o cdigo
E35 Cdigo de tributao inexistente. Consulte a legislao vigente para saber o Cdigo
de tributao que dever ser informado neste
campo.
E36 Campo ISSRetido invlido. Utilize um dos tipos: 1 para ISS Retido ou 2 para ISS
no Retido.
E37 Apenas servios tributados, no municpio
ou fora, podem sofrer reteno de ISS.
Operaes isentas, imunes ou com exigibilidade
suspensa por deciso judicial ou procedimento
administrativo no podem sofrer reteno de ISS.
E38 Contribuintes enquadrados como
Microempresa Municipal, Estimativa,
Sociedade de Profissionais ou Incentivador
Cultural no podem sofrer reteno de ISS.
No faa a reteno do ISS nos casos de empresas
enquadradas como Microempresa Municipal,
Estimativa, Sociedade de Profissionais ou
Incentivador Cultural.
E39 Apenas empresas tomadoras de servios
inscritas neste municipio podem efetuar
reteno de ISS.
O CNPJ e/ou a Inscrio Municipal informada do
tomador no foi encontrada na base de dados do
municpio, no sendo permitida a reteno. Acerte o
CNPJ e/ou Inscrio Municipal ou altere o campo
ISS Retido para 2 (Sem reteno de ISS).
E40 Valor do ISS retido no informado. O valor do ISS retido deve ser informado quando
o campo "IssRetido" for marcado com 1- Sim.
E41 O campo discriminao dos servios no
foi preenchido.
O preenchimento da discriminao dos servios
obrigatrio por lei, devendo ser preenchido
adequadamente.
E42 Cdigo do municpio da prestao do
servio invlido.
Consulte a tabela do IBGE e utilize um dos tipos
listados na tabela.
E43 Inscrio Municipal do prestador no
encontrada na base de dados do
municpio.
Informe a inscrio municipal correta do prestador.
E44 CNPJ do prestador invlido. Informe o nmero do CNPJ correto do prestador.
E45 CNPJ no encontrado na base de dados. Confira o numero do CNPJ informado. Caso esteja
correto, o prestador no est inscrito no municpio.
E46 CNPJ do prestador no informado. Informe o CNPJ do prestador.
E47 CPF/CNPJ do tomador invlido. Informe o CPF/CNPJ correto do tomador.
E48 O campo CPF/CNPJ do tomador dever
ser preenchido com zeros quando for de
Preencher o campo CPF/CNPJ do Tomador com
zeros quando se tratar de tomador com CPF no


Verso: 1.08

Pgina 50 de 62

CPF no-informado. informado.
E49 Lote de RPS com excesso de
inconsistncias.
O servio de validao de RPS abortado quando
atinge o nmero de 50 inconsistncias. Corrija os
erros e reenvie o lote de RPS.
E50 Inscrio Municipal do prestador invlida. Informe a inscrio municipal correta do prestador.
E51 Inscrio Municipal do tomador invlida Informe a inscrio municipal correta do tomador.
E52 O tomador de servios informado o
prprio prestador.
Na emisso da NFS-e no permitido que o
prestador seja igual ao tomador.
E53 O campo Inscrio Municipal do tomador
s dever ser preenchido para tomadores
estabelecidos neste municpio.
Para tomadores estabelecidos fora deste municpio
no preencher inscrio municipal.
E54 CNPJ do tomador (<CNPJ enviado>) est
vinculado a mais de uma inscrio
municipal.
Informe a Inscrio Municipal do tomador vinculada
ao CNPJ informado.
E55 Endereo do tomador (logradouro) no
corresponde ao CEP informado.
Corrija o endereo (logradouro) ou o CEP do
tomador do servio.
E56 Campo endereo do tomador no
informado (obrigatrio para tomador com
CNPJ).
O preenchimento do endereo (logradouro)
obrigatrio para tomadores Pessoas Jurdicas
(com CNPJ).
E57 Bairro no corresponde ao CEP informado. Corrija o Bairro ou o CEP do tomador do servio.
E58 Cdigo do municpio do tomador no
corresponde ao CEP informado.
Corrija o cdigo do municpio ou o CEP do
tomador do servio.
E59 Campo cidade do tomador no informado
(obrigatrio para tomador com CNPJ).
O preenchimento da Cidade do Tomador
obrigatrio para tomadores Pessoas Jurdicas
(com CNPJ).
E60 A cidade do tomador informada no foi
encontrada na base de dados da prefeitura.
Informe a cidade correta do tomador. No caso de
cidade do exterior (fora do pas), informe o campo
com 99999.
E61 Sigla da UF do tomador no corresponde
ao CEP informado.
Corrija a sigla da UF ou o CEP do tomador do
servio.
E62 Cep no existe na tabela DNE dos
Correios.
Informar o Cep correto.
E63 Razo Social do intermedirio do servio
no informada com CNPJ/CPF ou Inscrio
Municipal do intermedirio informada.
Informe a razo social do intermedirio do servio.
E64 Inscrio Municipal do intermedirio do
servio invlida.
Informe a Inscrio Municipal correta do
intermedirio do servio.
E65 Inscrio Municipal do intermedirio do
servio no esta vinculada ao CNPJ/CPF
informado.
Acerte a Inscrio Municipal ou o CNPJ/CPF do
intermedirio do servio.
E66 CNPJ/CPF do Intermedirio do Servio
invalido.
Informe o CNPJ/CPF correto do intermedirio do
servio.
E67 Cdigo da obra invlido. Informe o cdigo da obra correto.
E68 Status do RPS invlido. Utilize um dos tipos:1 Normal; 2 Cancelado;
E69 Quantidade de RPS incorreta. Informe a quantidade de RPS correta.
E70 Inscrio Municipal do prestador
especificada no lote no confere com o
prestador informado no RPS.
Informe corretamente a Inscrio Municipal do
prestador no lote e no RPS.
E71 RPS em duplicidade no arquivo enviado. Remova do arquivo o registro de RPS excedente.
E72 Campo Quantidade de RPS informado
incorretamente.
O campo quantidade de RPS numrico e dever
ter tamanho mximo de 4 dgitos.
E73 Campo tipo do RPS invlido para o tipo de
registro='3' (Cupons).
Utilize o tipo RPS-C".
E74 Data de emisso da Nota Fiscal no est
compreendida entre <data inicio de
emisso do lote> e <data fim de emisso
Utilize no cabealho do arquivo datas de emisso
da Nota Fiscal compreendidas entre a data incio
de emisso do lote e a data fim de emisso do lote.


Verso: 1.08

Pgina 51 de 62

do lote> conforme especificado no
cabealho do arquivo.
E75 Nmero do RPS substitudo no informado
para status do RPS igual a "S".
Informe o nmero do RPS substitudo.
E76 O nmero do RPS substitudo informado
no existe na base de dados.
Informe o nmero do RPS substitudo correto.
E77 Nmero da NFS-e no informado. Informe o nmero da NFS-e.
E78 Nmero da NFS-e inexistente na base de
dados para o prestador de servio
pesquisado.
Informe o nmero correto da NFS-e.
E79 Essa NFS-e j est cancelada. Confira e informe novamente os dados da NFS-e
que deseja cancelar.
E80 Cdigo de verificao no informado. Informe o cdigo de verificao da NFS-e.
E81 Cdigo de verificao no corresponde
NFS-e consultada.
Informe o cdigo de verificao correto.
E82 Pesquisa pela atividade s pode ser feita
com a indicao de um CEP ou bairro.
Informe um CEP ou um bairro.
E83 Campo Inscrio Municipal do tomador
informado incorretamente.
O campo Inscrio Municipal do tomador numrico
e dever ter tamanho mximo de 15 dgitos.
E84 Pesquisa pelo CEP s pode ser feita com a
Indicao de uma atividade.
Informe uma atividade.
E85 Pesquisa pelo bairro s pode ser feita com
a Indicao de uma atividade.
Informe uma atividade.
E86 Nmero do protocolo de recebimento do
lote Inexistente na base de dados.
Confira se o lote foi enviado e informe o nmero
Correto do protocolo de recebimento.
E87 Nmero de lote inexistente na base de
dados.
Confira se o lote foi enviado e informe o nmero
Correto.
E88 Nmero de lote no informado. Informe o nmero do lote.
E89 No existe na base de dados uma NFS-e
Emitida para o nmero de RPS informado.
Informe o nmero correto do RPS.
E90 Nmero do RPS invlido. Informe um nmero de RPS que corresponda
Sequncia utilizada pelo prestador de servio.
E91 Esse RPS no foi enviado para a nossa
base de dados.
Exija do prestador do servio emisso da NFS-E.
E92 Esse RPS foi enviado para a nossa base
de Dados, mas ainda no foi processado.
Faa uma nova consulta mais tarde.
E93 Srie informada invlida. Informe a srie correta para o RPS pesquisado.
E94 Ms de competncia no informado. Informe o ms de competncia no formato AAAAMM.
E95 Ms de competncia informado
incorretamente.
Informe o ms de competncia no formato AAAAMM.
E96 Campo nmero do RPS informado
Incorretamente.
O campo Nmero do RPS numrico e dever
Ter tamanho mximo de 15 dgitos.
E97 Campo srie do RPS informado
Incorretamente.
O campo Srie do RPS alfanumrico e dever
Ter tamanho mximo de cinco caracteres.
E98 Valor dos servios no informado. Informe o valor dos servios.
E99 Valor da reteno dever ser inferior ou
igual Ao valor dos servios.
No permitido valor de reteno superior ao
Valor de servios.
E100 Campo valor dos servios informado
Incorretamente.
O campo valor dos servios numrico e dever
Ter tamanho mximo de 15,2, ou seja, 15. Nmeros
inteiros e dois decimais.
E101 Campo dedues informado
incorretamente.
O campo valor das dedues numrico e dever
ter tamanho mximo de 15,2, ou seja, 15 nmeros
E102 Campo descontos informado
incorretamente.
O campo valor dos descontos numrico e dever
ter tamanho mximo de 15,2, ou seja, 15 nmeros


Verso: 1.08

Pgina 52 de 62

E103 Reteno de tributo federal informada
incorretamente.
O campo referente a reteno de tributo federal
numrico e dever ter tamanho mximo de 15,2, ou
seja, 15 nmeros inteiros e dois decimais.
E104 Campo item da lista de servio informado
incorretamente.
O campo item da lista de servio dever ter tamanho
mximo de 4 caracteres.
E105 Campo cdigo CNAE informado
incorretamente.
O campo cdigo CNAE dever ter tamanho mximo
de 7 caracteres.
E106 Campo cdigo de tributao do municpio
O campo cdigo de tributao do municpio
dever ter tamanho mximo de 20 caracteres.
E107 Campo discriminao do servio informado
incorretamente.
O campo discriminao do servio dever ter
tamanho mximo de 2000 caracteres.
E108 Campo municpio da prestao do servio
O campo municpio da prestao do servio dever
E109 Campo cidade do tomador informado
incorretamente.
O campo cidade do tomador dever ter tamanho
mximo de 7 dgitos, consulte tabela do IBGE..
E110 Quando a natureza da operao for
tributao fora do municpio, o campo
municpio da prestao do servio dever
ser diferente do municpio do prestador
Informar o municpio da prestao do servio
corretamente.
E111 Municpio da prestao do servio no
informado.
Informe o municpio da prestao do servio, de
acordo com a tabela do IBGE.
E112 Campo Inscrio Municipal do intermedirio
O campo Inscrio Municipal do intermedirio
numrico e dever ter tamanho mximo de 15
dgitos.
E113 Campo nmero do endereo do tomador
no informado (obrigatrio para tomador
com CNPJ) .
A informao do nmero do endereo do tomador
obrigatria para tomadores pessoas jurdicas (com
CNPJ).
E114 Campo bairro do tomador no informado
A informao do bairro do tomador obrigatria
para tomadores Pessoas Jurdicas (com CNPJ).
E115 Campo UF do tomador no informado
O preenchimento da UF do tomador obrigatrio
para tomadores pessoas jurdicas (com CNPJ).
E116 A UF do tomador informada no foi
encontrada na base de dados.
Informe a UF correta do tomador. Em caso de
cidades do exterior (fora do pas), preencher a UF
com "EX" e a cidade do tomador com 99999.
E117 Campo razo social do tomador informado
incorretamente.
O campo razo social do tomador dever ter
E118 Campo razo social do tomador no
informado.
O campo razo social do tomador dever ser
informado quando o campo Indicador de CPF/CNPJ
do tomador for preenchido com 1 - CPF ou 2 - CNPJ.
E119 Campo endereo do tomador informado
incorretamente.
O campo endereo do tomador dever ter tamanho
E120 Campo nmero do endereo do tomador
O campo nmero do endereo do tomador dever ter
E121 Campo complemento do endereo do
tomador informado incorretamente.
O campo complemento do endereo do tomador
E122 Campo bairro do tomador informado
incorretamente.
O campo bairro do tomador dever ter tamanho
E123 Campo AliquotaServicos no informado
para tributao fora do municpio.
Informe a alquota do ISS quando a tributao for
fora do municpio.
E124 Campo UF do tomador informado
incorretamente.
O campo UF do tomador dever ter tamanho
E125 Campo CEP do tomador informado
incorretamente.
O campo CEP do tomador dever ter tamanho
mximo de 8 dgitos.
E126 Campo e-mail do tomador informado
incorretamente.
O campo e-mail do tomador dever ter tamanho


Verso: 1.08

Pgina 53 de 62

E127 Campo telefone do tomador informado
incorretamente.
O campo telefone do tomador dever ter tamanho
E128 Campo razo social do intermedirio do
servio informado incorretamente.
O campo razo social do intermedirio do servio
E129 Campo cdigo da obra informado
incorretamente.
O campo cdigo da obra dever ter tamanho
E130 Campo ART informado incorretamente. O campo ART dever ter tamanho mximo de 15
caracteres.
E131 Campo data inicial preenchido
incorretamente.
A data informada dever estar no formato
DD/MM/AAAA, ou seja, dia (2 dgitos), seguido de
ms (2 dgitos) e ano (4 dgitos) e deve ser uma
data vlida.
E132 Campo data final preenchido
incorretamente.
A data informada dever estar no formato
DD/MM/AAAA, ou seja, dia (2 dgitos), seguido
de ms (2 dgitos) e ano (4 dgitos) e deve ser uma
data vlida.
E133 Data final da pesquisa no poder ser
superior a data de hoje.
Informe uma data final igual ou anterior a data de
hoje.
E134 A data final no poder ser anterior data
inicial.
Informe uma data final igual ou superior a data inicial
da pesquisa.
E135 O perodo de pesquisa no poder ser
superior a um ano.
Limitar as datas de incio e final a um perodo de um
ano.
E136 Campo nmero da NFS-e informado
incorretamente.
O campo nmero da NFS-e numrico e dever ter
tamanho mximo de 15 dgitos.
E137 Data de emisso da NFS-e informada
incorretamente.
Informe a data correta da emisso da NFS-e a ser
consultada.
E138 CNPJ no autorizado a realizar o servio. Informe o CNPJ autorizado a executar o servio.
E139 Campo nmero da NFS-e substituda
O campo nmero da NFS-e substituda numrico e
dever ter tamanho mximo de 15 dgitos.
E140 Bairro do prestador inexistente. Informe o bairro do prestador.
E141 Inscrio Municipal do prestador no
informada.
Informe a Inscrio Municipal do prestador.
E142 Inscrio Municipal do prestador no est
vinculada ao CNPJ informado.
Acerte a Inscrio Municipal ou o CNPJ do
prestador.
E143 Inscrio Municipal do tomador no est
vinculada ao CNPJ informado.
Acerte a Inscrio Municipal ou o CNPJ do tomador.
E144 Natureza da operao invlida. Utilize um dos tipos: 01 Tributao no municpio;
02 Tributao fora do municpio; 03 Iseno; 04
Imune; 05 Exigibilidade suspensa por deciso
judicial; 06 Exigibilidade suspensa por
procedimento administrativo.
E145 Regime Especial de Tributao invlido. Utilize um dos tipos: 01 Microempresa Municipal;
02 Estimativa; 03 Sociedade de Profissionais; 4
Cooperativa; 5 - Microempresrio Individual (MEI)
6 - Microempresrio e Empresa de Pequeno Porte
(ME EPP).
E146 Informao de optante pelo simples
nacional invlida.
E147 Informao de incentivador cultural
invlida.
E148 Status do RPS no informado. Informe o status do RPS.
E149 Campo CNPJPrestador informado
incorretamente,
O campo CNPJPrestador numrico e dever ter
tamanho mximo de 14 dgitos.
E150 Srie do RPS no informada. Campo de preenchimento obrigatrio, caso no
utilize srie, preencha o campo com 00000.
E151 Quantidade de RPS no informada. Informe a quantidade de RPS.


Verso: 1.08

Pgina 54 de 62

E152 Campo ISSRetido no informado. Informe um dos tipos: 1 para ISS Retido ou 2
para ISS no Retido.
E153 Campo ValorISSRetido informado
incorretamente.
O campo ValorISSRetido numrico e dever ter
tamanho mximo de 15,2, ou seja, 15 nmeros
E154 Campo CNPJ/CPF do Intermedirio do
Servio informado incorretamente.
O campo CNPJ/CPF do Intermedirio do Servio
dgitos.
E155 Campo CPFCNPJTomador informado
incorretamente.
O campo CPFCNPJTomador numrico e dever
E156 CNPJ do prestador no autorizado a emitir
NFS-e.
Solicite autorizao para emitir NFS-e para o CNPJ
informado.
E157 Usurio no est autorizado a utilizar esse
servio para esse contribuinte.
Solicite ao contribuinte autorizao para utilizar
o servio em seu nome.
E158 Campo Inscrio Municipal do prestador
O campo Inscrio Municipal do prestador
dgitos.
E159 CNPJ do prestador especificado no lote
no confere com o prestador informado no
RPS.
Informe corretamente o CNPJ do prestador no
lote e no RPS.
E160 Arquivo enviado fora da estrutura do
arquivo XML de entrada.
Envie um arquivo dentro do schema do arquivo
XML de entrada.
E161 Campo ValorISS no informado para
tributao fora do municpio.
Informe o valor do ISS quando a tributao for
fora do municpio.

4.2. TABELA DE ALERTAS
CD MENSAGEM INTERPRETAO
A1 Item da lista de servio, cdigo CNAE ou
cdigo de tributao informado para a
operao no est cadastrado para o
Prestador de servio.
Verifique se o item ou cdigo informado est correto.
Se estiver, proceda a atualizao cadastral junto
Prefeitura assim que possvel, pois o item ou cdigo
informado no est cadastrado para a sua inscrio
municipal, Item da Lista de Servio, Cdigo CNAE ou
Cdigo de Tributao.
A 2 Item da lista de servio, cdigo CNAE ou
cdigo de tributao informado para a
operao no permite deduo na base de
clculo.
ou cdigo informado permite deduo da base de
clculo.
A 3 Item da lista de servio informado para a
operao no permite tributao fora do
municpio
informado permite a tributao fora do municpio (Foi
informada a Natureza da Operao "2").
A 4 Valor do ISS retido diferente do ISS devido. Verifique se os valores esto corretos.
A 5 O CNPJ informado possui inscrio no
municpio, porm foi informado endereo
de fora do municpio.
O sistema ir considerar o tomador conforme todos
os dados informados no arquivo (endereo de fora
do municpio).
A 6 A inscrio municipal do tomador no foi
encontrada na base de dados de CCM.
O sistema ir interpretar como se o tomador no
tivesse inscrio no CCM.
A 7 Inscrio Municipal do tomador de servios
consta como cancelada.
A inscrio municipal do tomador fornecida consta
como cancelada na base de dados do municpio.
A 8 E-mail do tomador de servios invlido. E-
mail no ser enviado.
O e-mail do tomador de servios no vlido. Este
campo ser ignorado e no haver envio de e-mail.


Verso: 1.08

Pgina 55 de 62

4.3. TABELA DE MENSAGENS PERSONALIZADAS
CD MENSAGEM SOLUO
A900 O lote consultado no foi recebido, no foi
processado ou foi processado com erro.
Antes de fazer a consulta verifique a situao do
lote.
E900 Chamada ao mtodo retornou erro. Entre em contato com o suporte.
E901 Erro na autenticao do usurio. Usurio e
senha no conferem.
Entre em contato com o suporte.
E902 Quantidades de rps's enviandos no lote
extrapolou o limite de {0}.
Envie o lote novamente com a quantidade de
rps's dentro do limite.
E903 J existe lote protocolado com esse nmero
para o mesmo cnpj e inscrio municipal.
Altere o nmero do lote.
E904 Nmero de protocolo no corresponde a
identificao do prestador informado.
Confira o nmero do protocolo e os dados do
prestador.
E905 Nmero do protocolo no informado. Informe o nmero do protocolo.
E906 Soma total dos Itens de Servio informados
(Quantidade * ValorUnitario) diferente do
Valor do Servio informado no Rps.
Verifique os valores informados.
E907 Existe descricao de item de servio vazia. Preencha a descrio dos itens do servio
faltando.
E908 Exite quantidade informada de item de servio
menor ou igual a 0(zero).
A quantidade dos itens de servio devem ser
maior que 0(zero).
E909 Existe valor unitrio de item de servio menor
ou igua a 0(zero).
O valor unitrio dos itens de servio devem ser
maior que 0(zero).
E910 Campo de E910 informado incorretamente. O campo ValorServicos numrico e dever
ter tamanho mximo de 15,2 ou seja, 15 nmero
inteiros e 2 decimais.
E911 Campo de E911 informado incorretamente. O campo ValorDeducoes numrico e dever
E912 Campo de E912 informado incorretamente. O campo ValorPis numrico e dever ter
tamanho mximo de 15,2 ou seja, 15 nmero
E913 Campo de E913 informado incorretamente. O campo ValorCofins numrico e dever ter
E914 Campo de E914 informado incorretamente. O campo ValorInss numrico e dever ter
E915 Campo de E915 informado incorretamente. O campo ValorIr numrico e dever ter
E916 Campo de E916 informado incorretamente. O campo ValorCsll numrico e dever ter
E917 Campo de E917 informado incorretamente. O campo ValorIssRetido numrico e
dever ter tamanho mximo de 15,2 ou seja, 15
nmero inteiros e 2 decimais.
E918 Campo de E918 informado incorretamente. O campo ValorIss numrico e dever ter
E919 Campo de E919 informado incorretamente. O campo OutrasRetencoes numrico e


Verso: 1.08

Pgina 56 de 62

E920 Campo de E920 informado incorretamente. O campo BaseCalculo numrico e dever ter
E921 Campo de E921 informado incorretamente. O campo Aliquota numrico e dever ter
E922 Campo de E922 informado incorretamente. O campo ValorLiquidoNfse numrico e
E923 Campo de E923 informado incorretamente. O campo DescontoCondicionado numrico
e dever ter tamanho mximo de 15,2 ou seja, 15
E924 Campo de E924 informado incorretamente. O campo DescontoIncondicionado
numrico e dever ter tamanho mximo de 15,2
ou seja, 15 nmero inteiros e 2 decimais.
E925 Campo de E925 informado incorretamente. O campo ValorDeducoes numrico e dever
E926 Campo de E926 informado incorretamente. O campo ValorPis numrico e dever ter
E927 Campo de E927 informado incorretamente. O campo ValorCofins numrico e dever ter
E928 Campo de E928 informado incorretamente. O campo ValorInss numrico e dever ter
E929 Campo de E929 informado incorretamente. O campo ValorIr numrico e dever ter
E930 Campo de E930 informado incorretamente. O campo ValorCsll numrico e dever ter
E931 Campo de E931 informado incorretamente. O campo ValorIssRetido numrico e
E932 Campo de E932 informado incorretamente. O campo ValorIss numrico e dever ter
E933 Campo de E933 informado incorretamente. O campo OutrasRetencoes numrico e
E934 Campo de E934 informado incorretamente. O campo BaseCalculo numrico e dever ter
E935 Campo de E935 informado incorretamente. O campo ValorLiquidoNfse numrico e
E936 Campo de E936 informado incorretamente. O campo DescontoCondicionado numrico
e dever ter tamanho mximo de 15,2 ou seja, 15
E937 Campo de E937 informado incorretamente. O campo DescontoIncondicionado
numrico e dever ter tamanho mximo de 15,2
ou seja, 15 nmero inteiros e 2 decimais.


Verso: 1.08

Pgina 57 de 62

E938 Campo de E938 informado incorretamente. O campo Aliquota numrico e dever ter
E939 O valor de BaseCalculo declarado no est
correto.
Valor correto: BaseCalculo = ValorServico -
(ValorDeducoes + DescontoIncondicionado).
E940 O valor de ValorLiquidoNfse declarado no
est correto.
O clculo para ValorLiquidoNfse :
ValorLiquidoNfse = ValorServico - (ValorPis +
ValorCofins + ValorInss + ValorIr + ValorCsll +
OutrasRetencoes + ValorIssRetido +
DescontoIncondicionado +
DescontoCondicionado).
E941 O valor de alquota declarado no est
correto.
Consulte a legislao vigente para saber o valor
correto.
E942 O ValorIss declarado no est correto. Verifique os dados.
E943 O ValorIss declarado diferente do
ValorIssRetido retido para IssRetido = 1.
O ValorIss deve ser igual ao ValorIssRetido para
IssRetido = 1.
E944 Tipo invlido para Identificao do tipo de
documento do Tomador.
Tipos aceitos [Cpf|Cnpj].
E945 O campo CPF/CNPJ do intermedirio do
servio dever ser preenchido com zeros
quando for de CPF no-informado.
Preencher o campo CPF/CNPJ do intermedirio
do servio com zeros quando se tratar de
tomador com CPF no informado.
E946 O intermedirio do servio informado o
prprio prestador.
Na emisso da NFS-e no permitido que o
prestador seja igual ao intermedirio do servio.
E947 Este servio tem reteno obrigatria. Altere o campo 'ISS Retido'para 1 (Nota Fiscal
com ISS Retido).
E948 Esse Rps j foi substitudo. Confira e informe novamente os dados do Rps
que deseja substituir.
E949 Esse Rps j est cancelado. Confira e informe novamente os dados do Rps
que deseja cancelar.
E950 Campo nmero da Nfs-e substituda informado
incorretamente.
O campo nmero da Nfs-e substituda nmerico
e dever ter tamanho mximo de 15 dgitos.
E951 Arquivo enviado fora do layout de arquivo de
entrada (pode estar faltando o preechimento
de um campo obrigatrio).
Envie um arquivo dentro do layout de arquivo de
entrada (verifique se todos os campos
obrigatrios esto preenchidos).
E952 Arquivo enviado fora da estrutura do arquivo
XML de entrada - campo obrigatrio faltando
(ListaRps).
Inclua no arquivo o campo obrigatrio (ListaRps).
(ListaRps[].InfRps).
Inclua no arquivo o campo obrigatrio
(ListaRps[].InfRps).
(ListaRps[].InfRps.DataEmissao).
(ListaRps[].InfRps.DataEmissao).
(ListaRps[].InfRps.IdentificacaoRps).
(ListaRps[].InfRps.IdentificacaoRps).
(ListaRps[].InfRps.IdentificacaoRps.Numero).
(ListaRps[].InfRps.IdentificacaoRps.Numero).
(ListaRps[].InfRps.IdentificacaoRps.Serie).
(ListaRps[].InfRps.IdentificacaoRps.Serie).
(ListaRps[].InfRps.Servico).
(ListaRps[].InfRps.Servico).
E959 Arquivo enviado fora da estrutura do arquivo Inclua no arquivo o campo obrigatrio


Verso: 1.08

Pgina 58 de 62

(ListaRps[].InfRps.Servico.ItemListaServico).
(ListaRps[].InfRps.Servico.ItemListaServico).
(ListaRps[].InfRps.Servico.Discriminacao).
(ListaRps[].InfRps.Servico.Discriminacao).
(ListaRps[].InfRps.Servico.Valores).
(ListaRps[].InfRps.Servico.Valores).
(ListaRps[].InfRps.Servico.ItensServico).
(ListaRps[].InfRps.Servico.ItensServico).
(ListaRps[].InfRps.Servico.ItensServico[].Descr
icao).
(ListaRps[].InfRps.Servico.ItensServico[].Descrica
o).
(ListaRps[].InfRps.Prestador).
(ListaRps[].InfRps.Prestador).
(ListaRps[].InfRps.Prestador.Cnpj).
(ListaRps[].InfRps.Prestador.Cnpj).
(ListaRps[].InfRps.Prestador.InscricaoMunicipa
l).
(ListaRps[].InfRps.Prestador.InscricaoMunicipal).
(ListaRps[].InfRps.Tomador).
(ListaRps[].InfRps.Tomador).
(ListaRps[].InfRps.Tomador.IdentificacaoToma
dor).
(ListaRps[].InfRps.Tomador.IdentificacaoTomador
).
(ListaRps[].InfRps.Tomador.IdentificacaoToma
dor.CpfCnpj).
(ListaRps[].InfRps.Tomador.IdentificacaoTomador
.CpfCnpj).
E970 Existe alguma descricao de item de servio
muito grande. Tamanho mximo 100
caracteres.
Verifique o tamanho das descries de itens de
servio.
E971 Existe mais de uma srie de Nfs-e definida
para uso com o web service para este
contribuinte.
Entre em contato com a prefeitura para mais
informaes.
E972 No existe nenhuma srie de Nfs-e definida
para uso com o web service.
informaes.
E973 O servio {0} no est mais disponvel. Entre em contato com o fornecedor do servio
para mais informaes.
E974 No existe nenhuma srie de Nfs-e liberada
para ser usada com o web service.
informaes.
E975 A data de emisso do RPS ou da Nfs-e no
poder ser superior data limite autorizada
para a emisso da Nfs-e.
informaes.
E976 A numerao da Nfs-e a ser gerada
ultrapassar a numerao limite autorizada
pela prefeitura para a emisso de Nfs-e.
informaes.
E977 Existe mais de uma srie de Nfs-e liberada
para ser usada com o web service o que no
informaes.


Verso: 1.08

Pgina 59 de 62

permitido.
E978 Nota Fiscal sem valor de ISS no pode ter ISS
Retido.
Altere o campo ISS Retido para 2 (Nota Fiscal
sem ISS Retido)
E979 Campo Valor do ISS Retido deve ser 0.0 para
ISS No Retido.
Altere o campo Valor do ISS Retido para 0.0.
E980 O somatrio das dedues e do desconto
incondicionado est maior que o valor dos
servios.
O preo do servio deve ser maior ou igual
soma das dedues com o desconto
incondicionado.
E981 A somatria dos descontos, retenes federais
e ISSQN retido na fonte est maior que o valor
dos servios.
O preo do servio deve ser maior ou igual
soma dos tributos federais, o ISSQN devido e os
descontos.
E982 Cdigo de tributao no permite desconto
condicionado.
O tipo de servio prestado no permite desconto
condicionado.
E983 Cdigo de tributao no permite desconto
incondicionado.
O tipo de servio prestado no permite desconto
incondicionado.
E984 Campo Outras Informaes informado
Incorretamente.
O campo Outras Informaes alfanumrico e
dever Ter tamanho mximo de 255 caracteres.
E985 Campo Inscrio Estadual do tomador
O campo Inscrio Municipal do tomador dever
ter tamanho mximo de 20 caracteres.
E986 No pode ser cancelada a Nfs-e do Livro do
Prestador. J existe guia vinculada.
Primeiro entre em contato com a Prefeitura e
solicite o cancelamento da guia.
E987 No pode ser cancelada a Nfs-e do Livro do
Tomador. J existe guia vinculada.
Primeiro entre em contato com a Prefeitura e
solicite o cancelamento da guia.
E988 No permitido o envio de RPS com data de
emisso inferior dez dias da data atual.
Informe a data de emisso que esteja dentro do
perodo autorizado.
E989 Campo de Optante pelo Simples Nacional no
confere com o cadastro da Prefeitura.
Verifique no site, Configuraes do Prestador, a
opo correta.
E990 Opo Simples Nacional conflita com o
Regime Especial de Tributao informado.
Apenas podem ser Optantes pelo Simples
Nacional empresas enquadradas nos Regimes:
5 - MEI; 6 - ME EPP ou 8 - FIXO.
E991 O Regime Especial de Tributao
Microempresrio Individual (MEI) no permite
reteno de ISS.
Altere o campo ISS Retido para 2.
E992 A quantidade de itens de servio informada
excede o nmero mximo permitido.
A quantidade dos itens de servio no deve ser
maior que 15 (quinze).


Verso: 1.08

Pgina 60 de 62

5. VERSES DO MANUAL
5.1. ATUALIZAES
Verso 1.01 17/01/2011
Incluso da tabela tcItemServico:
Tabela que descreve a lista de servios, quantidade de itens e valor de cada
servio.
Incluso das tabelas tcInfNovaNfse, tcIdentNovaNfse e tcRepostaIdentNovaNfse:
Conjunto de tabelas que compem o servio Gerar Nfs-e.
Incluso do servio Gerar Nfs-e:
Servio utilizado para a emisso de uma nica Nfs-e por vez, no comportando
envio de lote nem processamento de RPS. Item 3.5.8 do manual.

Verso 1.02 11/05/2011
Alterao do campo tsIndicacaoCpfCnpj:
CPF 1; CNPJ 2; No Informado 3.
Alterao da tabela tcInfNovaNfse:
Foram adicionados os campos: Id, NaturezaOperacao, RegimeEspecialTributacao,
OptanteSimplesNacional, IncentivadorCultural, Status, Competencia,
NfseSubstituida, OutrasInformacoes e IntermediarioServico.
Incluso do servio Versao:
Servio utilizado para verificar a conectividade entre o sistema do contribuinte e o
sistema web service.

Verso 1.03 30/06/2011
Correo da tabela tcDadosServico:
Remoo dos campos Descricao, Quantidade e ValorUnitario, que causavam
duplicidade de dados com os da tabela tcItemServico.

Verso 1.04 23/02/2012
Incluso do campo OutrasInformacoes na tabela tcInfRps:
Campo usado para agregar informaes adicionais ao documento.


Verso: 1.08

Pgina 61 de 62

Incluso de mensagens personalizadas:
Adicionado mensagens de erros. Da mensagem E950 at a mensagem E978, que
dizem respeito estrutura do arquivo XML, srie e data de autorizao para a
emisso de RPS.
Incluso do Item 2.4. Ambiente de Homologao:
Disponibilizao dos links de Cadastro e de Homologao.

Verso 1.05 17/07/2012
Incluso de novas mensagens personalizadas. Item 4.3 do manual.
E979, E980, E981, E982, E983 e E984.

Verso 1.06 20/08/2012
Alterado exemplo de formato de valores percentuais, Item 3.2.
Incluso de novo campo na tabela tipo simples, Item 3.3:
tsInscricaoEstadual.
Incluso do campo tipo simples na tabela tipo complexo tcIdentificacaoTomador, Item 3.4:
InscricaoEstadual.
Para utilizar este novo campo, tem que refazer a referncia do link de conexo
entre aplicao cliente e web services.
Adicionado opes de motivo de cancelamento no campo tsCodigoCancelamentoNfse,
Item 3.3.
Alterao do campo tsTelefone de 11 para 15 caracteres.
Atualizada mensagem de erro E127, Item 4.1.
Adio de novas Mensagens Personalizadas no item 4.3. do manual.
E985, E986, E987, E988, E989, E990, E991.

Verso 1.07 20/09/2012
Adio de novas Mensagens Personalizadas no item 4.3. do manual.
E992.


Verso: 1.08

Pgina 62 de 62

Verso 1.08 03/10/2012
Alterao da Mensagem Personalizada no item 4.3. do manual.
E992.

Manual Webservice Nfse

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Manual Webservice Nfse

Uploaded by

Copyright:

Available Formats

Manual de Utilizao do Web Service

Revisado em: 3/10/2012

You might also like