Remesa Fiscal — transmisión en lote de varias notas a la SEFAZ en una sola llamada
Esta wiki cubre la pantalla Remesa Fiscal de Quaza, que agrupa documentos fiscales (NFe, NFCom, NFSe, NFe 21/22) y los transmite en una única solicitud ao webservice da SEFAZ. Audiencia: equipo fiscal/contable que procesa lotes diarios grandes de notas e necesita entender como o Quaza hace la transmisión en peroa. Atención: esta funcionalidad es específica de SEFAZ Brasil — si tu empresa solo opera en Paraguay/Argentina, esta wiki es referencia/contexto.
Resumen en una línea: Remesa Fiscal junta varias notas Criadas en un lote único, arma un XML envelope SOAP y lo manda en una única llamada à SEFAZ. Cada nota individualmente recibe su retorno (Protocolada/Rejeitada). Ahorra llamadas, es más rápido que transmitir una a una — útil cuando tenés alto volumen (más de 100 notas/día) o cuando el webservice individual está inestable.
No confundir con "Remesa e Retorno - CNAB": aquela otra wiki cubre
archivos bancarios CNAB
de cobranza (boleta, débito automático), con banco. Esta aqui es fiscal — envía notas a la SEFAZ. São conceptos completamente diferentes apesar do nome similar.
Por qué usar lote en vez de transmisión individual
Cada nota fiscal que vos emite no Quaza podés ser transmitida de 2 jeitos à SEFAZ:
| Modo |
Como funciona |
Cuándo usar |
| Individual |
Botão "Processar" em cada nota → 1 llamada SOAP por nota |
Volumen bajo, emisión puntual, feedback inmediato |
| Lote (Remesa Fiscal) |
Agrupa 50/100/500 notas num XML envelope → 1 chamada SOAP que transmite tudo |
Volume alto (facturación mentul), webservice individual inestable, procesamiento batch nocturno |
Cuánto cabe num lote? Depende de la SEFAZ — geralmente 50 a 500 notas. SEFAZ-SP suele aceptar mais; otras menos. O Quaza decide el tamaño automáticamente ou vos podés configurar.
Ventajas del lote:
-
Menos llamadas: 1 chamada vs 100 chamadas — reduz latência e carga no webservice.
-
Menos rechazo por timeout: cuando a SEFAZ tá lenta, transmitir uma a uma falla más — lote consolida el riesgo.
-
Histórico organizado: a remesa fica registrada como "lote del día X" — auditoría más limpia.
-
Procesamiento agendado: dá para correr vía cron à noite, descargar resultado por la mañana.
Desventajas:
-
Feedback tardío: vos solo sabe se a nota foi aprobada cuando o lote entero procese.
-
Rechazo en peroa: error en el envelope (no nos itens) derruba o lote inteiro — todas voltam para Criada.
-
Diagnóstico más complejo: cuando dá problema, vos necesita investigar lote + retorno + cada nota.
Glosario
| Termo |
O que é |
| Remesa Fiscal |
Lote de documentos fiscais agrupados para transmeson em perosa à SEFAZ. No confundir com Remesa 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 (pero ainda no processou). Tabela nfeRecibo guarda esse número. |
| Protocolo |
Número definitivo que cada documento individualmente recebe después que a SEFAZ processa e autoriza. Cada nota tiene tu protocolo. |
| Webservice em lote |
Endpoint específico da SEFAZ para 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 firmada. |
| Assíncrono |
A SEFAZ no responde imediatamente com "autorizada"/"rechazada" — ela diz "recebido com recibo X". Vos consulta o recibo después e pega o retorno. |
| Síncrono |
SEFAZ responde imediatamente com retorno completo. Algupero UFs usam síncrono em lotes pequenos. |
Flujo general — da Criada ao retorno
OPERADOR / CRON QUAZA (servidor) SEFAZ
| | |
| 1. Notas no estado | |
| "Criada" (1) acumulam | |
| | |
| 2. Clica "Gerar remesa" | |
| ou cron executa | |
|------------------------->| |
| | 3. Seleciona N notas Criadas |
| | Arma envelope SOAP |
| | Firma com cert A1 |
| | |
| | 4. Cria registro Remesa |
| | estado = "Pendente" |
| | |
| | 5. POST envelope -> SEFAZ |
| |----------------------------->|
| | | 6. SEFAZ recebe
| | | valida envelope
| | | gera RECIBO
| |<-----------------------------|
| | 7. Remesa = "Transmitida" |
| | Guarda nº do recibo |
| | Notas: situacao = 2 |
| | (Transmitida) |
| | |
| | 8. Espera procesamiento |
| | (assíncrono — 30s a 5min) |
| | |
| | 9. CONSULTA RECIBO |
| |----------------------------->|
| | | 10. SEFAZ devolve
| | | retorno final
| | | com 1 protocolo
| | | por nota:
| | | - autorizada (100)
| | | - rechazada (4xx)
| |<-----------------------------|
| | 11. Remesa = "Processada" |
| | Cada nota recebe tu |
| | status individual |
| | - sit=3 Protocolada |
| | - sit=4 Rejeitada |
| | |
| 12. Op vê listagem | |
|<-------------------------| |
| - notas OK -> imprime DANFE |
| - notas rechazadas -> corrige + retransmite |
Leia o diagrama assim: a transmeson em lote é assíncrona — vos envia, SEFAZ devolve recibo (no retorno final), vos consulta o recibo, aí vem o retorno por nota. Esse "ida e volta" é o que diferencia do modo individual (que é tudo síncrono).
Pantalla de Remesa Fiscal
Fiscal → Remesa Fiscal
Lista todas as remesas geradas, com filtros por período, situação, tipo de documento, empresa fiscal.
Pantalla de Remesa Fiscal — listagem das remesas geradas. Cada linha é um lote (com data, qtd. de notas, situação). Podés abrir o detalhe para ver quais notas están dentro do lote.
| Coluna |
O que mostra |
| Data emisión |
Cuándo a remesa foi gerada (no a data das notas). |
| Tipo de documento |
NFe, NFCom, NFSe, NFe 21/22 — solo um tipo por lote (no podés misturar). |
| Quantidade de notas |
Quantas notas están 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 remesa
Existiene 2 caminhos:
1. Manualmente (pela pantalla)
| Passo |
O que fazer |
| 1 |
Vá em Fiscal → Remesa Fiscal
|
| 2 |
Hacé clic em Gerar remesa
|
| 3 |
Elegí o tipo de documento (NFe 55, NFCom, NFSe, NFe 21/22) |
| 4 |
Elegí a empresa fiscal emisora
|
| 5 |
O Quaza lista todas as notas Criadas daquela empresa+tipo prontas para transmitir |
| 6 |
Selecione quais entrarão no lote (geralmente "todas") e hacé clic Confirmar
|
| 7 |
Quaza arma XML, firma, transmite, registra o recibo |
| 8 |
Espera procesamiento (alguns minutos), hacé clic Consultar retorno ou deixa o cron consultar automáticamente |
2. Automaticamente (via cron)
O Quaza tiene cron que podés rodar em horários fixos (ex: a cada 5 minutos das 22h às 05h) processando remesas. Configurado em Admin → Configuraciones → Tarefas (crons).
Cuándo usar cron: empresas com facturación mentul grande (milhares de NFCom emitidas no cambio de mes) deixam o cron noturno transmitir. Vos acorda com tudo Protocolado.
Estados da remesa (lote)
| Estado |
Significado |
Próxima ação possível |
| Pendente |
Lote criado no Quaza, ainda no transmitido. |
Transmitir → vira Transmitida. |
| Transmitida |
Enviada à SEFAZ. Tem recibo, espera procesamiento. |
Consultar retorno → vira Processada. |
| Processada |
Retorno completo recebido. Cada nota individualmente já tiene tu status. |
Estado terminal — verificar documentos. |
| Erro |
Falha na transmeson (timeout, certificado inválido, envelope malformado). Lote inteiro voltou. |
Diagnosticar erro → corrigir → regerar. |
Estados de los documentos en el retorno
Después que a remesa fica Processada, cada nota individual recebe tu status. Importante: o estado da remesa no determina o sucesso das notas — uma remesa Processada podés ter notas Protocoladas E Rechazadas no mismo lote.
| Resultado individual |
O que significa |
Próximo passo |
| Protocolada (sit=3) |
SEFAZ aprovou. Tem protocolo. Podés 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 negó uso por irregularidade fiscal do destinatário (CNPJ baixado, sit. especial). |
No dá para retransmitir contra o mismo destinatário. Verificá status fiscal do cliente. |
Tipos de documento que entran en lote
| Tipo |
Acepta lote? |
Observação |
| NFe Modelo 55
|
Sim |
Lote típico de 50-500 notas. Webservice NfeAutorizacao4. |
| NFCom Modelo 62
|
Sim |
Lote por competencia mentul (mentulidades). Webservice NFComAutorizacao. |
| NFSe Padrão Nacional
|
Limitado |
O Padrão Nacional acepta lote, pero algupero prefeituras legadas (Tecnospeed, Tecnos) no — transmeson individual obrigatória. |
|
NFe 21/22 (Convênio 201) |
Sim |
Em fim de vida — sendo substituída por NFCom. |
| NFCe Modelo 65 |
No (geralmente) |
NFCe é consumidor final em varejo — transmeson síncrona obrigatória. |
| NFeSVA
|
Verificar |
Específico SP. Configuração depende da SEFAZ. |
No misture tipos no lote. Uma remesa = um tipo de documento. Vos no envia NFe e NFCom no mismo envelope. Gere remesas separadas.
Lote × Transmeson individual — cuando usar cada
| Escenario |
Recomendação |
Por quê |
| Facturación mentul perosivo (milhares de NFCom no cambio de mes) |
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 para cliente que está esperando o documento (ex: comércio com pickup) |
Individual |
Cliente necesita do DANFE na hora — no dá para esperar lote. |
| SEFAZ instável / em manutenção parcial |
Lote |
Lote tiene retry mais simples — em individual cada timeout vira retentativa manual. |
| Recuperação de notas Rechazadas (correção em perosa) |
Lote |
Después de corrigir 50 NFes rechazadas, retransmitir em 1 chamada é mais limpo. |
| Cancelación / CCe / Eventos |
Individual |
Eventos no vão em lote — cada um tiene tu webservice dedicado (RecepcaoEvento). |
Trampas frecuentes
1. Confuson com Remesa CNAB. "Remesa Fiscal" (esta wiki) é envio em lote para
SEFAZ de notas.
"Remesa e Retorno - CNAB"
é envio de archivos para
banco com instruções de cobranza/débito. Conceitos completamente diferentes que compartilham o nome "remesa".
2. Lote Processado ≠ Notas Aprovadas. Uma remesa Processada solo significa que a SEFAZ devolveu o retorno — podés ter notas Rechazadas dentro. Sempre confirmá individualmente.
3. Envelope rejeitado derruba o lote inteiro. Se o XML envelope tiene erro (certificado expirado, schema inválido), as 200 notas dentro voltam para Criada. No dá para "salvar" parte do lote.
4. Recibo perdido = transmeson fantasma. Se o Quaza envia o lote pero perde o recibo (timeout, crash), vos no sabe se a SEFAZ recebeu. Antes de retransmitir, consulte status SEFAZ pelo recibo — podés ser que ela tenha aceptado. Retransmitir lote duplicado podés gerar notas autorizadas em duplicidade (que aí necesitam ser canceladas).
5. SEFAZ em manutenção rejeita lote inteiro. Cuándo a SEFAZ retorna cStat 108/109 (em manutenção), o lote falha. No retransmita imediatamente — esperá 30min-2h e tente de novo. Insistir derruba tu IP em rate limit.
6. Lote noturno por cron necesita de cron configurado. O cron de procesamiento de remesa solo roda se estiver agendado em Admin → Tarefas. Verificá se está ativo antes de confiar em emisión automática.
7. Cancelación NÃO usa lote. Pra cancelar 100 notas, vos cancela individualmente (cada uma envia evento 110111 separado). No há "cancelación em lote".
8. Tamanho do lote depende da SEFAZ. Cada UF tiene limite próprio (NFe: ~50 SP, ~30 otros). NFCom tiene padrão SVRS de ~50. Lote maior que o limite = rechazo imediata. Quaza respeita os limites; pero se configurar manualmente, atente-se.
FAQ
Puedo configurar para Quaza solo transmitir em lote (nunca individual)?
Sí — desativa o botón "Processar" individual nas configuraciones da empresa fiscal, e configura cron para rodar remesa periodicamente. Común em ISPs com facturación grande.
O cliente está esperando o DANFE — posso "puxar" solo essa nota para transmitir individual?
Sí. Mismo que esteja num lote ainda Pendente, vos podés retirar a nota do lote e processar individualmente. A remesa fica com 1 nota a menos.
Cómo sé que o cron está processando remesas?
Em Admin → Tarefas (crons) veja o log de execução. Se a tarefa "transmitir remesas fiscais" está ativa e rodou recentieneente, está OK.
Lote com erro: como reprocesso?
Abre a remesa em estado "Erro", vê o motivo (campo "Mensagem"), corrige a causa (geralmente certificado expirado, IP bloqueado, SEFAZ fora) e hacé clic Retransmitir. Se o erro foi nos itens, melhor desfazer o lote e regerar com as notas corrigidas.
Puedo ver o XML do envelope enviado?
Sí. Na pantalla da remesa há um botón Ver XML ou similar que mostra o envelope completo. Útil para debug e para entregar ao suporte da SEFAZ.
Qual o tienepo médio de procesamiento 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.
Puedo retransmitir um lote inteiro?
Se ele falhou (erro de transmeson) — sim. Se ele foi Processado e algupero notas Rechazadas, vos corrige as rechazadas e cria nova remesa com elas (no retransmite o original).
Lote dá direito a desconto ou tiene custo?
No. SEFAZ no cobra por chamada nem por nota. O ganho do lote é técnico (menos chamadas, menos timeout), no financeiro.
Puedo pegar lotes velhos (de meses atrás)?
Sí — a tabela fiscalRemesa guarda histórico. Filtre por período na listagem. Auditoria fiscal podés pedir esse histórico.
Quanto tienepo guardar o XML do envelope?
Quaza guarda automáticamente em storage/. No apague esse diretório. Mínimo legal de retenção: 5 anos.
Documentos relacionados