MANUAL

INTEGRADOR NOTA FISCAL DE

SERVIOS ELETRNICA
Sumrio
1. RESUMO ..................................................................................................................................................... 3
2. Formas de Funcionamento ........................................................................................................................... 4
2.1 Integrador desktop com NFS-e on-line ................................................................................................... 4
2.2 Web Service puro com NFS-e on-line .................................................................................................... 4
3. ARQUIVO DE RETORNO ......................................................................................................................... 5
4. ARQUIVO DE CONFIGURAO ............................................................................................................ 7
5. WEB SERVICE ........................................................................................................................................... 7
5.1 Consulta de NFS-e via Web Service ....................................................................................................... 8
5.2 Consulta de NFS-e via Web Service ....................................................................................................... 9
5.3 Funes da Interface................................................................................................................................ 9
6. LAYOUT DO ARQUIVO XML ............................................................................................................... 10
6.1 Layout arquivo tipo 1 ............................................................................................................................ 11
6.2 Utilizando Assinatura Digital (verificar obrigatoriedade com o municpio) ......................................... 19
6.3 Notas Fiscais conjugadas e Cupons Fiscais conjugados ....................................................................... 20
7. RETORNO DE ERROS/REGRAS DE VALIDAO DE DADOS MAIS COMUNS ........................... 20
1. RESUMO
Este manual pretende documentar o uso e parmetros necessrios para o
funcionamento da emisso de Notas Fiscais de Servio Eletrnicas de forma integrada
com os sistemas de gesto utilizados para faturamento dos servios prestados pelos
contribuintes do municpio.
2. Formas de Funcionamento
Existem duas formas de funcionamento integrado:

Integrador desktop com NFS-e on-line;

Web Service puro com NFS-e on-line;

Quem determinar o tipo de integrao a ser utilizada ser o prprio prestador de

servio.

2.1 Integrador desktop com NFS-e on-line

O sistema de gesto utilizado pelo emissor da NFS-e dever, no momento da

finalizao da digitao dos dados necessrios gerao da NFS-e, criar em pasta pr-
determinada arquivo do tipo XML, contendo os dados requisitados, segundo o Layout
do Arquivo XML, descrito neste manual.

O integrador deve estar rodando na mquina que se pretende que atue como
comunicador com o Web Service, ou seja, deve estar conectada internet no momento
da gerao da nota. Este fica verificando o contedo do diretrio padro ou do definido
no Arquivo de Configurao (o tempo de verificao padro de 3 segundos) e, ao
encontrar arquivo XML, ser procedida a transmisso para o Web Service, que ir
retornar a NFS-e ou a crtica, no caso do arquivo estar inconsistente.

O integrador possui mais algumas funes, conforme descrito em Funes da

Interface.

Neste formato, a NFS-e ser devolvida na hora para a mquina onde estiver
rodando o integrador e informaes como data de emisso, nmero da NFS-e, hora de
emisso, entre outras, sero automaticamente geradas.

2.2 Web Service puro com NFS-e on-line

O sistema de gesto utilizado pelo emissor da NFS-e dever, no momento da

finalizao da digitao dos dados necessrios gerao da NFS-e, transmitir para as
URLs determinadas o login, senha, cdigo da cidade (Receita Federal) e o arquivo no
Layout do Arquivo XML descrito neste manual, por mtodo Post.

O Web Service ir ento processar os posts enviados e devolver o retorno no

navegador.

Neste formato, a NFS-e ser devolvida para o browser que fizer o post no Web
Service.

As URLs do Web Service, os parmetros e exemplos estaro definidos em Web

Service, neste manual.

3. ARQUIVO DE RETORNO
Todas as formas de integrao iro gerar um retorno no formato XML com as
seguintes tags:

TAG Domnio Descrio

<retorno> Agrupador Dados do retorno
<mensagem> Agrupador Dados da mensagem
[Nmero do Erro] [Descrio do Erro] pode
acontecer tantas vezes quantas forem
nescessrias, o nmero do erro sempre
<codigo> Texto ser de cinco posies.
</codigo> Fecha tag
</mensagem> Fecha tag
Nmero da Nota Fiscal de Servios
<numero_nfse> Numrico Eletrnica
</numero_nfse> Fecha tag
<serie_nfse> Numrico Srie da Nota Fiscal de Servios Eletrnica
</serie_nfse> Fecha tag
Data de emisso da Nota Fiscal de Servios
<data_nfse> Texto Eletrnica
</data_nfse> Fecha tag
Hora de emisso da Nota Fiscal de Servios
<hora_nfse> Texto Eletrnica
</hora_nfse> Fecha tag
Cdigo da situao da NFS-e (1-Emitida,
<situacao_codigo_nfse> Numrico 2-Cancelada)
</situacao_codigo_nfse> Fecha tag
Descrio da situao da NFS-e
<situacao_descricao_nfse> Texto (Emitida/Cancelada)
</situacao_descricao_nfse> Fecha tag
Arquivo gerador da Nota Fiscal de Servios
<arquivo_gerador_nfse> Texto Eletrnica
</arquivo_gerador_nfse> Fecha tag
<nome_arquivo_gerado_eletron> Texto Nome do arquivo recebido no Datacenter
</nome_arquivo_gerado_eletron> Fecha tag
Link para a Nota Fiscal de Servios
<link_nfse> Texto Eletrnica
</link_nfse> Fecha tag
[Cdigo verificador da autenticidade da
NFSe], para armazenamento no bd do
contribuinte, somente existir se o retorno
<cod_verificador_autenticidade> Texto da operao for sucesso

</cod_verificador_autenticidade> Fecha tag

