Produto:

Datasul

Ocorrência:

Como funciona o configurador de regras (CD0024) para o conversor de XML (RE0708)?

Passo a passo:

Durante a importação da NF-e/NFS-e/CT-e, os dados do XML podem ser traduzidos para dados internos da empresa, por intermédio do cadastro de configurador de regras (CD0024).

Para os documentos, as seguintes operações podem ser traduzidas pela Engine:



Update

até 12.1.6

12.1.7 em diante



Descrição

Tipo Operação

Tipo Oper NF-e

Tipo Oper CT-e

Tipo Oper NFS-e

Trad. Natureza Operação

nat-operacao

nfe-nat-oper

cte-nat-oper

nfse-nat-oper

Trad. Série documento

serie-docto

nfe-serie-docto

cte-serie-docto

nfse-serie-docto

Trad. Código do Emitente

cod-emitente

nfe-cod-emit

cte-cod-emit

nfse-cod-emit

Trad. Código do Item

it-codigo

nfe-it-codigo

cte-it-codigo


Trad. Número Ordem de Compra

numero-ordem

nfe-num-ordem


nfse-num-ordem

Trad. Número Pedido de compra

num-pedido

nfe-num-pedido


nfse-num-pedido

Trad. Código observação

cod-observa

nfe-cod-observa



Trad. Código Item Serviço NFS-e

cod-item-serv



nfse-it-codigo

Trad. FIFO

log-fifo-oc

nfe-log-fifo-oc



Trad. Parcela Ordem Compra NF-e

parcela

nfe-num-parcela



Trad. Parcela Ordem Compra NFS-e

num-parcela



nfse-num-parcela

Trad. Número Ordem Produção

nr-ord-produ

nfe-nr-ord-produ



Trad. Código Referência

cod-refer

nfe-cod-refer



Trad. Lote

lote

nfe-lote



Trad. Data Validade Lote

dt-vali-lote

nfe-dt-vali-lote



Trad. Código Depósito

cod-depos

nfe-cod-depos



Trad. Código da Localização

cod-localiz

nfe-cod-localiz



Trad. Unidade medida NF-e

un-xml

nfe-un-xml



Trad. Unidade medida NFS-e

cod-un



nfse-cod-un

Trad. Código Município no IBGE

num-munpio-prestac



nfse-munic-prest

Importante:

Após atualizar para o update 12.1.7, poderão ser mantidos os Tipo de Operação já existentes, pois estes continuarão funcionando normalmente. A partir do update 12.1.7, ao criar o novo tipo de operação (exemplo: nfe-nat-oper) o sistema irá considerar este novo conjunto de regras para a tradução dos documentos, desconsiderando o conjunto de regras anterior, por exemplo: nat-operacao.

Para traduzir essas operações, há a possibilidade de utilizar as seguintes variáveis:


Doc

Descrição

Variável

Tipo Dado

NFe

Alíquota COFINS CST

aliq-cofins-cst

Caracter

NFe

Centro Custo

centro-custo

Caracter

NFe

CNPJ Destino

cnpj-destino

Caracter

NFe

CNPJ Saída

cnpj-saida

Caracter

NFe

Depósito

cod-depos

Caracter

NFe

Emitente

cod-emitente

Inteiro

NFe

Estab. Destino

cod-estabel

Caracter

NFe

Estab. Origem

cod-estabel-ori

Caracter

NFe

Grupo Fornecedor

cod-gr-forn

Inteiro

NFe

Localização

cod-localiz

Caracter

NFe

Observação

cod-observa

Caracter

NFe

Referência

cod-refer

Caracter

NFe

Cód. Sit. Trib. IPI

cod-sit-trib-ipi

Caracter

NFe

Alíquota pCredSN

cred-simp-nac

Decimal

NFe

Descrição Item

desc-item

Caracter

NFe

Data Emissão

dt-emissao

Data

NFe

Dt Valid. Lote

dt-vali-lote

Data

NFe

Família Comercial

fm-cod-com

