Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

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.

Importante
Informações
title
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:

     Selecionar

     Selecionar 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:

     Informar

     Informar a versão do documento para qual será cadastrada a regra para manipulação da TagCorresponde ao campo "Versão WebService" do programa CD0403B (Configurações do TSS).

  • Tag:

     Informar

     Informar o nome da Tag que será aplicada a regra.

  • Tag Pai:

     Informar

     Informar 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) dest

    Essa informação é usada em conjunto com o campo Tag para identificação dentro do XML.

  • Início de Validade:

     Informar

     Informar a data do início de validade para a regra.

  • Fim de Validade:

     Informar

     Informar a data do fim de validade para a regra.

Interface do cadastro de Informações da

...

Tag

Image Modified

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.

Informações
titleImportante

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.

Interface do cadastro de regra da Tag

Image Modified

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

Image Modified

...

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)
Image Added
Consulta das alterações realizadas pelo Configurador de Tags no programa FT0909E.

Image Added

05. EXEMPLOS


Alterado o programa FT0536 - Exporta Arquivo Polícia Federal para ser possível atender as alterações propostas pela Portaria.

Na pasta "Seleção", ficarão disponíveis apenas os campos referente a seleção dos dados a serem gerados no arquivo TXT para posteriormente serem importados no Sistema SIPROQUIM2 da DPF.

Image Removed

Foi criado uma nova pasta chamada "Parâmetro" onde foram disponibilizados os campos referentes a Versão do leiaute Siproquim a ser gerado pelo programa. Licença de Importação quando a versão do leiaute for inferior a 2.0 e o Diretório de Exportação do arquivo TXT.

Image Removed

Com relação a versão do arquivo Siproquim a ser gerado, o novo campo aceita qualquer valor conforme poderá ser liberado pela PF em caso de possíveis alterações do leiaute corrente. Atualmente o programa está preparado para aceitar as versões "1.0" ou "1.1" no caso da necessidade da geração do arquivo TXT para ser importado em versões anteriores do Sistema Siproquim da PF, ou o valor "2.0" quando for ser gerado o arquivo para ser importado já atendendo ao novo leiaute do Sistema Siproquim2 da PF.

Image Removed

Caso o valor informado no campo "Versão Siproquim" for "2.0" ou superior, o campo "Licença Importação" ficará desabilitado pois corresponde somente à versão anterior ("1.0" e/ou "1.1") e a geração dessa informação no arquivo passará a ser buscada do programa CD0160 - Parâmetros de Itens Controlados por Órgãos.

Exemplo do arquivo gerado contendo os dados do Mapa:

Image Removed

Dados gerados a partir de uma Nota Fiscal de Saída (Seção Movimentação Nacional de Produtos Químicos (MVN):

Image Removed

Dados gerados a partir de uma Nota Fiscal de Exportação (Seção Movimentação Internacional de Produtos Químicos (MVI):

Image Removed
Totvs custom tabs box
tabsPrograma Template,Alteração de Tag,Inclusão de Tag
ids1,2,3
idsFT0536,CD0160,CD0194,CD0161
Totvs custom tabs box items
defaultyes
referenciaFT0536

Parâmetros de Itens controlados por Órgãos (CD0160) é o programa responsável pelo controle das principais parâmetros onde são apresentados os estabelecimentos e uma guia para cada órgão, sendo eles Polícia Federal, Polícia Civil e Exército. Os parâmetros serão válidos a partir do momento que for informado o código licença para cada órgão. Através desse programa é possível realizar o cadastro dos parâmetros para cada tipo de órgão por estabelecimento com informações relevantes sobre as mesmas, incluindo as licenças dadas pelos órgãos.

Image Removed

Relacionamento Tipo de Operação x Natureza (CD0194) é o programa responsável por gerar a informação correspondente à Operação de Entrada e/ou Saída da Seção de Movimentação Nacional de Produtos Químicos (MVN) Mais informações disponíveis em CD0194 - Manutenção Relacionamento Tipo Operação x Natureza

Image Removed

Image Removed

Totvs custom tabs box items
defaultno
referenciaCD0160
Totvs custom tabs box items
defaultno
referenciaCD0194
2

Exemplos da ação "Alteração de Tag"

1) Eliminar a tag infCpl do XML da NF-e

1.1) Criar um cadastro no Configurador de Tags conforme o exemplo abaixo.

Image Added

1.2) XML antes da execução do Configurador de Tags

Image Added

1.3) XML após a execução do Configurador de Tags

Image Added

2) Concatenar um texto na tag infAdFisco

2.1) Criar um cadastro no Configurador de Tags conforme o exemplo abaixo.

Image Added

2.2) Como foi informado o Tipo de Operação "Programa", é necessário vincular um programa Progress que ficará responsável por atribuir o valor desejado.

Programa de exemplo: exemplo1.p

2.3) XML após a execução do Configurador de Tags

Image Added

Totvs custom tabs box items
defaultno
referenciaCD01613

Exemplo da ação "Inclusão de Tag"

