RECEBIMENTO AUTOMÁTICO DE NF-e

Características do Requisito

Descrição

O objetivo dessa implementação é permitir a importação automática das notas fiscais eletrônicas, através do processo do TOTVS Colaboração 2.0.

O atual processo responsável pelo recebimento da NF-e, exige a intervenção manual do usuário para resolver alguns conflitos, tais como, tradução dos produtos, seleção da natureza de operação, entre outros. A fim de simplificar este processo, será implementado o recebimento automático da NF-e, o qual será capaz de solucionar todas estas questões, mediante uma prévia configuração, sendo que todas as validações/consistências executadas na criação manual do movimento serão também executadas no recebimento e criação automática da NF-e.

O Recebimento Automático da NF-e está disponível apenas para o TOTVS Colaboração 2.0, mas as melhorias de performance e de usabilidade das telas também estão disponíveis para o TOTVS Colaboração 1.0.

É importante salientar que para a utilização do TOTVS Colaboração é indispensável a contratação dos serviços da NeoGrid que é a responsável pelo processamento da leitura dos arquivos XML, pela comunicação com os webservices da SEFAZ e pelo retorno às consultas destes documentos. Estes, por sua vez, serão lidos e interpretados através da execução de JOBs específicos pelo ERP TOTVS Linha RM para a devida atualização dos dados no sistema.

Procedimento para Utilização

1. Parametrização

Para o correto funcionamento da rotina de Recebimento Automático das NF-e é necessário que sejam executadas algumas parametrizações. São elas:

1.1. Tipo de Recebimento de NF-e

O campo "Tipo de Recebimento de NF-e" define a forma como o sistema irá realizar o processo de recebimento automático das NF-e. Esta informação é parametrizável por Fornecedor do Totvs Colaboração e/ou por Filial.

Assim, quando do recebimento automático de uma NF-e, caso o emitente da mesma conste na tabela de definições do Cli/For para o Totvs Colaboração ("Cadastros > Mais > Tabelas Auxiliares > Definições de Cli/For – Totvs Colaboração"), essa informação prevalecerá e assim, para determinados fornecedores, poderá ser definido um Tipo de Recebimento diferente do que é praticado geralmente. 

Para o preenchimento deste campo é importante avaliar quais os fornecedores que enviam o nº do Pedido de Compra no XML.

Caso no momento do recebimento automático de uma NF-e o emitente da mesma não conste na tabela de "Definições de Cli/For para o Totvs Colaboração", o sistema obedecerá ao que foi parametrizado para a filial de destino da NF-e em "Ambiente > Parâmetros > Gestão de Estoque, Compras e Faturamento > 04.03  - Integrações > 04.03.03 - Fiscal > 04.03.03.01 - Dados Fiscais > Parâmetros por Filial > Informações TOTVS Colaboração".

Assim, para evitar possíveis erros no momento do recebimento é importante que o parâmetro da filial esteja sempre preenchido indicando como o sistema deve proceder para os fornecedores cujo Tipo de Recebimento não foi informado.

Os Tipos de Recebimento possíveis são:

• Inclusão Direta:O sistema não considera o código do pedido no XML e realiza a inclusão direta do movimentode NF-e com base nos dados existentes no XML. O movimento será criado, acatando a todas as parametrizações do seu tipo de movimento, ou seja, efetuando todas as integrações parametrizadas e terá o status 'Normal'; 
  
  
•  Inclusão Direta - Status Não Processado:O sistema não considera o código do pedido no XML e realiza a inclusão direta do movimento com base nos dados existentes no XML, mas com o status “Não Processado”.  Um movimento criado com status 'Não Processado' existirá apenas como documentação, sem qualquer efeito sobre o sistema, ou seja, estes movimentos serão criados sem a geração de suas possíveis integrações com a Contabilidade, Financeiro e Estoque e não irão gerar movimentação no estoque, lançamentos financeiros, lançamentos contábeis, atendimentos no RMAgilis, etc. Para que estes movimentos passem a ter efeito os mesmos deverão ser processados, além de obrigatoriamente serem submetidos ao processo  "Conferir Movimento Totvs Colaboração" (vide item 4.3 deste documento);
  
  
• Recebimento de Pedido:O sistema utiliza o código do pedido contido no XML para buscar o movimento correspondente e realizar o faturamento do mesmo, sendo que se o pedido não for encontrado na base de dados o novo movimento não será criado na base de dados pois o sistema abortará o processo, informando o motivo através do log de execução. 
  
  
• Recebimento de Pedido ou Inclusão Direta:Através do conteúdo do XML, o sistema tentará identificar o respectivo pedido, e caso seja bem-sucedido, será realizado o faturamento do mesmo. Se o sistema não conseguir identificar nenhum pedido, a inclusão do movimento será feita através dos dados constantes do XML e sem nenhum relacionamento com qualquer outro movimento já existente na base de dados, ou seja, o movimento será criado acatando a todas às parametrizações do seu tipo de movimento, efetuando todas as integrações parametrizadas. O novo movimento terá o status "Normal";
  
  
• Recebimento de Pedido ou Inclusão Direta - Status Não Processado:Através do conteúdo do XML, o sistema tentará identificar o respectivo pedido, e caso seja bem-sucedido, será realizado o faturamento do mesmo.  Se o sistema não conseguir identificar nenhum pedido, a inclusão do movimento será feita através dos dados constantes do XML e sem nenhum relacionamento com qualquer outro movimento já existente na base de dados, ou seja, o movimento será criado acatando às parametrizações do seu tipo de movimento, exceto as de integração, pois o movimento será criado com o status "Não Processado". Um movimento criado com status 'Não Processado' existirá apenas como documentação, sem qualquer efeito sobre o sistema, ou seja, estes movimentos serão criados sem a geração de suas possíveis integrações com a Contabilidade, Financeiro e Estoque e não irão gerar movimentação no estoque, lançamentos financeiros, lançamentos contábeis, atendimentos no RMAgilis, etc. Para que estes movimentos passem a ter efeito os mesmos deverão ser processados, além de obrigatoriamente serem submetidos ao processo  "Conferir Movimento Totvs Colaboração" (vide item 4.3 deste documento).

