Central de Ajuda Quaza Provedores

Remesa & Retorno (CNAB) (ES-AR)

Remesa & Retorno (CNAB) — Quaza

Remesa & Retorno — CNAB + OFX + Conciliación

Remesa y Retorno son los archivos CNAB que hablan con el banco — antes (Quaza envía boletas para registrar) y después (banco devuelve bajas de los pagos). Es el "transporte" entre el sistema y la infraestructura bancaria.

Antes del PIX, era la forma casi exclusiva de cobro. Hoy continúa esencial para boletas tradicionales, débito automático y clientes corporativos que solo pagan por TED/Transferencia. Cada banco tiene su layout CNAB — Itaú, BBVA, Santander, Continental.
En esta wiki:

Visión general — flujo CNAB completo

┌──────────────────────────────────────────────────────────────────────┐ │ COBRO generado en Quaza (boleta/QR/débito) │ └──────────────────────────────────────────────────────────────────────┘ ↓ Quaza monta archivo ┌──────────────────────────────────────────────────────────────────────┐ │ ARCHIVO REMESA (CNAB 240 o 400) │ │ Líneas con: nuestro número, valor, vencimiento, cliente, instrucciones │ └──────────────────────────────────────────────────────────────────────┘ ↓ operador upload manual o API ┌──────────────────────────────────────────────────────────────────────┐ │ BANCO recibe │ │ • Valida → registra boleta │ │ • Boleta queda "registrada" → cliente puede pagar │ │ • Devuelve PROTOCOLO + status │ └──────────────────────────────────────────────────────────────────────┘ ↓ al día siguiente ┌──────────────────────────────────────────────────────────────────────┐ │ CLIENTE PAGA la boleta (en cualquier banco) │ └──────────────────────────────────────────────────────────────────────┘ ↓ banco procesa en lote ┌──────────────────────────────────────────────────────────────────────┐ │ ARCHIVO RETORNO (CNAB 240 o 400) │ │ Líneas con: nuestro número, valor pagado, fecha, ocurrencia (09=Pago)│ └──────────────────────────────────────────────────────────────────────┘ ↓ operador hace upload (o API) ┌──────────────────────────────────────────────────────────────────────┐ │ QUAZA importa │ │ • Para cada línea: localiza cobro vía "nuestro número" │ │ • Marca como Pagada + fecha + valor │ │ • Actualiza mensualidad/factura en cascada │ └──────────────────────────────────────────────────────────────────────┘ ↓ extracto bancario (OFX) ┌──────────────────────────────────────────────────────────────────────┐ │ CONCILIACIÓN (opcional) │ │ • Importa OFX del extracto │ │ • Compara movimientos con cobros bajados │ │ • Identifica TEDs/PIX sin boleta, tasas, diferencias │ └──────────────────────────────────────────────────────────────────────┘

Glosario

Término Significado
CNAB Centro Nacional de Automação Bancária. Estándar FEBRABAN para archivos entre empresas y bancos
CNAB 240 Versión moderna del CNAB — 240 caracteres por línea. Más detallada, soporta PIX/QR
CNAB 400 Versión antigua — 400 caracteres por línea. Aún usada en algunos bancos (Itaú)
Remesa Archivo ENVIADO al banco — registra nuevas boletas, comanda bajas manuales
Retorno Archivo RECIBIDO del banco — informa pagos, rechazos, devoluciones
Nuestro número ID único de la boleta en el banco — generado cuando emite, identifica retorno
Ocurrencia Código de 2 dígitos en el retorno (09=pagado, 06=protestado, 21=error dirección...)
OFX Open Financial Exchange. Formato estándar de extracto bancario (banco → empresa)
Conciliación Comparación entre lo que el sistema espera recibir × lo que efectivamente entró en la cuenta
Débito Automático Banco debita cuenta del cliente — Quaza envía remesa de débito; banco devuelve éxito/rechazo
Protocolo Respuesta del banco confirmando recepción del archivo (no es baja)
Lote Conjunto de cobros/bajas en un único archivo CNAB

Formatos soportados

