Remessa Fiscal — transmissão em lote de várias notas pra SEFAZ numa só chamada
Esta wiki cobre a tela Remessa Fiscal do Quaza, que agrupa documentos fiscais (NFe, NFCom, NFSe, NFe 21/22) e os transmite em uma única requisição ao webservice da SEFAZ. Audiência: equipe fiscal/contábil que processa lotes diários grandes de notas e precisa entender como o Quaza faz a transmissão em massa.
Resumo em uma linha: Remessa Fiscal junta várias notas Criadas num lote único, monta um XML envelope SOAP e manda numa única chamada à SEFAZ. Cada nota individualmente recebe o seu retorno (Protocolada/Rejeitada). Economiza chamadas, é mais rápido que transmitir uma a uma — útil quando você tem alto volume (mais de 100 notas/dia) ou quando o webservice individual está instável.
Não confunda com "Remessa e Retorno - CNAB": aquela outra wiki cobre
arquivos bancários CNAB
de cobrança (boleto, débito automático), com banco. Esta aqui é fiscal — envia notas pra SEFAZ. São conceitos completamente diferentes apesar do nome similar.
Por que usar lote em vez de transmissão individual
Cada nota fiscal que você emite no Quaza pode ser transmitida de 2 jeitos à SEFAZ:
| Modo |
Como funciona |
Quando usar |
| Individual |
Botão "Processar" em cada nota → 1 chamada SOAP por nota |
Volume baixo, emissão pontual, feedback imediato |
| Lote (Remessa Fiscal) |
Agrupa 50/100/500 notas num XML envelope → 1 chamada SOAP que transmite tudo |
Volume alto (faturamento mensal), webservice individual instável, processamento batch noturno |
Quanto cabe num lote? Depende da SEFAZ — geralmente 50 a 500 notas. SEFAZ-SP costuma aceitar mais; outras menos. O Quaza decide o tamanho automaticamente ou você pode configurar.
Vantagens do lote:
-
Menos chamadas: 1 chamada vs 100 chamadas — reduz latência e carga no webservice.
-
Menos rejeição por timeout: quando a SEFAZ tá lenta, transmitir uma a uma falha mais — lote consolida o risco.
-
Histórico organizado: a remessa fica registrada como "lote do dia X" — auditoria mais limpa.
-
Processamento agendado: dá pra rodar via cron à noite, baixar resultado de manhã.
Desvantagens:
-
Feedback tardio: você só sabe se a nota foi aprovada quando o lote inteiro processar.
-
Rejeição em massa: erro no envelope (não nos itens) derruba o lote inteiro — todas voltam pra Criada.
-
Diagnóstico mais complexo: quando dá problema, você precisa investigar lote + retorno + cada nota.
Glossário
| Termo |
O que é |
| Remessa Fiscal |
Lote de documentos fiscais agrupados pra transmissão em massa à SEFAZ. Não confundir com Remessa CNAB
(financeiro/bancário). |
| Lote |
Conjunto de notas embaladas num XML envelope SOAP único. |
| Recibo |
Número que a SEFAZ devolve assim que recebe o lote (mas ainda não processou). Tabela nfeRecibo guarda esse número. |
| Protocolo |
Número definitivo que cada documento individualmente recebe depois que a SEFAZ processa e autoriza. Cada nota tem seu protocolo. |
| Webservice em lote |
Endpoint específico da SEFAZ pra recebimento de lotes. Geralmente NfeAutorizacao + NfeRetAutorizacao (NFe), NFComAutorizacao + NFComRetAutorizacao (NFCom). Diferente do "consulta status". |
| Envelope SOAP |
Wrapper XML que carrega o lote. Tem cabeçalho com identificação do lote + corpo com cada nota assinada. |
| Assíncrono |
A SEFAZ não responde imediatamente com "autorizada"/"rejeitada" — ela diz "recebido com recibo X". Você consulta o recibo depois e pega o retorno. |
| Síncrono |
SEFAZ responde imediatamente com retorno completo. Algumas UFs usam síncrono em lotes pequenos. |
Fluxo geral — da Criada ao retorno
OPERADOR / CRON QUAZA (servidor) SEFAZ
| | |
| 1. Notas no estado | |
| "Criada" (1) acumulam | |
| | |
| 2. Clica "Gerar remessa" | |
| ou cron executa | |
|------------------------->| |
| | 3. Seleciona N notas Criadas |
| | Monta envelope SOAP |
| | Assina com cert A1 |
| | |
| | 4. Cria registro Remessa |
| | estado = "Pendente" |
| | |
| | 5. POST envelope -> SEFAZ |
| |----------------------------->|
| | | 6. SEFAZ recebe
| | | valida envelope
| | | gera RECIBO
| |<-----------------------------|
| | 7. Remessa = "Transmitida" |
| | Guarda nº do recibo |
| | Notas: situacao = 2 |
| | (Transmitida) |
| | |
| | 8. Aguarda processamento |
| | (assíncrono — 30s a 5min) |
| | |
| | 9. CONSULTA RECIBO |
| |----------------------------->|
| | | 10. SEFAZ devolve
| | | retorno final
| | | com 1 protocolo
| | | por nota:
| | | - autorizada (100)
| | | - rejeitada (4xx)
| |<-----------------------------|
| | 11. Remessa = "Processada" |
| | Cada nota recebe seu |
| | status individual |
| | - sit=3 Protocolada |
| | - sit=4 Rejeitada |
| | |
| 12. Op vê listagem | |
|<-------------------------| |
| - notas OK -> imprime DANFE |
| - notas rejeitadas -> corrige + retransmite |
Leia o diagrama assim: a transmissão em lote é assíncrona — você envia, SEFAZ devolve recibo (não retorno final), você consulta o recibo, aí vem o retorno por nota. Esse "ida e volta" é o que diferencia do modo individual (que é tudo síncrono).
Tela de Remessa Fiscal
Fiscal → Remessa Fiscal
Lista todas as remessas geradas, com filtros por período, situação, tipo de documento, empresa fiscal.
Tela de Remessa Fiscal — listagem das remessas geradas. Cada linha é um lote (com data, qtd. de notas, situação). Pode abrir o detalhe pra ver quais notas estão dentro do lote.
| Coluna |
O que mostra |
| Data emissão |
Quando a remessa foi gerada (não a data das notas). |
| Tipo de documento |
NFe, NFCom, NFSe, NFe 21/22 — só um tipo por lote (não pode misturar). |
| Quantidade de notas |
Quantas notas estão no lote. |
| Valor total |
Soma do valor de todas as notas do lote. |
| Recibo SEFAZ |
Nº do recibo retornado pela SEFAZ (15 dígitos, geralmente). |
| Situação |
Pendente / Transmitida / Processada / Erro. |
Como gerar uma remessa
Existem 2 caminhos:
1. Manualmente (pela tela)
| Passo |
O que fazer |
| 1 |
Vá em Fiscal → Remessa Fiscal
|
| 2 |
Clique em Gerar remessa
|
| 3 |
Escolha o tipo de documento (NFe 55, NFCom, NFSe, NFe 21/22) |
| 4 |
Escolha a empresa fiscal emissora
|
| 5 |
O Quaza lista todas as notas Criadas daquela empresa+tipo prontas pra transmitir |
| 6 |
Selecione quais entrarão no lote (geralmente "todas") e clica Confirmar
|
| 7 |
Quaza monta XML, assina, transmite, registra o recibo |
| 8 |
Aguarda processamento (alguns minutos), clica Consultar retorno ou deixa o cron consultar automaticamente |
2. Automaticamente (via cron)
O Quaza tem cron que pode rodar em horários fixos (ex: a cada 5 minutos das 22h às 05h) processando remessas. Configurado em Admin → Configurações → Tarefas (crons).
Quando usar cron: empresas com faturamento mensal grande (milhares de NFCom emitidas no virar do mês) deixam o cron noturno transmitir. Você acorda com tudo Protocolado.
Estados da remessa (lote)
| Estado |
Significado |
Próxima ação possível |
| Pendente |
Lote criado no Quaza, ainda não transmitido. |
Transmitir → vira Transmitida. |
| Transmitida |
Enviada à SEFAZ. Tem recibo, aguarda processamento. |
Consultar retorno → vira Processada. |
| Processada |
Retorno completo recebido. Cada nota individualmente já tem seu status. |
Estado terminal — verificar documentos. |
| Erro |
Falha na transmissão (timeout, certificado inválido, envelope malformado). Lote inteiro voltou. |
Diagnosticar erro → corrigir → regerar. |
Estados dos documentos no retorno
Depois que a remessa fica Processada, cada nota individual recebe seu status. Importante: o estado da remessa não determina o sucesso das notas — uma remessa Processada pode ter notas Protocoladas E Rejeitadas no mesmo lote.
| Resultado individual |
O que significa |
Próximo passo |
| Protocolada (sit=3) |
SEFAZ aprovou. Tem protocolo. Pode imprimir DANFE e enviar ao cliente. |
Imprimir, enviar e-mail. |
| Rejeitada (sit=4) |
SEFAZ recusou — campo errado, NCM inválido, IE do destinatário inativa, etc. |
Corrigir cadastro/produto → retransmitir (no próximo lote ou individualmente). |
| Denegada (sit=4 c/cStat 110) |
SEFAZ negou uso por irregularidade fiscal do destinatário (CNPJ baixado, sit. especial). |
Não dá pra retransmitir contra o mesmo destinatário. Verifique status fiscal do cliente. |
Tipos de documento que entram em lote
| Tipo |
Aceita lote? |
Observação |
| NFe Modelo 55
|
Sim |
Lote típico de 50-500 notas. Webservice NfeAutorizacao4. |
| NFCom Modelo 62
|
Sim |
Lote por competência mensal (mensalidades). Webservice NFComAutorizacao. |
| NFSe Padrão Nacional
|
Limitado |
O Padrão Nacional aceita lote, mas algumas prefeituras legadas (Tecnospeed, Tecnos) não — transmissão individual obrigatória. |
|
NFe 21/22 (Convênio 201) |
Sim |
Em fim de vida — sendo substituída por NFCom. |
| NFCe Modelo 65 |
Não (geralmente) |
NFCe é consumidor final em varejo — transmissão síncrona obrigatória. |
| NFeSVA
|
Verificar |
Específico SP. Configuração depende da SEFAZ. |
Não misture tipos no lote. Uma remessa = um tipo de documento. Você não envia NFe e NFCom no mesmo envelope. Gere remessas separadas.
Lote × Transmissão individual — quando usar cada
| Cenário |
Recomendação |
Por quê |
| Faturamento mensal massivo (milhares de NFCom no virar do mês) |
Lote |
Reduz chamadas e carga noturna no webservice. |
| Volume diário alto de NFe (> 100/dia, ex: ISP grande revendendo equipamento) |
Lote |
Mais rápido que transmitir 1 a 1. |
| Venda avulsa (1-3 NFe/dia) |
Individual |
Feedback imediato. Lote agrega complexidade desnecessária. |
| NFe pra cliente que está esperando o documento (ex: comércio com pickup) |
Individual |
Cliente precisa do DANFE na hora — não dá pra esperar lote. |
| SEFAZ instável / em manutenção parcial |
Lote |
Lote tem retry mais simples — em individual cada timeout vira retentativa manual. |
| Recuperação de notas Rejeitadas (correção em massa) |
Lote |
Depois de corrigir 50 NFes rejeitadas, retransmitir em 1 chamada é mais limpo. |
| Cancelamento / CCe / Eventos |
Individual |
Eventos não vão em lote — cada um tem seu webservice dedicado (RecepcaoEvento). |
Pegadinhas frequentes
1. Confusão com Remessa CNAB. "Remessa Fiscal" (esta wiki) é envio em lote pra
SEFAZ de notas.
"Remessa e Retorno - CNAB"
é envio de arquivos pra
banco com instruções de cobrança/débito. Conceitos completamente diferentes que compartilham o nome "remessa".
2. Lote Processado ≠ Notas Aprovadas. Uma remessa Processada só significa que a SEFAZ devolveu o retorno — pode ter notas Rejeitadas dentro. Sempre confira individualmente.
3. Envelope rejeitado derruba o lote inteiro. Se o XML envelope tem erro (certificado expirado, schema inválido), as 200 notas dentro voltam pra Criada. Não dá pra "salvar" parte do lote.
4. Recibo perdido = transmissão fantasma. Se o Quaza envia o lote mas perde o recibo (timeout, crash), você não sabe se a SEFAZ recebeu. Antes de retransmitir, consulte status SEFAZ pelo recibo — pode ser que ela tenha aceitado. Retransmitir lote duplicado pode gerar notas autorizadas em duplicidade (que aí precisam ser canceladas).
5. SEFAZ em manutenção rejeita lote inteiro. Quando a SEFAZ retorna cStat 108/109 (em manutenção), o lote falha. Não retransmita imediatamente — espere 30min-2h e tente de novo. Insistir derruba seu IP em rate limit.
6. Lote noturno por cron precisa de cron configurado. O cron de processamento de remessa só roda se estiver agendado em Admin → Tarefas. Verifique se está ativo antes de confiar em emissão automática.
7. Cancelamento NÃO usa lote. Pra cancelar 100 notas, você cancela individualmente (cada uma envia evento 110111 separado). Não há "cancelamento em lote".
8. Tamanho do lote depende da SEFAZ. Cada UF tem limite próprio (NFe: ~50 SP, ~30 outros). NFCom tem padrão SVRS de ~50. Lote maior que o limite = rejeição imediata. Quaza respeita os limites; mas se configurar manualmente, atente-se.
FAQ
Posso configurar pra Quaza só transmitir em lote (nunca individual)?
Sim — desativa o botão "Processar" individual nas configurações da empresa fiscal, e configura cron pra rodar remessa periodicamente. Comum em ISPs com faturamento grande.
O cliente está esperando o DANFE — posso "puxar" só essa nota pra transmitir individual?
Sim. Mesmo que esteja num lote ainda Pendente, você pode retirar a nota do lote e processar individualmente. A remessa fica com 1 nota a menos.
Como sei que o cron está processando remessas?
Em Admin → Tarefas (crons) veja o log de execução. Se a tarefa "transmitir remessas fiscais" está ativa e rodou recentemente, está OK.
Lote com erro: como reprocesso?
Abre a remessa em estado "Erro", vê o motivo (campo "Mensagem"), corrige a causa (geralmente certificado expirado, IP bloqueado, SEFAZ fora) e clica Retransmitir. Se o erro foi nos itens, melhor desfazer o lote e regerar com as notas corrigidas.
Posso ver o XML do envelope enviado?
Sim. Na tela da remessa há um botão Ver XML ou similar que mostra o envelope completo. Útil pra debug e pra entregar ao suporte da SEFAZ.
Qual o tempo médio de processamento de um lote?
De 30 segundos (lotes pequenos, SEFAZ pouco carregada) a 5 minutos (lotes grandes, SEFAZ ocupada). Lotes processados de madrugada costumam ser mais rápidos.
Posso retransmitir um lote inteiro?
Se ele falhou (erro de transmissão) — sim. Se ele foi Processado e algumas notas Rejeitadas, você corrige as rejeitadas e cria nova remessa com elas (não retransmite o original).
Lote dá direito a desconto ou tem custo?
Não. SEFAZ não cobra por chamada nem por nota. O ganho do lote é técnico (menos chamadas, menos timeout), não financeiro.
Posso pegar lotes velhos (de meses atrás)?
Sim — a tabela fiscalRemessa guarda histórico. Filtre por período na listagem. Auditoria fiscal pode pedir esse histórico.
Quanto tempo guardar o XML do envelope?
Quaza guarda automaticamente em storage/. Não apague esse diretório. Mínimo legal de retenção: 5 anos.
Documentos relacionados