# Formulário Geração de Notas Fiscais em Lote
## Introdução
O formulário de Geração de Notas Fiscais em Lote é uma ferramenta projetada para automatizar e simplificar o processo de emissão de notas fiscais em grande escala. Esta funcionalidade permite aos usuários gerar múltiplas notas fiscais simultaneamente, baseando-se em critérios específicos como dados financeiros ou dos contratos.

> [!NOTA] Acesso ao Formulário
> Caminho: Menu Configurações > Rotinas fiscais > Geração de notas em lote
## Benefícios 
- **Otimização**: O sistema facilita o processo de geração de notas, reduzindo intervenções manuais.
- **Flexibilidade**: Diversos filtros e opções permitem uma geração personalizada de notas.
- **Validação**: Mecanismos de validação garantem a integridade e conformidade das notas geradas.
- **Integração**: O processo se integra com outros módulos do sistema, como financeiro e contábil.
## Estrutura do Formulário 
O formulário "Geração em Lote" está estruturado em uma Grid, que possibilita o gerenciamento dos lote de notas ficais criados, além de permitir criar novos lotes. Ao criar um "Novo" registro, será apresentado um menu com seis aba, sendo elas: 

1. **Informações**: Exibe as informações gerais do registro ou documento selecionado;
2. **Opções**: Permite a configuração específica dos filtros para a geração das notas;
3. **Filtros**: A aba "Filtros" permite definir critérios específicos para a geração de notas fiscais em lote no sistema.
4. **Base no financeiro**: Permite filtrar informações na geração de notas a partir dos dados financeiros.

> [!INFO]  Observação: 
> Esta aba será habilitada apenas se na aba "Opções", no campo "Base para geração" estiver selecionada como "Financeiro". 