Tipo Formato Dónde Quaza lo usa
CNAB 240 (FEBRABAN) Texto, 240 chars/línea Remesa + Retorno en la mayoría de bancos modernos
CNAB 400 (Itaú legacy) Texto, 400 chars/línea Bancos con versión antigua
OFX 1.0/2.0 XML/SGML, extracto Importar extracto para conciliación
API bancaria (CNAB-less) JSON vía HTTP Asaas, Iugu, bancos digitales — sustituye CNAB
Tendencia: bancos modernos (Nubank PJ, Inter, Asaas) usan API JSON en vez de CNAB. Quaza soporta ambos. Para nuevos bancos, prefiere API — menos susceptible a error de layout y procesamiento más rápido.

1. Generar Remesa

Camino: Menú → Remesa

Generar nueva remesa

  1. 1Botón "Generar Remesa" → selecciona banco/cartera
  2. 2Sistema busca cobros pendientes de registro (estado "A registrar")
  3. 3Monta archivo CNAB (240 o 400 según el banco)
  4. 4Operador descarga archivo .REM y envía al banco (vía portal internet banking o API)
  5. 5Banco confirma recepción (protocolo)
  6. 6Banco procesa boletas una por una — D+1 están "registradas"

Remesa de Débito Automático

Cliente que autorizó débito en cuenta recibe el valor cobrado directo por la remesa. No es boleta — es instrucción al banco "debita Gs. X de la cuenta Y".

Ventaja Desventaja
Cliente no necesita hacer nada — automático Requiere autorización previa del cliente en el banco
Reduce drásticamente morosidad Si la cuenta sin saldo, retorna "Insuficiente"
Baja inmediata en el retorno Solo funciona con banco del cliente = banco de la cartera (misma institución)

2. Importar Retorno

Camino: Menú → Retorno

Cómo funciona

  1. 1Banco genera archivo .RET diario con pagos del día
  2. 2Operador descarga del portal banco
  3. 3Upload en Quaza — "Importar Retorno" → selecciona archivo
  4. 4Sistema procesa cada línea:
    • Localiza cobro vía "nuestro número"
    • Identifica ocurrencia (09=pagado, 06=protestado, etc.)
    • Marca cobro como Pagado + fecha + valor
    • Cascada: mensualidad/factura también pasan a "Pagada"

Códigos de ocurrencia comunes

Código Significado
02 Entrada confirmada (boleta registrada)
03 Entrada rechazada (error en el registro)
06 Liquidación (pagado)
09 Baja manual
17 Liquidación tras baja
21 Error de dirección
02 + valor cero Confirmación sin pago aún
Automatiza: algunos bancos disponibilizan integración vía API (Asaas, Iugu, etc.) — Quaza extrae retorno automáticamente vía webhook/polling. Sin upload manual diario.

3. Importar Extracto OFX

Camino: Financiero → Conciliación Bancaria (OFX) o Financiero → Movimientos

Extracto bancario en formato estándar. Incluye todos los movimientos de la cuenta: créditos (pagos recibidos), débitos (tasas, pagos a proveedores), TEDs/PIX entrantes.

Para qué sirve

  • Conciliación: comparar movimiento OFX × cobro que Quaza espera bajar
  • Pagos PIX/TED sin boleta: cliente paga vía PIX sin identificar — Quaza encuentra vía OFX
  • Tasas bancarias: registrar débitos de tasas como gasto contable
  • Análisis de flujo de caja: ver entradas/salidas reales vs previstas
OFX × Retorno CNAB: son DIFERENTES. Retorno CNAB tiene solo cobros del banco específico. OFX tiene TODO de la cuenta. Usa los dos — CNAB para baja rápida de boletas; OFX para revisar el resto.

4. Conciliación Bancaria

Camino: Financiero → Conciliación bancaria

Flujo

  1. 1Período: elegir mes o rango
  2. 2Sistema lista cobros del período
  3. 3Compara con movimientos importados (CNAB + OFX)
  4. 4Muestra 3 grupos:
    • Conciliado — cobro ↔ movimiento coinciden
    • Sin cobro — movimiento existe (PIX/TED), cobro no
    • Sin movimiento — cobro abierto, sin entrada en la cuenta
  5. 5Operador resuelve manualmente los "Sin cobro" — puede asignar cliente, crear lanzamiento manual
¿Por qué conciliar? Cliente paga PIX directo en la clave (sin boleta), el mensaje del PIX es solo "Pago Cliente Silva". Quaza no baja automático. Conciliación OFX permite encontrar ese PIX y asignar manualmente — 1 cliente menos moroso.

