Última modificação em: 06/04/2021
Documentação do Leiaute Padrão para importação da NFSe
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. |
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. |