Você está na página 1de 20

Inteligncia e Tecnologia em Gesto de Negcios

Manual de Importao/Exportao TXT

De Notas Fiscais de Servio eletrnicas

Middleware NF-e Easy v3.1.X

Produto: Manual de converso


Texto para XML usado
no Middleware NFS-e
Easy v3.1.X

Release date: AGO 01, 2014


Inteligncia e Tecnologia em Gesto de Negcios

Sumrio

1. Introduo..............................................................................................................................................3

2. Informaes sobre o arquivo .................................................................................................................3

2.1 Formato do Arquivo .......................................................................................................................3

2.2 Contedo do arquivo .....................................................................................................................3

3. Importao e exportao de dados .......................................................................................................4

3.1 Comunicao..................................................................................................................................4

4. Layout do arquivo ..................................................................................................................................5

4.1 Instrues gerais ............................................................................................................................5

4.2 Informaes sobre cada tipo de grupo/registro ............................................................................5

4.3 Expresses e regras ........................................................................................................................5

4.4 Formato Campo Data, Hora e Valores. ..........................................................................................6

4.5 Formato do arquivo Texto .............................................................................................................6

4.6 Formato TXT modelo ABRASF (V1 e V2) - Resumo dos Campos Abrasf (grupos A M) ...............7

4.7 Arquivos PDF: resumo dos Campos para gerao de RPS ou NFSE em PDF (grupos X W) .........8

4.7.1. Exemplo: Localizao no formulrio para os dados dinmicos .............................................9

4.7.2. Informaes adicionais ....................................................................................................... 10

4.7.3. Exemplo de uma RPS no modelo TXT com vrias linhas de discriminao de servios:..... 12

4.7.4. Identificao do Lote e do RPS em Solues GINFES .......................................................... 13

Outros Sistemas no compatveis com modelo ABRASF ............................................................................ 14

4.8 Modelo Municpio de SP (Tiplan) ................................................................................................ 14

4.8.1. Usando modelo Texto Tiplan - So Paulo ........................................................................... 14

4.8.2. Usando modelo Texto Abrasf.............................................................................................. 15

4.9 Modelo DSF ................................................................................................................................. 16

4.10 Modelo Atende.net ..................................................................................................................... 17

2
Inteligncia e Tecnologia em Gesto de Negcios

1. Introduo
A importao/exportao do registro das Notas Fiscais eletrnicas (NF-e) para arquivos TXT foi concebida
para facilitar o intercmbio de informaes entre o Software Emissor NFS-e e aplicativos de contribuintes
que apenas trabalhem com este tipo de formato de dados.

Por meio da importao possvel a converso dos dados TXT de notas para o Middleware NFS-e Easy.
Este se encarregar da converso, assinatura e posterior transmisso para a respectiva Secretaria de
Fazenda do Municpio.

Por meio da exportao possvel a realizao da cpia das informaes do Software para arquivos TXT,
e caso necessrio, a carga em aplicativo do contribuinte.

Tais arquivos devem atender a um layout pr-definido, apresentado neste documento.

Nomenclatura do documento

Esta imagem significa que existe uma informao explicando uma caracterstica do
sistema, funcionalidade ou norma quanto emisso da Nota Fiscal Eletrnica.

Ao visualizar esta imagem, fique atento, pois descreve uma ao ou caracterstica que
dependendo do analista programar e/ou implementar para obter os melhores resultados.

2. Informaes sobre o arquivo


2.1 Formato do Arquivo
O arquivo tem o formato texto, podendo ser gerado com qualquer nome, a critrio do contribuinte. O
Middleware NFS-e Easy no limita o tamanho do arquivo, entretanto, cada prefeitura poder limitar o
tamanho do arquivo ou a quantidade de RPS contidos no lote. Note que no modelo utilizado pelas
Prefeituras, existindo a rejeio de um RPS, todo o lote ser rejeitado, diferente do modelo estatual (NF-
e) que as processa individualmente.

Caso a equipe de TI da empresa ou do sistema contrato (ERP) utilize os web services para executar as
chamadas para funcionar em um modelo integrado e transparente ao usurio, no obrigatrio gerar o
arquivo texto, apenas passar o contedo do mesmo no parmetro do Web Service e tratar a resposta.

2.2 Contedo do arquivo


No arquivo enviado dever constar o registro de uma ou mais Notas Fiscais de Servio a serem emitidas
por apenas um nico emitente, ou seja, por apenas um CNPJ completo (estabelecimento) por vez. Caso a
empresa possua mais de um estabelecimento, cada um deles dever gerar suas notas de servios em
arquivos separados.

Note que cada GRUPO de informaes (A, B, C...) deve ser gerado em uma linha com uma quebra de linha
ao final da mesma. O caractere de final de linha referido como LF (Line feed, '\n', 0x0A, 10 em decimal)
ou CR (Carriage return, '\r', 0x0D, 13 em decimal).

Exemplo:

3
Inteligncia e Tecnologia em Gesto de Negcios

