Ú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. |