Emissão em lote por planilha
Atualizado em
Nesta página
A emissão em lote transforma cada linha de uma planilha em uma NFS-e. A Emitra valida o arquivo inteiro antes de emitir, mostra o que está certo e o que tem erro, e só transmite depois que você confirma.
Pré-requisitos#
- Permissão
lote:emitir(Owner, Admin ou Emissor). - Plano Profissional ou superior.
- Configuração fiscal completa e certificado válido.
Passo a passo#
- No menu, abra Notas › Automação › Emissão em lote.
- Clique em Baixar modelo e escolha CSV ou XLSX. Use sempre o modelo mais recente.
- Preencha uma linha por nota. As colunas cobrem o tomador (pelo documento de um cliente cadastrado ou com os dados para criar na hora), o código do item, a descrição, o valor, a competência e uma referência sua (
external_ref). - Envie o arquivo.
- Aguarde a validação. Cada linha passa pelas mesmas regras da emissão, sem transmitir nada.
- Confira a prévia: linhas válidas de um lado, linhas com erro do outro, com o motivo.
- Clique em Confirmar para emitir as linhas válidas.
- Acompanhe o progresso. Ao final, baixe o relatório (CSV ou XLSX) com o número da NFS-e ou o motivo da rejeição de cada linha.
Limites do arquivo#
| Item | Limite |
|---|---|
| Tamanho | 5 MB |
| Linhas | 2.000 |
| Formatos | CSV (separador ; ou ,, UTF-8 ou Latin-1) e XLSX |
Limite de notas do plano#
O limite mensal é conferido na confirmação: a Emitra compara o total de linhas válidas com o que resta no mês. Se não couber, ela avisa quantas notas cabem para você ajustar o arquivo. O limite é conferido de novo a cada nota no momento da emissão.
Sem nota duplicada#
Cada linha tem uma chave de idempotência própria (lote + número da linha). Se o processamento for interrompido e retomado, uma linha já emitida não gera uma segunda nota.
Rejeições no meio do lote#
Uma rejeição da Sefin afeta só a linha dela. As demais seguem normalmente. O relatório final mostra o código e a mensagem de cada linha rejeitada para você corrigir e enviar num novo arquivo.
Retenção do arquivo#
O arquivo original fica guardado por 90 dias e depois é apagado. O relatório e as notas emitidas continuam disponíveis.
Modo rascunho#
Se preferir revisar antes, os rascunhos gerados vão para a fila de aprovação, onde você aprova em massa.
Pela API#
Pela API, não há upload de planilha: envie uma chamada POST /integracao/nfse por nota, cada uma com a sua Idempotency-Key. Veja Idempotência. Para receber o aviso de lote concluído, assine batch.completed.
Erros comuns#
- Colunas não reconhecidas: o arquivo não segue o modelo. Baixe o modelo de novo.
- Tomador não encontrado: o documento não está cadastrado e a linha não traz os dados para criá-lo.
- Competência futura: a competência não pode ser posterior à data de emissão (E0015).