Cdigo HTML da Nota Fiscal de Servios
<codigo_html> html Eletrnica
</codigo_html> Fecha tag
</retorno> Fecha tag
4. ARQUIVO DE CONFIGURAO
Na execuo do integrador, ser criado arquivo de configurao e deve ser
alterado quando o uso das configuraes padro no for possvel. Este arquivo ser
criado dentro do mesmo diretrio do executvel, com o nome de config_nfse.ini. A
seguir, discriminado o seu contedo:

[NFSe]

{Diretrio onde o integrador ir ler os arquivos XML com o contedo das notas}:

entrada=C:\eletron\temp

{Diretrio onde o integrador ir gravar os retornos XML}

Retorno=C:\eletron\retorno

{Endereo Web Service}

url_send=http://sync.nfs-e.net/datacenter/include/nfw/importa_nfw/nfw_import_upload.php
url_view=http://sync.nfs-e.net/datacenter/include/nfw/importa_nfw/nfw_import_view_nf.php
url_login=http://sync.nfs-e.net/datacenter/include/nfw/importa_nfw/nfw_import_login.php

{Intervalo de tempo de verificao do contedo do diretrio de entrada}

interval=5000

As informaes preenchidas acima j so padres para o uso do integrador.

5. WEB SERVICE
Para que o formato do retorno seja em xml utilize a url abaixo:
http://sync.nfs-e.net/datacenter/include/nfw/importa_nfw/nfw_import_upload.php?eletron=1

Para que o formato do retorno seja em html utilize a url abaixo:

http://sync.nfs-e.net/datacenter/include/nfw/importa_nfw/nfw_import_upload.php
 Parmetros do post:
campo Tipo Descrio

login Text CPF/CNPJ, sem separadores

alfanumricos.

senha Password Senha de acesso ao sistema:

www.nfs-e.net

cidade Text Cdigo da cidade na receita federal.

Ex.: Brusque 8055.

f1 File Contedo do xml da NFS-e com os

dados da nota.

5.1 Consulta de NFS-e via Web Service

Para efetuar a respectiva consulta, o arquivo xml dever conter a seguinte

estrutura:

Layout do arquivo de consulta

TAG Domnio Tamanho Descrio

<nfse> Agrupador - Dados de consulta da NFS-e
<pesquisa> Agrupador - Detalhamento de pesquisa da
NFS-e
<codigo_autenticidade> Texto 16 Cdigo de autenticidade da
NFS-e
</cdigo_autenticidade> Fecha tag -
<numero> Numrico 9 Nmero da NFS-e
</numero> Fecha tag -
<serie> Numrico 1 Srie da NFS-e
</serie> Fecha tag -
<cadastro> Numrico 9 Cadastro econmico do
prestador de servio
</cadastro> Fecha tag -
</pesquisa> Fecha tag -
</nfse> Fecha tag -
 O arquivo xml de consulta da NFS-e poder conter somente a tag
<codigo_autenticidade> ou ento a consulta poder ser feita pelas tags <numero>
<serie> e <cadastro> tornando obrigatrio o preenchimento das mesmas.

5.2 Consulta de NFS-e via Web Service

Devem estar desbloqueados todos os endereos subordinados http://www.nfs-

e.net

5.3 Funes da Interface

Funes encontradas na interface do integrador para uso, quando utilizadas as

formas de integrao Integrador desktop com NFS-e on-line:

: abre a Nota Fiscal de Servios Eletrnica em vdeo;

: visualiza o contedo do arquivo XML;

 : mostra status do envio;

: faz o download do arquivo originalmente enviado e o de retorno (XML);

: envia e-mail com link para a NFS-e;

Ocultar: oculta o integrador na barra de tarefas;

Fechar: encerra o integrador.

6. LAYOUT DO ARQUIVO XML

Existe um tipo de arquivo XML que pode ser gerado para o integrador ou para o
Web Service puro, que o de regime de emisso on-line:

Integrador desktop com NFS-e on-line: Arquivo tipo1;

Web Service puro com NFS-e on-line: Arquivo tipo1;

LEMBRETE:

Uma nota por xml;

Ateno para a lista de caracteres no aceitos;

Incorretos Substituir por:

< &lt;

> &gt;

&apos;

&quot;

/ No permitido

& &amp;

As tags que constam em vermelho abaixo so obrigatrias.