Trampas frecuentes

1. Archivo CNAB rechazado por el banco — "Header inválido"
Configuración de la Cartera tiene dato errado (convenio, agencia, cuenta). El banco devuelve sin procesar. Verifica en Cartera los campos específicos del banco (cada uno exige sus formatos).
2. Retorno bajó cobro errado — el valor coincidía pero era otro cliente
Cliente pagó boleta vencida (mismo "nuestro número" fue reutilizado). Sistema bajó en la boleta nueva, dejando la antigua abierta. Solución: rastrear por fecha, mover baja manualmente. Configura "Bloquear reutilización nuestro número".
3. OFX importado 2x — generó duplicados
Operador importó el mismo archivo 2x en Quaza. El sistema permite eso si no detecta (depende de la versión). Solución: cancelar movimientos duplicados manualmente; configurar verificación de hash del archivo.
4. Banco cambió layout CNAB sin avisar
Versión actualizada del CNAB exige nuevos campos. La remesa empieza a fallar. Solución: Quaza actualiza homologación periódicamente — abre ticket con Quaza Tecnologia para ajustar.
5. Conciliación muestra "Sin movimiento" en masa — el proveedor entró en pánico
Olvidó importar retorno del día. Antes de asumir morosidad, importa los retornos pendientes. Si aún así sobró, ahí sí el cliente no pagó.
6. PIX recibido aparece duplicado en el extracto OFX
El banco a veces lista cada PIX 2x (uno como "crédito" otro como "transferencia recibida"). El algoritmo Quaza intenta deduplicar pero no siempre acierta — verifica manualmente.
7. Débito automático rechazado — cliente sin saldo
Retorno con ocurrencia "Débito no efectuado - saldo insuficiente". Quaza marca el cobro como "No bajado". Reenvío: configurar cuántos intentos (3 es estándar) antes de pasar a moroso normal.

Galería de pantallas

Rem remessa
Rem remessa
Rem remessadebito
Rem remessadebito
Rem retornocnab
Rem retornocnab
Rem retornoitem
Rem retornoitem
Rem ofx
Rem ofx
Rem conciliacao
Rem conciliacao
Rem remessa
Rem remessa
Rem retorno
Rem retorno
Rem remdebito
Rem remdebito
Rem conciliacao
Rem conciliacao
Rem ofx
Rem ofx
Rem movimento
Rem movimento

Documentos relacionados

Profundiza en los temas conexos:

FAQ

¿Puedo tener remesa en más de 1 banco?

Sim — cada Cartera = 1 banco. Cliente "A" tem boleto no Itaú, cliente "B" no Bradesco. Quaza gera 2 remessas separadas.

¿El banco demora 1-2 días para procesar retorno — normal?

Sim — banco procesa en lote, geralmente 1x/dia (madrugada). Pagamentos do dia X aparecem no retorno do dia X+1. Pra baixa instantânea: use PIX via gateway com webhook.

¿Olvidé importar retorno por 1 semana — perdí algo?

No — el banco mantiene archivos disponibles por 30-60 días. Descarga todos los pendientes e importa uno por uno (o en lote). Quaza procesa retroactivamente.

¿Cómo empezar con nuevo banco?

1) Solicitar credenciais e layout CNAB ao banco. 2) Quaza homologa a integração (1-2 semanas). 3) Cadastrar Cartera com dados. 4) Gerar primeira remessa de teste com 1 boleto. 5) Validar retorno. 6) Liberar pra produção.

¿Puedo editar archivo CNAB antes de enviar?

Técnicamente sí pero desaconsejado. El banco rechaza cualquier alteración de formato. Si necesitas ajustar valor/fecha, regenera el cobro en Quaza y rehaz la remesa.

¿La conciliación puede ser totalmente automática?

Para PIX/TED con identificación (CI/RUC en la descripción), sí — Quaza intenta casar automáticamente. Para movimientos genéricos ("Pago Cliente"), verificación manual es necesaria.

¿OFX es confiable? ¿Puede tener inconsistencia?

Sí — algunos bancos tienen OFX malo (campos vacíos, fechas erradas). Verifica manualmente las primeras importaciones de cada banco antes de confiar.