SC 11 Importacao XML NFSe para RPS

De Touch ERP
Ir para a navegação Ir para a procura

Importacoes_Dados

Este Smart Component realiza a importação de arquivos XML de NFSe e a conversão automática para RPS dentro do Touch Comp ERP. O objetivo é automatizar e padronizar o processo de entrada de notas de serviço, garantindo consistência tributária, aderência ao ambiente configurado (nacional ou provedor específico) e redução de atividades manuais.

O Smart Component pode ser executado manualmente pelo recurso 1957 – Iniciar Smart Component.

Quando utilizar

  • Importação em lote de XMLs de NFSe
  • Geração automática de RPS a partir de notas de serviço
  • Redução de digitação manual de serviços
  • Padronização do processo após a reforma tributária

Antes de continuar (Pré-requisitos)

Antes de executar o Smart Component, é obrigatória a validação dos cadastros abaixo:

1. Importação do Smart Component

Caso o componente ainda não esteja disponível:

  • Acesse 2032 – Marketplace Smart Component
  • Localize Importação de XML NFSe para RPS
  • Selecione a versão desejada
  • Realize o download e importe na empresa onde será utilizado

2. Revisão dos Serviços RPS (Recurso 1268)

Atenção: houve alterações estruturais em função da reforma tributária.

No recurso 1268 – Serviços RPS, revise os serviços que poderão ser utilizados na importação:

Campos obrigatórios:

  • Código Serviço Nacional Deve estar coerente com o código informado no XML da NFSe.
  • Código Serviço Municipal Deve refletir a legislação municipal e ser compatível com o XML importado.
  • NBS (Nomenclatura Brasileira de Serviços) Classificação nacional obrigatória para serviços. O NBS é utilizado para validações fiscais e para o correto enquadramento do serviço durante a importação do XML.

Recomendação:

  • Manter um serviço RPS para cada combinação válida de código nacional + municipal

3. Opções de Faturamento NFSe (Recurso 763)

Acesse 763 – Opções Faturamento NFSe e realize a conferência:

Aba: Configurações NFSe > Dados

Selecione o ambiente adequado:

  • Ambiente Nacional
  • Outros Provedores
  • Provedor específico (ex.: Governador Valadares)

Essa definição é essencial para que o sistema interprete corretamente a estrutura do XML.

Validação opcional em banco de dados

Caso necessário, valide diretamente no banco de dados:

Tabela: opcoes_faturamento_rps

Valores esperados:

  • nacional = 1
  • iss_integra = 2
  • outros = 0

Após qualquer ajuste neste recurso:

  • Reinicie a API para que as alterações sejam aplicadas

Execução do Smart Component

Passo a passo

  1. Acesse 1957 – Iniciar Smart Component
  2. Selecione o Smart Component:
    • Importação de XML NFSe para RPS
  3. Crie ou selecione um Perfil
  4. Informe o parâmetro Empresa
    • Recomenda-se criar um perfil por empresa
  5. Clique em Importar Dados

Acompanhamento

  • A execução pode ser acompanhada pelo ícone de notificações

Observação:

  • Em arquivos grandes ou com muitos XMLs, o processamento pode levar alguns minutos

Boas práticas para os arquivos

  • O arquivo a ser importado deve estar obrigatoriamente em formato ZIP
  • Arquivos em formato RAR não são aceitos diretamente

Caso o arquivo esteja em RAR

  1. Extraia os arquivos XML para uma pasta
  2. Selecione os XMLs extraídos
  3. Clique com o botão direito e escolha Adicionar ao arquivo / Comprimir arquivos
  4. Selecione o formato ZIP
  5. Confirme e utilize este novo arquivo na importação

Problemas comuns e soluções

1. Serviço não encontrado

Mensagem:

E.ERP.1268.001 - Nenhum serviço encontrado com código tributação municipal: 001 e código tributação nacional: 042001 ou código do contribuinte: NI

Causa:

  • Não existe serviço RPS cadastrado com os códigos informados no XML

Solução:

  • Acesse o recurso 1268
  • Verifique e ajuste os códigos de serviço nacional, municipal e o NBS

2. XML em formato inválido

Mensagem:

01-02-00581 - Arquivo/String XML não está em um formato/estrutura válida: Error on line 1: Content is not allowed in prolog

Causa comum:

  • Arquivo compactado em formato RAR

Solução:

  • Extraia os arquivos
  • Recomprima em formato ZIP
  • Reexecute o Smart Component

3. Importação não gera RPS

Possíveis causas:

  • Ambiente NFSe incorreto no recurso 763
  • Serviço RPS incompatível com o XML
  • API não reiniciada após alterações

Ações recomendadas:

  • Revisar os recursos 1268 e 763
  • Reiniciar a API
  • Executar novamente o Smart Component
Obtida de "https://touchcomp.mywikis.wiki/w139/index.php?title=SC_11_Importacao_XML_NFSe_para_RPS&oldid=8136"