Lembre-se que caso para alguns fornecedores o tipo de recebimento seja diferente do que foi definido para a filial forneça esta informação em "Cadastros > Mais > Tabelas Auxiliares > Definições de Cli/For – Totvs Colaboração".

Caso a filial não vá utilizar a rotina de recebimento automático da NF-e, o campo "Tipo de Recebimento de NF-e" deverá permanecer em branco. 

1.1. Tipo de Movimento para Recebimento Automático de NF-e

Em “Ambiente > Parâmetros > Gestão de Estoque, Compras e Faturamento > Integrações > Fiscal > Parâmetros por Filial > Informações Totvs Colaboração”, deverá ser preenchido por filial o campo "Tipo de Movimento para Recebimento Automático de NF-e".

Este novo parâmetro é do tipo fórmula, e assim, através do mesmo, o usuário poderá implementar uma regra específica para buscar o tipo de movimento que será utilizado no recebimento automático da NF-e de cada filial.

Essa fórmula será executada para cada XML a ser recebido.

Foram criadas duas novas funções de fórmula para auxiliar na criação dessa regra, são elas:

• TABXMLCOLAB - Retorna o valor de um campo da tabela de XMLs do Totvs Colaboração (TNFEENTRADA);
• DADOSXMLCOLAB - Retorna o valor de uma TAG de um XML.

Daremos a seguir exemplos de utilização de ambas as funções.

Exemplo de fórmula de seleção do tipo de movimento utilizando a função TABXMLCOLAB:

Exemplo de fórmula de seleção do tipo de movimento utilizando a função DADOSXMLCOLAB:

