Inteligncia e Tecnologia em Gesto de Negcios

Manual de Importao/Exportao TXT De Notas Fiscais de Servio eletrnicas Middleware NF-e Easy v1.0.4

Produto:

Manual de converso Texto para XML usado no Middleware NFS-e Easy v1.0.4
Release date: JAN 26, 2012

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.

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 (NFe) 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:

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.

Inteligncia e Tecnologia em Gesto de Negcios

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. 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 NFe, assim como grupos que podem ser repetidos diversas vezes, por exemplo, o RPS descrito no grupo C at o grupo M.

Inteligncia e Tecnologia em Gesto de Negcios 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. Na sequncia, ser apresentado o layout do modelo TXT e um exemplo com um LOTE e com dois RPS.

Inteligncia e Tecnologia em Gesto de Negcios

4.4 Formato TXT modelo ABRASF

[LoteRps] A | Id | NumeroLote | Cnpj | InscricaoMunicipal | QuantidadeRPS | { [ListaRps] B| [1 a N] { [Rps] C| { [InfRps] D | Id | DataEmissao | NaturezaOperacao | RegimeEspecialTributacao | OptanteSimplesNacional | IncentivadorCultural | Status | { [IdentificacaoRps] E | Numero | Serie | Tipo | [RpsSubstituido] F | Numero | Serie | Tipo | [Servico] G | ItemListaServico | CodigoCnae | CodigoTributacaoMunicipio | Discriminacao dos Servios | CodigoMunicipio | { [Valores] G01 | ValorServicos | ValorDeducoes | ValorPis | ValorCofins | ValorInss | ValorIr | ValorCsll | IssRetido | ValorIss | ValorIssRetido | OutrasRetencoes | BaseCalculo | Aliquota | ValorLiquidoNfse | DescontoIncondicionado | DescontoCondicionado | } [Prestador] H | Cnpj | InscricaoMunicipal | [Tomador] I| { [IdentificacaoTomador] I01 | RazaoSocial | [seleo entre H02 ou H02a] { I02 | Cpf |

Inteligncia e Tecnologia em Gesto de Negcios

I02a | Cnpj | } [Endereco] J | Endereco | Numero | Complemento | Bairro | CodigoMunicipio | Uf | Cep | [Contato] K | Telefone | Email | } [IntermediarioServico] L | RazaoSocial | InscricaoMunicipal | [seleo entre H02 ou H02a] { [CpfCnpj] L01 | Cpf | L01a | Cnpj | } [ConstrucaoCivil] M | CodigoObra | Art | } } } } [fim LoteRps] 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 caracter pipe | dever ser adicionado somente aps a ltima descrio.

Inteligncia e Tecnologia em Gesto de Negcios

Resumo dos Campos A | B | C | D | E | F | G | G01 Id | NumeroLote | Cnpj | InscricaoMunicipal | QuantidadeRPS |

Id | DataEmissao | NaturezaOperacao | RegimeEspecialTributacao | OptanteSimplesNacional | IncentivadorCultural | Status | Numero | Serie | Tipo | Numero | Serie | Tipo | ItemListaServico | CodigoCnae | CodigoTributacaoMunicipio | Discriminacao dos Servios | CodigoMunicipio | | ValorServicos | ValorDeducoes | ValorPis | ValorCofins | ValorInss | ValorIr | ValorCsll | IssRetido | ValorIss | ValorIssRetido | OutrasRetencoes | BaseCalculo | Aliquota | ValorLiquidoNfse | DescontoIncondicionado | DescontoCondicionado | H | Cnpj | InscricaoMunicipal | I | I01 | RazaoSocial | I02 | Cpf | I02a | Cnpj | J | Endereco | Numero | Complemento | Bairro | CodigoMunicipio | Uf | Cep | K | Telefone | Email | L | RazaoSocial | InscricaoMunicipal | L01 | Cpf | L01a | Cnpj | M | CodigoObra | Art | N | DsfOperao | DsfTributacao |

O atributo Id 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. 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.
Na sequncia, exemplos de RPS no formato TXT

Inteligncia e Tecnologia em Gesto de Negcios

Exemplo de duas RPS no modelo TXT: A | Rps12121212 | 6 | 57730256000159 | 4990076 | 1 | B| C| D | Rps11R11 | 2009-09-01T17:09:06 | 1 | 1 | 2 | 2 | 1 | E | 11 | R1 | 1 | G | 9999 | 9999 | 9999 | 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 | I02a | 16634427000505 | J | Endereo do Tomador | 132 | complemento tomador | Bairro do Tomador | 3170206 | MG | 70452154 | K | 1120200020 | usuario@provedor.com.br | M | 1245 | 123 | C| D | Rps11R11 | 2009-09-01T17:09:06 | 1 | 1 | 2 | 2 | 1 | E | 11 | R1 | 1 | G | 9999 | 9999 | 9999 | 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 | I02a | 16634427000505 | 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). Segundo RPS Primeiro RPS

Na sequncia, exemplo de uma RPS no modelo TXT com vrias linhas de discriminao de servios.

Inteligncia e Tecnologia em Gesto de Negcios