Caracter

NFe

Família Material

fm-codigo

Caracter

NFe

Grupo Estoque

ge-codigo

Inteiro

NFe

Alíquota ICMS

icms-aliq

Decimal

NFe

ICMS CSOSN

icms-csosn

Caracter

NFe

ICMS CST

icms-cst

Caracter

NFe

Código Item

it-codigo

Caracter

NFe

Código Item Fornec (Dados Originais)

it-codigo-fornec

Caracter

NFe

FIFO Ord. Compra

log-fifo-oc

Logico

NFe

Lote

lote

Caracter

NFe

Modalidade Frete

mod-frete

Inteiro

NFe

CFOP XML

cod-cfop

Caracter

NFe

Num Documento

nro-docto

Caracter

NFe

Num Ord. Produção

nr-ord-produ

Inteiro

NFe

Ordem Compra

numero-ordem

Inteiro

NFe

Ordem Investimento

num-ordem-inv

Inteiro

NFe

Pedido Compra

num-pedido

Inteiro

NFe

Parcela Ord. Compra

parcela

Inteiro

NFe

Redução Base Cálculo

reduc-bc

Decimal

NFe

Série Documento

serie-docto

Caracter

NFe

Tipo Item

tipo-item

Inteiro

NFe

UF do Emitente

uf-end

Caracter

NFe

Unid. Medida XML

un-xml

Caracter

NFe

Tipo Operação NF-e

tipo-oper-nfe

Inteiro

CTe

CFOP XML

cod-cfop

Caracter

CTe

Série Documento

serie-docto

Caracter

CTe

Emitente

cod-emitente

Inteiro

CTe

CNPJ Remetente

cnpj-rem

Caracter

CTe

UF destino

uf-dest

Caracter

CTe

UF entrega

uf-ent

Caracter

CTe

CNPJ Destino

cnpj-dest

Caracter

CTe

Código Item

it-codigo

Caracter

CTe

Grupo Fornecedor

cod-gr-forn

Inteiro

NFSe

Natureza Operação

nat-operacao

Caracter

NFSe

Série Documento

serie-docto

Caracter

NFSe

Emitente

cod-emitente

Inteiro

NFSe

Unidade Medida

cod-un 

Caracter

NFSe

Estabelecimento

cod-estab

Caracter

NFSe

Data Emissão

dt-emissao

Data

NFSe

UF prestador

cod-uf-prestdor

Caracter

NFSe

Codigo Item

cod-item-serv

Caracter

NFSe

Município Prest

num-munpio-prestac

Inteiro

NFSe

Grupo Estoque

ge-codigo

Inteiro

NFSe

Grupo Fornecedor

cod-gr-forn

Inteiro


Exemplo de simulação de regra

1. CD0025 (Tipo Operação): Primeiramente deve ser criada a operação, conforme listagem passada anteriormente.



2. CD0024 (Configurador de Regras): Incluir  a operação para a empresa e estabelecimento, veja que automaticamente a partir da versão 12.1.7 já são carregadas todas as variáveis disponíveis para a operação.



3. CD0024 (Configurador de Regras): Criar a regra que deseja que seja retornada, nesse exemplo criou-se uma regra para CFOP para que retorne a natureza de operação para o monitor

Observação:

O botão "Sequenciar Regras" tem por objetivo sequenciar as regras pela mais especifica primeiro, ou seja, com mais variáveis nas condições, e deixar por último a mais abrangente, a que possui menos variáveis.

(lightbulb) Vale lembrar que outro fator que influencia no retorno da regra é o agrupamento das condições.


4. CD0024 (Configurador de Regras): Na aba de condições é que efetivamente será cadastrada as condições para retorno da regra. No exemplo abaixo, ao receber um XML do fornecedor cujo código da CFOP é 6101 ou 6102, e a alíquota do ICMS do XML é igual a 12%, será aplicado o retorno.

Importante:

Deve-se verificar o agrupamento realizado pois funcionará como um operador matemático:

Por exemplo:

