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.
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
3.1. Dados da Nota Fiscal de Serviços Eletrônica – NFS-e... 5
3.2. Identificação da NFS-e... 5
3.3. Identificação do Emitente da NFS-e... 6
3.4. Identificação do Tomador do Serviço... 6
3.5. Detalhamento de Serviços da NFS-e... 7
3.6. Reembolsos e Restituições – Valores não Tributados pelo ISS... 7
3.7. ISS da Substituição Tributária ... 7
3.8. Valores Totais da NFS-e... 8
3.9. Dados da Cobrança... 8
3.10. Informações Adicionais... 9
3.11. Outras Informações... 9
4. Composição da Chave de Acesso da NFS-e... 9
VERSÃO 1.6
Data: 31/10/2011
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).
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 intei-ros e 2 decimais.
Deve ser utilizada a “,” como sepa-rador 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 separa-dor das casas decimais (vírgula). Exemplo:
62% = 62,00 18,00% = 18,00
Data e Hora 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.
Campos Tipo Caracter Tamanho máximo=conforme definido em cada campo
Campo opcionais com valores vazios ou zeros Não devem constar no arquivo ou não tem o valor indicado dentro da tag
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 Descrição TamMax Tipo Obrig Observação
AA01 infNFSe Tipo de leiaute S “NFS-e” AA02 Versão Versão do leiaute 3 N S 1 – 999
3.2. Identificação da NFS-e
# Campo Descrição TamMax Tipo Obrig Observação
AB01 Id S
AB02 cNFS-e Código Numérico que é um dos componentes da Chave de Acesso
9 N S Número Aleatório gerado pelo Emitente da NFS-e
AB03 natOp Descrição da Natureza da Operação 100 C S AB04 Mod Código do Modelo do Documento
Fiscal
2 C S
AB05 Serie Série do Documento Fiscal 3 C
AB06 nNFS-e Número do Documento Fiscal 9 N S 1 – 999999999 AB07 dEmi Data de emissão do Documento
Fiscal D S Formato “DD/MM/AAAA”
AB08 dSaiEnt Data de Saída ou da Entrada do
Serviço D Formato "DD/MM/AAAA " AB09 tpNF Tipo do Documento Fiscal 1 N S 0-entrada / 1-saída AB10 cMunFG Código do Município de Ocorrência
do Fato Gerador Chaves de acesso da NFS-e
7 N S Utilizar a Tabela do IBGE AB11 refNF Chaves de acesso das NFS-e
referenciadas
39 C Chave de acesso conforme composição no item 2.10 deste manual
AB12 tpImp Formato de Impressão da NFS-e 1 N 1-Retrato/ 2-Paisagem AB13 tpEmis Forma de Emissão da NFS-e 1 C N-Normal/ C-Contingência AB14 Anulada Se a nota esta anulada 1 C S- Sim ou N-Não
AB15 Notadebito Se a nota for de debito 1 C S- Sim ou N-Não AB16 motAnul Motivo anulacao nota 100 C
AB17 dataAnul Data da anulação da nota D DD/MM/AAAA AB18 notaSub Numero nota substituta 6 N
AB19 serieSub Serie da NF substituta 3 C AB20 descDesconto Descrição de desconto 100 C AB21 descCondEsp Descrição de desconto especial 100 C
AB22 numeroART Numero da ART 15 C Para construção civil AB23 Numero CEI Numero da Matrícula no CEI 15 C Para construção civil
3.3. Identificação do Emitente da NFS-e
# Campo Descrição TamMax Tipo Obrig Observação
AC01 Emit Emitente S
AC02 CNPJ CNPJ do Emitente 14 N S AC03 xNome Razão Social ou Nome do Emitente 70 C S AC04 xFant Nome fantasia 60 C AC05 IM Inscrição Municipal 15 C S AC06 End Endereço do Emitente S AC07 xLgr Logradouro 100 C S
AC08 Nro Número 10 C S
AC09 xCpl Complemento 100 C AC10 xBairro Bairro 100 C S
AC11 cMun Código do município 7 N S Utilizar a Tabela do IBGE AC12 xMun Nome do município 60 C S Associado a tabela IBGE
AC13 UF Sigla da UF 2 C S
AC14 CEP Código do CEP 8 N Sem caracter separador AC15 cPais Código do País 4 N Tabela Banco Central BR AC16 xPais Nome do País 100 C Associado tabela BCB
AC17 Fone Telefone 13 N
AC18 IE IE 14 C
AC19 IEST IE do Substituto Tributário 14 C AC20 IMSTS Inscrição Municipal do Substituto
Tributário do ISS
15 C
3.4. Identificação do Tomador do Serviço
# Campo Descrição TamMax Tipo Obrig Observação
AD01 TomS Tomador S
AD02 CNPJ CNPJ do Tomador 14 N S Obrigatório se pessoa Jurídica AD03 CPF CPF do Tomador 11 N S Obrigatório se pessoa Física AD04 xNome Razão Social ou nome do destinatário C S
AD05 Ender Endereço S
AD06 xLgr Logradouro 100 C S
AD07 Nro Número 10 C S
AD08 xCpl Complemento 100 C
AD09 xBairro Bairro 100 C S
AD10 cMun Código do município 7 N S Utilizar a Tabela do IBGE AD11 xMun Nome do município 60 C S Vinculado a tabela do IBGE
AD12 UF Sigla da UF 2 C S
AD13 CEP Código do CEP 8 N Sem caracteres separadores AD14 cPais Código do País 4 N Conforme tabela do BCB AD15 xPais Nome do País 100 C Vinculado a tabela do BCB
AD16 Fone Telefone 13 N
AD17 IE IE 14 C
AD18 IM Inscrição Municipal 15 C AD19 IMSTS Inscrição Municipal do Substituto
Tributário do ISS 15 C AD20 Praca Praca de pagamento 70 C
Manual de formato XML da NFS-e
3.5. Detalhamento de Serviços da NFS-e
# Campo Descrição TamMax Tipo Obrig Observação
AE01 Det S
AE02 nItem Número do item 3 N
AE03 serv S
AE04 cServ Código do serviço 60 C S Preencher com código obtido na tabela de serviços do Município AE05 xServ Descrição do serviço 120 C S
AE06 uTrib Unidade 6 C
AE07 qTrib Quantidade 11 N S
AE08 vUnit Valor unitario 15 N S Formato 13,2 AE09 vServ Valor Bruto do Serviço 15 N S Formato 13,2 AE10 vDesc Valor do Desconto 15 N Formato 13,2 AE11 vBCISS Base de Cálculo do ISS 15 N Formato 13,2 AE12 pISS Alíquota do imposto 5 N Formato 3,2 AE13 vISS Valor do ISS 15 N Formato 13,2 AE14 pRetINSS Percentual retencao INSS 5 N Formato 3.2 AE15 vRetINSS Valor retencao INSS 15 N Formato 13,2
3.6. Reembolsos e Restituições – Valores não Tributados pelo ISS
# Campo Descrição TamMax Tipo Obrig Observação
AF01 reemb
AF02 nItemReemb Número do item 3 N AF03 nTit Número do título 8 N AF04 cReemb Código do reembolso 5 C AF05 xReemb Descrição do reembolso 120 C
AF06 uReemb Unidade 6 C
AF07 qReemb Quantidade 11 N
AF08 vReemb Valor do reembolso 15 N Formato 13,2 AF09 vRepass Valor do repasse para terceiros 15 N Formato 13,2 AF10 vLiquid Valor líquido a pagar 15 N Formato 13,2 AF11 tPagto Tipo de pagamento 50 C
AF12 nLote Número do lote de reembolso 8 N
AF13 dPagto Data do pagamento D DD/MM/AAAA
3.7. ISS da Substituição Tributária
# Campo Descrição TamMax Tipo Obrig Observação
AG01 ISSST ISS Substituição Tributária AG02 pRedBCST Percentual da Redução do BC do
ISS ST 5 N Formato 3,2
AG03 vRedBCST Valor da Redução da BC do ISS
ST 15 N Formato 13,2
AG04 vBCST Valor da BC do ISS ST 15 N Formato 13,2 AG05 pISSST Alíquota do imposto 5 N Formato 3,2 AG06 vISSST Valor do ISS ST 15 N Formato 13,2
3.8. Valores Totais da NFS-e
# Campo Descrição TamMax Tipo Obrig Observação
AH01 total Totais da nota S
AH02 vReemb Valor do Reembolso 15 N Formato 13,2
AH03 vServ Valor Total dos Serviços 15 N Formato 13,2
AH04 vDesc Valor Total do Desconto 15 N Formato 13,2
AH05 vOutro Outras Despesas Acessórias 15 N Formato 13,2
AH06 vtNF Valor Total da NFS-e 15 N S Formato 13,2
AH07 vtLiq Valor liquido a pagar 15 N Formato 13,2
AH08 Ret Retençoes
AH09 xRetIRF Descrição da retenção de IRF 50 C
AH10 pRetIRF Percentual de retenção de IRF 5 N Formato 3,2
AH11 vRetIRF Valor da retenção de IRF 15 N Formato 13,2
AH12
xRetLei10833-PIS-PASEP Descrição da retenção de PIS-PASEP 50 C
AH13
pRetLei10833-PIS-PASEP Percentual de retenção de PIS-PASEP 5 N Formato 3,2
AH14 vRetLei10833-PIS-PASEP
Valor da retenção de PIS-PASEP 15 N Formato 13,2
AH15 xRetLei10833-COFINS Descrição da retenção de COFINS 50 C AH16 pRetLei10833-COFINS Percentual de retenção de COFINS 5 N Formato 3,2 AH17
vRetLei10833-COFINS Valor da retenção de COFINS 15 N Formato 13,2
AH18
xRetLei10833-CSLL Descrição da retenção de CSLL 50 C
AH19 pRetLei10833-CSLL
Percentual de retenção de CSLL 5 N Formato 3,2
AH20 vRetLei10833-CSLL
Valor da retenção de CSLL 15 N Formato 13,2
AH21 xRetINSS Descrição de retenção do INSS 50 C
AH22 vtRetINSS Valor total da retenção do INSS 15 N Formato 13,2
AH23 Fat Fatura
AH24 nFat Número da Fatura 50 C
AH25 vOrig Valor Original da Fatura 15 N Formato 13,2
AH26 vDesc Valor do desconto 15 N Formato 13,2
AH27 vLiq Valor Líquido da Fatura 15 N Formato 13,2
AH28 ISS ISS S
AH29 vBCISS Base de Cálculo do ISS 15 N S Formato 13,2
AH30 vISS Valor Total do ISS 15 N S Formato 13,2
AH31 vBCSTISS Base de Cálculo do ISS
Substituição Tributária 15 N S Formato 13,2
AH32 vSTISS Valor Total do ISS Substituição
Tributária 15 N S Formato 13,2
3.9. Dados da Cobrança
# Campo Descrição TamMax Tipo Obrig Observação
AI01 cobr Cobrança AI07 dup Duplicata
Manual de formato XML da NFS-e
AI09 dVenc Data de vencimento D DD/MM/AAAA AI10 vDup Valor da duplicata 15 N Formato 13,2
AI11 urlBol Boleto 256 C URL que pode ser usada para se exibir o boleto no navegador AI12 bBol Indicador da geração de boleto 1 C 1 – Gera 2 – Não gera
3.10. Informações Adicionais
# Campo Descrição TamMax Tipo Obrig Observação
AJ01 infAdic Informações Adicionais
AJ02 infAdic Informações Adicionais de Interesse do Fisco
256 C AJ03 infComp Informações Complementares de
interesse do Contribuinte
5000 C
3.11. Outras Informações
# Campo Descrição TamMax Tipo Obrig Observação
AK01 Observações
AK02 Xinf Item de observação 100 C 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 Descrição TamMax Tipo Observação
AL01 UF Código da UF do emitente do Documento Fiscal
2 N Utilizar a Tabela do IBGE AL02 CNPJ CNPJ do emitente 14 N
AL03 Mod Modelo do Documento Fiscal 2 C
AL04 Serie Série do Documento Fiscal 3 C Preencher com zeros a direita Exemplo: “T00”, “000”, “S00” AL05 nNF Número do Documento Fiscal 9 N 1 – 999999999
AL06 CNF Código Numérico que compõe
a Chave de Acesso 9 N Número Aleatório gerado pelo Emitente da NF-e