Tempo aproximado para leitura: 00:07:00 min
Dúvida
Como parametrizar o Configurador de TAGs?
Ambiente
Cross Segmentos - TOTVS Backoffice (Linha Datasul) - Configurador de TAGs (CTAG) - A partir da versão 12.1.25
Solução
O Configurador de TAGs é uma ferramenta que permite o cadastro de regras para manipulação do arquivo XML gerado no cálculo de uma NFe - Nota Fiscal Eletrônica ou NFSe - Nota Fiscal de Serviço Eletrônica.
As alterações são realizadas exclusivamente no arquivo XML e consequentemente no DANFE - Documento Auxiliar da Nota Fiscal Eletrônica, ou seja, não serão efetivadas no registro da tabela Nota Fiscal no Sistema.
O cadastro das regra dentro do Configurador de TAGs será explicado em três etapas que serão detalhadas abaixo.
1. Informações da TAG
Essas informações serão utilizadas para definir um tratamento para determinada TAG da NFe / NFSe.
Ação: Selecionar qual ação será realizada no XML. Opções: Inclusão de uma nova TAG ou alteração de uma TAG já existente.
Documento: Selecionar o documento eletrônico para qual que será cadastrada a regra para manipulação da TAG. Opções: NFe ou NFSe.
Versão: Informar a versão do documento para qual será cadastrada a regra para manipulação da TAG. Corresponde ao campo Versão WebService do programa CD0403B - Configurações do TSS - na guia NFSE. Ou campo Versão Layout do CD0403 - Manutenção Estabelecimento guia Doc Eletrôn.
TAG: Informar o nome da TAG que será aplicada a regra.
TAG Pai: Informar o nome da TAG Pai. Essa informação é usada em conjunto com o campo TAG para identificação dentro do XML.
Início de Validade: Informar a data do início de validade para a regra.
Fim de Validade: Informar a data do fim de validade para a regra.
2. Regras da TAG
Depois de cadastrar a TAG, deve-se cadastrar as regras que determinam quando a TAG deve ser inserida ou alterada. Pode-se cadastrar uma ou mais regras para a TAG, sendo obrigatório cadastrar pelo menos uma regra. Os campos desse cadastro variam de acordo com a ação selecionada para a TAG.
Campos disponíveis na opção Inclusão de TAG:
- Descrição da Regra - Utilizado como identificador para a regra.
- XML - Determina qual a TAG ou grupo de TAGs que serão inseridos no XML quando essa regra for válida. É necessário informa-los na sintaxe XML.
- Programa - Permite informar um programa Progress que permitirá com que os valores para as TAGs informadas no campo XML sejam gerados dinamicamente. Esse programa possui parâmetros de INPUT e OUTPUT que facilitam a manipulação do arquivo XML.
Campos disponíveis na opção Alteração de TAG:
- Descrição da Regra - Utilizado como identificador para a regra.
- Tipo de Operação - Determina o tipo de operação que será aplicado na TAG quando essa regra for válida.
- Valor da Operação - Determina o valor que será aplicado na TAG quando essa regra for válida.
Exemplos de uso do campo Tipo de Operação
Exemplo 1: Demonstrar a alíquota do ISS - Imposto Sobre Serviço com duas decimais, sem separador decimal.
Se a alíquota de 5% deve ser demonstrada com o valor 500, deve-se selecionar a opção Multiplicar por e informar o valor 100 para o campo Valor da Operação.
Exemplo 2: Demonstrar a alíquota do ISS em valor decimal.
Se a alíquota de 5% deve ser demonstrada com o valor 0,05, então deve-se selecionar a opção Multiplicar por e informar o valor 0,01 para o campo Valor da Operação.
Exemplo 3: Formatar o código do serviço com quatro dígitos demonstrando zeros à esquerda.
Se o código de serviço 70 deve ser demonstrado com o valor 0070, deve-se selecionar a opção Formato numérico e informar o valor 9999 para o campo Valor da Operação.
Exemplo 4: Formatar um valor com quatro decimais.
Se um determinado valor é demonstrado no arquivo XML com duas decimais e é necessário que seja demonstrado com quatro decimais. Deve-se selecionar a opção Formato numérico e informar o valor >>>>>9.9999 para o campo Valor da Operação.
Quando ocorrer algum erro ao aplicar o Tipo de Operação na TAG, a TAG permanecerá com o seu antigo valor.
Exemplo: Selecionar a opção Multiplicar por para uma TAG com valor caracter.
3. Faixas de campos da regra
Uma regra é composta por uma ou mais faixas de seleção que serão comparadas com os valores da nota fiscal e/ou itens da nota fiscal. As faixas podem ser parametrizadas pelos campos abaixo:
- CFOP - Código da CFOP - Código Fiscal de Operações e Prestações da natureza de operação do item da nota fiscal.
- Cidade da Nota -Cidade da nota fiscal.
-
Cidade do Cliente - Cidade do cliente da nota fiscal.
-
Cidade do Estabelecimento - Cidade do estabelecimento da nota fiscal.
-
Classificação Fiscal - Classificação fiscal do item da nota fiscal.
-
Código do Cliente - Código do cliente da nota fiscal.
-
Código do Estabelecimento - Código do estabelecimento da nota fiscal.
-
Código do Item - Código do item da nota fiscal.
-
Código do Serviço - Código de serviço do item da nota fiscal.
-
Estado da Nota - Estado da nota fiscal.
-
Estado do Cliente - Estado do cliente da nota fiscal.
-
Estado do Estabelecimento - Estado do estabelecimento da nota fiscal.
-
Natureza de Operação - Natureza de operação do item da nota fiscal.
-
País da Nota - País da nota fiscal.
-
País do Cliente - País do cliente da nota fiscal.
-
País do Estabelecimento - País do estabelecimento da nota fiscal.
-
Série - Série da nota fiscal.
Se uma TAG possuir mais de uma regra
O Sistema validará todas as regras até encontrar uma regra válida e então aplicará o Tipo de Operação na TAG.
O relacionamento condicional entre as regras é do tipo OU operador lógico OR, dessa forma, basta que uma das regras seja válida.
Quando uma regra possuir mais de uma faixa de seleção
Todas as faixas cadastradas para a Regra deverão ser válidas para que o Sistema aplique o Tipo de Operação na TAG.
O relacionamento condicional entre as faixas de seleção é do tipo E operador lógico AND, dessa forma uma regra será considerada válida somente quando os dados do documento estiverem dentro de todas as faixas de seleção cadastradas para a Regra.
TAG de item do documento com seleção por item
Se cadastrar uma TAG do bloco de itens do documento com uma regra com faixa de seleção por item ou outro campo dependente do item, o Sistema aplicará o Tipo de Operação na TAG de cada item do documento que esteja dentro da faixa de seleção.
TAG de documento com seleção por item
Se cadastrar uma TAG do bloco do documento com uma regra com faixa de seleção por item ou outro campo dependente do item, o Sistema aplicará o Tipo de Operação na TAG somente se todos os itens do documento que estiverem dentro da faixa de seleção.
Após a conclusão do cadastro das regra dentro do Configurador de TAGs, é necessário habilitar a funcionalidade para o estabelecimento emissor da nota fiscal através do parâmetro Utiliza Regras Específicas para Transmissão de Documentos Eletrônicos. Com o parâmetro habilitado, a rotina do Configurador de TAGs será executada durante o cálculo das notas fiscais emitidas para o estabelecimento.
A rotina do Configurador de TAGs verificará todas as regras cadastradas para as TAGs do cadastro efetuado anteriormente, e quando encontrar uma regra válida para a nota fiscal, aplicará a ação parametrizada no XML do documento.
É possível consultar no FT0909 - Monitor NFe, botão Histórico do XML, quais alterações foram realizadas pelo Configurador de TAGs:
0 Comentários