Última modificação em: 06/04/2021

Leiaute Padrão NFS-e

Documentação do Leiaute Padrão para importação da NFSe

Formato do Campo:

  • Cada campo tem um tipo que determina o formato de seu conteúdo, conforme a tabela 1.
  • Cada campo possui um tamanho máximo para seu conteúdo. Os excessos serão desconsiderados.

 

Tabela 1: Formatação dos Campos do Arquivo

 

Tipo

Instrução

Inteiro

Formato Padrão: 1234 

São aceitos números inteiros e positivos, apenas dígitos de 0 a 9. O separador do milhar não deve constar nos números.

Numérico

Padrão: 1234.56 

São aceitos números reais e positivos, dígitos de 0 a 9, sempre com separador decimal, o separador decimal deve ser “.” (ponto). A quantidade de casas decimais deve ser de duas casas após o ponto. O separador do milhar não deve constar nos números. 

Data

Padrão: 31/01/2020 (dd/mm/yyyy) 

São aceitos datas compostas por (dia, mês e ano), dígitos de 0 a 9, com separador. O separador deve ser: “/” 

Lógico

Padrão: false; true 

São aceitos false, para representar Falso ou Não, e, true, para representar Verdadeiro ou Sim.

Texto

Padrão: NF Cancelada

São aceitos Caracteres como: letras, dígitos e símbolos.

 

Tabela 2: Leiaute dos Registros

 

Nome do Campo

Tipo

Tam.

Requerido

Valores Válidos

Observação

<XML>

 

 

Sim

 

Início do Arquivo XML.

<VERSAO>

Texto

4

Sim

1.00

Versão do Leiaute

<PREFEITURA>

Texto

100

Não

 

Razão Social da Prefeitura do Município de Emissão da NFSE.

<N_DA_NFSE>

Inteiro

 

Sim

 

Número da NFSE.

<DATA_EMISSAO>

Data

10

Sim

Formato (dd/mm/yyyy);

Data de Emissão da NFSE.

<COMPETENCIA>

Data

10

Sim

Quando na extração dos dados da Prefeitura vier com a informação em formato (dd/mm/yyyy), será mantido a informação na tag.

Quando vier em outro formato deve ser convertido para o formato (dd/mm/yyyy).

Quando na extração somente vir a informação de (mm/yyyy), será inserido o primeiro dia do mês (01), para ficar no formato(dd/mm/yyyy).

Quando não vier nenhuma informação na <COMPETENCIA>, assumirá o mesmo Valor da <DATA_EMISSAO>, sendo que essa tag também seguirá o formato (dd/mm/yyyy);

Data de Competência da NFSE.

<CODIGO_DE_VERIFICACAO>

Texto

44

Não

 

Código de verificação que confirma a autenticidade da NFS-e.

<NUMERO_DO_RPS>

 

 

Não

 

Número do RPS (Recibo Provisório de Serviço).

(Parâmetro não utlizado nesta versão do Leiaute)

<NO_NFSE_SUBSTITUIDA>

 

 

Não

 

Número da NFS-e substituída.

(Parâmetro não utlizado nesta versão de Leiaute)

<LOCAL_DA_PRESTACAO>

Inteiro

 

Sim

Quando <LOCAL_DA_PRESTACAO> não possuir conteúdo, informa o conteúdo do <MUNICIPIO_TOMADOR>;

Código IBGE do Município onde foi prestado o serviço.

<NOME_PRESTADOR>

Texto

50

Sim

 

Razão Social do prestador do serviço.

<NOME_FANTASIA>

Texto

50

Não

 

Nome Fantasia do prestador do serviço.

<CPFCNPJ_PRESTADOR>

Texto

18

Sim

Pode ser informado na sequência de 14 números corridos sem máscara, ex: “99999999000199”;

Ou

Pode ser informado no formato com a máscara padrão CNPJ, ex: “99.999.999/0001-99”;

Número do CPF/CNPJ do Prestador do Serviço

<INSC_MUNICIPAL>

Texto

25

Não

 

Inscrição municipal do prestador que emitiu a NFSE.

<CIDADE_PRESTADOR>

Inteiro

 

Não

Informar o código IBGE do município;

Código do município onde o tomador está estabelecido (Tabela do IBGE).