1) Inclusão do grupo de tags entrega

1.1) Criar um cadastro no Configurador de Tags conforme o exemplo abaixo.

Image Added

Image Added

<entrega>
    <CNPJ>01527909000165</CNPJ>
    <xLgr>RUA SANTA CATARINA</xLgr>
    <nro>1500</nro>
    <xBairro>CENTRO</xBairro>
    <cMun>3550308</cMun>
    <xMun>SAO PAULO</xMun>
    <UF>SP</UF>
</entrega>

1.2) Como foi informado o campo "Programa", é necessário vincular um programa Progress que ficará responsável por atribuir o valor desejado. Por mais que os valores das Tags já foram preenchidos no cadastro, é possível alterá-los pelo programa.

Programa de exemplo: exemplo2.p

1.3) XML após a execução do Configurador de Tags. Obs: Notem que a tag "nro" foi alterada via programa.

Image Added


Totvs custom tabs box items
defaultyes
referencia1

Programa Template

No Configurador de Tags, é possível utilizar um programa Progress para atribuir valores as tags que serão incluídas ou alteradas. Esse programa Progress possui uma assinatura de parâmetros que deve ser respeitada para que a execução funcione com sucesso.

Informações
iconfalse
titlePrograma Template

// As definições das temp-table dos parâmetros e alguns funções auxiliares podem ser consultadas na include ftapi924.i.

{ftp/ftapi924.i}

DEFINE INPUT PARAM TABLE FOR ttParam.                                              /* Temp-Table com os parâmetros */
DEFINE INPUT-OUTPUT PARAM TABLE FOR ttStructClient. 

Relacionamento Item x Órgãos (CD0161): é pré-requisito para geração do arquivo de Mapa da Polícia Federal que os itens estejam cadastrados no programa de Relacionamento Item x Órgão (CD0161). Informações gerais sobre essa rotina, estão disponíveis em Cadastro de Relacionamento Item x Órgãos - CD0161

Informações detalhadas dos campos, folder "Polícia Federal":

Image Removed

  • Controla Item para a Polícia Federal: É utilizado como base para verificar quais itens são controlados pela polícia federal;
  • Código Polícia Federal: Indica a classificação fiscal do item, conforme leiaute da polícia o primeiro campo se refere ao código e o segundo campo a classificação fiscal.
  • Unidade de Medida da Polícia Federal: Deve ser controlado ou em L (litro) ou em K (kilos). Obs: O leiaute pede a unidade de medida com essa nomenclatura, portanto é importante trabalhar com a unidade dessa maneira. 
  • Concentração: Informar a concentração do item;
  • Densidade: Informar a densidade do item. Obs.: no novo leiaute o formato da densidade é "99,99", deve ser respeitado esse formato no momento do cadastro.
  • Considera Itens nas Movimentações de Saídas (Ambos ou Exportação):  Define para qual tipo de movimentação o item será considerado na emissão do relatório para a Polícia Federal. Além de definir o tipo de movimentação do item, também é necessário vincular os países que tiveram operações conforme o tipo de movimentação selecionado e que devem apresentar o item no relatório. Para isso, deve-se utilizar o botão "Adicionar País", que disponibiliza uma interface (CD0161A) para vínculo do país com o item.
    • Importante:
      • Se for selecionado a opção "Ambos", não é necessário vincular o país Brasil ao item, pois o programa irá considerá-lo automaticamente.
      • A planilha abaixo é um exemplo, aonde é possível constatar que a movimentação de determinado item para alguns países não deve ser listada no relatório da Polícia Federal.

Image Removed

Nota

Campo "Código da Polícia Federal": Deve ser verificado se o item é simples ou composto para validar a forma de cadastrar as informações:

           Ex: PR (produto simples) ou SC (substância controlada) -  Campo "Código da Polícia Federal":  Sigla + classificação fiscal (cadastrar sempre com máscara);

                 PC (produto composto)    -  Campo código polícia federal - classificação fiscal (cadastrar sempre com máscara). No caso de produto composto o primeiro campo referente a sigla não deve ser preenchido.

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

...

 /* Temp-Table com a estrutura do XML parametrizado para a regra */
DEFINE INPUT-OUTPUT PARAM TABLE FOR ttStructCurrent.                    /* Temp-Table com o estrutura atual do XML */
DEFINE INPUT-OUTPUT PARAM cTagValue AS CHARACTER NO-UNDO.  /* Valor da Tag */

RETURN "OK".

Exemplos:

ftnfe001a.p - Incluir a tag infAdProd se existir relacionamento item-cli com narrativa informada 

ftnfe002a.p - Atribui a quantidade do item para as tags qTrib e qCom em notas fiscais de diferença de preço com finalidade complementar

ftnfe003a.p - Incluir a tag infAdic e infCpl ou alter -la quando existir cadastro no CD0208 para o item com o tipo de texto NF-e

06. SITUAÇÕES ATENDIDAS PELO CONFIGURADOR DE TAGS

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

...

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>