Conteúdo

1. Visão Geral

O processo de Gerar NFCom - disponível no Módulo "TOTVS Gestão de Estoque, Compras e Faturamento" - transforma os movimentos criados nesse módulo em documentos fiscais eletrônicos (arquivos em formato XML) que serão transmitidas à SEFAZ do Contribuinte posteriormente, em outra etapa do fluxo da NFCom (para visualizar o fluxo, acesse Nota Fiscal de Comunicação Eletrônica (NFCom) | 3.2 Processos).

Este processo está disponível em três formas, permitindo diferentes configurações para o usuário:

O XML gerado é o mesmo para todas as formas mencionadas acima, sendo que a diferença entre os processos está na forma de execução fornecida ao usuário. Essas diferenças são detalhadas posteriormente neste documento no tópico 4. Execução do Processo.


2. Fluxo do Processo


3. Configurações iniciais

Para acessar o menu Documentos Eletrônicos | Nota Fiscal de Comunicação Eletrônica (NFCom) e gerar a NFCom, é necessário realizar algumas configurações iniciais, conforme abaixo:

Este modelo de documento possui uma permissão de acesso diferente dos demais documentos eletrônicos. Para dar permissão de acesso ao menu da NFCom a um usuário, siga os passos abaixo:

  • Acesse o perfil vinculado ao usuário desejado do módulo TOTVS Gestão de Estoque, Compras e Faturamento e edite o perfil;
  • Vá até a aba Acesso a Menus, siga o caminho [04] Vendas | [04.02] Documentos Eletrônicos, selecione [04.02.01.07] Nota Fiscal de Comunicação Eletrônica (NFCom) e, logo após, clique em Permitir Acesso.

Este processo possui o conceito de multiprocessamento¹, ou seja, pode ser executado em vários pedaços para não sobrecarregar o processamento de grandes volumes de dados.
Suponhamos que a geração da NFCom será feita para 15.000 movimentos. O multiprocessamento irá dividir esses movimentos em vários processos separados e executar cada um desses processos com quantidades menores de notas. Isso resulta em um ganho de tempo e performance tanto na geração das notas quanto na utilização do sistema como um todo.


¹ Este conceito é referido tecnicamente na Linha RM como fracionamento de jobs.

Para usar o multiprocessamento na geração da NFCom, é necessário cadastrá-lo em Ambiente | Segurança de Jobs Fracionáveis. No cadastro, informe o perfil do usuário correspondente ao módulo, a classe de job como "DocNFComGerarData", as frações máximas e mínimas de acordo com a quantidade de vezes que desejar dividir o multiprocessamento e marque se ele é agendável e/ou se está ativo.

Formulário exemplificando os dados do fracionamento:

Agora, é necessário parametrizar um movimento para gerar NFCom. Para isso, vá em Ambiente | Parâmetros | Gestão de Estoque, Compras e Faturamento | Selecione o movimento desejado | Etapa 67 - Fis - NF-e | NF-e Estadual | Envia Manualmente (trocar pelo parâmetro da NFCom quando for criado). 


4. Execução do Processo

Como exibido no tópico 1. Visão Geral, há três caminhos para execução do processo de Gerar NFCom. Todos os três caminhos irão fazer a geração do XML da nota da mesma forma, possuindo diferença apenas na forma que permite ao usuário planejar/executar a geração de suas notas. Abaixo, seguem as diferenças entre cada um dos processos e respectivos detalhes sobre seleção de registros, fracionamento de jobs e agendamento:

A execução deste processo ocorre através do menu Documentos Eletrônicos | Nota Fiscal de Comunicação Eletrônica (NFCom) | Processos | Gerar NFCom.


O processo identifica automaticamente quais movimentos de NFCom ainda não geraram o XML, não sendo necessário selecionar nenhum registro na tela. Esta seleção é feita com base no parâmetro de envio selecionado no movimento (vide item 3. Configurações Iniciais > Parametrizar Movimento). Mesmo que algum registro em específico seja selecionado, a geração não irá se aplicar apenas para ele, e sim para todos os movimentos no sistema que estejam parametrizados para geração da NFCom e ainda não tenham suas notas geradas.

Este processo principal não reprocessa notas já geradas ou com erro/inconsistência. Caso seja necessário reprocessar notas específicas, veja "Gerar NFCom (à partir do movimento)".

Diferente dos modelos de NF-e e NFS-e, o processo de Gerar NFCom não faz nenhuma comunicação com a SEFAZ. Ele apenas gera o XML da nota e valida seu schema, sendo necessário realizar a transmissão das notas posteriormente.

As notas serão geradas com o status Não Transmitido, caso a validação do schema da nota não retorne erros, ou Inconsistente, caso haja erro na validação. [ajustar após implementação da validação de schema]

A execução deste processo ocorre diretamente no movimento. Para isto, acesse o movimento parametrizado para geração de NFCom e vá em Processos | Gerar Xml NFCom.

Exemplo acessando o processo através de um movimento de faturamento:

Esta tela permite a seleção específica dos movimentos que irão gerar a NFCom na tela. Caso nenhum movimento seja selecionado, o processo será executado para todos os movimentos presentes na tela, semelhante à maioria dos processos da Linha RM.

