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 al webservice de la SEFAZ. Audiencia: equipo fiscal/contable que procesa lotes diarios grandes de notas y necesita entender cómo Quaza hace la transmisión en lote. 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 a la SEFAZ. Cada nota individualmente recibe su retorno (Protocolada/Rechazada). 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": esa otra wiki cubre
archivos bancarios CNAB
de cobranza (boleto, débito automático), con banco. Esta es fiscal — envía notas a la SEFAZ. Son conceptos completamente diferentes a pesar del nombre similar.
Por qué usar lote en vez de transmisión individual
Esta pantalla también se llama "generación de remesa 21/22" (nombre heredado de los modelos antiguos). Los modelos
NFe 21/22 (Servicio de Comunicación/Telecomunicación) están
depreciados — fueron sustituidos por la
NFCom (modelo 62)
. Para servicio de comunicación, emita NFCom.
Cada nota fiscal que usted emite en Quaza puede ser transmitida de 2 formas a la SEFAZ:
| Modo |
Como funciona |
Cuándo usar |
| Individual |
Botón "Procesar" en cada nota → 1 llamada SOAP por nota |
Volumen bajo, emisión puntual, feedback inmediato |
| Lote (Remesa Fiscal) |
Agrupa 50/100/500 notas en un XML envelope → 1 llamada SOAP que transmite todo |
Volumen alto (facturación mensual), webservice individual inestable, procesamiento batch nocturno |
¿Cuánto cabe en un lote? Depende de la SEFAZ — generalmente 50 a 500 notas. SEFAZ-SP suele aceptar más; otras menos. Quaza decide el tamaño automáticamente o usted puede configurarlo.
Ventajas del lote:
-
Menos llamadas: 1 llamada vs 100 llamadas — reduce la latencia y la carga en el webservice.
-
Menos rechazo por timeout: cuando la SEFAZ está lenta, transmitir una a una falla más — el lote consolida el riesgo.
-
Historial organizado: la remesa queda registrada como "lote del día X" — auditoría más limpia.
-
Procesamiento programado: se puede correr vía tarea en la noche y descargar el resultado por la mañana.
Desventajas:
-
Feedback tardío: usted solo sabe si la nota fue aprobada cuando el lote entero se procesa.
-
Rechazo en lote: error en el envelope (no en los ítems) derriba el lote entero — todas vuelven a Creada.
-
Diagnóstico más complejo: cuando hay problema, usted necesita investigar lote + retorno + cada nota.
Glosario
| Término |
Qué es |
| Remesa Fiscal |
Lote de documentos fiscales agrupados para transmisión en lote a la SEFAZ. No confundir con Remesa CNAB
(financiero/bancario). |
| Lote |
Conjunto de notas empaquetadas en un XML envelope SOAP único. |
| Recibo |
Número que la SEFAZ devuelve en cuanto recibe el lote (pero aún no procesó). El sistema guarda ese número. |
| Protocolo |
Número definitivo que cada documento individualmente recibe después que la SEFAZ procesa y autoriza. Cada nota tiene su protocolo. |
| Webservice en lote |
Endpoint específico de la SEFAZ para recepción de lotes. Generalmente NfeAutorizacao + NfeRetAutorizacao (NFe), NFComAutorizacao + NFComRetAutorizacao (NFCom). Diferente del "consulta status". |
| Envelope SOAP |
Wrapper XML que lleva el lote. Tiene encabezado con identificación del lote + cuerpo con cada nota firmada. |
| Asíncrono |
La SEFAZ no responde inmediatamente con "autorizada"/"rechazada" — dice "recibido con recibo X". Usted consulta el recibo después y obtiene el retorno. |
| Síncrono |
La SEFAZ responde inmediatamente con retorno completo. Algunas UFs usan síncrono en lotes pequeños. |
Flujo general — de Creada al retorno
Flujo de la Remesa fiscal — envío en lote (carriles: Operador/Tarea · Quaza · SEFAZ).
Cómo leer el diagrama: la transmisión en lote es asíncrona — usted envía, la SEFAZ devuelve un recibo (no el retorno final), usted consulta el recibo y ahí llega el retorno por nota. Ese "ida y vuelta" es lo que diferencia del modo individual (que es todo síncrono).
Pantalla de Remesa Fiscal
Fiscal → Remesa Fiscal
Lista todas las remesas generadas, con filtros por período, situación, tipo de documento, empresa fiscal.
Pantalla de Remesa Fiscal — listado de las remesas generadas. Cada línea es un lote (con fecha, cant. de notas, situación). Puede abrir el detalle para ver qué notas están dentro del lote.
| Columna |
Qué muestra |
| Fecha emisión |
Cuándo se generó la remesa (no la fecha de las notas). |
| Tipo de documento |
NFe, NFCom, NFSe, NFe 21/22 — solo un tipo por lote (no se pueden mezclar). |
| Cantidad de notas |
Cuántas notas hay en el lote. |
| Valor total |
Suma del valor de todas las notas del lote. |
| Recibo SEFAZ |
Nº del recibo devuelto por la SEFAZ (15 dígitos, generalmente). |
| Situación |
Pendiente / Transmitida / Procesada / Error. |
Cómo generar una remesa
Existen 2 caminos:
1. Manualmente (desde la pantalla)
| Paso |
Qué hacer |
| 1 |
Vaya a Fiscal → Remesa Fiscal
|
| 2 |
Haga clic en Generar remesa
|
| 3 |
Elija el tipo de documento (NFe 55, NFCom, NFSe, NFe 21/22) |
| 4 |
Elija la empresa fiscal emisora
|
| 5 |
Quaza lista todas las notas Creadas de esa empresa+tipo listas para transmitir |
| 6 |
Seleccione cuáles entrarán en el lote (generalmente "todas") y haga clic en Confirmar
|
| 7 |
Quaza arma el XML, lo firma, lo transmite y registra el recibo |
| 8 |
Espere el procesamiento (algunos minutos), haga clic en Consultar retorno o deje que la tarea lo consulte automáticamente |
2. Automáticamente (vía tarea)
Quaza tiene una tarea que puede correr en horarios fijos (ej.: cada 5 minutos de 22h a 05h) procesando remesas. Se configura en Admin → Configuraciones → Tareas (automático).
Cuándo usar la tarea: empresas con facturación mensual grande (miles de NFCom emitidas en el cambio de mes) dejan la tarea nocturna transmitir. Usted se despierta con todo Protocolado.
Estados de la remesa (lote)
| Estado |
Significado |
Próxima acción posible |
| Pendiente |
Lote creado en Quaza, aún no transmitido. |
Transmitir → pasa a Transmitida. |
| Transmitida |
Enviada a la SEFAZ. Tiene recibo, espera procesamiento. |
Consultar retorno → pasa a Procesada. |
| Procesada |
Retorno completo recibido. Cada nota individualmente ya tiene su estado. |
Estado terminal — verificar documentos. |
| Error |
Falla en la transmisión (timeout, certificado inválido, envelope malformado). El lote entero retrocedió. |
Diagnosticar error → corregir → regenerar. |
Estados de los documentos en el retorno
Después que la remesa queda Procesada, cada nota individual recibe su estado. Importante: el estado de la remesa no determina el éxito de las notas — una remesa Procesada puede tener notas Protocoladas Y Rechazadas en el mismo lote.
| Resultado individual |
Qué significa |
Próximo paso |
| Protocolada (sit=3) |
La SEFAZ aprobó. Tiene protocolo. Puede imprimir el DANFE y enviarlo al cliente. |
Imprimir, enviar e-mail. |
| Rechazada (sit=4) |
La SEFAZ rechazó — campo incorrecto, NCM inválido, IE del destinatario inactivo, etc. |
Corregir registro/producto → retransmitir (en el próximo lote o individualmente). |
| Denegada (sit=4 c/cStat 110) |
La SEFAZ negó el uso por irregularidad fiscal del destinatario (CNPJ dado de baja, sit. especial). |
No es posible retransmitir al mismo destinatario. Verifique el estado fiscal del cliente. |
Tipos de documento que entran en lote
| Tipo |
Acepta lote? |
Observación |
| NFe Modelo 55
|
Sí |
Lote típico de 50-500 notas. Webservice NfeAutorizacao4. |
| NFCom Modelo 62
|
Sí |
Lote por competencia mensual (mensualidades). Webservice NFComAutorizacao. |
| NFSe Estándar Nacional
|
Limitado |
El Estándar Nacional acepta lote, pero algunas prefecturas legadas (Tecnospeed, Tecnos) no — transmisión individual obligatoria. |
|
NFe 21/22 (Convênio 201) |
Sí |
En fin de vida — siendo sustituida por NFCom. |
| NFCe Modelo 65 |
No (generalmente) |
NFCe es consumidor final en retail — transmisión síncrona obligatoria. |
| NFeSVA
|
Verificar |
Específico SP. La configuración depende de la SEFAZ. |
No mezcle tipos en el lote. Una remesa = un tipo de documento. No se envía NFe y NFCom en el mismo envelope. Genere remesas separadas.
Lote × Transmisión individual — cuándo usar cada uno
| Escenario |
Recomendación |
Por qué |
| Facturación mensual masiva (miles de NFCom en el cambio de mes) |
Lote |
Reduce llamadas y carga nocturna en el webservice. |
| Volumen diario alto de NFe (> 100/día, ej.: ISP grande revendiendo equipos) |
Lote |
Más rápido que transmitir 1 a 1. |
| Venta avulsa (1-3 NFe/día) |
Individual |
Feedback inmediato. El lote agrega complejidad innecesaria. |
| NFe para cliente que está esperando el documento (ej.: comercio con retiro) |
Individual |
El cliente necesita el DANFE al momento — no se puede esperar el lote. |
| SEFAZ inestable / en mantenimiento parcial |
Lote |
El lote tiene retry más simple — en individual cada timeout se vuelve un reintento manual. |
| Recuperación de notas Rechazadas (corrección en lote) |
Lote |
Después de corregir 50 NFes rechazadas, retransmitir en 1 llamada es más limpio. |
| Cancelación / CCe / Eventos |
Individual |
Los eventos no van en lote — cada uno tiene su webservice dedicado (RecepcaoEvento). |
Tareas automáticas
| Tarea |
Qué hace |
| Fiscal — Generar remesa |
Arma automáticamente la remesa en lote de las notas pendientes y la envía a la SEFAZ. |
Quién activa o desactiva la tarea es el administrador del servidor (en el crontab). La pantalla Admin → Tareas solo informa el estado.
Cómo leer errores y depurar
Si la remesa falla, cada documento muestra el motivo (cStat/xMotivo). La remesa solo concluye cuando todos los documentos del lote son aceptados o tratados.
| Síntoma |
Causa probable |
Corrección |
| El lote no cierra |
Documento del lote rechazado |
Corrija el documento rechazado y regenere la remesa |
| La remesa no envía |
Certificado/ambiente |
Verifique la Empresa fiscal y el ambiente (producción) |
Trampas frecuentes
1. Confusión con Remesa CNAB. "Remesa Fiscal" (esta wiki) es envío en lote de notas a la
SEFAZ.
"Remesa e Retorno - CNAB"
es envío de archivos al
banco con instrucciones de cobranza/débito. Son conceptos completamente diferentes que comparten el nombre "remesa".
2. Lote Procesado ≠ Notas Aprobadas. Una remesa Procesada solo significa que la SEFAZ devolvió el retorno — puede haber notas Rechazadas dentro. Confirme siempre individualmente.
3. Envelope rechazado derriba el lote entero. Si el XML envelope tiene error (certificado vencido, schema inválido), las 200 notas dentro vuelven a Creada. No es posible "salvar" parte del lote.
4. Recibo perdido = transmisión fantasma. Si Quaza envía el lote pero pierde el recibo (timeout, crash), usted no sabe si la SEFAZ lo recibió. Antes de retransmitir, consulte el estado en la SEFAZ por el recibo — puede que ella ya lo haya aceptado. Retransmitir un lote duplicado puede generar notas autorizadas en duplicidad (que después necesitan ser canceladas).
5. SEFAZ en mantenimiento rechaza el lote entero. Cuando la SEFAZ retorna cStat 108/109 (en mantenimiento), el lote falla. No retransmita inmediatamente — espere 30min-2h e inténtelo de nuevo. Insistir puede bloquear su IP por rate limit.
6. Lote nocturno por tarea necesita tarea configurada. La tarea de procesamiento de remesa solo corre si está programada en Admin → Tareas. Verifique que esté activa antes de confiar en la emisión automática.
7. Cancelación NO usa lote. Para cancelar 100 notas, cancele individualmente (cada una envía el evento 110111 por separado). No existe "cancelación en lote".
8. El tamaño del lote depende de la SEFAZ. Cada UF tiene su propio límite (NFe: ~50 SP, ~30 otras). NFCom tiene estándar SVRS de ~50. Un lote mayor al límite = rechazo inmediato. Quaza respeta los límites; pero si configura manualmente, preste atención.
FAQ
¿Puedo configurar Quaza para transmitir solo en lote (nunca individual)?Sí — desactiva el botón "Procesar" individual en la configuración de la empresa fiscal y programa la tarea para correr la remesa periódicamente. Común en ISPs con facturación grande.
El cliente espera el DANFE — ¿puedo "sacar" solo esa nota para transmitirla individual?Sí. Aunque esté en un lote aún Pendiente, puede retirar la nota del lote y procesarla individualmente. La remesa queda con una nota menos.
¿Cómo sé que la tarea está procesando remesas?En Admin → Tareas vea el log de ejecución. Si la tarea de transmisión de remesas está activa y corrió recientemente, está OK.
Lote con error: ¿cómo lo reproceso?Abra la remesa en estado "Error", vea el motivo (campo "Mensaje"), corrija la causa (certificado vencido, IP bloqueado, SEFAZ caída) y haga clic en Retransmitir. Si el error fue en los ítems, deshaga el lote y regenérelo con las notas corregidas.
¿Puedo ver el XML del sobre enviado?Sí. En la pantalla de la remesa hay un botón Ver XML que muestra el sobre completo. Útil para depurar y para el soporte de la SEFAZ.
¿Cuál es el tiempo medio de procesamiento de un lote?De 30 segundos (lotes chicos) a 5 minutos (lotes grandes, SEFAZ ocupada). Los lotes procesados de madrugada suelen ser más rápidos.
¿Puedo retransmitir un lote entero?Si falló (error de transmisión) — sí. Si fue Procesado y algunas notas Rechazadas, corrija las rechazadas y cree una nueva remesa con ellas.
¿El lote tiene costo o descuento?No. La SEFAZ no cobra por llamada ni por nota. La ganancia del lote es técnica (menos llamadas, menos timeout), no financiera.
¿Puedo tomar lotes viejos (de meses atrás)?Sí — el sistema guarda el histórico. Filtre por período en el listado. La auditoría fiscal puede pedir ese histórico.
¿Qué es la remesa fiscal?Es el envío en lote de notas a la SEFAZ, en vez de una por una.
¿Cuándo uso lote vs individual?Lote para volumen (mensualidades); individual para casos puntuales. Vea la sección lote-vs-individual.
¿La remesa es automática?Sí, por la tarea "Fiscal - Generar remesa"; también se puede generar manualmente.
¿Un documento rechazado traba la remesa?El documento queda rechazado; corríjalo y regenere la remesa.
Documentos relacionados