5. **Saídas:** Exibe as notas emitidas no lote, incluindo  informações importantes como status, data de emissão, numeração, entre outras;
6. **Log:** Registra os erros e os motivos pelos quais as notas não foram emitidas.
## Campos Disponíveis 
### Aba Informações 
| Campo                               | Descrição                                                                                                | Observação                                                                        |
| ----------------------------------- | -------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| **ID**                              | Identificação única do filtro no sistema.                                                                | Campo preenchido automaticamente pelo sistema.                                    |
| **Descrição do filtro**             | Descrição de identificação (**Exemplo:** Notas Fiscais de Janeiro 2025)                                  | Campo obrigatório. Deve ser preenchido pelo usuário.                              |
| **Status**                          | Estado atual do filtro (**Opções:** Não Gerado, Gerado, Cancelado, Excluído, Parcial, Em processamento). | Campo atualizado automaticamente pelo sistema com base nas movimentações do lote. |
| **Notas geradas**                   | Quantidade total de notas geradas até o momento.                                                         | Campo preenchido automaticamente pelo sistema.                                    |
| **Valor total gerado**              | Soma total dos valores das notas geradas.                                                                | Campo de preenchimento automático.                                                |
| **Erros (última execução)**         | Quantidade de erros ocorridos na última execução do filtro.                                              | Campo de preenchimento automático.                                                |
| **Início da rotina**                | Data e hora de início da execução da rotina.                                                             | Campo de preenchimento automático.                                                |
| **Final da rotina**                 | Data e hora de término da execução da rotina.                                                            | Campo de preenchimento automático.                                                |
| **Tempo médio por Nota (segundos)** | Tempo médio gasto para a geração de cada nota, em segundos.                                              | Campo de preenchimento automático.                                                |
### Aba Opções 
| Campo                                  | Descrição                                                                                                                                                                                                                                                                                  | Observação                                                                       |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------- |
| **Base para geração**                  | Indica a base que será utilizada para a geração das notas fiscais (**Opções**: Contrato ou Financeiro).                                                                                                                                                                                    | Campo obrigatório. Deve ser preenchido pelo usuário.                             |
| **Base geração por tipo de documento** | Define o método de emissão das notas fiscais. A opção **" Documento Opcional do Contrato"** seguirá a configuração feita na aba “Faturamento” do contrato do cliente. Já a opção **"Documento do produto do Produto"** considerará o tipo de documento vinculado aos produtos do contrato. | Campo obrigatório. Deve ser preenchido pelo usuário.                             |
| **Modelos de NF**                      | Define o tipos de Nota Fiscal a serem gerados (**Opções**: Notas SCM (21/22), Notas de Comércio (55/65), Notas de Serviço (13), SVA, Notas NFCom (62).                                                                                                                                     | Campo obrigatório. Deve ser preenchido pelo usuário.                             |
| **Data emissão NF gerada**             | Data em que a nota fiscal será emitida e informada na nota fiscal.                                                                                                                                                                                                                         | Campo obrigatório. Deve ser preenchido pelo usuário.                             |
| **Tipo documento opcional**            | Tipo do documento opcional configurado no contrato dos clientes (**Opções**: 1, 2, 3 ou 4).                                                                                                                                                                                                | Campo obrigatório. Deve ser preenchido pelo usuário.                             |
| **Condição de pagamento**              | Condição de pagamento que será aplicada no financeiro gerado junto com a Notas Fiscais.                                                                                                                                                                                                    | Campo de busca. Deve ser preenchido somente quando houver geração de financeiro. |
### Aba Filtros
| Campo                                    | Descrição                                                                                                                                                                                                                    | Observação         |
| ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ |
| **Filial**                               | Se marcado, irá trazer apenas clientes vinculado a filial informada.                                                                                                                                                         | Campo opcional.    |
| **Carteira de cobrança**                 | Se marcado, irá trazer apenas clientes vinculado carteira de cobrança associada.                                                                                                                                             | Campo opcional.    |
| **Tipo de cliente**                      | Se marcado, irá gerar notas fiscais apenas para os clientes vinculado a esse tipo.                                                                                                                                           | Campo opcional.    |
| **Tipo pessoa**                          | Se marcado, irá trazer apenas clientes com a classificação escolhida (**Opções**: Todos Estrangeiro, Jurídica ou Física).                                                                                                    | Campo opcional.    |
| **Gerar nota proporcional avulso**       | Define se notas proporcionais avulsas serão geradas.                                                                                                                                                                         | Campo opcional.    |
| **Gerar NF clientes bloqueados**         | Define se serão geradas notas fiscais para clientes bloqueados.                                                                                                                                                              | Campo opcional.    |
| **Gerar NF boletos recebimento parcial** | Define se serão geradas notas fiscais para boletos com recebimento parcial. (**Observação:** A geração e a simulação da NF é feitas a partir de um boleto com recebimento parcial serão geradas com o valor total do boleto) | Campo opcional.    |
| **Modelo de NF**                         | Tipo de modelo de Nota Fiscal a ser emitido.                                                                                                                                                                                 | Campo opcional.    |
| **Contrato inicial**                     | Número do contrato inicial ao qual o filtro será aplicado. (**Observação:** ID do contrato)                                                                                                                                  | Campo opcional.    |
| **Contrato final**                       | Número do contrato final ao qual o filtro será aplicado. (**Observação:** ID do contrato)                                                                                                                                    | Campo opcional.    |
| **Mês/Ano referência**                   | Mês e ano de referência para a geração de notas fiscais.                                                                                                                                                                     | Campo obrigatório. |
| **Data inicial do contrato**             | Data inicial do contrato considerado para a geração das notas fiscais. (**Observação**: Se marcado, o lote incluirá os contratos com data de ativação igual ou posterior à data informada.                                   | Campo opcional.    |
### Aba Base no financeiro
| Campo                                            | Descrição                                                                                                                                                                                                                        | Observação      |
| ------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------- |
| **Buscar produtos por**                          | Critério para buscar os produtos a serem considerados na geração da nota fiscal. (**Opções:** Produtos do contrato, Produtos do financeiro.)                                                                                     | Campo opcional. |
| **Status**                                       | Status dos lançamentos financeiros que serão considerados. (**Opções:** Recebidos, Em aberto ou ambos).                                                                                                                          | Campo opcional. |
| **Forma recebimento**                            | Tipo de forma de recebimento que será considerada. (**Observação:** A forma de recebimento "Caixa" se refere a qualquer tipo de valor recebido, a forma "Banco" se refere a Pix, Gateway, Débito em conta ou Cartão de crédito.) | Campo opcional. |
| **Gerar NF para pré-contrato**                   | Indica se notas fiscais devem ser geradas para pré-contratos.                                                                                                                                                                    | Campo opcional. |
| **Data de geração**                              | Critério de data para geração das notas fiscais.                                                                                                                                                                                 | Campo opcional. |
| **Vencimento inicial**                           | Data de início do período de vencimento a ser considerado. (**Observação**: O campo será exibido apenas quando o filtro **Data de geração** estiver configurado como **Vencimento**. )                                           | Campo opcional. |
| **Vencimento final**                             | Data final do período de vencimento a ser considerado. (**Observação**: O campo será exibido apenas quando o filtro **Data de geração** estiver configurado como **Vencimento**. )                                               | Campo opcional. |
| **Recebimento Inicial**                          | Data de início do período de recebimento a ser considerado. (**Observação**: O campo será exibido apenas quando o filtro **Data de geração** estiver configurado como **Recebimento**. )                                         | Campo opcional. |
| **Recebimento Final**                            | Data final do período de recebimento a ser considerado. (**Observação**: O campo será exibido apenas quando o filtro **Data de geração** estiver configurado como **Recebimento**. )                                             | Campo opcional. |
| **Gerar nota para recebimentos fora do período** | Se marcado, só serão geradas notas para status 'Recebido'. A geração será com base nos vencimentos e não na data de recebimento.                                                                                                 | Campo opcional. |
## Funcionalidades Principais 
Ao acessar o formulário de geração de notas em lote, será exibido um menu com os registros dos lotes já gerados anteriormente. Na parte superior, serão apresentadas quatro opções com as seguintes funcionalidades.

1. **Novo**: Cria um novo registro;
2. **Editar**: Permite a edição de um registro existente.  **Observação:** O sistema só irá permitir editar dados dos lotes que estiver o status "Não Gerado"
3. **Deletar**: Remove um registro do sistema. **Observação:** O sistema só irá permitir deletar dados dos lotes que estiver o status "Não Gerado".
4. **Clonar filtro**: Cria uma cópia do registro selecionado.
5. **Simular Geração**: Opção para simular a geração das notas, permitindo identificar e corrigir erros antes da geração final.
6. **Listar Filtros**: Opção para listar as notas que serão geradas com base nos filtros aplicados.
7. **Excluir notas fiscais**: Permite Excluir notas fiscais do modelo 21/22 e SVA. 
8. **Cancelar notas em massa**: Permite realizar o cancelamento em massa das Notas Fiscais emitidas em lote. 
## Filtros Adicionais
### Filtro: Gerar Nota Para Recebimentos Fora do Período
O filtro "Gerar nota para recebimentos fora do período" é uma funcionalidade essencial no processo de geração de notas fiscais em lote. Este recurso permite um controle mais preciso sobre quais recebimentos serão incluídos na geração de notas, mesmo quando estão fora do período padrão de faturamento. 

> [!INFO] Observação
> Só serão geradas notas para status 'Recebido'. A geração será com base nos vencimentos e não na data de recebimento.

> [!TIP] Observação
> Quando for gerar períodos retroativos, o campo **Data de vencimento inicial para períodos retroativos** deve ser preenchido com a data inicial para o sistema verificar se existem boletos recebidos que não foram gerados notas anteriormente.
>  - **Exemplo**: se nos campos **Vencimento inicial e final**, estiver preenchido com as datas 01/03/2024 e 31/03/2024, no campo **Data de vencimento inicial para períodos retroativos**, poderá ser preenchido com a data 01/01/2024, e neste caso, o sistema buscará se existem boletos que não foram gerados entre 01/01/2024 até 29/02/2024 (um dia antes da data de vencimento inicial).
### Filtro: Base para Geração
### Geração base do Contrato:
- Gera notas fiscais de acordo com os produtos que estão na aba de produtos do contrato do cliente;
- O sistema busca as informações diretamente nos produtos cadastrados no contrato;
- A nota é gerada de acordo com o valor dos produtos do contrato;
- Tem menos opções de filtros comparado à geração base do financeiro. 
### Geração base do Financeiro:
- Gera notas fiscais de acordo com os vencimentos e recebimentos dos financeiros;
- Baseia-se nos registros financeiros existentes, como boletos gerados;
- Permite mais opções de filtros comparado à geração base do contrato;
- Requer que o financeiro já esteja gerado e contenha os produtos corretos para emitir a nota fiscal adequadamente;
- Se houver discrepância entre os produtos no contrato e no financeiro, pode ser necessário ajustar ou regenerar o financeiro para emitir a nota corretamente.

> [!INFO] Observação: 
> É importante notar que, ao gerar com base no financeiro, é necessário que os produtos no financeiro correspondam aos que se deseja incluir na nota fiscal. Se houver alterações no contrato após a geração do financeiro, pode ser necessário atualizar o financeiro antes de emitir as notas fiscais por esse método.
### Filtro: Buscar produtos por 
O filtro **"Buscar produtos por"** será exibido apenas quando a base de geração do lote, definida na aba **"Opções"**, estiver configurada como **Documento por produto do contrato**.

- **Buscar produtos do contrato:** Se marcado, o sistema buscar **produtos do contrato**, a nota fiscal será gerada vinculada ao financeiro, utilizando o tipo de documento associado ao produto do contrato.

> [!WARNING] Atenção 
> Independentemente dos produtos vinculados ao financeiro, ao selecionar a opção para buscar o tipo de documento do produto/plano do contrato, essa configuração será aplicada. Dessa forma, o financeiro não terá interferência, seja em situações como: boletos proporcionais ou renegociados.

- **Buscar produtos do financeiro:** Se marcado, o sistema buscar **produtos do financeiro**, a nota fiscal será gerada vinculada ao financeiro, utilizando o tipo de documento associado ao produto do financeiro.
## Conceito Status do Lote
- **Não gerado**: Indica o status inicial do lote no momento de sua criação.
- **Gerado:** Aparece quando a emissão do lote é concluída e todas as notas fiscais são geradas com sucesso pela rotina.
- **Cancelado:** Apresentado no para quando as notas do lote forem canceladas.
- **Lote excluído:** Apresentado quando as notas fiscais do lote foram excluídas;
- **Parcial:** Apresentado quando as notas não foram geradas por completo;
- **Em processamento**: Apresentado enquanto a rotina ainda está em andamento ou há notas fiscais pendentes de conclusão; 
## Fluxo de Trabalho
```mermaid
graph TD
    A[Início] --> B[Acessar Formulário]
    B --> C[Configurar Filtros]
    C --> D[Simular Geração]
    D --> E{Resultados OK?}
    E -->|Sim| F[Gerar Notas]
    E -->|Não| G[Ajustar Filtros]
    G --> D
    F --> H[Fim]
```
## Considerações Finais
O formulário de Geração de Notas Fiscais em Lote é uma ferramenta poderosa que otimiza e simplifica o processo de faturamento. Sua utilização adequada pode resultar em significativa economia de tempo e redução de erros, melhorando a eficiência operacional da empresa.
## Etiquetas
 #Faturamento #AutomacaoFiscal #NFSe #ProcessosFinanceiros #NotasFiscais #Fiscal 
## Leia Também
- [[tipos de notas fiscais emitidas no sistema|Tipos de Notas Fiscais Emitidas no Sistema]]
- [[aba tributacao por operacao - classificacao tributaria|Aba Tributação por operação - Classificação Tributária]]
- [[formulario geracao de notas fiscais em lote - agrupado|Formulário Geração de Notas Fiscais em Lote - Agrupado]]
- [[emissao de notas fiscais em lote - base financeiro|Emissão de Notas Fiscais em Lote - Base Financeiro]]
- [[emissao de notas fiscais em lote - base do contrato|Emissão de Notas Fiscais em Lote - Base do Contrato]]
- [[emissao de notas fiscais saidas|Tipos de Emissão de notas fiscais no Sistema]]