Em arquivos formato ASCII no Windows usado <CR LF> como nova linha, em Unix <LF> e
Mac OS <CR>. As linguagens possuem semntica como \n, outras apenas chr(10), verifique
na documentao do seu ambiente de desenvolvimento o caractere de quebra de linha.

3. Importao e exportao de dados


A importao de arquivos TXT para o NFS-e Easy realizada utilizando os Web Services disponveis em
um servidor Web, racionalizando recursos para sistemas de gesto das empresas.

Note que em sistemas de gesto cliente servidor, dependendo da arquitetura, pode existir a necessidade
de atualizao em computadores clientes. O modelo usando Web Services, evita a instalao de
componentes tanto no ambiente de desenvolvimento, quanto na liberao do produto, centralizando o
gerenciamento e assinatura em um nico ponto.

3.1 Comunicao
A aplicao NFS-e Easy utiliza comunicao padro http de modo a facilitar a comunicao com Web
Services com o sistema de gesto. O canal seguro, gerenciamento de certificados e assinaturas, elas so
abstradas da rea de desenvolvimento de sua empresa de modo a deixar o modelo mais simples possvel
para utilizao no sistema de gesto, acelerando a integrao, evitando desperdiar energia no
desenvolvimento e manuteno.

Os documentos assinados digitalmente atendem aos principais requisitos de segurana para a realizao
de negcios eletrnicos:
Autenticidade: garante a identidade de todas as partes envolvidas.
Integridade: fidelidade da informao com seu estado original intacto.
Confidencialidade: tcnica para manter a confidencialidade utilizando criptografia
No-repdio: impede as partes de negarem a participao no negcio eletrnico.

Como a aplicao para emisso de NFS-e um ambiente novo, certamente ocorrero alteraes e
atualizaes nos schemas e documentos XML, tal como ocorreu e ainda ocorre na NF-e no ambiente
estadual.

A cada chamada do mtodo do Web Service, ser retornado o status corrente da transao para
atualizao e sincronizao de informaes. Os protocolos de retorno podem ser no formato XML e/ou
TXT.

4
Inteligncia e Tecnologia em Gesto de Negcios

4. Layout do arquivo
4.1 Instrues gerais
O arquivo TXT segue uma estrutura hierrquica de grupos, que so determinados por letras (conforme o
Manual de Integrao da NOTA FISCAL DE SERVIO ELETRNICA (NFSe)) e a delimitao dos campos de
cada grupo pelo caractere |, denominado pipe.

Se utilizar com Web Services integrado ao sistema de gesto, no necessrio criar um arquivo,
apenas o contedo em uma varivel e passar no parmetro do Web Service.

4.2 Informaes sobre cada tipo de grupo/registro


Conforme layout abaixo, existem grupos de dados opcionais, que podem ser omitidos do registro da NF-
e, assim como grupos que podem ser repetidos diversas vezes, por exemplo, o RPS descrito no grupo C
at o grupo M.

Sobre os campos dos grupos, estes podem ter limitaes de tamanho mnimo e mximo, alm de
validaes de tipo (apenas caracteres, apenas dgitos, datas, etc.). Assim, necessrio realizar a
confrontao do tipo, tamanho e demais validaes para cada campo, conforme descrito no layout.

4.3 Expresses e regras


O modelo utilizado seguir o mesmo padro que o Modelo Nacional de NF-e, facilitando o entendimento
e integraes, visto que muitas empresas estaro emitindo tanto NF-e como NFS-e.

Alguns conceitos utilizados:

[ 0 a N ] { ... } : Expresso indicando que todo o contedo entre chaves ( { e } ) pode ser inserido
0 (ou seja, nenhuma vez) ou mais vezes.
[ 0 a 1 ] { ... } : Expresso indicando que todo o contedo entre chaves ( { e } ) pode ser inserido
0 (ou seja, nenhuma vez) ou 1 vez.
[ 1 a 990 ] { ... } : Expresso indicando que todo o contedo entre chaves ( { e } ) pode ser
adicionado at um limite de 990, mas deve ser inserido pelo menos 1 vez.
[seleo entre X ou Y ] { X|... [ou] Y|... } : Expresso indicando que deve-se realizar uma escolha
entre o cdigo X ou o cdigo Y, lembrando que X e Y podem variar de acordo com os cdigos do
layout.
Cadeias hierrquicas de chaves { }: Sempre deve-se seguir a precedncia das chaves.

Note que a sua hierarquia difere-se em relao ao modelo Nacional NF-e devido s normatizaes
aplicadas na cmara na ABRASF, aplicando estruturas com maior amplitude do que profundidade na
concepo de rvores hierrquicas.

5
Inteligncia e Tecnologia em Gesto de Negcios

4.4 Formato Campo Data, Hora e Valores.


Vrios Municpios tm definido Data/Hora em diversos formatos. Por padro, ser usado sempre
o formato ISO 8601 utilizado tambm no ABRASF. O NFS-e Easy ajustar para cada Municpio.

Campo Data/Hora

FORMATO:

yyyy-MM-ddTHH:mm:ss

2013-04-20T10:30:06 (dia 20 de abril de 2013, dez horas, trinta minutos e seis


segundos).