Exemplo de uma RPS no modelo TXT com vrias linhas de discriminao de servios: A | Rps12121212 | 6 | 57730256000159 | 4990076 | 1 | 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 linha 06 de Discriminao do Servio 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 | I02a | 16634427000505 | J | Endereo do Tomador | 132 | complemento tomador | Bairro do Tomador | 3170206 | MG | 70452154 | K | 1120200020 | usuario@provedor.com.br | M | 1245 | 123 |

Fim dos exemplos de RPS.

Primeiro RPS

Inteligncia e Tecnologia em Gesto de Negcios

4.5 Outros Sistemas no compatveis com modelo ABRASF

4.5.1. 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. No modelo ABRASF, os seguintes campos sero ignorados, e, portanto podem ser deixados em branco: D | Id | DataEmissao | NaturezaOperacao | RegimeEspecialTributacao | OptanteSimplesNacional | IncentivadorCultural | Status | G | ItemListaServico | CodigoCnae | CodigoTributacaoMunicipio | Discriminacao | CodigoMunicipio | A linha de dados TXT adicional dever ser inserida para complementar os dados que no so similares ao ABRASF e completar as informaes no documento XML segundo guia da DSF. A linha de dados do grupo N so exclusivos da DSF V10. N | | N01 | N02 | Operacao | Tributacao | SeriePrestacao | TipoRecolhimento | AliquotaPIS | AliquotaCOFINS | AliquotaINSS AliquotaIR | AliquotaCSLL | MunicipioPrestacao | MunicipioPrestacaoDescricao | DDDPrestador | DDDTomador | MotCancelamento | CidadeTomadorDescricao | NumeroNFSeSubstituida | DataEmissaoNFSeSubstituida | DocTomadorEstrangeiro | TipoRecolhimento | DeducaoPor | TipoDeducao | CPFCNPJReferencia | NumeroNFReferencia | ValorTotalReferencia | PercentualDeduzir | ValorDeduzir |

N03 | DiscriminacaoServico

| Quantidade

| ValorUnitario | ValorTotal | Tributavel |

Observao, os campos N02 e N03 podem repetir mais de uma vez, pois se referem a Itens de deduo e itens de servios.

(DSF) Operao Guia WebService pg. 07 A - Sem Deduo B - Com Deduo/Materiais C - Imune/Isenta de ISSQN D - Devoluo/Simples Remessa J - Intemediao

(DSF) Tributacao Guia WebService pg. 07 C - Isenta de ISS E - No Incidncia no Municpio F - Imune K - Exigibilide Susp.Dec.J/Proc.A N - No Tributvel T Tributvel G - Tributvel Fixo H - Tributvel S.N. M - Micro Empreendedor Individual (MEI)

10

Inteligncia e Tecnologia em Gesto de Negcios

(DSF) SeriePrestacao Guia WebService pg. 07 Nmero do equipamento emissor do RPS ou srie de prestao. Caso no utilize a srie, preencha o campo com o valor 99 que indica modelo nico. Caso queira utilizar o campo srie para indicar o nmero do equipamento emissor do RPS deve-se solicitar liberao da prefeitura.

(DSF) TipoRecolhimento Guia WebService pg. 07 A - A Receber R - Retido na Fonte (DSF) Aliquota PIS/COFINS/INSS/IR/CSLL Guia WebService pg. 07 AliquotaPIS Numrico 6,4 Alquota PIS AliquotaCOFINS Numrico 6,4 Alquota COFINS AliquotaINSS Numrico 6,4 Alquota INSS AliquotaIR Numrico 6,4 Alquota IR AliquotaCSLL Numrico 6,4 Alquota IR (DSF) MunicipioPrestacaoDescricao Guia WebService pg. 07 30 Caracteres - Municpio de Prestao do Servio

(DSF) DDD Guia WebService pg. 07 DDD Telefone do Prestador DDD Telefone do Tomador

11

Inteligncia e Tecnologia em Gesto de Negcios

(DSF) ValorTotalReferencia Guia WebService pg. 09 Numrico 15,2 Valor total da Nota Fiscal de Referncia

(DSF) Percentual e Valor a Deduzir Guia WebService pg. 09 Numrico 5,2 Percentual a Deduzir ValorDeduzir Numrico 15,2 Valor a ser Deduzido (DSF) DescricaoRPS - Guia WebService pg. 09 Alfanumrico 1500 Descrio/ Dados Complementares do RPS (DSF) Quantidade - Guia WebService pg. 08 Numrico 10,4 Quantidade do servio tomado

(DSF) ValorUnitario - Guia WebService pg. 08 Numrico 15,4 Valor Unitrio

(DSF) ValorTotal - Guia WebService pg. 08 Numrico 15,4 Valor total do servio

(DSF) Tributavel - Guia WebService pg. 08 Alfanumrico 1 S- Item tributvel , N- No tributvel. Verifique o anexo 08 para identificar quais atividades so permitidas no municpio.

12

Inteligncia e Tecnologia em Gesto de Negcios

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: nfe@e-benefix.com.br URL: www.webenefix.com.br

13