Esta documentação tem como objetivo apresentar o processo de envio em lote de NFS-e entre PlugNotas e Prefeituras. O envio em lote é uma solução prática e eficiente, permitindo a transmissão simultânea de múltiplas notas fiscais, o que é especialmente benéfico para empresas que lidam com um grande volume de documentos fiscais. Essa abordagem não apenas otimiza o tempo de processamento, mas também contribui para a redução de erros e a melhoria na organização dos registros fiscais.

É importante ressaltar que a aceitação do envio em lote pode variar entre as diferentes prefeituras e cidades. Portanto, é fundamental verificar se a cidade atual do prestador aceita envio em lote via webservice. Abaixo abordaremos os requisitos, benefícios e orientações necessárias para garantir um envio eficiente e conforme as validações presentes.

Funcionamento do Envio em Lote no PlugNotas

O envio em lote de Notas Fiscais de Serviço Eletrônicas (NFS-e) no PlugNotas é um processo simplificado que permite a transmissão de várias notas fiscais simultaneamente, otimizando o tempo e os recursos das empresas. A seguir, detalhamos como funciona esse processo:

1. Ativação do Envio em Lote
O cliente pode ativar a funcionalidade de envio em lote de duas maneiras:

- Via API: O cliente pode ativar o envio em lote por empresa diretamente no cadastro da empresa no PlugNotas.
- Via Interface: Alternativamente, a opção pode ser ativada através da interface do usuário do PlugNotas, no cadastro da empresa

É importante ressaltar que, para que a ativação do envio em lote seja realizada com sucesso, a prefeitura do cliente deve conter o envio em lote integrado para emissões via webservice. Se a prefeitura não permitir o envio em lote, o PlugNotas retornará um erro ao tentar salvar a atualização/cadastro da empresa.

2. Preparação das Notas para Envio
Para que as notas sejam enviadas em lote, o cliente deve enviar várias requisições simultâneas ao PlugNotas ou, de forma mais eficiente, um único array contendo múltiplos objetos de notas fiscais.

3. Conversão de JSON para XML
Assim que as requisições são recebidas, o PlugNotas converte o JSON enviado pelo cliente em um formato XML apropriado. Este XML conterá vários RPS (Recibo Provisório de Serviço), permitindo que todas as notas sejam enviadas de uma só vez para a prefeitura.

4. Tratamento do Retorno do Lote
Após o envio, o PlugNotas processa o retorno do lote. Com isso, iremos atualizar o status das notas fiscais com base na resposta da prefeitura, informando se as notas foram rejeitadas ou autorizadas. Essa atualização é fundamental para garantir que o cliente tenha sempre informações precisas sobre o status de suas NFS-e.

Na prática...

1. Ativando o envio em lote

VIA API

Na rota de atualizar empresa, envie o campo agrupaLoteAutomatico dentro do nó nfse.config.rps.agrupaLoteAutomatico

Caso a prefeitura não aceitar o envio em lote, iremos devolver uma mensagem informando que não é possível ativar para aquela cidade específica. 

VIA INTERFACE WEB

Na interface do PlugNotas, acesse a empresa e na configuração de NFS-e, ative o envio em lote automático. Caso a prefeitura não aceitar o envio em lote, iremos devolver uma mensagem informando que não é possível ativar para aquela cidade específica. 

Envio em lote com múltiplas séries

Além do envio em lote normal, existem prefeituras apenas com fluxos sequenciais que permitem que seja enviado mais de um lote ao mesmo tempo, porém, com séries diferentes. A cidade de Maringá por exemplo, permite este tipo de envio, portanto, antes de ativar o envio de múltiplos lotes simultâneos em séries diferentes, será necessário confirmar se a prefeitura/cidade aceita este tipo de envio. 

O envio de lotes com múltiplas séries simultâneas pode ser ativado via API ou via interface. Com este campo ativo, as notas poderão ser agrupadas em lotes durante o envio aos Web Services que permitem envio em lote. O PlugNotas ficará responsável por controlar as séries dos lotes de acordo com as séries cadastradas para a empresa. Só é possível utilizar esse recurso com duas ou mais séries cadastradas. A quantidade máxima de lotes simultâneos que podem ser enviados com séries diferentes pode variar de padrão pra padrão, porém, o PlugNotas tem como valor default de 5 lotes podendo ser enviados ao mesmo tempo, ou seja, utilizando 5 séries diferentes. 

2. Realizando o envio

1. Enviar notas em lote: O envio em lote da parte do cliente funciona da mesma forma. É necessário enviar duas ou mais notas no JSON na rota /nfse da API.

• Caso o lote seja rejeitado pela prefeitura, todas as notas também serão rejeitadas no PlugNotas. Assim, será necessário verificar o erro, corrigir a nota adequada e reenviar as notas rejeitadas. Posteriormente, o PlugNotas enviará essas notas em lote para a prefeitura.
• Algumas prefeituras retornam informações específicas sobre a nota que apresentou erro dentro do lote, o que facilita a identificação do problema. No entanto, outras prefeituras podem enviar um erro genérico para todas as notas, tornando essencial que o prestador compreenda a situação para identificar qual nota realmente apresenta erro ou se todas estão com problemas. Dessa forma, ele poderá realizar os ajustes necessários e reenviar as notas corretamente.
• Se o lote for autorizado na prefeitura, todas as notas são alteradas para CONCLUIDO no PlugNotas.

Porém, aqui temos um ponto de atenção: pode ser que você envie 6 notas de uma vez mas a prefeitura só aceite 2 RPS por lote. Neste caso, o PlugNotas irá repartir essas notas e irá enviar 2 notas em cada lote. Com isso, teremos essas 6 notas divididas em 3 lotes, com 2 RPS em cada lote. 

2.Consultar notas: A consulta funciona da mesma forma já existente, utilizar a consulta de nfse por id ou protocolo. Rotas /nfse/consultar/${idNfse} ou /nfse/consultar/${protocoloDeEnvio} da API.

É possível verificar o número do lote das notas nas rotas de consulta completa ou consulta resumida da NFS-e, através do protocolo retornado pela API no envio da requisição:

O envio do webhook será realizado conforme de costume, de forma individual, nota a nota. Não será enviado um webhook único quando as notas forem enviadas em lote.

Em Outubro/2024 será disponibilizado a opção de consultar se a cidade aceita o envio em lote, através das rotas auxiliares para a busca de informações e particularidades da cidade para emissão. 

O envio em lote de notas fiscais através do PlugNotas é um recurso eficiente que otimiza o processo de emissão e gestão de documentos fiscais.