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