<ESTADO_PRESTADOR>

Texto

2

Sim

Caso operação com Exterior, informar “EX”;

Sigla da unidade da federação do prestador.

<ENDERECO_PRESTADOR>

Texto

40

Não

 

Tipo e nome do logradouro do prestador (Av.., Rua..., ...)

<NO_ENDERECO_PRESTADOR>

Inteiro

 

Não

 

Número do Imóvel do prestador.

<CEP_PRESTADOR>

Texto

10

Não

Utilizar apenas números, sem separadores. Ex: “99777000”. Caso informado menos de 8 dígitos, será complementado com zeros a esquerda. Caso informado mais de 8 dígitos serão considerados os 8 dígitos da direita;

Ou

Utilizar o formato com a seguinte máscara “99.777-000”;

Número do CEP do prestador.

<BAIRRO_PRESTADOR>

Texto

30

Não

 

Bairro do prestador.

<COMPLEMENTO_PRESTADOR>

Texto

20

Não

 

Complemento de Endereço do prestador.

<TELEFONE_PRESTADOR>

Inteiro

 

Não

 

Número do telefone do prestador.

<EMAIL_PRESTADOR>

Texto

100

Não

 

E-mail do prestador.

<NOME_TOMADOR>

Texto

50

Sim

 

Nome / Razão Social do tomador.

<NOME_FANTASIA_TOMADOR>

Texto

50

Não

 

Nome Fantasia do tomador.

<CPFCNPJ_TOMADOR>

Texto

18

Sim

Pode ser informado na sequência de 14 números corridos sem máscara, ex: “99999999000199”;

Ou

Pode ser informado no formato com a máscara padrão CNPJ, ex: “99.999.999./0001-99”;

CPF/CNPJ do tomador do serviço.

<INSC_MUNICIPAL_TOMADOR>

Texto

25

Não

 

Número da inscrição municipal do Tomador.

<MUNICIPIO_TOMADOR>

Inteiro

 

Não

Informar o código IBGE do município..

Código do município onde o tomador está estabelecido (Tabela do IBGE).

<ESTADO_TOMADOR>

Texto

2

Sim

Caso operação com Exterior, informar “EX”;

Sigla da unidade da federação do tomador

<ENDERECO_E_CEP_TOMADOR>

Texto

40

Não

 

Tipo e nome do logradouro (Av.., Rua..., ...)

<NO_ENDERECO_TOMADOR>

Inteiro

 

Não

 

Número do Imóvel do tomador.

<CEP_TOMADOR>

Texto

10

Não

Utilizar apenas números, sem separadores. Ex: “99777000”. Caso informado menos de 8 dígitos, será complementado com zeros a esquerda. Caso informado mais de 8 dígitos serão considerados os 8 dígitos da direita;

Ou

Utilizar o formato com a seguinte máscara “99.777-000”;

Número do CEP do tomador

<BAIRRO_TOMADOR>

Texto

30

Não

 

Bairro do tomador

<COMPLEMENTO_TOMADOR>

Texto

20

Não

 

Complemento de Endereço do tomador.

<TELEFONE_TOMADOR>

Inteiro

 

Não

 

Número do Telefone do tomador.

<EMAIL_TOMADOR>

Texto

100

Não

 

E-mail do tomador.

<CODIGO_SERVICO>

Texto

 

Sim

Lista de serviços anexa à Lei Complementar nº 116;

Código do serviço prestado.

<COD_DE_ATIVIDADE_SUB_ITEM>

 

 

Não

 

(Parâmetro não utlizado nesta versão de Leiaute)

<ATIVIDADE>

 

 

Não

 

(Parâmetro não utlizado nesta versão de Leiaute)

<CODIGO_DA_OBRA_CEI>

 

 

Não

 

Número da matrícula CEI da obra ou da empresa.

(Parâmetro não utlizado nesta versão de Leiaute)

<CODIGO_ART>

Texto

15

Não

 

Número da ART.

<VL_PIS>

Numérico

14,2

Não

 

Valor da retenção do PIS.

<VL_COFINS>

Numérico

14,2

Não

 

Valor da retenção do COFINS.

<VL_CSLL>

Numérico

14,2

Não

 

Valor da retenção do CSLL.