A informao, quando do tipo real, deve usar como separador de decimais a vrgula. Para
separador de milhar, no necessrio nenhum separador, mas pode ser utilizado o ponto.
6.1 Layout arquivo tipo 1
TAG
<nfse>
<identificador>
</identificador>
<rps>
<nro_recibo_provisorio>
</nro_recibo_provisorio>
<serie_recibo_provisorio>
</serie_recibo_provisorio>
<data_emissao_recibo_provisorio>
</data_emissao_recibo_provisorio>
<hora_emissao_recibo_provisorio>
</hora_emissao_recibo_provisorio>
</rps>
<nf>
<numero>
Domnio Tamanho Descrio
Dados da NFS-e.(Caso o municpio
exija que a nfs-e seja assinada
digitalmente, dever ento ser utilizada
a informao id=nota Ex:<nfse
Agrupador - id=nota>
Utilizado para identificao do arquivo
a ser processado, arquivos com mesmo
identificador no sero processados
mais de uma vez, indiferente se o
restante dos dados so correspondentes
a uma nova NFS-e. Se a tag estiver
informada no arquivo a mesma se torna
Alfa 80 obrigatria.
Fecha tag -
Informaes referentes ao recibo
provisrio de servio. Somente poder
constar no arquivo quando o municpio
autorizar sua utilizao. (verificar
legislao municipal). As tag's somente
devero ser utilizadas, quando houver a
real necessidade da converso de um
Agrupador - recibo (RPS) em NFS-e.
Informar o nmero do recibo provisrio
Numrico 9 de servio.
Fecha tag -
Informar o cdigo da srie do recibo
Numrico 2 provisrio de servio.
Fecha tag -
Data em que foi emitido o recibo
Texto 10 provisrio de servio. Ex: 26/11/2013
Fecha tag -
Horrio em que foi emitido o recibo
Texto 8 provisrio de servio. Ex: 13:30:05
Fecha tag -
Fecha tag -
Agrupador - Dados gerais da NFS-e.
Nmero da NFS-e somente dever ser
preenchido, quando for utilizar a rotina
Numrico 9 de cancelamento.
 </numero> Fecha tag -
Dever ser preenchido somente para
utilizar o cancelamento da NFS-e,
<situacao> Alfa 1 informar como C
</situacao> Fecha tag -
<valor_total> Real 15 Valor Total da NFS-e.
</valor_total> Fecha tag -
Valor do Desconto. Este valor no
afetar a base de clculo do imposto,
<valor_desconto> Real 15 apenas assinala na nota.
</valor_desconto> Fecha tag -
Valor do Imposto de Renda Retido. Este
valor no afetar a base de clculo do
<valor_ir> Real 15 imposto, apenas assinala na nota.
</valor_ir> Fecha tag -
Valor do INSS. Este valor no afetar a
base de clculo do imposto, apenas
<valor_inss> Real 15 assinala na nota.
</valor_inss> Fecha tag -
Valor da Contribuio Social. Este valor
no afetar a base de clculo do
<valor_contribuicao_social> Real 15 imposto, apenas assinala na nota.
</valor_contribuicao_social> Fecha tag -
Valor do RPS(Retenes da Previdncia
Social). Este valor no afetar a base de
clculo do imposto, apenas assinala na
<valor_rps> Real 15 nota.
</valor_rps> Fecha tag -
Valor do PIS. Este valor no afetar a
base de clculo do imposto, apenas
<valor_pis> Real 15 assinala na nota.
</valor_pis> Fecha tag -
Valor do COFINS. Este valor no
afetar a base de clculo do imposto,
<valor_cofins> Real 15 apenas assinala na nota.
</valor_cofins> Fecha tag -
Observaes da NFS-e, tambm
utilizado para informar o motivo de
<observacao> Alfa 1000 cancelamento da NFS-e.
</observacao> Fecha tag -
</nf> Fecha tag -
<prestador> Agrupador - Dados do Prestador (emissor da nota).
 CPF/CNPJ do emissor da nota, sem
<cpfcnpj> Numrico 14 formatao nenhuma.
</cpfcnpj> Fecha tag -
Cdigo da cidade onde o emissor est
estabelecido, junto Receita Federal
(eles chamam de codigotom). Ex.:
<cidade> Numrico 9 Brusque 8055
</cidade> Fecha tag -
</prestador> Fecha tag -
Dados do Tomador dos Servios,
<tomador> Agrupador - recebedor da nota.
Quando for do interesse que o endereo
do tomador do servio seja o informado
no arquivo xml, utilizar esta tag. Sujeito
a disponibilidade pelo municpio. S ou 1
<endereco_informado> Alfa 1 SIM, N ou 0 NO.
</endereco_informado> Fecha tag -
Tipo da pessoa J - Jurdica, F - Fsica ou
<tipo> Caractere 1 E - Estrangeiro.
</tipo> Fecha tag -
Nmero do carto de identificao
<identificador> Numrico 20 estrangeira ou passaporte.
</identificador> Fecha tag -
Informar o estado de origem do
tomador.
OBS: Somente informar quando o tipo
<estado> Alfa 100 do tomador for E (estrangeiro).
</estado> Fecha tag -
Informar o pas de origem do tomador.
OBS: Somente informar quando o tipo
<pais> Alfa 100 do tomador for E (estrangeiro).
</pais> Fecha tag -
CPF/CNPJ do Tomador do(s)
<cpfcnpj> Numrico 14 Servio(s).
</cpfcnpj> Fecha tag -
Inscrio Estadual do Tomador do(s)
<ie> Alfa 16 Servio(s).
</ie> Fecha tag -
<nome_razao_social> Alfa 100 Nome do Tomador do(s) Servio(s).
</nome_razao_social> Fecha tag -
Sobrenome ou Nome Fantasia do
<sobrenome_nome_fantasia> Alfa 100 Tomador do(s) Servio(s).
</sobrenome_nome_fantasia> Fecha tag -
 Logradouro do endereo do
estabelecimento ou residncia do
<logradouro> Alfa 70 Tomador do(s) Servio(s).
</logradouro> Fecha tag -
Quando necessrio informar mais de um
email para o Tomador do(s) Servio(s)
os mesmos devero ser separados por
<email> Alfa 100 (,)ou (;)
</email> Fecha tag -
Nmero do endereo do
estabelecimento ou residncia do
<numero_residencia> Alfa 8 Tomador do(s) Servio(s).
</numero_residencia> Fecha tag -
Complemento do endereo do
estabelecimento ou residncia do
<complemento> Alfa 50 Tomador do(s) Servio(s).
</complemento> Fecha tag -
Ponto de referncia do endereo do
estabelecimento ou residncia do
<ponto_referencia> Alfa 100 Tomador do(s) Servio(s).
</ponto_referencia> Fecha tag -
Bairro do endereo do estabelecimento
ou residncia do Tomador do(s)
<bairro> Alfa 30 Servio(s).
</bairro> Fecha tag -
Cdigo da cidade do endereo do
estabelecimento ou residncia do
Tomador do(s) Servio(s), junto
Receita Federal (eles chamam de
codigotom). Ex.: Brusque 8055.
OBS: Quando o tipo do tomador for
Estrangeiro, o campo cidade deve ser
preenchido com o nome da cidade
<cidade> Numrico 9 (mximo 100 caracteres).
</cidade> Fecha tag -
CEP do endereo do estabelecimento ou
<cep> Alfa 8 residncia do Tomador do(s) Servio(s).
</cep> Fecha tag -
Cdigo de rea do telefone do
estabelecimento do Tomador do(s)
<ddd_fone_comercial> Numrico 3 Servio(s).
</ddd_fone_comercial> Fecha tag -
Telefone do estabelecimento do
<fone_comercial> Numrico 9 Tomador do(s) Servio(s).
 </fone_comercial> Fecha tag -
Cdigo de rea do telefone residencial
<ddd_fone_residencial> Numrico 3 do Tomador do(s) Servio(s).
</ddd_fone_residencial> Fecha tag -
Telefone residencial do Tomador do(s)
<fone_residencial> Numrico 9 Servio(s).
</fone_residencial> Fecha tag -
Cdigo de rea do fax do Tomador do(s)
<ddd_fax> Numrico 3 Servio(s).
</ddd_fax> Fecha tag -
Nmero do fax do Tomador do(s)
<fone_fax> Numrico 9 Servio(s).
</fone_fax> Fecha tag -
</tomador> Fecha tag -
<itens> Agrupador - Itens da Nota Fiscal.
Itens da Nota Fiscal - ir acontecer
tantas vezes quantos forem os itens da
<lista> Agrupador - NFS-e.
Esta tag serve para informar onde ser
recolhido o imposto e deve ser
preenchida com "0" ou "N" quando
NO TRIBUTAR P/ PRESTADOR e
"1" ou "S" quando TRIBUTAR P/
<tributa_municipio_prestador> Alfa 1 PRESTADOR.

</tributa_municipio_prestador> Fecha tag -

Cdigo da cidade onde o servio foi
prestado, junto Receita Federal (eles
chamam de codigotom). Ex.: Brusque
<codigo_local_prestacao_servico> Numrico 9 8055.

</codigo_local_prestacao_servico> Fecha tag -

Cdigo das unidades de servios pr
cadastradas.
OBS: Cdigo sobre variaes de
Prefeitura para Prefeitura. O campo
torna-se obrigatrio a partir do momento
em que o Municpio utiliza esta
<unidade_codigo> Numrico 9 configurao.

</unidade_codigo> Fecha tag -


<unidade_quantidade>
Quantidade dos servios prestados,
relativo a unidade informada.
OBS: Campo torna-se obrigatrio a
partir do momento em que o Municpio
Real 15 utiliza esta configurao.

</unidade_quantidade> Fecha tag -

<unidade_valor_unitario>
Valor unitrio do servio, referente a
unidade informada.
OBS: Campo torna-se obrigatrio a
partir do momento em que o Municpio
Real 15 utiliza esta configurao.

</unidade_valor_unitario> Fecha tag -

Cdigo do subitem da lista de servios,
em conformidade com a Lei
<codigo_item_lista_servico> Numrico 9 Complementar 116/2003.
</codigo_item_lista_servico> Fecha tag -
Descritivo coloquial do servio
<descritivo> Alfa 1000 prestado.
</descritivo> Fecha tag -
Alquota que ir incidir sobre a base de
clculo. Esta alquota ser consistida de
acordo com a legislao do municpio.
ATENO: caso seja informada
incorretamente, o software rejeitar a
nota. Caso estiver em branco, o software
ir preencher sozinho. Caso o emissor
estiver enquadrado no simples nacional
e a alquota estiver em branco, o sistema
preencher com a alquota mxima de
<aliquota_item_lista_servico> Real 15 5%.
</aliquota_item_lista_servico> Fecha tag -
 Cdigo da Situao Tributria. Este
cdigo caracterizar de que forma ser
cobrado o ISS. Aqui, podem ocorrer as
codificaes:
0 - Tributada Integralmente: o valor do
imposto ser lanado para o emissor da
nota.
1 - Tributada Integralmente com ISSRF:
o valor do imposto no ser lanado,
pois ser recolhido pelo tomador, caso
seja rgo pblico municipal.
2 - Tributada Integralmente e sujeita
Substituio Tributria: o valor do
imposto no ser lanado, pois ser
recolhido pelo tomador (substituto
tributrio), caso no seja um rgo
pblico municipal.
3 - Tributada com reduo da base de
clculo: o valor do imposto ser lanado
para o emissor da nota, porm, na
apurao da base de clculo, ser
descontado o valor da tag
<valor_deducao> (esta situao
tributria somente se aplica, caso o
servio consignado seja o de cdigo
1705).
4 - Tributada com reduo da base de
clculo com ISSRF: o valor do imposto
no ser lanado, pois ser recolhido
pelo tomador, caso seja rgo pblico
municipal, porm na apurao da base
de clculo ser descontado o valor da
tag <valor_deducao> (esta situao
tributria somente se aplica, caso o
servio consignado seja o de cdigo
1705).
5 - Tributada com reduo da base de
clculo e sujeita Substituio
Tributria: o valor do imposto no ser
lanado, pois ser recolhido pelo
tomador, caso no seja um rgo
pblico municipal, porm na apurao
da base de clculo ser descontado o
valor da tag <valor_deducao> (esta
<situacao_tributaria> Numrico 4 situao tributria somente se aplica,
 caso o servio consignado seja o de
cdigo 1705).
6 - Isenta: no ir gerar valor de
imposto, pois o prestador isento.
7 - Imune: no ir gerar valor do
imposto, pois o prestador imune.
8 - No Tributada - ISS regime Fixo:
no ir influenciar no clculo do
imposto, pois o valor previamente
calculado.
9 - No Tributada - ISS regime
Estimativa: no ir influenciar no
clculo do imposto, pois o valor
previamente estimado.
10 - No Tributada - ISS Construo
Civil recolhido antecipadamente: no ir
gerar valor de imposto, pois foi
recolhido antecipadamente (esta
situao tributria somente se aplica,
caso os servios consignados sejam os
de cdigo 1701, 1702, 1703, 1705,
1719).
15- No Tributada - Ato Cooperado:
no ir gerar valor do imposto, pois a
prestao de servio para cooperados
no est sujeita ao ISS; porm, mesmo
que cooperativa e caso o servio seja
prestado para um no cooperado, deve-
se utilizar das outras situaes
tributrias, de acordo com o caso.
</situacao_tributaria> Fecha tag -
Valor do item que servir de base de
clculo para o imposto, com a deduo
aplicada, se a situao tributria
<valor_tributavel> Real 15 permitir.
</valor_tributavel> Fecha tag -
Valor da deduo, quando houver e se a
<valor_deducao> Real 15 situao tributria permitir.
</valor_deducao> Fecha tag -
Valor do ISS Retido na Fonte, quando
houver e se a situao tributria
<valor_issrf> Real 15 permitir.
</valor_issrf> Fecha tag -
</lista> Fecha tag -
 </itens> Fecha tag -
Item para livre manuseio. Coloca-se o
que desejar que saia na nota. Acontecer
tantas vezes quantas forem as subtags
relacionadas, logicamente limitado pelo
<genericos> Agrupador - espao fsico.
<linha> Agrupador -
<titulo> Alfa 50 Ttulo do campo livre.
</titulo> Fecha tag -
<descricao> Alta 200 Contedo do campo livre.
</descricao> Fecha tag -
</linha> Fecha tag -
</genericos> Fecha tag -
<produtos> Agrupador - Produtos relacionados na NFS-e.
Tudo que se quer que saia na nota a
respeito dos produtos (quantidade,
desconto, etc.), lembrando que esta deve
<descricao> Alfa 200 ser agrupada de todos os produtos.
</descricao> Fecha tag -
<valor> Real 15 Soma do valor dos produtos da NFS-e.
</valor> Fecha tag -
</produtos> Fecha tag -
</nfse> Fecha tag -

Sendo informado a tag <identificador>, porm, caso a mesma j tenha sido

utilizada para gerao de outra NFS-e, o arquivo de retorno ir conter as informaes da
respectiva NFS-e gerada.

6.2 Utilizando Assinatura Digital (verificar obrigatoriedade com o municpio)

As tags referentes a assinatura digital devero ser inseridas antes do fechamento

da tag </nfs-e>. O padro de assinatura XML utilizado o W3C, maiores informaes
podero ser consultadas no link: http://www.w3.org/TR/xmldsig-core/.

Exemplos de XML utilizando-se da assinatura digital podem ser consultados no

link https://www.nfs-e.net no menu da opo XML.

Quando da adeso de utilizao de Assinatura Digital por parte do Municpio, os

xmls de emisso bem como o de cancelamento da NFS-e devem estar assinados
digitalmente.
6.3 Notas Fiscais conjugadas e Cupons Fiscais conjugados

Para o uso desses dois tipos de documentos fiscais, o contribuinte precisa ter
autorizao especfica da Prefeitura, que concedida em conjunto com o Estado.

Se este tipo de documento for transcrito para Nota Fiscal de Servio Eletrnica,
deve-se gerar o arquivo XML para a Prefeitura, INDEPENDENTE de qualquer
integrao ou arquivo para o Estado (para este, deve-se seguir as regras prprias).

Ento haver duas numeraes, uma para o Estado e uma para a Prefeitura. Caso
o sistema de gesto do contribuinte permita, pode-se manter a mesma numerao, mas
legalmente so dois documentos fiscais distintos.

7. RETORNO DE ERROS/REGRAS DE VALIDAO DE

DADOS MAIS COMUNS
As excees que sero retornadas pelo Web Service sero as seguintes:
Sucesso

[1] Sucesso

Valida o Usurio

[131] No foi possvel validar o usurio logado!

[132] Usurio ou Senha invlidos!

[133] Usurio informado encontra-se desativado.

[134] Usurio informado no cadastrado como contribuinte (dc.unico).

[135] Usurio informado no cadastrado como econmico (is.economico).

[136] Cdigo da cidade do contribuinte informado no encontrado no cadastro

(dc.unico.codmun).
 [144] Login informado deve conter apenas nmeros.

[145] No foi possvel estabelecer uma conexo com o link informado.

Valida Privilgio do Usurio

[137] Usurio informado sem privilgio para acessar o mdulo de emisso de NFSe.

Valida Autorizao de Emisso de NFS-e

[138] Usurio informado sem permisso para acessar o mdulo de emisso de NFSe.

[139] Cadastro informado sem autorizao para emisso de NFSe.

Valida o Prestador do Servio

[2] CPF/CNPJ do Prestador no informado no XML.

[3] CPF/CNPJ do prestador no vlido.

[4] Prestador no cadastrado como Econmico.

[5] Usurio logado diferente do prestador informado e no existe relacionamento

contador/cliente entre ambos.

[6] Prestador informado encontra-se baixado.

[111] Prestador informado no cadastrado no nico.

[245] Contador no autorizado a emitir NFS-e pelo Econmico.

Valida a Cidade do Prestador

[7] Cidade do prestador no informada no arquivo XML.

[8] Cidade do prestador informado no um cdigo vlido.

[9] Cidade do prestador informado no encontra-se cadastrada na base de dados do

datacenter.

Valida Solicitao de Impresso de NFS-e

[10] Solicitao de emisso para NFSe no encontrada.

Valida Tomador de Servio

[11] Tipo do tomador ("F" - Fsica ou "J" Jurdica ou "E" - Estrangeiro) est ausente
no arquivo XML.

[12] Tipo do tomador foi preenchido incorretamente, utilize apenas "F" ou "J" ou "E".

[13] CNPJ do tomador est ausente no arquivo XML e o tipo est setado como "J"
(Pessoa Jurdica).

[14] CNPJ do tomador informado est preenchido incorretamente.

[176] As configuraes do respectivo cliente exigem que o campo CPF/CNPJ do

tomador seja informado.

[190] Para usar TIRF ou TIST necessrio que seja informado um tomador do servio.

[191] Tomador e Prestador do servio no podem ser iguais.

[195] O CEP da cidade do tomador do servio deve possuir 8 dgitos.

[228] O municpio no contm configuraes para utilizar o cadastro alternativo de

endereos para o tomador de servio da NFSe.

[229] O Tomador do servio possui cadastro econmico no municpio. No possvel

inserir um novo endereo.

[230] O DDD Comercial do Tomador de servio contm mais que 3 caracteres.

[231] O DDD Residencial do Tomador de servio contm mais que 3 caracteres.

[232] O DDD do Fax do Tomador de servio contm mais que 3 caracteres.

[233] O Fone Comercial do Tomador de servio contm mais que 9 caracteres.

 [234] O Fone Residencial do Tomador de servio contm mais que 9 caracteres.

[235] O Fone Fax do Tomador de servio contm mais que 9 caracteres.

[236] O novo endereo do tomador igual ao endereo j cadastrado no nico. Altere a

tag "endereco_informado.

[237] A opo de "Cadastro de Novos Endereos para Tomadores de Servio", no est

disponvel para tomadores do tipo estrangeiro.

[238] O logradouro informado para o endereo do tomador do servio, no consta

cadastrado na base de dados.

[239] O bairro informado para o endereo do tomador do servio, no consta cadastrado

na base de dados.

[240] Erro na tentativa de inserir na tabela "dcarq.wm_endereco_tomador".

[241] Nmero da residncia do tomador do servio no pode conter mais que 8

caracteres.

Inserindo novo Tomador do Servio

[15] Tipo (Jurdica ou Fsica) do tomador no definido no arquivo XML.

[16] CPF/CNPJ do tomador no definido no arquivo XML.

[17] CPF/CNPJ do tomador no um CPF/CNPJ vlido.

[18] CPF do tomador no um CPF vlido.

[19] CNPJ do tomador no um CNPJ vlido.

[20] Nome/razo social do tomador no definido no arquivo XML.

[21] Endereo (logradouro) do tomador no definido no arquivo XML.

[22] Cdigo da cidade do tomador no definido no arquivo XML.

[23] Cdigo da cidade do tomador no um cdigo vlido.

[24] Cidade do tomador no cadastrada na base de dados do datacenter.

 [25] Erro na tentativa de gravar na monitora (Novo cadastro tomador).

[164] O tipo do tomador foi declarado com "E" (Estrangeiro) porm o

IDENTIFICADOR no foi informado.

[165] Para utilizar um Tomador estrangeiro necessrio informar os campos

identificador, nome_razao_social, logradouro, cidade, estado e pais.

[171] O Nome do Tomador deve ser informado de maneira composta (Nome +

Sobrenome).

[174] No possvel inserir um tomador de servio estrangeiro utilizando como pas o

Brasil.

[196] Bairro do tomador no definido no arquivo XML.

[197] Nome/razo social do tomador invalido no arquivo XML.

[198] Endereo (logradouro) do tomador invalido no arquivo XML.

[199] Bairro do tomador invalido no arquivo XML.

[200] Email(s) informado para o tomador invlido.

[242] Erro na tentativa de inserir um registro na tabela nfw_tomadores_favoritos.

Valores da NFS-e

[26] O valor total da NFSe no foi declarado corretamente.

[27] O valor total da NFSe no pode ser zero (0,00).

[28] O valor do desconto no pode ser superior ao valor total da NFSe.

[29] A soma do valor do IR + INSS + Contribuio Social no pode ser superior ao

valor total da NFSe.

Itens da NFS-e

[30] Nenhum cdigo da lista de servio foi informado.

 [31] Cdigo do item da lista de servio est preenchido incorretamente.

[32] Cdigo do local da prestao de servio est preenchido incorretamente.

[33] Descritivo do servio prestado no foi preenchido.

[34] Alquota do servio prestado no foi preenchida corretamente.

[35] Situao tributria do servio prestado no foi preenchida corretamente.

[36] Valor tributvel do servio prestado no foi est preenchido corretamente.

[37] Valor tributvel do servio prestado no pode ser zerado.

[38] Valor da deduo do servio prestado no est preenchido corretamente.

[39] Valor do ISSRF para o servio prestado no est preenchido corretamente.

[40] Os cdigos da lista de servio no podem ser repetidos.

[41] Econmico (Prestador do servio) no encontrado [sql - atividade].

[42] No existe relacionamento entre as atividades e a lista de servio do prestador.

[43] Cdigo da lista de servio ausente.

[44] Cdigo da lista de servio no um nmero vlido.

[45] Cdigo da lista de servio sem relacionado com a tabela iss.atiser para o prestador
do servio informado.

[46] Cdigo da lista de servio no encontrado [iss.listserv].

[47] Nenhuma cidade (local da prestao do servio) foi informada.

[48] Cdigo do local da prestao do servio ausente.

[49] Cdigo do local da prestao do servio no um cdigo vlido.

[50] Nenhuma "descrio" do servio realizado foi informado.

[51] Descrio do servio realizado no foi informado para o item da lista

correspondente.

[52] Nenhum "valor tributvel" do servio realizado foi informado.

 [53] Valor do ISSRF superior ao valor tributvel.

[54] Valor da deduo superior ao valor tributvel.

[55] Valor da soma (DEDUO + ISSRF) superior ao valor tributvel.

[56] Soma dos valores tributveis no pode ser zero("0").

[57] Soma dos valores tributveis no pode ser superior ao valor total da NFSe.

[58] Nenhuma "situao tributria" foi informada.

[59] Cdigo da situao tributria est ausente.

[60] Cdigo da situao tributria no est preenchido corretamente.

[61] Cdigo da situao tributria utilizado no item da lista invlido.

[62] A situao tributria TI (tributado integralmente), porm foi informado um valor

para o ISSRF.

[63] A situao tributria TI (tributado integralmente), porm foi informado um valor

para deduo.

[64] O servio foi declarado como TIRF, porm foi informado um valor para deduo.

[65] A situao tributria do servio TIRF, porm o valor do ISSRF no foi

informado.

[66] A situao tributria do servio TIRF, porm o valor do ISSRF no foi informado
corretamente.

[67] A situao tributria do servio TIRF, porm o valor do ISSRF foi declarado
como zero (0,00).

[68] O servio foi declarado como TIST, porm foi informado um valor para deduo.

[69] A situao tributria do servio TIST, porm o valor do ISSRF no foi

informado.

[70] A situao tributria do servio TIST, porm o valor do ISSRF invlido.

[71] A situao tributria do servio TIST, porm o valor do ISSRF foi declarado
como zero (0,00).

[72] A situao tributria do servio TRBC (Tributada com reduo da base de

clculo), porm foi informado um valor para o ISSRF.

[73] O valor da deduo para o servio invlido.

[74] O valor tributvel para o servio invlido.

[75] O valor tributvel do servio no pode ser menor que o valor da deduo.

[76] O valor da deduo para o servio s tem validade quando o cdigo do servio for
1705.

[77] A situao tributria do servio TRBCRF, porm o valor do ISSRF no foi

informado.

[78] A situao tributria do servio TRBCRF, porm o valor do ISSRF invlido.

[79] A situao tributria do servio TRBCRF, porm o valor do ISSRF foi declarado
como zero (0,00).

[80] A situao tributria do servio TRBCST, porm o valor do ISSRF no foi

informado.

[81] A situao tributria do servio TRBCST, porm o valor do ISSRF invlido.

[82] A situao tributria do servio TRBCST, porm o valor do ISSRF foi declarado
como zero (0,00).

[83] O servio foi declarado como ISE (ISENTO), porm foi informado uma deduo
para o item.

[84] O servio foi declarado como ISE (ISENTO), porm foi informado um valor para o
ISSRF.

[85] O servio foi declarado como IMU (IMUNE), porm foi informado uma deduo
para o item.

[86] O servio foi declarado como IMU (IMUNE), porm foi informado um valor para
o ISSRF.

[87] O servio foi declarado como NTIFx (ISS regime Fixo), porm foi informado uma
deduo para o item.

[88] O servio foi declarado como NTIFx (ISS regime Fixo), porm foi informado um
valor para o ISSRF.

[89] O servio foi declarado como NTIEs (ISS regime Estimativa), porm foi informado
um valor para a deduo.

[90] O servio foi declarado como NTIEs (ISS regime Estimativa), porm foi informado
um valor para o ISSRF.

[91] O servio foi declarado como NTICc (ISS Construo Civil), porm foi informado
um valor para deduo.

[92] O servio foi declarado como NTICc (ISS Construo Civil), porm foi informado
um valor para o ISSRF.

[93] O servio foi declarado como NTAC (Ato Cooperado), porm foi informado um
valor para deduo.

[94] O servio foi declarado como NTAC (Ato Cooperado), porm foi informado um
valor para o ISSRF.

[95] Situao tributria sem relacionamento definido.

[113] Soma dos valores tributveis no pode ser menor que o valor total da NFSe [Ver
configurado principal->valida_reducao_base_calculo].

[114] Soma dos valores tributveis no pode ser menor que o valor total da NFSe
(Configurado).

[115] Soma dos valores tributveis no pode ser menor que o valor total da NFSe
(Configurado).

[127] Cdigo do local da prestao do servio no foi encontrado na base de dados.

[128] Alquota do item da lista de servio enviada diferente das alquotas do SUPER
SIMPLES.

[129] Alquota enviada diferente da alquota do item da lista de servio cadastrada.

[130] Nenhum item da lista de servio foi encontrado contendo o cdigo enviado.
 [141] Cdigo de Autenticidade ausente no retorno do envio do arquivo.

[142] NFSe no encontrada na tabela nfe.

[143] Erro na tentativa de inserir o registro na tabela wm_import_nfe.

[158] Alquota do Local da Prestao do servio no encontrada ou zerada.

[159] Alquota enviada no pode ser inferior a 2% nem superior a 5%.

[163] Servio duplicado para a mesma cidade.

[166] Para utilizar Unidade de Servio nos tens dos servios necessrio informar os
campos unidade_codigo, unidade_quantidade e unidade_valor_unitario.

[167] A UNIDADE DO SERVIO correspondente ao cdigo informado no foi

encontrada na tb.nf.unidade_servico.

[168] A quantidade da UNIDADE DO SERVIO no foi informada corretamente.

[169] O valor unitrio da UNIDADE DO SERVIO no foi informado corretamente.

[170] O valor tributvel do tem do servio diferente da multiplicao da

QUANTIDADE DA UNIDADE com o VALOR DA UNIDADE.

[172] O Servio foi declarado como NTRIB, porm o cadastro econmico no possui
permisso para declarar utilizando essa Situao Tributria.

[175] tem declarado como TIST,TIRF,TRBCRF ou TRBCST porm o valor do ISSRF

no compatvel com o valor calculado (Valor Tributvel X Alquota).

[177] O servio foi declarado como NTICc (ISS Construo Civil), porm o cadastro
econmico do prestador no esta enquadrado para utilizar esta situao tributria.

[178] O Cdigo da lista de servio informado s pode ser utilizado com as situaes
tributrias TRBC, TRBCRF, ou TRBCST quando houver relacionamento entre os mesmos
previamente autorizado pela prefeitura.

[201] O item da lista de servio no permite substituio tributria.

[243] O CEI informado no possue autorizao para ser integrado com a NFSe.
 Gravao da NFS-e

[101] A NFSe no encontra-se declarada, impossibilitando o cancelamento.

[107] Erro na tentativa de inserir na tb nfe.nfeitem.

[112] Erro na tentativa de gravar novo tomador de servio.

[116] Erro na tentativa de gravar na tabela NFSe.

[173] A base de dados atual j contm uma importao com o respectivo nome de
arquivo.

[192] Erro na tentativa de realizar o update na tabela nf.wm_credito_iptu.

[193] O desconto no deve ser menor que zero.

[246] Contribuinte, a emisso de NFS-e est temporariamente bloqueada, para efetuar a

liberao proceda com a protocolao da(s) competncia(s) no Software Escrita Fiscal.

[248] necessrio informar ao menos 5 caracteres na Tag Observao.

[251] A soma do valor lquido no pode ser negativa.

Lanamento nas tabelas de Escrita Fiscal

[108] NFSe no foi inserida no software de Escrita Fiscal.

[109] Erro na tentativa de gravar na tabela de monitorao (monitora).

Lanamento nas tabelas do mdulo de NFS-e

[110] Erro na tentativa de inserir o HTML da NFSe.

Cancelamento da NFS-e

[01] Sucesso.

[96] A situao (EMITIDA/CANCELADA) da NFSe no foi informada.

 [97] A situao da NFSe no foi informada corretamente.

[98] O nmero da NFSe no foi informado.

[99] O nmero da NFSe foi informado incorretamente.

[117] A NFSe j encontra-se cancelada.

[118] No necessrio informar a data do cancelamento da NFSe.

[119] No necessrio informar a observaes sobre o cancelamento da NFSe.

[120] A NFSe no pode ser cancelada pois foi gerada via sistema como FORMULRIO
EM BRANCO.

[121] Para cancelar a NFSe acesse o software de ESCRITA FISCAL ou procure a

Prefeitura Municipal do seu municpio.

[122] A NFSe no pode ser cancelada pois a competncia relativa j foi protocolada.

[124] Erro na tentativa de inserir as informaes no Escritra Fiscal.

[126] Erro na tentativa de cancelar a NFSe.

[162] A data limite para o cancelamento da NFSe foi ultrapassada pela data atual.

[194] Ultrapassou a quantidade de dias da emisso para o cancelamento da NFSe.

[217] A NFSe no pode ser cancelada pois ultrapassou o limite de horas configuradas
para o cancelamento.

Validaes Tributa no Municpio do Prestador

[154] Verificar a situao TRIBUTA_MUNICIPIO_PRESTADOR.

[155] Situao indefinida para TRIBUTA_MUNICIPIO_PRESTADOR.

[156] Verificar alquota para TRIBUTA_MUNICIPIO_PRESTADOR.

[157] Situao indefinida para o resgate da alquota

TRIBUTA_MUNICIPIO_PRESTADOR.

[160] A tag TRIBUTA_MUNICIPIO_PRESTADOR no foi preenchida ou foi

preenchida incorretamente.

Validaes de Pesquisa via Web Service

[202] Cdigo da autenticidade no informado no arquivo de pesquisa.

[203] Nmero da NFSe no informado no arquivo de pesquisa.

[204] Srie da NFSe no informado no arquivo de pesquisa.

[205] A tag cadastro no foi informada no arquivo de pesquisa.

[206] Nenhuma NFSe foi encontrada na base de dados utilizando os parametros para
pesquisa informados.

[207] Usurio logado sem permisso para pesquisar essa NFSe (Somente o prestador ou
o contador do respectivo cadastro esto habilitados).

[208] A tag IDENTIFICADOR no foi preenchida corretamente.

[209] J consta uma NFSe para o referido prestador de servio com o mesmo
IDENTIFICADOR de arquivo.

[252] Arquivo temporrio no encontrado no servidor.

Validaes utilizao de RPS Recibo provisrio de servio

[219] A srie do RPS no foi informada.

[220] A srie do RPS informada no arquivo invlida.

[221] A srie do RPS informada no arquivo diferente da srie do RPS utilizada pelo
respectivo municpio.

[244] No foi possvel fazer a converso. Quantidade de dias aps a emisso do RPS
maior que a quantidade de dias limite para converso.

[249] Nmero de RPS fora de sequncia.

[250] Nmero de RPS est cancelado.

 [280] Cidade informada no encontra-se cadastrada na base de dados do datacenter.

[281] Cadastro informado sem autorizao para emisso de NFSe com item zero(0).

Validaes Assinatura Digital (verificar obrigatoriedade com o municpio)

[186] As assinaturas contidas no arquivo no fazem parte da lista dos responsveis pelo
prestador.

[187] No foi encontrada nenhuma assinatura digital no arquivo enviado.

[188] No foi possvel conectar com o TOMCAT para validar a assinatura digital
contida no arquivo enviado.

Validaes para utilizao de forma de pagamento

[268] A forma de pagamento informada no est prevista, informe uma das formas
cadastradas no sistema (1 = vista, 2 = prazo, 3 = Na Apresentao, 4 = Carto de Dbito,
5 = Carto de Crdito).

[269] A forma de pagamento informada exige pelo menos uma parcela com Numero,
Valor e Data de Vencimento.

[270] O somatrio das parcelas informadas no equivale ao valor total da NFS-e.

[271] Nmero da parcela informada invlido.

[272] O valor da parcela deve ser maior que zero.

[273] A data de vencimento da parcela invlida.

[274] A quantidade de parcelas da forma de pagamento no pode ser maior que 24.

[275] H parcelas duplicadas, verifique o nmero das parcelas.

[276] Erro ao inserir parcelas da forma de pagamento.

[277] O nmero da parcela no pode ser maior que 24.

[278] Parcela fora do sequencial, as parcelas da forma de pagamento devem comear

pelo nmero 1 e manter um sequencial de no mximo 24 parcelas.
Quaisquer dvidas ou sugestes devero ser repassadas para o setor de
Atendimento IPM atravs do e-mail atendimento@ipm.com.br ou pelo
telefone (47) 3531-1500.