Introdução Este manual tem como objetivo apresentar o layout utilizado pelo Sistema de Notas Fiscais de Serviços Eletrônica na exportação e importação de NFS-e (Contribuintes Prefeitura e Prefeitura Contribuintes), permitindo que sejam transferidas informações de lançamentos de Notas de Serviços em grande volume, sem a necessidade de emissão ou confirmação individual online. O Contribuinte utilizará arquivos texto seguindo um layout pré-definido apresentado neste documento. Especificações 1. O arquivo tem o formato texto (Text Encoding = ISO-8859-1), podendo ser salvo com qualquer nome, a critério do contribuinte, possuindo no máximo 10 MB (10240 KBytes) de tamanho. 2. O arquivo conterá as NFS-e emitidas em determinado período, a critério do contribuinte. 3. O arquivo de envio deverá ser nomeado com o prefixo envio_ seguido do CPF/CNPJ do prestador (sem pontos e barras) e acrescido de um sequencial de controle. 4. A extensão do arquivo deverá ser txt. Layout de Envio (Contribuinte Prefeitura) O arquivo de envio é formado por campos que possuem tamanhos fixos (largura fixa), com organização seqüencial e agrupados em registros de 400 bytes de comprimento contando com salto de linha, conforme a tabela de construção e formatação do layout apresentada mais abaixo. Composição do arquivo Registro Tipo 1 Header do Arquivo: Registro obrigatório de abertura do arquivo. Contém as informações do Prestador e do lote de envio das NFS-e. Só ocorre uma única vez no arquivo. Registro Tipo 2 Cabeçalho da NFS-e: Registro obrigatório que identifica detalhes sobre cada nota a ser processada pela Prefeitura. Este registro deve ser gerado para cada nota lançada no arquivo. Registro Tipo 3 Identificação do Tomador da NFS-e: Registro obrigatório que contém informações sobre o Tomador do Serviço. Este registro deve ser gerado para cada nota lançada no arquivo. Registro Tipo 4 Observação da NFS-e: Registro opcional contendo um campo para descrição em uma NFSe. Este registro deve ser gerado para cada nota lançada no arquivo que fizer uso do campo descrição. Caso seja necessário uma Observação maior, o registro deve ser re-informado com a continuação do texto, até o tamanho necessário. Registro Tipo 5 Descrição do Serviço Realizado: Registro obrigatório que detalha o serviço prestado. Este registro deve ser gerado para cada nota lançada no arquivo. Registro Tipo 6 Indicador de Final de Arquivo: Registro obrigatório de fechamento do arquivo.
** Leia Importante ** Número da Nota Fiscal, é importante destacar que o número da Nota Fiscal quem fornece é a Prefeitura, ou seja, o que é enviado no campo (Sequencial NFS-e - Registro tipo 2), não se converte em Número da Nota Fiscal, por este motivo há o arquivo de Retorno, a partir deste sim se obtém o Número gerado pela Prefeitura (Registro tipo 2 arquivo de Retorno). Composição dos Campos Todos os campos numéricos serão preenchidos alinhados pela direita e sem formatação (sem ponto e sem vírgula). Se necessário, serão preenchidos com zeros à esquerda até completar seu tamanho máximo. Campo opcional (numérico): caso o conteúdo do campo não seja fornecido, este será preenchido com zeros até completar seu tamanho máximo. A estrutura do layout está baseada em 2 (dois) tipos de dados primitivos somente. Os tipos podem ser: TEXTO (T) ou NUMERICO (N). Todos os campos do tipo TEXTO (T) serão preenchidos alinhados pela esquerda. Se necessário, serão preenchidos com espaços em branco à direita até completar seu tamanho máximo, com exceção do campo de Discriminação dos Serviços da linha de detalhe. Campo opcional (alfanumérico): caso o conteúdo do campo não tenha sido fornecido, este será preenchido com espaços em branco até completar seu tamanho máximo. Todos os campos do tipo NUMERICO (N) serão preenchidos alinhados pela direita. Se necessário, serão preenchidos com zeros à esquerda até completar seu tamanho máximo. Atualização de Versão 103 -> 104 Registro Tipo 2, ordem 4: adicionada a opção Sem Recolhimento utilizada para os contribuintes que se enquadram à emitir notas Sem Recolhimento. Registro Tipo 2, ordem 16: adicionada a opção de Local da Prestação, informando se a prestação do Serviço da Nota foi dentro ou Fora do Município. Registro Tipo 3, ordem 3: adicionada opção para tomador não identificado. Registro Tipo 4, mudança na nomenclatura do registro para melhor identificação na nota fiscal, mudando a nomenclatura de Descrição da Nota para Observação da Nota, campo à qual se encaixa na Observação da Nota Fiscal. Atualização de Versão 104 -> 105 Registro Tipo 2, ordem 8: alteração na observação do layout. Registro Tipo 2, ordem 17: adicionada a opção de informar uma nota à ser Substituída. Registro Tipo 3, ordem 16: adicionada a opção Inscrição Estadual Tomador. Registro Tipo 1, ordem 10: adicionada a opção de Quantidade de casas decimais para o Valor de Serviço. Registro Tipo 1, ordem 11: adicionada a opção de Quantidade de casas decimais para a Quantidade de um Serviço. Registro Tipo 5, ordem 5: alteração na observação do layout. Registro Tipo 5, ordem 9: alteração na observação do layout. Atualização de Versão 105 -> 106 Registro Tipo 2, ordem 18: adicionado campo Outros Descontos. Atualização de Versão 106 -> 107 Registro Tipo 3, ordem 3: adicionada opção para informar Tomadores Estrangeiros.
Registro Tipo 1 Header do Arquivo o valor 1, indicando linha de 2 Versão do Layout 2 3 N Indica a versão do layout a ser utilizada. Será preenchido com o número da versão atual. A versão atual é a 107. 3 Inscrição Municipal do Prestador 5 26 T Inscrição municipal do prestador a que se refere o arquivo, alinhado à esquerda. 4 Indicador de CPF/CNPJ do Prestador 31 1 N Este campo indica o tipo de dados fornecido no campo CPF/CNPJ do Prestador. Valor 1 para CPF. Valor 2 para CNPJ. CNPJ do Prestador com 14 posições ou CPF do Prestador com 11 posições. Sem 5 CNPJ ou CPF do Prestador 32 14 T formatação (ponto, traço, barra,...) alinhados à esquerda 0 = -Optante pelo ples Federal nem Municipal 1 = Optante p/ ples Federal (Alíquota de 1,0%) 6 Optante pelo ples 46 1 T 2 = Optante p/ ples Federal (Alíquota de 0,5%) 3 = Optante p/ ples Municipal 4 = Optante p/ ples Nacional 7 Data de Início do Período 47 8 T O arquivo de exportação conterá todas as Notas Fiscais referentes ao período escolhido. Neste campo será informada a Data INICIAL desse período no formato AAAAMMDD. 8 Data de Fim do Período 55 8 T O arquivo de exportação conterá todas as Notas Fiscais referentes ao período escolhido. Neste campo será informada a Data FINAL desse período no formato AAAAMMDD. Quantidade de Notas informadas no 9 Quantidade de NFS-e informadas 63 5 N arquivo. Caso não seja preenchido o sistema 10 Quantidade de Casas Decimais para o Valor 68 1 N assumirá o valor de 2 casas decimais como de Serviço padrão. Quantidade de casas decimais para a ordem 5 do Registro Tipo 5, devendo ser obrigatóriamente preenchido entre 2 e 4. 11 Quantidade de Casas Decimais para a Quantidade de um Serviço 69 1 N Caso não seja preenchido o sistema assumirá o valor de 2 casas decimais como padrão. Quantidade de casas decimais para a ordem 9 do Registro Tipo 5, devendo ser obrigatóriamente preenchido entre 2 e 4. 12 Brancos 70 322 T Preencher com Brancos 13 Sequencial do registro 392 8 N
Registro Tipo 2 Cabeçalho da NFS-e o valor 2, indicando linha de. Número Seqüencial para controle do prestador, com possibilidade de atingir 2 Seqüencial da NFS-e 2 20 N 20 dígitos. é permitida a duplicação de números. Data/hora de emissão da NFS-e no 3 Data e Hora da NFS-e 22 14 T formato AAAAMMDDHHmmSS. Tipo de Recolhimento com uma posição: 4 Tipo de Recolhimento 36 1 T N Normal, R Retido na Fonte S Sem Recolhimento 5 Situação da Nota Fiscal 37 1 T Situação da Nota Fiscal com 01 posição: T - Operação normal (tributação conforme documento emitido) I - Operação isenta ou não tributável, executadas no Município de XXXXXX. F Operação isenta ou não tributável pelo Município de XXXXX, executada em outro Município. C - Cancelada E - Extraviada J ISS Suspenso por Decisão Judicial 6 Data de Cancelamento 38 8 T Se a NFS-e tiver sido cancelada, este campo será preenchido com a data de cancelamento da NF-e (no formato AAAAMMDD), caso contrário, será preenchido com espaços. 7 Município de prestação do serviço 46 7 N Código do município onde o serviço foi prestado (tabela do IBGE), se exterior colocar 9999999. 8 Valor Total dos Serviços 53 15 N 9 Valor Total das Deduções 68 15 N 10 Valor da retenção do PIS 83 15 N Valor Total dos Serviços da nota fiscal, incluindo os centavos (sem ponto decimal e sem R$), com 15 posições. As casas decimais podem váriar entre 2 e 4, conforme a ordem 10 do Registro Tipo 1. Caso a situação da nota seja igual a C (Cancelada) ou E (Extraviada), as 15 posições poderão estar preenchidas Valor Total das deduções para Redução da Base de Cálculo em R$ (sem ponto Valor da retenção do PIS em R$.
11 Valor da retenção do COFINS 98 15 N Valor da retenção do COFINS em R$. 12 Valor da retenção do INSS 113 15 N 13 Valor da retenção do IR 128 15 N 14 Valor da retenção do CSLL 143 15 N 15 Valor do ISSQN 158 15 N 16 Local da Prestação 173 1 T 17 Seqüencial da NFS-e à ser Substituída 174 20 N Valor da retenção do INSS em R$. Valor da retenção do IR em R$. Valor da retenção do CSLL em R$. Valor Total de ISSQN da Nota Fiscal, incluindo os centavos (sem ponto decimal e sem R$), com 15 posições. Caso a situação da nota seja igual a C (Cancelada) ou E (Extraviada), as 15 posições poderão estar preenchidas Local da Prestação com uma posição: F Fora do Município, M Município Número Seqüencial de uma NFS-e ordem 2 deste registro do layout que já foi enviado ou que conste no arquivo à ser processado para que o mesmo seja cancelado e substituído pela nota atual. 18 Outros Descontos 194 15 T Valor para Outros Descontos da Nota Fiscal, incluindo os centavos (sem ponto decimal e sem R$), com 15 posições. 19 Brancos 209 183 T Preencher com Brancos 20 Sequencial do registro 392 8 N Registro Tipo 3 Identificação do Tomador da NFS-e o valor 3, indicando linha de Número Seqüencial para controle do prestador, com possibilidade de atingir 2 Seqüencial da NFS-e 2 20 N 20 dígitos. é permitida a duplicação de números.
3 Indicador de CPF/CNPJ do Tomador 22 1 T 4 CNPJ, CPF do Tomador/(Documento) 23 14 T Este campo indica o tipo de dados fornecido no campo CPF/CNPJ do Tomador. Valor 1 para CPF. Valor 2 para CNPJ. Valor 3 para Identificado. (Quando usada esta opção as demais à baixo não serão obrigatórias). Valor 9 para Estrangeiro. (Quando usada esta opção deve se informar um documento no campo abaixo que identifique o estrangeiro como por exemplo o passaporte). CNPJ do Tomador com 14 posições, CPF do Tomador com 11 posições. Sem formatação (ponto, traço, barra,...) alinhados à esquerda ou Documento para os casos de Estrangeiro Nome do Tomador para tipo 1 ou Razão 5 Nome do Tomador 37 50 T Social para tipo 2. Nome Fantasia para Tomadores do tipo 6 Nome Fantasia 87 50 T 2. 7 Tipo de Endereço do Tomador 137 3 T 8 Endereço do Tomador 140 50 T 9 Número do Endereço do Tomador 190 10 T 10 Complemento do Endereço do Tomador 200 20 T 11 Bairro do Tomador 220 30 T 12 Cidade do Tomador 250 50 T 13 UF do Tomador 300 2 T 14 CEP do Tomador 302 8 T Caso o conteúdo destes campos não tenha sido fornecido na emissão da NFS-e, eles serão preenchidos com espaços até completar o número máximo de posições de cada um. 15 E-Mail do Tomador 310 60 T E-mail de contato do tomador 16 Inscrição Estadual Tomador 370 20 T Inscrição Estadual do Tomador 17 Brancos 390 2 T Preencher com Brancos 18 Sequencial do registro 392 8 N Registro Tipo 4 Observação da NFS-e o valor 4, indicando linha de. Caso seja necessário uma Observação maior, o registro deve ser re-informado com a continuação do texto, até o tamanho necessário. Número Seqüencial para controle do prestador, com possibilidade de atingir 2 Seqüencial da NFS-e 2 20 N 20 dígitos. é permitida a duplicação de números. Caso não seja utilizado preencher com 3 Observação da Nota 22 255 T brancos 4 Brancos 277 115 T Preencher com Brancos 5 Sequencial do registro 392 8 N Registro Tipo 5 Descrição do Serviço Realizado o valor 5, indicando linha de. Número Seqüencial para controle do prestador, com possibilidade de atingir 2 Seqüencial da NFS-e 2 20 N 20 dígitos. é permitida a duplicação de números. 3 Código do serviço prestado 22 4 T Código do serviço prestado. Item da LC 116/2003. Caso não seja usado preencher com XXXX
Código do serviço pre 4 Código Tributação Município 26 20 T stado próprio do município Valor do Serviço, incluindo os centavos (sem ponto decimal e sem R$), com 15 posições. 5 Valor do Serviço 46 15 N As casas decimais podem váriar entre 2 e 4, conforme a ordem 10 do Registro Tipo 1. Caso a situação da nota seja igual a C (Cancelada) ou E (Extraviada), as 15 posições poderão estar preenchidas 6 Valor Dedução 61 15 N Valor da Dedução, incluindo os centavos (sem ponto decimal e sem R$), com 15 posições. Caso a situação da nota seja igual a C (Cancelada) ou E (Extraviada), as 15 posições poderão estar preenchidas Valor da Alíquota, incluindo duas casas decimais (sem ponto decimal e sem %) com 4 posições 7 Alíquota 76 4 N 5,00% 0500 2,75% 0275 8 Unidade 80 20 T Unidade do Serviço Quantidade do Serviço incluindo duas casas decimais 9 Quantidade 100 8 N 22,66 00002266 As casas decimais podem váriar entre 2 e 4, conforme a ordem 11 do Registro Tipo 1. 10 Descrição do Serviço 108 255 T Descrição do Serviço 11 Alvará 363 20 T Alvará para Construção Civil 12 Brancos 383 9 T Preencher com Brancos 13 Sequencial do registro 392 8 N Registro Tipo 6 Indicador de Final de Arquivo o valor 6, indicando linha de 2 Brancos 2 390 T Preencher com Brancos 3 Sequencial do registro 392 8 N Especificações do Layout de Retorno 1. O arquivo tem o formato texto (Text Encoding = ISO-8859-1), podendo ser salvo com qualquer nome, a critério do contribuinte, possuindo no máximo 10 MB (10240 Kbytes) de tamanho. 2. O arquivo conterá as NFS-e emitidas acatadas pela Prefeitura em um determinado período, de acordo com o arquivo de envio original. 3. O arquivo de retorno será nomeado com o prefixo retorno_ seguido do CNPJ do prestador (sem pontos e barras) e acrescido do mesmo sequencial de controle do arquivo de envio original.
4. A extensão do arquivo será txt. Layout de Retorno (Prefeitura Contribuinte) O arquivo de retorno é formado por campos que possuem tamanhos fixos (largura fixa), com organização sequencial e agrupada em registros de 70 bytes de comprimento contando com salto de linha, conforme a tabela de construção e formatação do layout apresentada mais abaixo. Composição do Arquivo Registro Tipo 1 Header do Arquivo: Registro obrigatório de abertura do arquivo. Contém as informações do Prestador e do lote de recibo das NFS-e. Só ocorre uma única vez no arquivo. Registro Tipo 2 Retorno da NFS-e: Registro obrigatório que identifica detalhes sobre cada nota processada pela Prefeitura. Este registro será gerado para cada nota acatada pela prefeitura. Registro Tipo 3 Indicador de Final de Arquivo: Registro obrigatório de fechamento do arquivo. Todos os campos numéricos serão preenchidos alinhados pela direita e sem formatação (sem ponto e sem vírgula). Se necessário, serão preenchidos com zeros à esquerda até completar seu tamanho máximo. Registro Tipo 1 Header do Arquivo o valor 1, indicando linha de 2 Versão do Layout 2 3 N Indica a versão do layout a ser utilizada. Será preenchido com o número da versão atual. A versão atual é a 100. 3 Inscrição Municipal do Prestador 5 26 T Inscrição municipal do prestador a que se refere o arquivo, alinhado à esquerda. 4 Indicador de CPF/CNPJ do Prestador 31 1 N Este campo indica o tipo de dados fornecido no campo CPF/CNPJ do Prestador. Valor 1 para CPF. Valor 2 para CNPJ. CNPJ do Prestador com 14 posições ou CPF do Prestador com 11 posições. Sem 5 CNPJ ou CPF do Prestador 32 14 T formatação (ponto, traço, barra,...) alinhados à esquerda 6 Brancos 46 51 T Preencher com Brancos 7 Sequencial do registro 97 8 N Registro Tipo 2 Retorno NFS-e o valor 2, indicando linha de 2 Sequencial da NFS-e 2 20 N Número sequencial gerado pelo prestador e informado no lote de envio com possibilidade de atingir 20 dígitos. 3 Número da NFS-e 22 20 N Número da NFS-e gerado pela Prefeitura e vinculado com o Sequencial gerado pelo prestador. 4 Indicador de CPF/CNPJ do Tomador 42 1 N Este campo indica o tipo de dados fornecido no campo CPF/CNPJ do Prestador. Valor 1 para CPF. Valor 2 para CNPJ. CNPJ do Prestador com 14 posições ou CPF do Prestador com 11 posições. Sem 5 CNPJ ou CPF do Tomador 43 14 T formatação (ponto, traço, barra,...) alinhados à esquerda 6 Código de Verificação 57 40 T Código de Verificação da Nota 7 Sequencial do registro 97 8 N arquivo.
Registro Tipo 3 Indicador de Final de Arquivo o valor 3, indicando linha de 2 Brancos 2 95 T Preencher com Brancos 3 Sequencial do registro 97 8 N arquivo.