Se (cod-cfop = 6101 ou cod-cfop = 6102) e (icms-aliq = 12,00).

Ou seja, o botão "Agrupar Inicio" simboliza o local que inicialmente será colocado o parênteses na sua operação, e o botão "Agrupa Fim" simboliza onde será fechado o parênteses .


Essa informação é muito importante pois caso seja feito o agrupamento incorreto pode ocasionar o retorno de outra regra ou de não traduzir nenhum retorno na importação do XML.





5. CD0024 (Configurador de Regras): Ao cadastrar o retorno para a regra, o retorno sempre deve ser igual a operação. A partir da 12.1.7 já é sugerido automaticamente a operação de retorno, sendo necessário apenas o usuário cadastrar nesse caso qual a natureza de entrada que deve ser sugerida.


6. CD0026 (Simulador Configurador de Regras): Nesse programa pode ser testada a regra criada para verificar se as condições cadastradas retornam a regra correta.

Trata-se apenas de um simulador para testar o agrupamento e se retorna a informação desejada. Ao importar o XML, se todas as condições não forem atendidas, pode ocorrer de não retornar a informação esperada.


7. Importando um XML para verificar a Regra

Ao importar o XML (RE0522/RE0516/RE0517) deve-se confirmar se as informações estão de acordo com a regra. No exemplo a seguir o XML tem a CFOP 6101 e a alíquota do ICMS é de 12%.

Dessa forma, atendendo todas as condições, poderá ser verificado após a importação do arquivo que a regra criada foi importada com sucesso no Monitor NF-e/CT-e/NFS-e (RE0708).


(question) E se eu criei toda a regra, importei o XML e não traduziu a informação que eu cadastrei?

Abaixo, segue um passo a passo das principais verificações a serem feitas:

  1. Abrir o XML importado e comparar ao CD0024 (Configurador de Regras), verificando se o conteúdo do XML está de acordo com as condições cadastradas. Pode ocorrer de cadastrar uma condição mas no XML o conteúdo ser diferente.
    Por exemplo: CFOP - 6101 mas o XML ser da CFOP - 5101, sendo assim não deve interpretar a regra.
  2. CD0024 (Configurador de Regras): Verificar o agrupamento das regras. Como o agrupamento é como um operador matemático, se não for feito de forma correta pode ocasionar o retorno incorreto, ou de não retornar a informação no momento da importação do XML.
    Importante:  O agrupador Início e Fim são como "parênteses" em operações matemáticas. Por exemplo: (nat-operacao = 5122 ou nat-operacao=5123 ou nat-operacao = 5224 ) e (cod-sit-trib-ipi > 51).
  3. CD0024 (Configurador de Regras): Verificar se foi cadastrado um retorno válido, ou seja, o retorno deve ser a operação cadastrada e deve ter um conteúdo existente no ambiente. Se você deseja retornar uma natureza de operação "1101", essa natureza deve estar cadastrada no ambiente.

Confira o vídeo no qual demonstra a usabilidade e criação de regras no CD0024, disponível em: http://fluig.totvs.com:80/portal/p/10097/videos/dmateriais/2254500/3742831

A partir da versão 12.1.11, foi liberada uma pequena melhoria para permitir rastrear as regras utilizadas na tradução do XML. Foi criado um novo parâmetro para ativar ou desativar a criação do histórico de execução do configurador de regras (também conhecido como engine de regras). Este parâmetro foi criado na tela de cadastro de Tipo de Operação (CD0025). Ao ativar o histórico de execução poderá ser emitido o relatório (CD0034) que exibirá as regras que foram utilizadas em cada execução do configurador. No relatório, várias informações podem ser visualizadas, tais como: A regra utilizada, o conteúdo anterior e conteúdo traduzido, as condições da regra utilizada e as variáveis que foram passadas para o configurador.

Observações:

Não se aplica


#trackbackRdf ($trackbackUtils.getContentIdentifier($page) $page.title $trackbackUtils.getPingUrl($page))