01. DADOS GERAIS

Linha de Produto:DATASUL
Segmento:BACKOFFICE
Módulo:MFT - FATURAMENTO
Função:CONFIGURADOR DE TAGS
Release Expedida:12.1.25

02. OBJETIVO

O Configurador de Tags é uma ferramenta que permite o cadastro de regras para manipulação do arquivo XML gerado no cálculo de uma NF-e ou NFS-e.

As alterações realizadas pelo Configurador de Tags são realizadas exclusivamente no arquivo XML que será integrado com a Sefaz, portanto, não surtem efeito nas demais rotinas do produto.

03. COMO O CADASTRO FUNCIONA?

O cadastro das regra dentro do Configurador de Tags pode ser explicado em 3 etapas que serão detalhadas abaixo.

1) INFORMAÇÕES DA TAG

Essas informações serão utilizadas para definir um tratamento específico para determinada Tag da NF-e / NFS-e.

Interface do cadastro de Informações da tag

2) REGRAS DA TAG

Depois de cadastrar a Tag, o usuário deverá cadastrar as regras que determinam quando a Tag deve ser inserida ou alterada; o usuário pode 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

Campos
Descrição da RegraUtilizado como identificador para a regra.
XMLDetermina 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.
ProgramaPermite informar um programa Progress (.p) 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. Exemplos no final dessa documentação. Opção Alteração de Tag

Campos disponíveis na opção Alteração de Tag

Campos
Descrição da RegraUtilizado como identificador para a regra.
Tipo de OperaçãoDetermina 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.

Interface do cadastro de regra da Tag

Exemplos de uso do campo "Tipo de Operação"

Exemplo 1: Demonstrar a alíquota do ISS com duas decimais sem separador decimal.
Se a alíquota de 5% deve ser demonstrada com o valor 500.
O usuário deve 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.
O usuário deve 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
O usuário deverá 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.
O usuário deverá 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:

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 o usuário 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 o usuário 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.
Interface do cadastro de campos de faixa da regra

04. PRÓXIMOS PASSOS

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

Habilitado o parâmetro, durante o cálculo da nota fiscal para o estabelecimento, a rotina do Configurador de Tags será executada.

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, botão "Histórico do XML", se foi aplicada

Parâmetro "Utiliza Regras Específicas para Transmissão de Documentos Eletrônicos" no CD0403 (Manutenção Estabelecimento)

05. EXEMPLOS





06. ASSUNTOS RELACIONADOS

Gerar quantidade do item nas Tags qTrib e qCom em notas fiscais de diferença de preço com finalidade complementar

Gerar tag infAdProd com a observação do item do pedido de venda

Gerar tag infCpl com informações ou características do item

Tag codcanc do XML de cancelamento da NFS-e

Tag cresponsavelretencao no XML da NFS-e

Tags dthremissao e dtcompetencia da NFS-e de substituição


<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}
</style>