Operações em lote

O menu Operações em Lote reúne o que você faria documento a documento - importar, baixar, etiquetar e manifestar - em uma ação só. Quem integra pela API também emite em lote.

Importar XMLs

Se você tem XMLs guardados fora da plataforma - de um sistema antigo, do e-mail do contador -, Importar XMLs os traz para dentro.

1Escolha a Empresa destino.
2Arraste ou selecione os arquivos XML de NF-e ou CT-e - a plataforma detecta o tipo sozinha.
3Documentos que já existem (mesma chave de acesso) não são duplicados: a importação é idempotente.

Cada documento novo conta no bloco Inbound contratado - importado ou sincronizado, o custo de processar e guardar é o mesmo. Reimportar um documento que já existe não conta de novo. A tela mostra esse aviso e o saldo do ciclo para quem tem bloco contratado.

Com o bloco esgotado, um ZIP é recusado de entrada; se ele esgotar durante a importação, os documentos novos que não couberam ficam como retidos por cota, com o XML guardado, sem perda. Compre mais blocos e use Reprocessar retidos por cota para importá-los. Importar um arquivo avulso sem saldo é recusado com a mensagem de bloco esgotado.

Baixar em lote

Download XML NF-e, Download XML CT-e e Download PDF recebem uma lista de chaves de acesso e devolvem os arquivos de uma vez - para fechar o mês com o contador sem clicar documento por documento.

Etiquetar em lote

Etiqueta aplica uma etiqueta a vários documentos de uma vez. As etiquetas são criadas na área administrativa e servem de filtro nas listagens - um jeito leve de marcar “conferido”, “pendência” ou qualquer recorte seu.

Manifestar em lote

A manifestação em lote fica na própria listagem de NF-e: selecione os documentos e use Manifestar Operação. Há um teto de 50 documentos por lote - cada item vira uma chamada assinada à SEFAZ, e lotes maiores devem ser divididos. Um documento recusado não interrompe os demais: o resultado sai item a item.

Emitir em lote (integração)

Quem integra pela API pode emitir várias NF-e numa requisição só, enviando um arquivo ZIP com um arquivo .json por documento, no mesmo contrato canônico da emissão unitária. É a rota de emissão com o sufixo /batch.

O teto é de 50 documentos por lote. O limite é da SEFAZ, não uma escolha de capacidade da plataforma - por isso não é ajustável. Um lote com 51 documentos é recusado por inteiro, antes de emitir qualquer nota: emitir as 50 primeiras e falhar na última deixaria você com 50 documentos fiscais válidos gerados a partir de uma requisição que você considera inválida, e documento autorizado não se desfaz.

O lote não é tudo-ou-nada. Cada nota tem seu próprio destino na SEFAZ e pode ser autorizada ou rejeitada por razões próprias - a resposta traz o resultado de cada documento, identificado pela sua referência de idempotência.

Reenviar é seguro. A emissão é idempotente pela referência do seu sistema: se o lote falhou no meio, reenvie o mesmo ZIP. As notas já emitidas devolvem o resultado original, sem duplicar, e só as restantes são processadas. Referências repetidas dentro do mesmo ZIP emitem uma vez só, e a repetição é reportada.

O arquivo é tratado como entrada não confiável: além do limite de 50, há teto de tamanho do upload e do conteúdo descompactado, e arquivos compactados aninhados não são abertos.