Campo Data

FORMATO:

yyyy-MM-dd

2013-04-20 (dia 20 de abril de 2013).

Campo Valor

FORMATO: separador de decimal ponto (padro US)

100.00 (100 reais).

4.5 Formato do arquivo Texto


Se utilizar acentuao grfica no texto a ser encaminhado para Interface ou Web Services, garanta que o
texto esteja codificado em UTF-8. Para evitar problemas, evite acentuaes se no quiser usar codificao.

Na sequncia, ser apresentado o layout do modelo TXT e um exemplo com um LOTE e com dois RPS.

A ABRASF definiu vrios schemas (1.00, 1.04, V1.07 e 2.01) e os municpios adotam
diferentes verses e modelos.
O arquivo de importao TXT foi elaborado para auxiliar na gerao da NFS-e
independente da verso utilizada.
Quando utilizar a V1.0x, devero ser usados espaos em branco ou vazios adicionando
a barra vertical | para completar a quantidades de campos por linha.
Observe estas orientaes para evitar maiores problemas.

6
Inteligncia e Tecnologia em Gesto de Negcios

4.6 Formato TXT modelo ABRASF (V1 e V2) - Resumo dos Campos Abrasf (grupos A M)
(Vermelho: Campos adicionais ABRASF-V2)
/* Grupo A: informao de Lote */
A| Id | NumeroLote | CpfCnpjPrestadorLote | InscricaoMunicipalPrestadorLote | QuantidadeRPS |
B|
C|
/* Grupo D: Informao RPS Campo IncentivadorCultural no ABRASF V1, neste modelo, ABRASF V1 ou V2 utiliza campo IncentivoFiscal */
D| Id | DataEmissao | NaturezaOperacao | RegimeEspecialTributacao | OptanteSimplesNacional | IncentivoFiscal | Status| DataCompetencia |
E| NumeroRps | SerieRps | TipoRps |
F| NumRpsSubst | SerieRpsSubst | TipoRpsSubst |
G| ItemListaServico | CodigoCnae | CodigoTributacaoMunicipio | DiscriminacaoDosServios | CodigoMunicipio | CodigoPais | MunicipioIncidencia | NumeroProcesso |
G01| ValorServicos | ValorDeducoes | ValorPis | ValorCofins | ValorInss | ValorIr | ValorCsll | IssRetido | ValorIss | ValorIssRetido | OutrasRetencoes | BaseCalculo | Aliquota |
ValorLiquidoNfse | DescontoIncondicionado | DescontoCondicionado | ResponsavelRetencao | ExigibilidadeISS |
/* CpfCnpjPrestador: [ABRASF V2] Cpf ou Cnpj, [ABRASF V1], somente Cnpj */
H| CpfCnpjPrestador | InscricaoMunicipal |
I| CpfCnpjTomador | InscrioMunicipalTomador | RazaoSocialTomador |
I01| InscricaoEstadualTomador | /* Opcional e usado somente no AtendeNet e PM SP. */
J| EnderecoTomador | NumeroEnderecoTomador | ComplementoTomador | BairroTomador | CodigoMunicipioTomador | UfTomador | CepTomador | CodigoPaisTomador |
K| TelefoneTomador | EmailTomador |
L| CpfCnpjIntermediario | RazaoSocialIntermediario | InscricaoIntermediario |
M| CodigoObra | Art |

OBS: Note que a linha G : Discriminao dos Servios, o manual da ABRASF permite ter quebras de linhas, mas muitos sistemas aceitam um certo nmero, procure no gerar
mais que 20 linhas.
Quando descrever os servios e este tiver vrias linhas, o caractere pipe ou barra vertical |, dever ser adicionado somente aps a ltima descrio.
Inteligncia e Tecnologia em Gesto de Negcios

4.7 Arquivos PDF: resumo dos Campos para gerao de RPS ou NFSE em PDF (grupos X W)

Grupos X, Y, Z e W: Informaes adicionais para gerar um PDF da NFS-e ou RPS usando o mtodo ConverterRps2Pdf( ).
PDF: pode ser gerado um extrato NFS-e ou RPS*
Note que para gerar um PDF com preenchimento nos cabealhos do Tomador / Prestador, algumas informaes no existem no modelo da ABRASF e devem ser fornecidos
adicionalmente.
A gerao de PDF pode ser de um RPS ou de uma NFS-e, dependendo dos dados recebidos. Se RPS, pode ser inserida as linhas X e Y.
Aps um RPS ser convertido em NFS-e, possvel informar nas linhas X, Y e Z os dados adicionais da NFS-e.
Grupo Y: [ATENO] O campo UfTomador no ser mais usado neste grupo, mas o campo existente do grupo J. Para fins de compatibilidade, no foi removido do modelo.
Novas implementaes, favor deixar com espao VAZIO ou em branco.
Grupo Y01: foram acrescentados mais dados na linha Y para gerao de RPS, obrigatrio em decreto em alguns Municpios.
Grupo W: Valores com nomes de campos (labels) e descrio (informao) so dinmicos. Se tiver algum campo obrigatrio em algum Municpio, basta usar o GRUPO W e
ser inserido no modelo RPS ou no extrato NFS-e. (Exemplo na pgina seguinte).
Grupo Z: obrigatria apenas para gerar um extrato de NFS-e em PDF, pois contm as informaes da nota eletrnica.