Nesta função é permitido o acesso a qualquer TAG do XML e para isso, assim como no exemplo acima, deve ser informado o caminho da TAG desejada separado por barra ( / ), e o namespace do XML, no nosso caso o namespace da NF-e (http://www.portalfiscal.inf.br/nfe).

Quando a tag possuir índice, basta informá-lo o entre colchetes ([ ]).

No nosso exemplo o sistema irá retornar a informação da TAG CFOP do primeiro item da NFe, já que não informamos o índice.

Veja abaixo um exemplo da mesma fórmula retornando o CFOP do 2º item da NFe:

Caso a filial não vá utilizar a rotina de recebimento automático da NF-e, o campo "Tipo de Mov. para Recebimento Automático de NF-e" não deverá ser preenchido.

Este novo parâmetro somente será habilitado quando, no quadro “Tipo Documento Integração Totvs Colaboração” pelo menos uma das opções, 'Todos' ou 'Recebimento de NF-e' estiver marcada.

2. Cadastros

Para o correto funcionamento da rotina de Recebimento Automático das NF-e devemos ficar atentos ao preenchimento de alguns cadastros. São eles:

2.1. Natureza Fiscal (CFOP)

Quando uma nota fiscal eletrônica é enviada por um fornecedor, ela contém, para cada um dos seus itens, uma natureza fiscal (CFOP) de saída, que caracteriza a operação desse fornecedor. Para a empresa que recebe esse documento, entretanto, devemos encontrar a natureza fiscal (CFOP) de entrada correspondente. Essa ‘Natureza Inversa’ é indispensável para a criação automática de um movimento de NF-e.

Para definir a Natureza Inversa na geração automática do movimento de entrada, o Totvs Gestão de Estoque, Compras e Faturamento utilizará os seguintes recursos:

2.1.1. Regra de Seleção da Natureza (RSN)

Para cada movimento de NF-e a ser incluído, o sistema irá encontrar a Natureza Inversa da CFOP constante do arquivo XML. Para isso, é necessário saber, através das parametrizações vigentes do tipo de movimento, se o movimento a ser criado seleciona a Natureza de Operação somente para o movimento, ou se deve ser selecionada também uma Natureza para o item de movimento. Para ambos os casos, será utilizada em primeiro lugar a Regra de Seleção da Natureza (RSN), rotina hoje já existente e, que tem a finalidade de encontrar a Natureza de Operação baseada nas informações do movimento e parametrizações de várias tabelas tais como: Parâmetros do Tipo de Movimento, Produto, Classificação de Produto, Naturezas Fiscais, Regras de ICMS, Regras de IPI, etc..

Para verificar como está a parametrização da sua empresa vá na etapa "Fis - Natureza" dos Parâmetros dos Tipos de Movimento que serão utilizados no Recebimento Automático da NF-e e verifique o preenchimento do campo "Seleção Automática da Natureza".

Detalharemos a seguir como o sistema procederá, conforme o tipo de Seleção Automática da Natureza definido para o tipo de movimento.

2.1.1.1. Seleção Automática da Natureza por Movimento

Neste caso, deverá ser encontrada obrigatoriamente uma Natureza de Operação analítica para o movimento.

Através dos dados do XML e das parametrizações e cadastros do sistema, a RSN irá encontrar as naturezas possíveis, de forma que:

• Se a RSN encontrar apenas uma Natureza de Operação (CFOP) possível, o movimento de NF-e será incluído com o CFOP encontrado;
  
  
• Se a RSN encontrar mais de uma Natureza de Operação (CFOP) possível, o sistema irá verificar as opções cadastradas como Natureza Inversa da CFOP extraída do XML (veja item 2.1.2) e
  • Se uma das opções selecionadas pela RSN estiver cadastrada como ‘Default’, ela será utilizada para a criação de movimento;
  • Se uma das opções selecionadas pela RSN estiver cadastrada como Natureza Inversa, mas não como ‘Default’, ela será utilizada para a criação do movimento, desde que exista apenas uma única correspondência entre os itens cadastrados e as opções retornadas pela RSN. Caso contrário, o sistema não saberá qual Natureza Inversa escolher e o movimento será criado com status ‘Inconsistente'.
  • Se nenhuma das opções retornadas pela RSN estiver no cadastro de Natureza inversa, o movimento não será criado.

2.1.1.2. Seleção Automática da Natureza por Item de Movimento

Nesta situação, será realizado o mesmo procedimento já explicado anteriormente para encontrar a Natureza de Operação do movimento, com a diferença desta poder ser analítica ou sintética. 

Se for encontrada uma Natureza analítica, sua ‘Raiz’ (Natureza Sintética) deve ser extraída e considerada como a Natureza do movimento enquanto que a Natureza analítica será atribuída ao item.

Caso sejam encontradas 2 naturezas sintéticas possíveis, os campos natureza 1 e natureza 2 do movimento (TMOV.IDNAT, TMOV.IDNAT2) serão preenchidos caso ambos estejam parametrizados para o tipo de movimento. Se por algum motivo existirem mais de 2 naturezas sintéticas possíveis, o sistema não será capaz de resolver o conflito e, neste caso a natureza não será identificada.

Caso seja encontrada apenas a Natureza sintética, ela será atribuída ao movimento, e o procedimento de busca será realizado novamente para selecionar a Natureza do item. Para o item, a RSN irá considerar os dados do movimento e das demais tabelas citadas anteriormente (Parâmetros do Tipo de Movimento, Produto, Classificação de Produto, Naturezas Fiscais, Regras de ICMS, Regras de IPI, etc.).

Conforme já informado o sistema primeiramente executará as Regras de Seleção da Natureza, mas caso a mesma retorne mais de uma opção de CFOP para os itens do movimento, o sistema utilizará o cadastro das Naturezas Inversas que detalharemos a seguir:

2.1.2. Natureza Inversa 

No cadastro de Natureza de Operação (CFOP), de responsabilidade do sistema Totvs Gestão Fiscal (RMLiber), foi criado um anexo onde deverão ser cadastradas as possíveis naturezas de operação inversas para uma determinada natureza sintética.

Uma natureza de operação sintética, poderá ter a ela vinculada, várias naturezas de operação inversas, sejam elas sintéticas ou analíticas.

Entre as naturezas inversas cadastradas, o usuário poderá definir ‘defaults’, ou seja, registros que devem ser considerados prioritários caso existam várias naturezas possíveis para um determinado movimento. Uma natureza default pode ser sintética ou analítica, entretanto, poderá haver somente uma natureza analítica default de cada 'raiz' para uma mesma natureza sintética. 

Exemplo:

Image Added

No nosso exemplo acima a natureza 1.102.04 não pode ser default para a natureza 5.101 já que outra natureza que possui a mesma sintética (1.102.03) já foi definida como default para a mesma.