TaxPlus NFS-e | Erro ao criar novo tipos de impostos retidos no SAP
4 min
Criado por Gabriel Santiago em 09/06/2025 09:00
Atualizado por Julianna Lima em 24/11/2025 15:37

Dúvida

Esta documentação pretende informar sobre os problemas que podem surgir ao criar novos impostos retidos no SAP. Nosso foco é explicar o motivo técnico pelo qual não é aconselhável criar novos tipos de impostos retidos no SAP de forma descontrolada ou sem a devida atenção.

Erros

Quando novos impostos retidos são criados no SAP, o TaxPlus NFS-e não consegue fazer a leitura desses novos tipos. Isso pode levar a um erro no XML da NFS-e, onde o valor da retenção é descontado corretamente no SAP, mas não é reportado no XML.

Essa inconsistência fiscal não afeta apenas o TaxPlus NFS-e, mas também o TaxPlus, comprometendo as apurações fiscais do cliente.

Exemplo abaixo no XML de Canoas - RS:


Quando novos impostos retidos são configurados no SAP, pode acontecer de eles não atualizarem a coluna "WTTypeId". Nesses casos, o TaxPlus NFS-e pode classificar esses novos impostos como "OutrasRetencoes" no XML de envio.

Importante: A aceitação da tag "OutrasRetencoes" depende diretamente do schema XML da prefeitura. Caso o schema da prefeitura não contemple essa tag, o XML será rejeitado.

Exemplo abaixo utilizando o XML de Rio de Janeiro - RJ:


Um erro crítico pode surgir se a ordem padrão dos impostos no SAP for alterada. Como nosso add-on depende da coluna "WTTypeId" na tabela "OWTT" do SAP para mapear as informações, qualquer mudança nessa ordem ou nos dados associados à "WTTypeId" pode causar um comportamento inesperado ou erro no sistema.

Exemplo:

  • Tabela correta sem alteração na coluna:


  • Tabela com alteração, mas ordem padrão seguida. Não afeta negativamente o NFS-e. Mas podem ocorrer ambos os erros citados anteriormente na documentação.


  • Tabela com alteração, ordem padrão não seguida. Afeta negativamente a leitura dos impostos do add-on podendo ocorrer diversos erros. Deve ser ajustado com urgência.


Motivos

Os erros descritos anteriormente ocorrem porque o TaxPlus NFS-e baseia sua leitura e processamento nos impostos padrão do SAP, especificamente na coluna "WTTypeId" da tabela "OWTT".

Quando novos tipos de imposto são criados no SAP e essas alterações impactam a coluna "WTTypeId", o TaxPlus NFS-e pode apresentar comportamento incorreto, como:

  • Não levar algum imposto para o XML da NFS-e.
  • Levar o imposto errado ou de forma indevida.

Conclusão

Por essa razão, não é aconselhável alterar os impostos padrão existentes no SAP.

Se houver necessidade de criar novos impostos, a orientação é criá-los abaixo dos impostos padrão já configurados, garantindo que não haja interferência no mapeamento esperado pelo TaxPlus NFS-e.


Observação
Este artigo é válido para emissão padrão nacional e municipal.
Este artigo foi útil para você?
Últimos artigos visitados