/* Linhas Y e Z somente devero ser usadas para IMPRIMIR um PDF rascunho RPS ou da NFS-e - Ver Mtodo ConverterRps2Pdf( ) */
X| CaminhoLogoPdf | RodapeTextoLivre |
Y| RazaoSocialPrestador | EnderecoPrestador | NomeMunicipioPrestador | UfPrestador | NomeMunicipioTomador | UfTomador | TelefonePrestador|
/* Grupo Y01: dados somente para gerar um RPS, obrigatrio em alguns locais */
Y01| CepPrestador | EmailPrestador |
/* Grupo Z: dados somente para gerar uma NFS-e] */
Z| NumNFSe | CodVerificacao | DataEmissao | DataCancelamento | NumNFSeSubstituida |
/* Grupo W: campos dinmicos para o ERP gerar qualquer informao que julgue importante */
W| nomeCampo1 | descricaoCampo1 | nomeCampo2 | descricaoCampo2 | nomeCampo3 | descricaoCampo3 | nomeCampo4 | descricaoCampo4 |

8
Inteligncia e Tecnologia em Gesto de Negcios

4.7.1. Exemplo: Localizao no formulrio para os dados dinmicos

W| nomeCampo1 | descricaoCampo1 | nomeCampo2 | descricaoCampo2 | nomeCampo3 | descricaoCampo3 | nomeCampo4 | descricaoCampo4 |

9
Inteligncia e Tecnologia em Gesto de Negcios

4.7.2. Informaes adicionais

A| Id | NumeroLote | ...
D| Id | DataEmissao | NaturezaOperacao ...

O atributo Id (incio das linhas dos grupos A e D) do tipo tsIdTag, que definido na pgina 21 do manual de integrao (um pouco antes do item 3.4). Esse atributo
usado em vrios elementos, como por exemplo TcInfRps e TcInfNfse.

O tsIdTag definido como um Atributo de identificao da tag a ser assinada no documento XML do tipo caractere com tamanho limitado em 255. PORTANTO, evite
repetir o mesmo ID do LOTE (grupo A) e RPS (grupo D) e usar caracteres separadores como :, - e etc, pois alguns Municpios geram erro de assinatura.

O manual da ABRASF no bem claro em como ele deve ser construdo, mas o objetivo dele diferenciar o que est sendo assinado dentro do arquivo. Isso acontece
porque um nico arquivo pode ter vrias assinaturas de vrios trechos diferentes (por exemplo, ter 10 RPS e ter 10 assinaturas, uma para cada RPS). Esse campo diz
qual assinatura corresponde a qual RPS.

Sugerimos usar nomes diferentes diferenciando LOTE de RPS, por exemplo: LoteId001 e RpsId001, sem usar caracteres como :,
separadores etc, pois em alguns Municpios, pode gerar erro na validao da assinatura, mesmo sendo um documento vlido.

10
Inteligncia e Tecnologia em Gesto de Negcios

Exemplo de duas RPS [ABRASF V1] no modelo TXT:

A | Rps12121212 | 6 | 57730256000159 | 4990076 | 1 |


Campos com barras verticais sem contedo ou
LOTE B|
C| espao em branco, usados somente no ABRASF V2,
D | Rps11R11 | 2009-09-01T17:09:06 | 1 | 1 | 2 | 2 | 1 | | mas necessitam serem declarados no modelo TXT.
E | 11 | R1 | 1 |
G | 9999 | 9999 | 9999 | Discriminao do Servio | 3305802 | | | |
Primeiro RPS

G01 | 1900.00 | 10.00 | 100.00 | 12.00 | 11.50 | 13.00 | 14.00 | 2 | 90.00 | 0.00 | 15.00 | 1800.00 | 0.0500 | 1624.50 | 100.00 | 10.00 | | |
H | 57730256000159 | 4990076|
I | 16634427000505 | Inscrio Municipal do Tomador | Razo Social do Tomador |
J | Endereo do Tomador | 132 | complemento tomador | Bairro do Tomador | 3170206 | MG | 70452154 | |
K | 1120200020 | usuario@provedor.com.br |
M | 1245 | 123 |
D | Rps11R11 | 2009-09-01T17:09:06 | 1 | 1 | 2 | 2 | 1 | |
E | 11 | R1 | 1 |
G | 9999 | 9999 | 9999 | Discriminao do Servio | 3305802 | | | |
Segundo RPS