Este processo é semelhante ao de  "Gerar NFCom" que está no menu de "Nota Fiscal de Comunicação Eletrônica (NFCom)". Ele irá gerar as notas com status Não transmitido, caso não haja erros na validação de schema, ou Inconsistente, caso haja algum erro na validação.

Diferente dos modelos de NF-e e NFS-e, o processo de Gerar NFCom não faz nenhuma comunicação com a SEFAZ. Ele apenas gera o XML da nota e valida seu schema, sendo necessário realizar a transmissão das notas posteriormente.

Este processo permite o reprocessamento de notas com erro ou inconsistentes, atualizando tanto o conteúdo da nota quanto seu novo status ao reprocessar.

Para acessar o agendamento da NFCom, vá em Documentos Eletrônicos | Nota Fiscal de Comunicação Eletrônica (NFCom) | Processos | Agendar Geração NFCom. 

Este processo é o mesmo do Gerar NFCom (principal), com a diferença de que permite realizar agendamento dos jobs que irão executar o processo. O agendamento permite que várias execuções do processo sejam programadas futuramente de forma automática, sem necessidade posterior de intervenção manual para gerar a NFCom, além de também ser fracionável.
O processo de agendamento apenas irá aparecer na NFCom caso o ambiente utilizado esteja em 3 camadas E o cadastro do fracionamento esteja com a opção "Agendável" marcada. Caso o fracionamento não seja agendável, apenas uma tela de conclusão de processos será exibida. 
Este agendamento também não permite seleção manual dos movimentos a gerarem a NFCom, se baseando unicamente nos movimentos parametrizados para geração da NFCom que ainda não tenham notas geradas. Assim como processo principal, o agendamento da geração da NFCom não irá reprocessar notas com erro ou inconsistente.

Diferente dos modelos de NF-e e NFS-e, o processo de Gerar NFCom não faz nenhuma comunicação com a SEFAZ. Ele apenas gera o XML da nota e valida seu schema, sendo necessário realizar a transmissão das notas posteriormente.


5. Multiprocessamento e agendamento


 3. Este processo é passível de fracionamento de job

3.1 Quando o fracionamento vai ocorrer?
        Ao executar o processo Gerar NFCom.
        Para isso é necessário criar o job fracionável em "Segurança de Jobs Fracionáveis", como explicado em Configurações Iniciais.

3.2 Quantos registros por fracionamento podem ter?
        21000 registros por fração.
        Se for necessário mais fatias do que parametrizado, o sistema fará o calculo automático da quantidade de fatias serão necessárias.
        Calcula quantidade de movimentos e a quantidade máxima de fatias, (Quantidade_Movimento / Quantidade_Maxima_Fatias) para achar quantas fatias que serão necessárias para executar o processo.

3.3 O que pode ocorrer quando não tem fracionamento configurado?
        Ao não criar Fracionamento de Jobs, pode ocorrer erro ao persistir dos dados no banco, se existirem mais de 21.000 notas na mesma execução.

4. Quando parametrizado em N camadas o processo identifica instâncias dele mesmo para evitar concorrência.

4.1 Como funciona a concorrência de job?
        Verifica se existe outro job em execução de mesmo ID, coligada, nome e módulo (movimento), se sim não executa

Importante: a quantidade máxima de notas processadas por fatia no fracionamento é de 21.000. Caso a quantidade de frações mínimas/máximas não sejam suficientes para processar um determinado volume de notas, o sistema irá calcular a quantidade de fatias mínimas necessárias para processamento internamente.
Exemplo: é necessário gerar 100.000 notas, e a quantidade mínima e máxima de frações cadastrada é igual a 2. O sistema irá dividir a quantidade de notas pelo número máximo por fatia (100.000 / 21.000 ~= 4.76, arredondando para um número inteiro, = 5) e utilizará 5 fatias para geração da NFCom.


 5. Este processo é passível de fracionamento de job

3.1 Quando o fracionamento vai ocorrer?
        Ao selecionar o(s) movimentos e executar o processo Gerar Xml NFCom.
        Para isso é necessário criar o job fracionável em "Segurança de Jobs Fracionáveis", como explicado em Configurações Iniciais.

3.2 Quantos registros por fracionamento podem ter?
        21000 registros por fração.
        Se for necessário mais fatias do que parametrizado, o sistema fará o calculo automático da quantidade de fatias serão necessárias.
        Calcula quantidade de movimentos e a quantidade máxima de fatias, (Quantidade_Movimento / Quantidade_Maxima_Fatias) para achar quantas fatias que serão necessárias para executar o processo.

3.3 O que pode ocorrer quando não tem fracionamento configurado?
        Ao não criar Fracionamento de Jobs, pode ocorrer erro ao persistir dos dados no banco, se existirem mais de 21.000 notas na mesma execução.

6. Quando parametrizado em N camadas o processo identifica instâncias dele mesmo para evitar concorrência.

4.1 Como funciona a concorrência de job?
        Verifica se existe outro job em execução de mesmo ID, coligada, nome e módulo (movimento), se sim não executa


6. Layout do XML Gerado

Esse processo irá gerar o XML da NFCom conforme estrutura abaixo. Ao clicar em cada ponto da estrutura, pode-se verificar os detalhes e regras de geração de cada campo dentro dos grupos.