<VL_IR>

Numérico

14,2

Não

 

Valor da retenção do IR.

<VL_INSS>

Numérico

14,2

Não

 

Valor da retenção do INSS.

<VALOR_DOS_SERVICOS>

Numérico

14,2

Não

 

Valor Total dos Serviços.

<DESCONTO_INCONDICIONADO_VLS>

Numérico

14,2

Não

 

Valor do desconto incondicionado.

<DESCONTO_CONDICIONADO>

Numérico

14,2

Não

 

Valor do desconto condicionado.

<RETENCOES_FEDERAIS>

Numérico

14,2

Não

 

Valor das retenções Federais.

<ISS_RETIDO>

Numérico

14,2

Não

Terá valor quando <ISS_A_RETER> for igual a 1;

Valor de retenção do ISS.

<VALOR_LIQUIDO>

Numérico

14,2

Não

 

Valor Líquido dos Serviços.

<NATUREZA_OPERACAO>

Inteiro

1

Não

Quando tributação dentro do município de prestação do serviço enviar “1”;

Quando tributação fora do município de prestação de serviço enviar “2”;

Observar <LOCAL_DA_PRESTACAO> para alimentar essa tag;

Natureza da operação que indica se a tributação foi dentro ou fora do Município de prestação de serviço.

<REGIME_ESPECIAL_TRIBUTACAO>

Inteiro

1

Não

1 – Microempresa Municipal;

2 – Estimativa;

3 – Sociedade de Profissionais;

4 – Cooperativa;

5 – Microempresário Individual (MEI);

6 – Microempresário e Empresa de Pequeno Porte (ME EPP);

Informar o Regime Especial de Tributação.

<OPCAO_SIMPLES_NACIONAL>

Inteiro

1

Não

1 – Sim;

2 – Não;

Informar se é optante pelo Simples Nacional.

<DEDUCOES_PERMITIDAS_EM_LEI>

Numérico

14,2

Não

 

Valor do desconto condicionado.

<DESCONTO_INCONDICIONADO_ISS>

Numérico

14,2

Não

 

Valor do desconto incondicionado.

<BASE_ISS>

Numérico

14,2

Não

Quando não tem valor na <BASE_ISS>, informar o resultado dos valores das <VALOR_DOS_SERVICOS> -<DEDUCOES_PERMITIDAS_EM_LEI>

- <DESCONTO_INCONDICIONADO_ISS>;

Valor da Base de Cálculo do ISS.

<ALIQUOTA_ISS>

Numérico

5,2

Não

Será apresentada com 2 casas decimais. Exemplo: 2.00;

Alíquota do ISS.

<ISS_A_RETER>

Inteiro

1

Não

Quando tem retenção enviar o dígito: “1”;

Quando não tem retenção enviar o dígito: “2”;

Indica se existe retenção de ISS na operação.

<VL_ISS>

Numérico

14,2

Não

Somente será importado se <ISS_A_RETER> = 1;

Valor do ISS.

<BASE_INSS>

Numérico

14,2

Não

Quando <VL_INSS> maior que 0 (zero), deve apresentar o valor na tag;

Quando a <BASE_INSS> não possuir conteúdo, o valor será o mesmo que a <BASE_ISS>;

Valor da Base de Cálculo do INSS.

<DISCRIMINACAO_DOS_SERVICOS>

Texto

120

Sim

 

Discriminação dos serviços.

<AVISOS>

 

 

Não

 

(Parâmetro não utlizado nesta versão de Leiaute)

<PEDIDO>

 

 

Não

 

(Parâmetro não utlizado nesta versão de Leiaute)

<NUM_PEDIDO>

 

 

Não

 

(Parâmetro não utlizado nesta versão de Leiaute)

<CANCELADO>

Lógico

 

Não

Informar “true” para verdadeiro ou “false” para falso (quando em branco ou não informado, equivale a “false”);

Situação/status do Documento.

<ATUALIZA>

Lógico

 

Não

Informar “true” para verdadeiro ou “false” para falso (quando em branco ou não informado, equivale a “false”);

Indica se a aplicação deve atualizar um registro já existente.

</XML>

 

 

Sim

 

Fim do Arquivo XML.

 

CCQ Blog
© Questor Sistemas 2025