G01 | 1900.00 | 10.00 | 100.00 | 12.00 | 11.50 | 13.00 | 14.00 | 2 | 90.00 | 0.00 | 15.00 | 1800.00 | 0.0500 | 1624.50 | 100.00 | 10.00 | | |
H | 57730256000159 | 4990076|
I |16634427022 | Inscrio Municipal do Tomador | Razo Social do Tomador |
J | Endereo do Tomador | 132 | complemento tomador | Bairro do Tomador | 3170206 | MG | 70452154 | |
K | 1120200020 | usuario@provedor.com.br |
M | 1245 | 123 |
Observe que as linhas B e C esto vazias devido s definies da ABRASF no modelo do documento XML. O padro de layout gerado segue o mesmo modelo do ENCAT na NF-e padro nacional
(ICMS).

Caso deseje gerar um PDF do RPS, a linha X insere os dados do Municpio no cabealho. A linha Y contm dados opcionais, mas altamente
indicado o fornecimento, j que no modelo ABRASF, muitos dos dados do tomador no existem no modelo, ficando vrios campos vazios.
Quando um RPS for convertido em NFS-e e queira gerar um PDF da mesma, dever informar os dados da linha Z tambm, que contm os dados
da NFS-e.

A seguir, exemplo de uma RPS no modelo TXT com vrias linhas de discriminao de servios.

11
Inteligncia e Tecnologia em Gesto de Negcios

4.7.3. Exemplo de uma RPS no modelo TXT com vrias linhas de discriminao de servios:

A | Rps12121212 | 6 | 57730256000159 | 4990076 | 1 |


LOTE B|
C|
D | Rps11R11 | 2009-09-01T17:09:06 | 1 | 1 | 2 | 2 | 1 | |
E | 11 | R1 | 1 |
G | 9999 | 9999 | 9999 | linha 01 de Discriminao do Servio
linha 02 de Discriminao do Servio
linha 03 de Discriminao do Servio
linha 04 de Discriminao do Servio
linha 05 de Discriminao do Servio
| 3305802 | | | |
G01 | 1900.00 | 10.00 | 100.00 | 12.00 | 11.50 | 13.00 | 14.00 | 2 | 90.00 | 0.00 | 15.00 | 1800.00 | 0.0500 | 1624.50 | 100.00 | 10.00 |
Primeiro RPS

H | 57730256000159 | 4990076|
I|
I01 | Razo Social do Tomador |
I01a| |
I02a | 16634427000505 |
J | Endereo do Tomador | 132 | complemento tomador | Bairro do Tomador | 3170206 | MG | 70452154 | |
K | 1120200020 | usuario@tomador.com.br |
M | 1245 | 123 |
X | LogoNFSeEasy.jpg | DOCUMENTO SEM VALOR FISCAL |
Y | RazoSocial.Prestador |Endereo+Nm+Bairro.Prestador | Municpio.Prestador | UF.Prestador | Municpio.Tomador | UF(No Ser Usado) | 71 3621-6416 |
Y01 | 80000000 | prestador@dominio.com.br |
Z | 3589 | 827OY3270 |2014-07-29T21:25:29 | 2014-07-29T21:26:46 | |

Caso deseje gerar um PDF do RPS, a linha X insere os dados do Municpio no cabealho do PDF.
A linha Y contm dados opcionais, mas altamente indicado o fornecimento, j que no modelo ABRASF, muitos dos dados do tomador no existem
no modelo, ficando vrios campos vazios no PDF gerado.
Quando um RPS for convertido em NFS-e e queira gerar um PDF da mesma, dever informar os dados da linha Z tambm, que contm os dados
da NFS-e. Se o NFE-e EASY detectar o GRUPO Z, em vez de usar o modelo RPS, ser usado o modelo NFS-e.

Fim dos exemplos de RPS ABRASF.

12
Inteligncia e Tecnologia em Gesto de Negcios

4.7.4. Identificao do Lote e do RPS em Solues GINFES


Quando utilizar o sistema em algum Municpio que tenha a soluo GINFES (ver arquivo Municipio.config), a identificao do LOTE deve ser diferente da identificao do RPS, por exemplo:

A | LoteId1 | 6 | 57730256000159 | 4990076 | 1 |


LOTE B|
C|
D | RpsId1 | 2009-09-01T17:09:06 | 1 | 1 | 2 | 2 | 1 | |
E | 11 | R1 | 1 |
G | 9999 | 9999 | 9999 | linha 01 de Discriminao do Servio
linha 02 de Discriminao do Servio
linha 03 de Discriminao do Servio
linha 04 de Discriminao do Servio
linha 05 de Discriminao do Servio
linha 06 de Discriminao do Servio
Primeiro RPS

linha 07 de Discriminao do Servio


linha 08 de Discriminao do Servio
linha 09 de Discriminao do Servio | 3305802 | | | |
G01 | 1900.00 | 10.00 | 100.00 | 12.00 | 11.50 | 13.00 | 14.00 | 2 | 90.00 | 0.00 | 15.00 | 1800.00 | 0.0500 | 1624.50 | 100.00 | 10.00 |
H | 57730256000159 | 4990076|
I|
I01 | Razo Social do Tomador |
I01a| |
I02a | 16634427000505 |
J | Endereo do Tomador | 132 | complemento tomador | Bairro do Tomador | 3170206 | MG | 70452154 | |
K | 1120200020 | usuario@provedor.com.br |
M | 1245 | 123 |
Note a Identificao na Linha A e Linha D, os IDs so diferentes, se deixar a mesma informao, gerado um erro de assinatura:

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


