Histórico da Página
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.
Informações | title | Importante
---|
Aviso |
As alterações realizadas pelo Configurador de Tags são realizadas exclusivamente no arquivo XML , portanto não surtem efeito nas demais rotinas do produto. |
...
e consequentemente no DANFE, ou seja, não serão efetivadas no registro da tabela Nota Fiscal no Sistema. |
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
...
para determinada Tag da NF-e / NFS-e.
Ação: Selecionar qual ação será realizada no XML
do documento eletrônico. Opções: Inclusão de uma nova Tag ou alteração de uma Tag já existente.
Documento:
SelecionarSelecionar o documento eletrônico para qual que será cadastrada a regra para manipulação da Tag. Opções: NF-e ou NFS-e.
Versão:
InformarInformar 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).
Tag:
InformarInformar o nome da Tag que será aplicada a regra.
Tag Pai:
InformarInformar o nome da Tag Pai.
Esse campo será usado para especificar uma Tag quando o nome da Tag estiver repetido em mais de um bloco do arquivo XML; por exemplo: A Tag "xBairro" pode ser encontrada nos blocos: (a) enderEmit; (b) enderDest; (c) destEssa informação é usada em conjunto com o campo Tag para identificação dentro do XML.
Início de Validade:
InformarInformar a data do início de validade para a regra.
Fim de Validade:
InformarInformar a data do fim de validade para a regra.
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 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 (.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 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. |
Informações | ||
---|---|---|
| ||
Exemplos de uso do campo "Tipo de Operação" Exemplo 1: Demonstrar a alíquota do ISS com duas decimais sem separador decimal. Exemplo 2: Demonstrar a alíquota do ISS em valor decimal. Exemplo 3: Formatar o código do serviço com quatro dígitos demonstrando zeros à esquerda. Exemplo 4: Formatar um valor com quatro decimais. 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. |
Interface do cadastro de regra da Tag
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 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).
Avisoinfo |
---|
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. 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. 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". 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, botão "Histórico do XML", quais alterações foram realizadas pelo Configurador de Tags.
Parâmetro "Utiliza Regras Específicas para Transmissão de Documentos Eletrônicos" no CD0403 (Manutenção Estabelecimento)
Consulta das alterações realizadas pelo Configurador de Tags no programa FT0909E.
05. EXEMPLOS
Totvs custom tabs box | ||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||
ids | FT0536,CD0160,CD0194,CD0161 | |||||||||||||||||||||||||||||||||||||||
Totvs custom tabs box items | ||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||
|
04. DEMAIS INFORMAÇÕES
Importante: Quando uma nota fiscal e/ou movimentações do produto, possuir itens com o mesmo código da polícia (CD0161), Unidade de medida da PF, Densidade e Concentração esses itens deverão ser agrupados e serem impressos em uma única linha no quantidade e em seguida agrupado em uma única linha no arquivo do Mapa da PF.
Para geração dos dados referentes à Seção Movimentação Nacional de Produtos Químicos (MVN) são consideradas as Notas Fiscais de Venda Nacional:
- Notas fiscais com Uso Autorizado pela SEFAZ;
- Notas fiscais que baixam estoque;
- Notas fiscais onde a natureza de operação seja do tipo "Saída";
- Notas fiscais com CFOP que inicia com "5" ou "6";
Observação Subseção de Armazenagem (MA): Os dados referentes à Subseção de Armazenagem são gerados com base no Local de Entrega constante na Nota Fiscal de Saída. Com relação ao Nome da Razão Social, caso não tenha sido informado para o Local de Entrega no cadastro (CD0705), o sistema irá buscar o emitente correspondente ao CNPJ para inserir a informação do Nome do Emitente e caso este registro não exista, o sistema irá duplicar a informação do CNPJ para este campo.
E são desconsideradas as notas fiscais:
- Notas fiscais do tipo Diferença de Preço;
- Notas fiscais canceladas;
Para geração dos dados referentes à Seção Movimentação Internacional de Produtos Químicos (MVI) são consideras as Notas Fiscais de Exportação:
- Notas Fiscais com Uso Autorizado pela Sefaz;
- Notas fiscais que baixam estoque;
- Notas Fiscais onde a natureza de operação seja do tipo "Saída";
- Notas Fiscais com CFOP que inicia com 7;
- Notas Fiscais que estão atualizadas em Obrigações Fiscais;
- Documentos Fiscais que possuem os dados de Exportação informados (consultar em "Consulta Documentos Fiscais" (OF0311), folder "Comex");
E são desconsideradas as notas fiscais:
- Notas fiscais de Diferença de Preço;
- Notas Fiscais canceladas;
05. ASSUNTOS RELACIONADOS
...
|
06. SITUAÇÕES ATENDIDAS PELO CONFIGURADOR DE TAGS
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
...
Templatedocumentos |
---|
HTML |
---|
<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> |