Nota Fiscal de
Serviço Eletrônica – NFS-e
ANEXO I - MANUAL DE FORMATO
XML DA NFS-e
Este manual destina-se a orientar
o Prestador de Serviços na
geração e uso dos arquivos XML
da Nota Fiscal de Serviços
eletrônica – NFS-e.
Versão 1.6.1 05/03/2012
Infisc
NOTA FISCAL DE SERVIÇO – Eletrônica (NFS-e)
Anexo I - Manual de formato XML da NFS-e
Sumário
1. Apresentação.................................................................................................................3
2. Convenções de formatos deste Manual ........................................................................4
3. Leiaute da Nota Fiscal de Serviços Eletrônica – NFS-e – Versão 1.0..........................5
4. Composição da Chave de Acesso da NFS-e..................................................................9
Infisc
VERSÃO 1.6.1
Data: 05/03/2012
NOTA FISCAL DE SERVIÇO – Eletrônica (NFS-e)
Manual de formato XML da NFS-e
1. Apresentação
Este documento tem como objetivo apresentar as especificações técnicas de formato de
arquivos utilizadas pelo Sistema de Notas Fiscais de Serviço eletrônicas (NFS-e) ®, permitindo que
sejam utilizados pelos contribuintes os arquivos XML (eXtend Markup Language) das Notas
Fiscais disponibilizados pelo sistema sempre que uma NFS-e é gerada.
Ainda, para conectividade de sistemas ERP com o sistema NFS-e da prefeitura, com
transferência automática de informações de faturamento,
este manual deve ser utilizado em
conjunto com o “MANUAL DE XML PARA TRATAMENTO DE NFS-e”, também disponível no
site. Juntos, estes dois Manuais definem o padrão de interação entre os sistemas através de formatos
XML pré-definidos.
Tais arquivos devem estar em conformidade com o padrão de linguagem XML e atender
estritamente aos leioutes aqui instruídos, específicos para as Notas Fiscais de Serviço –eletrônicas
(NFS-e).
NOTA FISCAL DE SERVIÇO – Eletrônica (NFS-e)
Manual de formato XML da NFS-e
2. Convenções de formatos deste Manual
Versão atual do leiaute
Formato N.N
Versão 1.00
Legendas de Tipos de Campos
N
D
C
XML
Numérico
Data
Caracter
Formato XML específico
Valores Numéricos com Decimais
Formato: N,NN
Cada campo tem seu tamanho
descrito no campo “observações”
Exemplo: “13,2”, significa 13 inteiros e 2 decimais.
Deve ser utilizada a “,” como separador decimal (virgula)
16382,34
1,00
0,50
Valores Numéricos Percentuais
Formato N,NN
O formato em percentual deve ser
informado com o caracter separador das casas decimais (vírgula).
Exemplo:
62% = 62,00
18,00% = 18,00
Data e Hora
Campos Tipo Caracter
Campo opcionais com valores vazios ou zeros
LAYOUT DO ARQUIVO
Formato
AAAA-MM-DD HH:MM:SS
O campo deve ser informado com
os separadores e um espaço entre
a data e a hora, que são
opcionais..
Tamanho máximo=conforme
definido em cada campo
Não devem constar no arquivo ou
não tem o valor indicado dentro da
tag
NOTA FISCAL DE SERVIÇO – Eletrônica (NFS-e)
Manual de formato XML da NFS-e
3. Leiaute da Nota Fiscal de Serviços Eletrônica – NFS-e – Versão 1.0
3.1.
#
Dados da Nota Fiscal de Serviços Eletrônica – NFS-e
Campo
AA01 infNFSe
AA02 Versão
3.2.
#
Descrição
Tipo de leiaute
Versão do leiaute
Tam
Max
Tipo
Obrig
3
N
Tam
Max
Tipo
9
N
S
S
100
2
C
C
S
S
3
9
C
N
D
S
S
S
S
Observação
“NFS-e”
1 – 999
Identificação da NFS-e
Campo
AB01
AB02
Id
cNFS-e
AB03
AB04
natOp
Mod
AB05
AB06
AB07
Serie
nNFS-e
dEmi
AB08
dSaiEnt
AB09
AB10
tpNF
cMunFG
AB11
refNF
AB12
tpImp
AB13
Descrição
Código Numérico que é um dos
componentes da Chave de Acesso
Descrição da Natureza da Operação
Código do Modelo do Documento
Fiscal
Série do Documento Fiscal
Número do Documento Fiscal
Data de emissão do Documento
Fiscal
Data de Saída ou da Entrada do
Serviço
Tipo do Documento Fiscal
Código do Município de Ocorrência
do Fato Gerador Chaves de acesso da
NFS-e
Chaves de acesso das NFS-e
referenciadas
Obrig
D
Observação
Número Aleatório gerado pelo
Emitente da NFS-e
1 – 999999999
Formato “AAAA-MM-DD”
Formato "AAAA-MM-DD "
1
7
N
N
S
S
0-entrada / 1-saída
Utilizar a Tabela do IBGE
39
C
Formato de Impressão da NFS-e
1
N
Chave de acesso conforme
composição no item 2.10 deste
manual
1-Retrato/ 2-Paisagem
tpEmis
Forma de Emissão da NFS-e
1
C
N-Normal/ C-Contingência
AB14
AB15
AB16
AB17
Anulada
Notadebito
motAnul
dataAnul
Se a nota esta anulada
Se a nota for de debito
Motivo anulacao nota
Data da anulação da nota
1
1
100
C
C
C
D
S- Sim ou N-Não
S- Sim ou N-Não
AB18
AB19
AB20
notaSub
serieSub
descDesconto
Numero nota substituta
Serie da NF substituta
Descrição de desconto
6
3
100
N
C
C
AB21
descCondEsp
Descrição de desconto especial
100
C
AB22
AB23
numeroART
Numero CEI
Numero da ART
Numero da Matrícula no CEI
15
15
C
C
AAAA-MM-DD
Para construção civil
Para construção civil
NOTA FISCAL DE SERVIÇO – Eletrônica (NFS-e)
Manual de formato XML da NFS-e
3.3.
#
AC01
AC02
AC03
AC04
AC05
AC06
AC07
AC08
AC09
AC10
AC11
AC12
AC13
AC14
AC15
AC16
AC17
Identificação do Emitente da NFS-e
Campo
Emit
CNPJ
xNome
xFant
IM
End
xLgr
Nro
xCpl
xBairro
cMun
xMun
UF
CEP
cPais
xPais
Fone
AC18 IE
AC19 IEST
AC20 IMSTS
3.4.
#
Descrição
Emitente
CNPJ do Emitente
Razão Social ou Nome do Emitente
Nome fantasia
Inscrição Municipal
Endereço do Emitente
Logradouro
Número
Complemento
Bairro
Código do município
Nome do município
Sigla da UF
Código do CEP
Código do País
Nome do País
Telefone
IE
IE do Substituto Tributário
Inscrição Municipal do Substituto
Tributário do ISS
Tam
Max
Tipo
14
70
60
15
N
C
C
C
100
10
100
100
7
60
2
8
4
100
13
C
C
C
C
N
C
C
N
N
C
N
14
14
15
C
C
C
Obrig
Observação
S
S
S
S
S
S
S
S
S
S
S
Utilizar a Tabela do IBGE
Associado a tabela IBGE
Sem caracter separador
Tabela Banco Central BR
Associado tabela BCB
Identificação do Tomador do Serviço
Campo
Descrição
AD01 TomS
AD02 CNPJ
Tomador
CNPJ do Tomador
AD03
AD04
AD05
AD06
AD07
AD08
AD09
AD10
AD11
AD12
AD13
AD14
AD15
AD16
AD17
AD18
CPF
xNome
Ender
xLgr
Nro
xCpl
xBairro
cMun
xMun
UF
CEP
cPais
xPais
Fone
IE
IM
CPF do Tomador
Razão Social ou nome do destinatário
Endereço
Logradouro
Número
Complemento
Bairro
Código do município
Nome do município
Sigla da UF
Código do CEP
Código do País
Nome do País
Telefone
IE
Inscrição Municipal
AD19 IMSTS
Inscrição Municipal do Substituto
Tributário do ISS
Praca de pagamento
AD20 Praca
Tam
Max
Tipo
14
N
11
N
C
100
10
100
100
7
60
2
8
4
100
13
14
15
C
C
C
C
N
C
C
N
N
C
N
C
C
15
C
70
C
Obrig
S
S
S
S
S
S
S
S
S
S
S
Observação
Obrigatório se pessoa Jurídica
Obrigatório se pessoa Física
Utilizar a Tabela do IBGE
Vinculado a tabela do IBGE
Sem caracteres separadores
Conforme tabela do BCB
Vinculado a tabela do BCB
NOTA FISCAL DE SERVIÇO – Eletrônica (NFS-e)
Manual de formato XML da NFS-e
3.5.
#
Detalhamento de Serviços da NFS-e
Campo
AE01
AE02
AE03
AE04
Det
nItem
serv
cServ
AE05
AE06
AE07
AE08
AE09
AE10
AE11
AE12
AE13
AE14
AE15
xServ
uTrib
qTrib
vUnit
vServ
vDesc
vBCISS
pISS
vISS
pRetINSS
vRetINSS
3.6.
#
AF01
AF02
AF03
AF04
AF05
AF06
AF07
AF08
AF09
AF10
AF11
AF12
AF13
3.7.
#
Tam
Max
Tipo
3
N
Código do serviço
60
C
Descrição do serviço
Unidade
Quantidade
Valor unitario
Valor Bruto do Serviço
Valor do Desconto
Base de Cálculo do ISS
Alíquota do imposto
Valor do ISS
Percentual retencao INSS
Valor retencao INSS
120
6
11
15
15
15
15
5
15
5
15
C
C
N
N
N
N
N
N
N
N
N
Descrição
Obrig
Observação
S
Número do item
S
S
Preencher com código obtido na
tabela de serviços do Município
S
S
S
S
Formato 13,2
Formato 13,2
Formato 13,2
Formato 13,2
Formato 3,2
Formato 13,2
Formato 3.2
Formato 13,2
Reembolsos e Restituições – Valores não Tributados pelo ISS
Campo
reemb
nItemReemb
nTit
cReemb
xReemb
uReemb
qReemb
vReemb
vRepass
vLiquid
tPagto
nLote
dPagto
Descrição
Número do item
Número do título
Código do reembolso
Descrição do reembolso
Unidade
Quantidade
Valor do reembolso
Valor do repasse para terceiros
Valor líquido a pagar
Tipo de pagamento
Número do lote de reembolso
Data do pagamento
Tam
Max
3
8
5
120
6
11
15
15
15
50
8
Tipo
Obrig
N
N
C
C
C
N
N
N
N
C
N
D
Observação
Formato 13,2
Formato 13,2
Formato 13,2
AAAA-MM-DD
ISS da Substituição Tributária
Campo
AG01 ISSST
AG02 pRedBCST
AG03 vRedBCST
AG04 vBCST
AG05 pISSST
AG06 vISSST
Descrição
ISS Substituição Tributária
Percentual da Redução do BC do
ISS ST
Valor da Redução da BC do ISS
ST
Valor da BC do ISS ST
Alíquota do imposto
Valor do ISS ST
Obrig
Tam
Max
Tipo
5
N
Formato 3,2
15
N
Formato 13,2
15
5
15
N
N
N
Formato 13,2
Formato 3,2
Formato 13,2
Observação
NOTA FISCAL DE SERVIÇO – Eletrônica (NFS-e)
Manual de formato XML da NFS-e
3.8.
Valores Totais da NFS-e
#
AH01
AH02
AH03
AH04
AH05
AH06
AH07
AH08
AH09
AH10
AH11
AH12
AH21
AH22
AH23
AH24
AH25
AH26
AH27
AH28
AH29
AH30
AH31
total
vReemb
vServ
vDesc
vOutro
vtNF
vtLiq
Ret
xRetIRF
pRetIRF
vRetIRF
xRetLei10833PIS-PASEP
pRetLei10833PIS-PASEP
vRetLei10833PIS-PASEP
xRetLei10833COFINS
pRetLei10833COFINS
vRetLei10833COFINS
xRetLei10833CSLL
pRetLei10833CSLL
vRetLei10833CSLL
xRetINSS
vtRetINSS
Fat
nFat
vOrig
vDesc
vLiq
ISS
vBCISS
vISS
vBCSTISS
AH32
vSTISS
AH13
AH14
AH15
AH16
AH17
AH18
AH19
AH20
3.9.
Obrig
Tam
Max
Tipo
15
15
15
15
15
15
N
N
N
N
N
N
50
5
15
50
C
N
N
C
Formato 3,2
Formato 13,2
5
N
Formato 3,2
15
N
Formato 13,2
50
C
5
N
Formato 3,2
15
N
Formato 13,2
Descrição da retenção de CSLL
50
C
Percentual de retenção de CSLL
5
N
Formato 3,2
Valor da retenção de CSLL
15
N
Formato 13,2
50
15
C
N
Formato 13,2
50
15
15
15
C
N
N
N
Formato 13,2
Formato 13,2
Formato 13,2
15
15
15
N
N
N
S
S
S
S
Formato 13,2
Formato 13,2
Formato 13,2
15
N
S
Formato 13,2
Tam
Max
Tipo
10
N
Campo
Descrição
Totais da nota
Valor do Reembolso
Valor Total dos Serviços
Valor Total do Desconto
Outras Despesas Acessórias
Valor Total da NFS-e
Valor liquido a pagar
Retençoes
Descrição da retenção de IRF
Percentual de retenção de IRF
Valor da retenção de IRF
Descrição da retenção de PISPASEP
Percentual de retenção de PISPASEP
Valor da retenção de PIS-PASEP
Descrição da retenção de
COFINS
Percentual de retenção de
COFINS
Valor da retenção de COFINS
Descrição de retenção do INSS
Valor total da retenção do INSS
Fatura
Número da Fatura
Valor Original da Fatura
Valor do desconto
Valor Líquido da Fatura
ISS
Base de Cálculo do ISS
Valor Total do ISS
Base de Cálculo do ISS
Substituição Tributária
Valor Total do ISS Substituição
Tributária
Observação
S
S
Formato 13,2
Formato 13,2
Formato 13,2
Formato 13,2
Formato 13,2
Formato 13,2
Dados da Cobrança
#
Campo
AI01
cobr
AI07
AI08
dup
nDup
Descrição
Cobrança
Duplicata
Número da Duplicata
Obrig
Observação
NOTA FISCAL DE SERVIÇO – Eletrônica (NFS-e)
Manual de formato XML da NFS-e
AI09
AI10
AI11
dVenc
vDup
urlBol
Data de vencimento
Valor da duplicata
Boleto
AI12
bBol
Indicador da geração de boleto
3.10.
D
N
256
C
1
C
Tam
Max
Tipo
256
C
5000
C
Tam
Max
Tipo
100
C
AAAA-MM-DD
Formato 13,2
URL que pode ser usada para se
exibir o boleto no navegador
1 – Gera 2 – Não gera
Informações Adicionais
#
Campo
AJ01
AJ02
infAdic
infAdic
AJ03
infComp
3.11.
15
Descrição
Informações Adicionais
Informações
Adicionais
de
Interesse do Fisco
Informações Complementares de
interesse do Contribuinte
Obrig
Observação
Outras Informações
#
Campo
AK01 Observações
AK02 Xinf
Descrição
Item de observação
Obrig
Observação
Este item se repete tantas vezes
quanto for necessário em uma
nota
4. Composição da Chave de Acesso da NFS-e
A Chave de acesso da NFe tem o seguinte leiaute:
#
Campo
AL01 UF
AL02 CNPJ
AL03 Mod
AL04 Serie
AL05 nNF
AL06 CNF
Tam
Max
Código da UF do emitente do
2
Documento Fiscal
CNPJ do emitente
14
Modelo do Documento Fiscal
2
Série do Documento Fiscal
3
Descrição
Número do Documento Fiscal
Código Numérico que compõe
a Chave de Acesso
9
9
Tipo
N
N
C
C
N
N
Observação
Utilizar a Tabela do IBGE
Preencher com zeros a direita
Exemplo: “T00”, “000”, “S00”
1 – 999999999
Número Aleatório gerado pelo
Emitente da NF-e
A regra de formação do nome do arquivo da NF-e será a chave de acesso completa com extensão
“.nfe”.