<ns3:EnviarLoteRpsResposta xmlns:ns2="http://www.ginfes.com.br/tipos_v03.xsd" xmlns:ns3="http://www.ginfes.com.br/servico_enviar_lote_rps_resposta_v03.xsd">
<ListaMensagemRetorno>
<ns2:MensagemRetorno>
<ns2:Codigo>E302</ns2:Codigo>
<ns2:Mensagem>Assinatura invlida.</ns2:Mensagem>
<ns2:Correcao>Informar assinatura correta no documento XML.</ns2:Correcao>
</ns2:MensagemRetorno>
</ListaMensagemRetorno>
</ns3:EnviarLoteRpsResposta>

13
Inteligncia e Tecnologia em Gesto de Negcios

Outros Sistemas no compatveis com modelo ABRASF


4.8 Modelo Municpio de SP (Tiplan)
A Interface NFS-e Easy, pode processar dados para o Municpio de So Paulo, que utiliza um modelo prprio e que no segue o modelo ABRASF, ou informar os dados
seguindo o mesmo formato do modelo ABRASF, com apenas uma adaptao, comentado na sequncia.

Independente do modelo a ser utilizado, existem algumas observaes.

4.8.1. Usando modelo Texto Tiplan - So Paulo


O modelo Texto delimitado em uso pelo Municpio de SP, pode ser usado com entrada de dados, mas dever ser informado no cabealho o Cpf/Cnpj do declarante,
e na linha (2), coluna 306, onde cita o nome do Municpio , dever ser trocado pelo Cdigo ABRASF. Exemplo:

14
Inteligncia e Tecnologia em Gesto de Negcios

4.8.2. Usando modelo Texto Abrasf


Observe que no modelo de SP, no existe a informao NaturezaOperacao, logo, o tipo TributaoRps de SP deve ser declarado neste campo (NaturezaOperacao).
Exemplo:

D | Id | DataEmissao | NaturezaOperacao | RegimeEspecialTributacao | OptanteSimplesNacional | IncentivoFiscal | Status | CompetenciaV2 |

TIPO DE TRIBUTAO CDIGO DE NATUREZA DA OPERAO


T - Tributao no municpio de So Paulo 1 Tributao no municpio
F - Tributao fora do municpio de So Paulo 2 - Tributao fora do municpio
I Isento 3 Iseno
I Isento 4 Imune
J - ISS Suspenso por Deciso Judicial 5 Exigibilidade suspensa por deciso judicial
J - ISS Suspenso por Deciso Judicial 6 Exigibilidade suspensa por procedimento administrativo

Com este modelo, possvel padronizar a gerao de dados para o Municpio de SP e demais Prefeituras que tendem a seguir este modelo.
Exemplo de um modelo ABRASF gerado para SP, veja a informao no GRUPO D:

A | Lote23 | 23 | 06039615000108 | 1218155 | 1 |


B |
C |
D | RPS1A23 | 2013-04-26T16:00:01| 1 | | | | N | |
E | 23 | A | RPS |
G | | | 07498 | Teste emisso de Servio | | | | |
G01 | 1.00 | | | | | | | 2 | | | | | 5 | | | | | |
H | 61656088000199 | 96880600 |
I | 00038166000954 | 81257589 | BANCO CENTRAL DO BRASIL|
J | AV PAULISTA | 1804 | | Bela Vista | 3550308 | SP | 1310200 | |
K | | |

Linha I01 opcional no modelo do Municpio de SP, no exemplo acima no foi utilizado.

15
Inteligncia e Tecnologia em Gesto de Negcios

4.9 Modelo DSF


Sistemas que no sejam compatveis podem ser utilizados, mas as informaes no campo TXT devem ser observadas quanto aos valores. O sistema DSF possui algumas variaes discutidas a
seguir, e por este motivo foi criado um novo modelo de dados, com informaes de campos como definidos no Manual da DSF, evitando dvidas de interpretao de campos.

N01| IdLote | CodCidade | CpfCnpjRemetente | RazaoSocialRemetente | DtInicio | DtFim | QtdRps | ValorTotalServicos |


