NFe Layout Emitidas Recebidas-1
NFe Layout Emitidas Recebidas-1
NFe Layout Emitidas Recebidas-1
Eletrônica – NFS-e
Versão 4.09
http://notadomilhao.prefeitura.sp.gov.br/Nfe/empresas/informacoes-gerais/manuais
Manual de Exportação de NFS-e Versão do Manual: 4.09 pág. 2
ÍNDICE
1. Introdução ................................................................................................................................................ 3
2. Especificações........................................................................................................................................... 3
3. Formatos e Layout Disponíveis ................................................................................................................ 3
3.1. Instruções Gerais ............................................................................................................................... 3
3.2. Tipos de Registro utilizados por cada formato.................................................................................. 4
3.3. Formato txt ........................................................................................................................................ 4
3.4. Formato csv ..................................................................................................................................... 13
3.5. Formato txt tabulado ...................................................................................................................... 14
3.6. Formato txt retorno (Arquivo de Retorno) ..................................................................................... 14
4. Acesso ao Sistema .................................................................................................................................. 27
5. Mais Informações ................................................................................................................................... 27
Manual de Exportação de NFS-e Versão do Manual: 4.09 pág. 3
1. Introdução
Este manual tem como objetivo apresentar os layouts utilizados pelo Sistema NFS-e da Prefeitura de São
Paulo na exportação de NFS-e (Prefeitura → Contribuintes), permitindo que sejam transferidas
informações da Prefeitura para os contribuintes em arquivos texto. Tais arquivos serão gerados em layouts
pré-definidos, apresentados neste documento.
Este manual não contempla a substituição do Recibo Provisório de Serviços (RPS) por NFS-e (conversão
em lote). Para importar os RPS no sistema de NFS-e, enviando informações do contribuinte para a
Prefeitura (Contribuinte → Prefeitura), consulte o manual disponível na seção “Manuais”, acessando o
endereço:
http://notadomilhao.prefeitura.sp.gov.br/Nfe/empresas/informacoes-gerais/manuais
2. Especificações
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.
O arquivo poderá ser gerado em 4 (quatro) tipos de formatos, descritos no item 3 deste documento.
O contribuinte poderá escolher o formato que lhe for mais conveniente.
Neste item, são apresentados os 4 tipos de layout e 4 tipos de formato de arquivo de exportação (Prefeitura
→ Contribuintes) disponíveis no sistema de NFS-e. O contribuinte poderá escolher o formato que lhe for
mais conveniente.
Manual de Exportação de NFS-e Versão do Manual: 4.09 pág. 4
O formato TXT utiliza os seguintes tipos de registro, na disposição em que são apresentados:
Os formatos CSV e TXT Tabulado utilizam os seguintes tipos de registro, na disposição em que são
apresentados:
1º Linha do arquivo: Cabeçalho com o nome de cada um dos campos apresentados no Registro
Tipo 2, separados por seus respectivos delimitadores (CSV = “;” e Tabulado = “TAB” - código
ASCII 9);
Registro Tipo 2: Zero ou mais linhas de detalhe. Cada linha correspondente a uma NFS-e
(inclusive RPS-C);
Última linha do arquivo: Totalizador da quantidade de NFS-e do arquivo, Valor dos Serviços, das
Deduções, do ISS e do Crédito. Todos Alinhados com suas respectivas colunas (o total da
quantidade de notas do arquivo está alinhado com a coluna que apresenta o Nº das NFS-e).
O formato TXT Retorno utiliza os seguintes tipos de registro, na disposição em que são apresentados:
Neste formato, os campos possuem tamanhos fixos conforme descritos nas tabelas a seguir.
Neste formato 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.
Todos os campos alfanuméricos 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.
Manual de Exportação de NFS-e Versão do Manual: 4.09 pág. 5
Posição Posição
Ordem Campo Tamanho Formato Conteúdo
Inicial Final
O arquivo de exportação
conterá todas as Notas Fiscais
Data de Início do
referentes ao período
Período
4 13 20 8 AAAAMMDD escolhido. Neste campo será
Transferido no
informada a Data INICIAL
Arquivo
desse período no formato
AAAAMMDD.
O arquivo de exportação
conterá todas as Notas Fiscais
Data de Fim do
referentes ao período
Período
5 21 28 8 AAAAMMDD escolhido. Neste campo será
Transferido no
informada a Data FINAL desse
Arquivo
período no formato
AAAAMMDD.
REGISTRO TIPO 2 – DETALHE (para o layout V.001 na íntegra e V.002 e V.003 até a ordem 47)
Posição Posição
Ordem Campo Tamanho Formato Conteúdo
Inicial Final
Código de
Código de Verificação da NFS-e
4 verificação da 24 31 8 Texto
com 8 posições.
NFS-e
Razão Social do
12 85 159 75 Texto Razão Social do Prestador.
Prestador
Tipo do Endereço
13 do Prestador (Rua, 160 162 3 Texto Tipo do Endereço do Prestador.
Av, ...)
Endereço do
14 163 212 50 Texto Endereço do Prestador.
Prestador
Número do
Número do Endereço do
15 Endereço do 213 222 10 Texto
Prestador.
Prestador
Manual de Exportação de NFS-e Versão do Manual: 4.09 pág. 7
Posição Posição
Ordem Campo Tamanho Formato Conteúdo
Inicial Final
Complemento do
Complemento do Endereço do
16 Endereço do 223 252 30 Texto
Prestador.
Prestador
Bairro do
17 253 282 30 Texto Bairro do Prestador.
Prestador
Cidade do
18 283 332 50 Texto Cidade do Prestador.
Prestador
E-mail do
21 343 417 75 Texto E-mail do Prestador.
Prestador
Posição Posição
Ordem Campo Tamanho Formato Conteúdo
Inicial Final
Data de Quitação
Data de quitação da guia
da Guia
26 440 447 8 AAAAMMDD vinculada a NFS-e no formato
Vinculada a Nota
AAAAMMDD.
Fiscal
Código do Serviço
Código do Serviço da Nota Fiscal
29 Prestado na Nota 478 482 5 Numérico
com 05 posições.
Fiscal
Posição Posição
Ordem Campo Tamanho Formato Conteúdo
Inicial Final
Razão Social do
38 553 627 75 Texto Razão Social do Tomador.
Tomador
Tipo do Endereço
39 do Tomador (Rua, 628 630 3 Texto
Av, ...)
Endereço do
40 631 680 50 Texto
Tomador
Número do
41 Endereço do 681 690 10 Texto
Tomador
Texto
Posição Posição
Ordem Campo Tamanho Formato Conteúdo
Inicial Final
ATENÇÃO: para o Layout V.002, os itens ordenados de 48 a 52 são conforme demonstrados abaixo.
Posição Posição
Ordem Campo Tamanho Formato Conteúdo
Inicial Final
R$ 500,85: 000000000050085
50 ISS a recolher 909 923 15 Numérico Valor a recolher para a NFS-e,
incluindo os centavos (sem
ponto decimal e sem R$), com
15 posições. Exemplo:
R$ 500,85: 000000000050085
51 Discriminação dos 924 924 + (N- N (N ≤ Texto Descritivo dos serviços. Texto
Serviços 1) 1000) contínuo. O conjunto de
caracteres correspondentes ao
código ASC 13 e ASC 10
(Chr(13) + Chr(10)) deverá ser
substituído pelo caracter | (pipe
ou barra vertical. ASC 124).
Exemplo:
Digitado na NF “Lavagem de
carro
com lavagem de motor”
Preenchimento do arquivo:
“Lavagem de carro|com lavagem
de motor”
Não serão colocados espaços
neste campo para completar seu
tamanho máximo (que é de 1000
caracteres).
52 Caractere de Fim 924 + N 925 + N 2 ASC(13) + Caractere de Fim de Linha
de Linha ASC(10) (Chr(13) + Chr(10)).
Manual de Exportação de NFS-e Versão do Manual: 4.09 pág. 11
ATENÇÃO: para o Layout V.003, os itens ordenados de 48 a 57 são conforme demonstrados abaixo.
Posição Posição
Ordem Campo Tamanho Formato Conteúdo
Inicial Final
R$ 500,85: 000000000050085
50 ISS a recolher 909 923 15 Numérico Valor a recolher para a NFS-e,
incluindo os centavos (sem
ponto decimal e sem R$), com
15 posições. Exemplo:
R$ 500,85: 000000000050085
51 Indicador de 924 924 1 Numérico Este campo indica o tipo de
CPF/CNPJ do dados fornecido no campo
Intermediário CPF/CNPJ do Intermediário
Valor 1 para CPF.
Valor 2 para CNPJ.
Valor 3 para sem CPF/CNPJ
informado.
R$ 500,85: 000000000050085
Posição Posição
Ordem Campo Tamanho Formato Conteúdo
Inicial Final
ATENÇÃO: para o Layout V.004, os itens ordenados de 56 a 70 são conforme demonstrados abaixo.
O layout V.004 trata da exportação da nota com adição de informações sobre retenções federais e carga
tributária, obras e município de prestação do serviço e os novos campos relativos à nota consolidada de
SUP (sociedade uniprofissional).
Posição Posição
Ordem Campo Tamanho Formato Conteúdo
Inicial Final
Posição Posição
Ordem Campo Tamanho Formato Conteúdo
Inicial Final
Este formato contempla os mesmos campos e na mesma ordem do formato TXT (registros tipo 2), descrito
no item 3.3. Neste formato, os campos são separados por “;” (ponto e vírgula). O arquivo gerado pode ser
facilmente visualizado através de planilhas no formato Excel.
Observações:
Os campos a seguir serão preenchidos com seu respectivo padrão de formatação: Inscrição Municipal
(0.000.000-0), CPF (000.000.000-00), CNPJ (00.000.000/0000-00), CEP (00000-000);
Os campos referentes a valores monetários (Valor dos Serviços, Valor das Deduções, Valor do ISS e
Valor do Crédito) e o campo de Alíquota serão preenchidos com sua formatação padrão, utilizando
ponto (“.”) como separador de milhar e virgula (“,”) como separador de decimal;
Todos os demais campos numéricos serão preenchidos sem formatação (sem ponto e sem vírgula) e
não 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 não será preenchido com zeros até
completar seu tamanho máximo.
Todos os campos texto (alfanumérico) não serão preenchidos com espaços em branco à direita até
completar seu tamanho máximo. Campo opcional (alfanumérico): caso o conteúdo do campo não tenha
sido fornecido, este não será preenchido.
Formato semelhante ao CSV (item 3.4). A única diferença é que neste formato, o caractere separador de
campos utilizado é o “TAB” (código ASCII 9).
Este formato contempla todas as informações do Tomador e do serviço prestado na NFS-e. A única
informação do Prestador de serviço fornecida no arquivo é o número do CCM (inscrição municipal). Neste
caso, o principal objetivo é disponibilizar para o Prestador um arquivo compacto contendo os dados das
NFS-e geradas após o envio dos RPS em Lote. Desta forma, é possível relacionar qual o número da NFS-
e foi gerado para cada RPS enviado, bem como ter acesso a outras informações geradas pelo sistema da
NFS-e: o código de verificação, a data de quitação do ISS e etc.
Observações:
Neste formato 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.
Todos os campos alfanuméricos 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
Manual de Exportação de NFS-e Versão do Manual: 4.09 pág. 15
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.
Posição Posição
Ordem Campo Tamanho Formato Conteúdo
Inicial Final
O arquivo de exportação
conterá todas as Notas Fiscais
Data de Início do
referentes ao período
Período
4 13 20 8 AAAAMMDD escolhido. Neste campo será
Transferido no
informada a Data INICIAL
Arquivo
desse período no formato
AAAAMMDD.
O arquivo de exportação
conterá todas as Notas Fiscais
Data de Fim do
referentes ao período
Período
5 21 28 8 AAAAMMDD escolhido. Neste campo será
Transferido no
informada a Data FINAL desse
Arquivo
período no formato
AAAAMMDD.
REGISTRO TIPO 2 - DETALHE (para o layout V.001 na íntegra e V.002 e V.003 até a ordem 32)
Posição Posição
Ordem Campo Tamanho Formato Conteúdo
Inicial Final
Manual de Exportação de NFS-e Versão do Manual: 4.09 pág. 16
Inscrição
Inscrição Municipal do
2 Municipal do 2 9 8 Numérico
Prestador, com 8 posições.
Prestador
Posição Posição
Ordem Campo Tamanho Formato Conteúdo
Inicial Final
Código de
Código de Verificação da NFS-
5 Verificação da 32 39 8 Texto
e com 8 posições.
NFS-e
P - Exportação de Serviços
S - NFS-e substituída
Posição Posição
Ordem Campo Tamanho Formato Conteúdo
Inicial Final
Código do Serviço
Código do Serviço da Nota
14 Prestado na Nota 109 113 5 Numérico
Fiscal com 05 posições.
Fiscal
Inscrição Municipal do
Tomador, com 8 posições.
Inscrição Quando o conteúdo deste
21 Municipal do 164 171 8 Numérico campo não tiver sido fornecido
Tomador na emissão da NFS-e, será
preenchido com zeros até
completar as 8 posições.
Razão Social do
23 184 258 75 Texto Razão Social do Tomador.
Tomador
Posição Posição
Ordem Campo Tamanho Formato Conteúdo
Inicial Final
Tipo do Endereço
24 do Tomador (Rua, 259 261 3 Texto
Av, ...) Caso o conteúdo destes
campos não tenha sido
fornecido na emissão da NFS-
Endereço do
25 262 311 50 Texto e, eles serão preenchidos com
Tomador
espaços até completar o
número máximo de posições de
Número do cada um.
26 Endereço do 312 321 10 Texto
Tomador
Complemento do
27 Endereço do 322 351 30 Texto
Tomador
Bairro do
28 352 381 30 Texto
Tomador
Cidade do
29 382 431 50 Texto
Tomador
ATENÇÃO: para o Layout V.002, os itens ordenados de 33 a 37 são conforme demonstrado abaixo.
Posição Posição
Ordem Campo Tamanho Formato Conteúdo
Inicial Final
Posição Posição
Ordem Campo Tamanho Formato Conteúdo
Inicial Final
R$ 500,85: 000000000050085
35 ISS a recolher 540 554 15 Numérico Valor a recolher para a NFS-e,
incluindo os centavos (sem
ponto decimal e sem R$), com
15 posições. Exemplo:
R$ 500,85: 000000000050085
36 Discriminação dos 555 555 + (N- N (N ≤ Texto Descritivo dos serviços. Texto
Serviços 1) 1000) contínuo. O conjunto de
caracteres correspondentes ao
código ASC 13 e ASC 10
(Chr(13) + Chr(10)) deverá ser
substituído pelo caracter | (pipe
ou barra vertical. ASC 124).
Exemplo:
Digitado na NF “Lavagem de
carro
com lavagem de motor”
Preenchimento do arquivo:
“Lavagem de carro|com lavagem
de motor”
Não serão colocados espaços
neste campo para completar seu
tamanho máximo (que é de
1000 caracteres).
37 Caractere de Fim 555 + N 556 + N 2 ASC(13) + Caractere de Fim de Linha
de Linha ASC(10) (Chr(13) + Chr(10)).
ATENÇÃO: para o Layout V.003, os itens ordenados de 33 a 42 são conforme demonstrado abaixo.
Posição Posição
Ordem Campo Tamanho Formato Conteúdo
Inicial Final
R$ 500,85: 000000000050085
35 ISS a recolher 540 554 15 Numérico Valor a recolher para a NFS-e,
incluindo os centavos (sem
ponto decimal e sem R$), com
15 posições. Exemplo:
R$ 500,85: 000000000050085
36 Indicador de 555 555 1 Numérico Este campo indica o tipo de
CPF/CNPJ do dados fornecido no campo
Intermediário CPF/CNPJ do Intermediário
Valor 1 para CPF.
Valor 2 para CNPJ.
Valor 3 para sem CPF/CNPJ
informado.
Posição Posição
Ordem Campo Tamanho Formato Conteúdo
Inicial Final
39 Razão Social do
578 652 75 Texto Razão Social do Intermediário.
Intermediário
40 Repasse do Plano 653 667 15 Numérico Repasse do Plano de Saúde,
de Saúde incluindo os centavos (sem
ponto decimal e sem R$), com
15 posições. Exemplo:
R$ 500,85: 000000000050085
41 Discriminação dos 668 668 + (N- N (N ≤ Texto Descritivo dos serviços. Texto
Serviços 1) 1000) contínuo. O conjunto de
caracteres correspondentes ao
código ASC 13 e ASC 10
(Chr(13) + Chr(10)) deverá ser
substituído pelo caracter | (pipe
ou barra vertical. ASC 124).
Exemplo:
Digitado na NF “Lavagem de
carro
com lavagem de motor”
Preenchimento do arquivo:
“Lavagem de carro|com lavagem
de motor”
Não serão colocados espaços
neste campo para completar seu
Manual de Exportação de NFS-e Versão do Manual: 4.09 pág. 21
ATENÇÃO: para o Layout V.004, os itens ordenados de 41 a 54 são conforme demonstrado abaixo.
O layout de versão V.004 trata da exportação da nota com adição de informações sobre retenções federais
e carga tributária, obras, município de prestação do serviço.
Posição Posição
Ordem Campo Tamanho Formato Conteúdo
Inicial Final
Posição Posição
Ordem Campo Tamanho Formato Conteúdo
Inicial Final
REGISTRO TIPO 3 - DETALHE (Exclusivo para NFS-e originada de Cupom Fiscal – Válido para o
layout V.001 na íntegra e V.002 e V.003 até a ordem 20)
Manual de Exportação de NFS-e Versão do Manual: 4.09 pág. 22
Posição Posição
Ordem Campo Tamanho Formato Conteúdo
Inicial Final
Inscrição
Inscrição Municipal do
2 Municipal do 2 9 8 Numérico
Prestador, com 8 posições.
Prestador
Código de
Código de Verificação da NFS-
5 Verificação da 32 39 8 Texto
e com 8 posições.
NFS-e
Posição Posição
Ordem Campo Tamanho Formato Conteúdo
Inicial Final
Posição Posição
Ordem Campo Tamanho Formato Conteúdo
Inicial Final
Código do Serviço
Código do Serviço da Nota
14 Prestado na Nota 109 113 5 Numérico
Fiscal com 05 posições.
Fiscal
ATENÇÃO: para o Layout V.002, os itens ordenados de 21 a 25 são conforme demonstrado abaixo.
REGISTRO TIPO 3 - DETALHE (Exclusivo para NFS-e originada de Cupom Fiscal – Válido para o
layout V.002 a partir da ordem 21)
Posição Posição
Ordem Campo Tamanho Formato Conteúdo
Inicial Final
R$ 500,85: 000000000050085
23 ISS a recolher 187 201 15 Numérico Valor a recolher para a NFS-e,
incluindo os centavos (sem
ponto decimal e sem R$), com
15 posições. Exemplo:
R$ 500,85: 000000000050085
24 Discriminação dos 202 202 + (N- N (N ≤ Texto Descritivo dos serviços. Texto
Serviços 1) 1000) contínuo. O conjunto de
caracteres correspondentes ao
código ASC 13 e ASC 10
(Chr(13) + Chr(10)) deverá ser
substituído pelo caracter | (pipe
ou barra vertical. ASC 124).
Exemplo:
Digitado na NF “Lavagem de
carro
com lavagem de motor”
Preenchimento do arquivo:
Manual de Exportação de NFS-e Versão do Manual: 4.09 pág. 25
ATENÇÃO: para o Layout V.003, os itens ordenados de 21 a 30 são conforme demonstrado abaixo.
REGISTRO TIPO 3 - DETALHE (Exclusivo para NFS-e originada de Cupom Fiscal – Válido para o
layout V.003 a partir da ordem 21)
Posição Posição
Ordem Campo Tamanho Formato Conteúdo
Inicial Final
Posição Posição
Ordem Campo Tamanho Formato Conteúdo
Inicial Final
R$ 500,85: 000000000050085
23 ISS a recolher 187 201 15 Numérico Valor a recolher para a NFS-e,
incluindo os centavos (sem
ponto decimal e sem R$), com
15 posições. Exemplo:
R$ 500,85: 000000000050085
24 Indicador de 202 202 1 Numérico Este campo indica o tipo de
CPF/CNPJ do dados fornecido no campo
Intermediário CPF/CNPJ do Intermediário
Valor 1 para CPF.
Valor 2 para CNPJ.
Valor 3 para sem CPF/CNPJ
informado.
25 CPF/CNPJ do 203 216 14 Numérico CNPJ do intermediário com 14
Intermediário posições ou CPF do tomador
com 11 posições. Sem
formatação (ponto, traço, barra,
....).
Quando o conteúdo deste
campo não tiver sido fornecido
na emissão da NFS-e, será
preenchido com zeros até
completar as 8 posições.
26 Inscrição Municipal 217 224 8 Numérico Inscrição Municipal do Tomador,
do Intermediário com 8 posições.
Quando o conteúdo deste
campo não tiver sido fornecido
na emissão da NFS-e, será
preenchido com zeros até
completar as 8 posições.
27 Razão Social do
225 299 75 Texto Razão Social do Intermediário.
Intermediário
28 Repasse do Plano 300 314 15 Numérico Repasse do Plano de Saúde,
de Saúde incluindo os centavos (sem
ponto decimal e sem R$), com
15 posições. Exemplo:
Manual de Exportação de NFS-e Versão do Manual: 4.09 pág. 26
R$ 500,85: 000000000050085
Posição Posição
Ordem Campo Tamanho Formato Conteúdo
Inicial Final
4. Acesso ao Sistema
Para exportar as NFS-e é necessário acessar o sistema de NFS-e e informar o CNPJ e a senha de acesso
(Senha-Web) ou Certificação Digital da empresa inscrita no cadastro de contribuintes municipal (CCM).
Caso sua empresa não possua autorização para emissão de NFS-e, é permitido apenas o envio e
validação do arquivo, não sendo permitida a gravação do mesmo. Com isto, é possível apenas validar o
arquivo, sem a necessidade de solicitar autorização para emissão de NFS-e.
5. Mais Informações
Para obter mais informações sobre a Exportação de NFS-e, acesse a seção Perguntas e Respostas do
site http://notadomilhao.prefeitura.sp.gov.br/Nfe/empresas/informacoes-gerais/perguntas-e-respostas
ou envie um e-mail para [email protected]
Para obter a versão mais atualizada deste documento, acesse o link a seguir:
http://notadomilhao.prefeitura.sp.gov.br/Nfe/empresas/informacoes-gerais/manuais