Beruflich Dokumente
Kultur Dokumente
Sumrio
1. Introduo..............................................................................................................................................3
3.1 Comunicao..................................................................................................................................4
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.3. Exemplo de uma RPS no modelo TXT com vrias linhas de discriminao de servios:..... 12
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.
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.
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.
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.
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.
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.
[ 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
Campo Data/Hora
FORMATO:
yyyy-MM-ddTHH:mm:ss
Campo Data
FORMATO:
yyyy-MM-dd
Campo Valor
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
9
Inteligncia e Tecnologia em Gesto de Negcios
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
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:
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.
12
Inteligncia e Tecnologia em Gesto de Negcios
13
Inteligncia e Tecnologia em Gesto de Negcios
14
Inteligncia e Tecnologia em Gesto de Negcios
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:
Linha I01 opcional no modelo do Municpio de SP, no exemplo acima no foi utilizado.
15
Inteligncia e Tecnologia em Gesto de Negcios
16
Inteligncia e Tecnologia em Gesto de Negcios
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):
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
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
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.
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|
20