ValorTotalDeducoes |
/* Rps */
N02| IdRps | NumRps | SerieRps | TipoRps | DataEmissaoRps | SituacaoRps | SeriePrestacao | CodigoAtividade | AliquotaAtividade |
TipoRecolhimento | MotCancelamento |
/* Dados Rps Substituido */
N03| NumeroRpsSubstituido | SerieRpsSubstituido | NumeroNfseSubstituida | DataEmissaoNfseSubstituida |
N04| Operacao | Tributacao | MunicipioPrestacao | MunicipioPrestacaoDescricao | DescricaoRps | CpfCnpjIntermediario |
/* Dados Tomador */
N05| InscricaoMunicipalTomador | CpfCnpjTomador | RazaoSocialTomador | DocTomadorEstrangeiro |
N06| TipoLogradouroTomador | LogradouroTomador | NumeroEnderecoTomador | ComplementoEnderecoTomador | TipoBairroTomador |
BairroTomador | CidadeTomador | CidadeTomadorDescricao | CepTomador |
N07| EmailTomador | DddTomador | TelefoneTomador |
/* Dados Prestador */
N08| CpfCnpjPrestador | InscricaoMunicipalPrestador | RazaoSocialPrestador | DddPrestador | TelefonePrestador |
/* Valores Impostos */
N09| ValorPis | ValorCofins | ValorInss | ValorIr | ValorCsll |
N10| AliquotaPis | AliquotaCofins | AliquotaInss | AliquotaIr | AliquotaCsll |
/* Dedues 0..200 */
N11| DeducaoPor | TipoDeducao | CpfCnpjReferencia | NumeroNfReferencia | ValorTotalReferencia | PercentualDeduzir | ValordeDuzir |
/* Itens 1..25 */
N12| DiscriminacaoServico | Quantidade | ValorUnitario | ValorTotal | Tributavel|
/* Linhas Y e Z somente devero ser usadas para IMPRIMIR um PDF rascunho RPS ou da NFS-e - Ver Mtodo ConverterRps2Pdf() */
[Pdf: NFSe ou RPS* - Dados para preenchimento dos cabealhos no PDF]
NX | CaminhoLogoPdf | RodapeTextoLivre |
NY | RazaoSocialPrestador | EnderecoPrestador | MunicipioPrestador | UfPrestador | MunicipioTomador | UfTomador | TelefonePrestador|
[Pdf: NFSe Somente * - Dados para preenchimento nos campos do PDF]
NZ | NumNfse | CodVerificacao | DataEmissaoNfse | DataCancelamento | NumNfseSubstituida |

16
Inteligncia e Tecnologia em Gesto de Negcios

4.10 Modelo Atende.net


(Link manual https://www.nfs-e.net/fiscalweb.php?req=manuais)

O Sistema Atende.Net (tambm conhecido como Fiscal Web, NFS-e.Net, IPM) no segue o padro ABRASF, portanto, algumas consideraes so necessrias para poder se utilizar
do modelo ABRASF definido na seo 3.4. As diferenas comeam nos mtodos expostos pela interface. No Atende.Net s esto disponveis as seguintes (chamadas aos outros mtodos
retornaro erro por no ter funcionalidade):

public static string Echo(string codIbgeMunicipio, string texto)


public static string ConverterXml2Txt(string codIbgeMunicipio, string xml)
public static string ConverterRps2Pdf(string codIbgeMunicipio, string conteudoLoteTxt, string caminhoPDF)
public static string RecepcionarLoteRpsTxt(string codIbgeMunicipio, string conteudoLoteTxt, string certFileNameOrThumbPrint, string senha)
public static string EnviarLoteGenerico(string codIbgeMunicipio, string conteudoLoteTxt, string certFileNameOrThumbPrint, string senha)
public static string CancelarNfseGenerico(string codIbgeMunicipio, string cnpj, string inscricaoEmissor, string numNfSe,
string codCancelamento, string certFileNameOrThumbPrint, string senha)
public static string CancelarNfse(string codIbgeMunicipio, string cnpj, string inscricaoEmissor, string numNFSe, string codCancelamento,
string certFileNameOrThumbPrint, string senha)

No modelo Atende.Net, s existem RecepcionarLoteRpsTxt ou EnviarLoteGenerico (nome da Interface NfseEast V3.0), que tem exatamente o mesmo comportamento do recepcionar
para gerao de NFS-e. Ainda, os mtodos CancelarNfse ou CancelarNfseGenerico (idntico) para cancelamento.
No existem mtodos de consulta de lotes ou Nfse, pois o Atende.net no utiliza o conceito de lotes, processamento, consulta de situao, etc, pois o processo sncrono. Como o
Atende.net no trabalha com o conceito de lotes e somente 1 documento Nfse pode ser gerada a cada chamada. Portanto, no arquivo de entrada TXT do a ser recebido no mtodo
Easy, podem ser omitidas as linhas A, B e C (que se referem ao lote). Ainda, o Atende.net tambm no tem o conceito de Recibo Provisrio de Servio (RPS), logo no h nmero, srie
nem tipo de RPS, nem RPS substitudo. E a propsito, tambm no possui NFS-e substituta (a NFS-e deve ser cancelada).
Tambm alguns conceitos previstos no modelo ABRASF no possuem correspondncia no modelo Atende.net, por exemplo Regime Especial de Tributao, Optante pelo Simples
Nacional (existem empresas optantes pelo simples, mas no existe este campo no XML), Incentivo Fiscal, Intermedirio, Cdigo Obra, ART e outros. Isto simplifica bastante o envio dos
dados.
Observando estas informaes que esto no Manual de Integrao do Atende.Net (https://www.nfs-e.net/fiscalweb.php?req=manuais), o contedo do TXT mais simples e
devero ser consideradas antes do envio para interface.
Finalmente, quando uma LINHA no conter dados, pode ser omitida (No precisa declarar e colocar os pipes sem dados), mas se um campo for utilizado, a formatao deve ser precisa,
conforme o modelo deste documento, finalizando sempre com um pipe (|).

17
Inteligncia e Tecnologia em Gesto de Negcios

Modelo ABRASF, Legendas :


Cinza negritado em itlico: campo no utilizado, deve ser utilizado o pipe (|) com campo vazio (nulo) ou com espao em branco.
Preto negritado: campo com significado especial
Preto normal: campo utilizado (pode ou no ser obrigatrio, consultar manual do sistema)

D | IdRps | DataEmissao | NaturezaOperacao | RegimeEspecialTributacao | OptanteSimplesNacional | IncentivadorCultural |


Status | CompetenciaV2 |
G | ItemListaServico | CodigoCnae | CodigoTributacaoMunicipio | Discriminacao | CodigoMunicipio | CodigoPaisV2 |
MunicipioIncidenciaV2 | NumeroProcessoV2 |
G01| ValorServicos | ValorDeducoes | ValorPis | ValorCofins | ValorInss | ValorIr | ValorCsll | IssRetido | ValorIss | ValorIssRetido |
OutrasRetencoes | BaseCalculo | Aliquota | ValorLiquidoNfse | DescontoIncondicionado | DescontoCondicionado |
ResponsavelRetencaoV2 | ExigibilidadeISSV2 |
H | CpfCnpjPrestador | InscricaoPrestador |
I | CpfCnpjTomador | InscricaoTomador | RazaoSocialTomador|
I1 | InscricaoEstadualTomador |
J | EnderecoTomador | NumeroEnderecoTomador | ComplementoTomador | BairroTomador | CodigoMunicipioTomador | UfTomador | CepTomador |
CodigoPaisTomadorV2 |
K | ContatoTelefone | ContatoEmail |

Consideraes sobre os campos em preto normal:


CodigoMunicipio
Cdigo do municpio de prestao. No modelo ABRASF o cdigo IBGE, no modelo Atende.net o cdigo TOM (Receita Federal) com 4 dgitos.

CodigoMunicipioTomador
Pode ser cdigo IBGE ou nome do municpio.

CodigoPaisTomadorV2
Nome do pas do tomador. No modelo ABRASF o cdigo BACEN.

18
Inteligncia e Tecnologia em Gesto de Negcios

Consideraes sobre os campos em preto negritado:


NaturezaOperacao
No modelo ABRASF, este campo significa como ser a tributao (por exemplo tributao no municpio, fora do municpio, imune, isento, etc). No modelo Atende.net,
existe um conceito semelhante, que Situao Tributria, transcrito abaixo, do Manual do Atende.Net:

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 cdigo1705).
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 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, devese utilizar das outras situaes tributrias, de acordo com o caso.
Portando, informe este cdigo no campo NaturezaOperacao.

MunicipioIncidenciaV2
No modelo ABRASF Verso 2.0, este o municpio de tributao. No modelo Atende.net, no h correspondncia para este campo. Porm, no Atende.Net, o
prestador deve informar no XML se o prestador ser tributado no municpio ou fora.
Quando a tributao for NO municpio, informar o cdigo TOM do municpio (por exemplo, para emitis NFS-e em Concrdia com tributao no municpio, informar o
cdigo IBGE de Concrdia na chamada da DLL e informar o cdigo TOM de Concrdia neste campo). Caso o valor deste campo difira do cdigo TOM do municpio
gerador, a tributao ser fora do municpio (e possivelmente a NFS-e no ser rejeitada dependendo de alguma regra do municpio).

19
Inteligncia e Tecnologia em Gesto de Negcios

InscricaoTomador
Existem informaes para tomador estrangeiro. Quando o tomador for estrangeiro, deixar o CpfCnpjTomador vazio e informar o nmero do carto de identificao
estrangeira ou passaporte no campo InscricaoTomador.

Formato TXT (aps convertido com o ConverterXml2Txt) de Retorno do RecepcionarLoteRps ou EnviarLoteGenerico:

Retorno|CodigoErro|NumeroNfse|SerieNfse|DataNfse|HoraNfse|LinkNfse|CodVerificacao|

Exemplo:

Retorno|00001 - Sucesso|4406|1|09/01/2013|11:41:07|http://www.nfs-e.net/datacenter/include/nfw/nfw_imp_notas.php?codauten=01808334462478
|01808334462478|

Cancelamento.

No necessrio informar o Cdigo Cancelamento nem inscrio do prestador. O retorno TXT do Cancelamento segue o mesmo padro do RecepcionarLoteRps.

Exemplo:

Retorno|00001 - Sucesso|4406|1|09/01/2013|11:41:07|http://www.nfs-e.net/datacenter/include/nfw/nfw_imp_notas.php?codauten=01808334462478
|01808334462478|

Caso deseje mais informaes, favor contatar:

Benefix Sistemas e Gesto de Negcios Ltda.


+55 (21) 2621-5063 / +55 (41) 3353-3839
+55 (21) 9112-1847
E-mail: contato@e-benefix.com.br
URL: www.webenefix.com.br

20