Central de Ajuda Quaza Provedores

Remesa y Retorno (CNAB) (ES-PY)

Remesa y Retorno (CNAB)

La Remesa y el Retorno son la forma en que Quaza se comunica con el banco mediante intercambio de archivos, en el estandar CNAB. Usted genera en Quaza un archivo de remesa (que registra sus boletos en el banco en lote), lo envia en el portal de su banco y, despues, importa de vuelta en Quaza el archivo de retorno que el banco devuelve: ese archivo da de baja automatica los boletos pagados y muestra las novedades de cada titulo. Esta pagina es para quien lleva las finanzas del proveedor: explica como generar la remesa, como procesar el retorno, que significan las novedades mas comunes y que hacer cuando un boleto pagado no se da de baja.

En esta wiki:

Cuando usar Remesa/Retorno (y cuando NO)

La Remesa/Retorno es el camino por archivo: Quaza no habla directo con el banco; usted es el mensajero que lleva el archivo de remesa al portal del banco y trae de vuelta el archivo de retorno. Es el camino que usan los bancos que no ofrecen integracion directa. Cuando su banco ofrece Gateway bancario (integracion directa, en linea), prefiera el gateway: evita el ida y vuelta de archivos y la baja es casi instantanea.

Use Remesa/Retorno cuando…	NO la use cuando…
Su banco trabaja por intercambio de archivos CNAB (remesa y retorno) y no ofrece integracion directa.	Su banco ofrece Gateway (integracion directa): en ese caso el gateway registra y da de baja solo.
Quiere registrar varios boletos a la vez (lote) en un unico archivo enviado al banco.	Su cobro es solo caja local (recibo en mano, sin banco).
Acepta revisar y enviar/importar los archivos al ritmo del banco (manual, en general diario).	Necesita baja en tiempo real, sin ninguna etapa manual.

Remesa/Retorno vs. Gateway: ambos registran el cobro en el banco y confirman el pago; la diferencia es el medio. Remesa/Retorno = intercambio de archivos (usted envia e importa). Gateway = integracion directa (en linea, casi instantaneo). Una misma cartera usa uno u otro, segun lo que el banco ponga a disposicion. Detalles del gateway en Gateway bancario .

Paso a paso: de la remesa a la baja por el retorno

1	Genere los boletos de los clientes normalmente (por el Cobro , facturas, mensualidades). Quedan "Abierto" y todavia no fueron informados al banco.
2	En la pantalla de Remesa, haga clic en Generar remesa. Elija la cartera, el tipo (normalmente Entrada/Baja), el periodo o las fechas y confirme. Quaza arma el archivo con todos los boletos abiertos de ese filtro.
3	Descargue el archivo de remesa (haciendo clic en el nombre del archivo en la lista) y envielo en el portal de su banco, en el area de cobro/CNAB. A partir de ahi el banco pasa a reconocer esos boletos.
4	El cliente paga el boleto en su banco, dentro del plazo.
5	El banco genera el archivo de retorno (en general a diario) con la confirmacion de los registros, los pagos y demas novedades. Descargue ese archivo en el portal del banco.
6	En la pantalla de Retorno, haga clic en Procesar retorno y envie el archivo que el banco devolvio. Quaza lee cada linea, da de baja los boletos pagados y registra las novedades.
7	Revise los items del retorno para tratar lo que no se dio de baja (rechazados, no encontrados, valor distinto). El ciclo se repite: nueva remesa, nuevo retorno.

Flujo general: de Quaza al banco y de vuelta

El ciclo de la Remesa/Retorno: Quaza arma el archivo de remesa, usted lo envia en el portal del banco; el banco cobra y devuelve el archivo de retorno, que usted importa de vuelta en Quaza para dar de baja automatica los boletos pagados.

Note las dos etapas manuales y externas (en amarillo): enviar la remesa y descargar el retorno ocurren en el portal del banco, no dentro de Quaza. Eso es lo que diferencia de la integracion directa (Gateway), donde el sistema hace todo solo.

Glosario

Termino	Que es
CNAB	Estandar de archivo que usan los bancos brasilenos para intercambiar informacion de cobro. Los mas comunes son el CNAB 240 y el CNAB 400 (boletos) y el de debito en cuenta (150).
Remesa	El archivo que Quaza genera con sus boletos en lote para registrarlos en el banco. Usted lo envia en el portal del banco.
Retorno	El archivo que el banco devuelve, con la confirmacion de los registros, los pagos y demas novedades de cada titulo. Usted lo importa de vuelta en Quaza.
Registro	El acto de que el banco reconozca el boleto a partir de la remesa. Solo un boleto registrado es cobrado y dado de baja correctamente por el banco.
Baja	El momento en que el boleto deja de estar "Abierto" y pasa a "Pagado" en Quaza. En el retorno, ocurre sola cuando el banco confirma el pago.
Cartera	El registro de Quaza que representa su cuenta en el banco (agencia, cuenta, convenio) y donde esta la configuracion de cobro. Los boletos se generan ligados a una cartera.
Nuestro numero	El identificador que el boleto tiene dentro del banco. Por el (o por el numero del titulo) Quaza encuentra, en el retorno, cual boleto pagar.
Novedad	El codigo que el banco informa para cada titulo en el retorno, diciendo que paso con el (entrada confirmada, liquidacion, rechazo, tarifa, etc.).
Liquidacion	El termino bancario para "pago confirmado". Es la novedad que hace que Quaza de de baja el boleto.
Entrada rechazada	Cuando el banco rechaza el registro de un boleto que vino en la remesa (dato invalido, fuera de estandar). El titulo no queda registrado y hay que corregirlo y reenviarlo.
Tarifa / costo	Valor que el banco cobra por titulo o por operacion. Aparece en el retorno como costo y Quaza puede registrarlo en la caja.
Debito en cuenta	Modalidad en que el banco debita la factura directo de la cuenta del cliente (en lugar de boleto). Tiene remesa y retorno propios y usa el archivo en el estandar de debito.

Antes de empezar: que tiene que estar listo

Cartera de cobroFinanciero → Carteras de cobro

Hay que tener una cartera registrada con los datos bancarios (banco, agencia, cuenta, convenio/cedente, cartera) y una configuracion de cobro del tipo Registrado (CNAB 240), que no sea gateway. Sin eso, la pantalla de Remesa no lista ninguna cartera para generar.

Homologacion del banco

Cada banco tiene un proceso de homologacion (validacion de la remesa y del retorno) antes de operar de verdad. Busque en el Centro de ayuda la guia de su banco (por ejemplo "Homologacion Sicoob — Remesa y Retorno", "Homologacion Santander", "Homologacion Itau", "Homologacion Banrisul", "Homologacion Cresol").

La ciudad del cliente es obligatoria. Al generar la remesa, Quaza usa la direccion del cliente. Si un cliente esta sin ciudad cargada, la generacion se detiene con un aviso que indica el nombre del cliente. Corrija el registro y vuelva a generar.

Generar la remesa

Donde estaFinanciero → Remesa

La pantalla "Listar remesas" muestra el historial de remesas generadas, filtrado por cartera. Use el boton Generar remesa para crear una nueva.

La lista trae, para cada remesa: la secuencia (numero de la remesa en esa cartera), el archivo (haga clic para descargar), el tipo de remesa, la fecha de generacion, la cantidad de titulos, el valor total, la cartera y el creador.

Las lineas en rojo son remesas con mas de un dia que todavia no tienen ningun retorno vinculado. Eso puede indicar que la remesa no llego a ser enviada al banco (o que el retorno correspondiente todavia no fue procesado). Revise en el portal del banco.

Que elegir al generar

Al hacer clic en Generar remesa, Quaza abre una ventana con estas opciones:

Campo	Que elegir
Remesa (tipo)	El tipo de movimiento. Entrada/Baja es el uso normal (registra los boletos nuevos y, cuando la cartera lo pide, tambien envia las bajas de titulos pagados manualmente o removidos). Vea los tipos abajo.
Fecha	Por periodo (elige Ano y Mes) o Por fecha (elige fecha inicial y final). Define el rango de vencimiento de los boletos que entran en la remesa.
Ano / Mes	Cuando el tipo de fecha es "Por periodo": el mes/ano de vencimiento de los boletos a incluir.
Fecha inicial / Fecha final	Cuando el tipo de fecha es "Por fecha": el rango de vencimiento. La fecha inicial no puede ser mayor que la final.
Cartera	La cartera (cuenta en el banco) cuyos boletos seran enviados.
Cliente	Opcional: genera la remesa de un unico cliente. Util para reenviar un boleto especifico (disponible segun el permiso del usuario).

Tipos de remesa

Tipo	Cuando usar
Entrada	Solo registra los boletos nuevos (abiertos) en el banco.
Entrada/Baja	El uso mas comun: registra los boletos nuevos y, si la cartera esta configurada para dar de baja el titulo, envia tambien las bajas de titulos que fueron pagados por fuera o removidos.
Alteracion de intereses	Envia al banco la alteracion de los intereses de titulos ya registrados. Disponible segun el banco.
Alteracion de vencimiento	Envia al banco la prorroga de vencimiento de titulos ya registrados. Disponible segun el banco y el permiso del usuario.
Cancelacion de protesto	Envia al banco la suspension/cancelacion de protesto de titulos ya registrados. Disponible segun el banco.

Los tipos de alteracion y cancelacion solo aparecen para los bancos que soportan esa instruccion. Para el uso diario, deje en Entrada/Baja.

Despues de confirmar, Quaza abre el archivo generado para descarga y la nueva remesa aparece arriba en la lista. Descargue el archivo (por su nombre en la columna Archivo) y envielo en el portal de su banco.

Deshacer la ultima remesa

Si genero una remesa por error y todavia no la envio al banco, use el boton Deshacer ultima remesa. Quita la remesa, devuelve los titulos a "sin remesa" y revierte la numeracion de secuencia.

No se puede deshacer una remesa que ya fue enviada al banco. Si ya hay retorno vinculado a esos titulos, Quaza bloquea la operacion: deshacer en ese punto dejaria el sistema fuera de sincronia con el banco. (Este boton depende de permiso; puede no aparecer para todos los usuarios.)

Procesar el retorno

Donde estaFinanciero → Retorno

La pantalla "Listar retornos" muestra el historial de retornos importados. Use el boton Procesar retorno para enviar un archivo nuevo que el banco devolvio.

La lista trae, para cada retorno: el archivo (haga clic para descargar), el estado, el tipo (240 - Boleto, 400 - Boleto o 150 - Debito), si genera nota, la cantidad de items, el valor, los intereses, el costo, la fecha de creacion y el creador. La lupa a la izquierda abre los items de ese retorno.

Que elegir al procesar

Campo	Que elegir
Retorno (archivo)	Seleccione el archivo de retorno que descargo en el portal del banco.
Simulado	No procesa de verdad (da las bajas). Si solo simula: Quaza lee el archivo y muestra lo que haria, sin dar de baja. Util para revisar antes.
Generar Nota	Cuando Si, genera las notas fiscales vinculadas a los titulos liquidados (segun la configuracion fiscal del proveedor). Dejelo como viene configurado si no esta seguro.

Hay dos botones para confirmar:

Boton	Que hace
Procesar y esperar	Procesa al instante y usted sigue el resultado en la propia pantalla. Indicado para archivos menores: hay que esperar el fin del proceso.
Procesar en 2.o plano	Procesa en segundo plano y envia una notificacion al terminar. Indicado para archivos grandes (muchos titulos), para no trabar la pantalla.

Estado de cada retorno

Estado	Significado	Que hacer
Procesando	El retorno se esta leyendo (en general, procesamiento en 2.o plano).	Espere. Quaza no deja procesar dos retornos al mismo tiempo.
Finalizado	El retorno fue leido hasta el final y los items quedaron registrados.	Revise los items para tratar lo que no se dio de baja.
Fallado	Algo impidio la lectura (archivo invalido o error en el procesamiento).	Revise el archivo. Los retornos no finalizados pueden reprocesarse por la pantalla.

En el detalle de un retorno que no fue finalizado, hay la opcion de reprocesar: Quaza intenta leer el archivo de nuevo en segundo plano y avisa al terminar. Los retornos ya finalizados no se reprocesan.

Si el proveedor exige control de secuencia, Quaza solo acepta el retorno si el anterior en la secuencia ya fue procesado, asi usted no saltea ni repite archivos. Si aparece "el retorno no esta en la secuencia esperada", verifique si hay un retorno anterior todavia sin importar.

Seguir los items del retorno

Donde estaFinanciero → Retorno → (lupa de un retorno)

La pantalla "Listar items del retorno" muestra cada titulo que vino en el archivo, con la novedad del banco y el mensaje de Quaza sobre lo que paso. Aqui es donde usted trata lo que no se dio de baja.

Cada linea trae: el financiero (con enlace al titulo), el cliente, el nuestro numero, el vencimiento, la fecha de pago, el valor pagado, los intereses, el costo, la operacion y la novedad informadas por el banco, y el mensaje de Quaza.

Color de la linea	Que significa
Sin color	Item tratado normalmente (en general, pago efectuado).
Amarillo	Alerta: el titulo ya estaba pagado antes de este retorno (pago anterior). Solo revise que no haya duplicidad.
Rojo	Necesita atencion: no se dio de baja (rechazado, no encontrado, cuenta no encontrada, fondos insuficientes, no fue liquidado). Trate caso por caso.

La pantalla tiene un Listado con filtros listos. Use la opcion que muestra solo los errores para ir directo a los items que necesitan atencion, sin recorrer los que se dieron de baja normalmente.

Novedades y mensajes mas comunes

El banco informa una novedad (que paso con el titulo). Quaza traduce eso en un mensaje (que hizo o por que no dio de baja). Las mas comunes:

Novedades del banco

Operacion	Que esta diciendo el banco	Efecto en Quaza
2	Entrada confirmada: el boleto fue registrado.	Confirma el registro; no da de baja.
3	Entrada rechazada: el banco rechazo el registro.	No da de baja; si no estaba registrado, el titulo sale de la remesa para poder corregirlo y reenviarlo.
6	Liquidacion: el boleto fue pagado.	Da de baja el titulo (lo marca como pagado).
9	Baja de titulo: el banco dio de baja el boleto.	Registra la baja; no lo marca como pagado automaticamente.
17	Liquidacion despues de baja o de titulo no registrado: pago confirmado.	Da de baja el titulo (lo marca como pagado).
28	Debito de tarifas/costas.	Registra el costo cobrado por el banco; no da de baja.

Los archivos de retorno traen decenas de otras novedades (alteracion de vencimiento confirmada, instruccion rechazada, gastos de protesto, etc.). Todas aparecen en la columna Operacion del item; las que importan para su dia a dia son las de pago (6, 17) y las de rechazo (3).

Mensajes de Quaza

Mensaje	Que significa / que hacer
Pago efectuado	Todo bien: el titulo fue dado de baja.
Financiero anteriormente pagado	El titulo ya estaba pagado antes del retorno. Revise solo que no haya cobro en duplicidad.
Financiero rechazado	El banco rechazo la entrada del boleto. Verifique los datos del titulo/cliente, genere una nueva remesa y reenvie.
Financiero no encontrado	Quaza no encontro en el sistema el titulo del archivo (nuestro numero/numero distinto, titulo de otra base). Revise si el retorno es de la cartera correcta.
Financiero esta removido	El titulo existia pero fue removido. En general no hay accion; investigue solo si esperaba que estuviera activo.
Valor original del sistema distinto del retorno	El valor pagado vino distinto del valor del titulo (pago parcial/de mas, intereses). Quaza da de baja, pero conviene revisar.
Retorno con valor en cero	La linea vino sin valor de pago. El titulo no se da de baja por esa linea.
Insuficiencia de fondos	Especifico de debito en cuenta: el banco no logro debitar la cuenta del cliente. El titulo no se da de baja.
Cuenta no encontrada	Especifico de debito en cuenta: Quaza no encontro la cuenta/contrato del cliente para el debito. Actualice los datos bancarios del cliente.
SIMULACION	El retorno fue procesado en modo simulado. Nada fue dado de baja de verdad: reprocese con Simulado = No para efectivar.

Tareas automaticas

El grueso del trabajo de la Remesa/Retorno es manual: usted genera la remesa, la envia al banco, descarga el retorno y lo procesa. Hay, sin embargo, una tarea que actua cuando usted manda procesar un retorno en segundo plano.

Tarea	Que hace
Financiero - Procesar retorno	Lee el archivo de retorno en segundo plano (cuando usted elige "Procesar en 2.o plano" o reprocesa un retorno), da las bajas y envia una notificacion al terminar.

Quien activa y desactiva las tareas es el administrador del sistema (sysadmin), por la agenda del servidor. La pantalla Admin → Tareas solo muestra el historial de ejecucion (cuando corrio, si concluyo o fallo): no inicia ni programa las tareas.

No hay tarea que genere la remesa sola ni que importe el retorno solo. A diferencia del Gateway (que da de baja automatica), en la Remesa/Retorno el envio de la remesa y la importacion del retorno dependen de que usted haga el ida y vuelta de los archivos con el portal del banco.

Trampas frecuentes

Generar la remesa y olvidar enviarla al banco. Generar el archivo en Quaza no registra nada: el banco solo conoce los boletos despues de que usted envia la remesa en su portal. Los boletos no enviados no son reconocidos y el pago puede no volver en el retorno. Las remesas sin retorno aparecen en rojo en la lista.

Saltear un archivo de retorno. Cuando el control de secuencia esta activo, importar fuera de orden queda bloqueado. Importe los retornos en el orden en que el banco los genero.

Procesar el retorno en modo Simulado y creer que se dio de baja. En Simulado nada se da de baja de verdad: los items vienen con el mensaje "SIMULACION". Para efectivar, reprocese con Simulado = No.

Importar el retorno en la cartera equivocada. Si el archivo es de otra cuenta/cartera, Quaza no encuentra los titulos y marca todo como "Financiero no encontrado". Descargue en el portal del banco el retorno de la cartera correcta.

Intentar deshacer una remesa ya enviada. Si ya hay retorno vinculado, deshacer queda bloqueado: desincronizaria Quaza del banco. Trate los titulos individualmente en lugar de deshacer.

Cliente sin ciudad en el registro. La remesa necesita la direccion completa. Un cliente sin ciudad interrumpe la generacion con un aviso por su nombre; corrija y vuelva a generar.

Confundir baja por retorno con pago manual. Si usted dio de baja un boleto a mano y despues el retorno trae el mismo pago, el item viene como "Financiero anteriormente pagado" (amarillo): es solo revision, no es error.

Creer que la pantalla de Tareas activa la automatizacion. Solo muestra el historial. Y en la Remesa/Retorno el envio y la importacion son siempre manuales: no hay tarea que haga el ida y vuelta de los archivos sola.

Olvidar la homologacion del banco. Antes de operar de verdad, cada banco exige homologar remesa y retorno. Siga la guia de su banco en el Centro de ayuda.

Preguntas frecuentes

Cual es la diferencia entre Remesa/Retorno y Gateway?

Ambos registran el cobro en el banco y confirman el pago. La Remesa/Retorno lo hace por intercambio de archivos: Quaza genera la remesa, usted la envia en el portal del banco e importa el retorno despues. El Gateway lo hace por integracion directa (en linea, casi instantaneo, con baja automatica). Use el Gateway cuando el banco lo ofrezca; vea Gateway bancario .

Donde envio la remesa y de donde descargo el retorno?

En el portal de su banco (banca por internet o portal de cobro/CNAB), no dentro de Quaza. Quaza solo genera el archivo de remesa e importa el archivo de retorno. El camino exacto en el portal varia por banco; vea la guia de homologacion de su banco en el Centro de ayuda.

Con que frecuencia tengo que hacer esto?

Depende de su operacion. En general se genera la remesa cuando hay boletos nuevos por registrar y se importa el retorno a diario (la mayoria de los bancos genera un retorno por dia). Coordine la rutina con su banco.

Genere la remesa por error. Como la deshago?

Si todavia no la envio al banco, use "Deshacer ultima remesa" en la pantalla de Remesa: devuelve los titulos y revierte la numeracion. Si la remesa ya tiene retorno vinculado (ya fue al banco), Quaza bloquea el deshacer; trate los titulos individualmente.

El cliente pago pero el boleto sigue "Abierto". Que hago?

La baja solo ocurre cuando el retorno de ese pago es importado. Confirme si el retorno del dia ya fue descargado en el portal del banco y procesado en Quaza. Despues revise en los items del retorno si ese titulo no vino con alguna novedad de rechazo o "no encontrado".

Que significa un item en rojo?

Es un item que no se dio de baja y necesita atencion: rechazado, no encontrado, cuenta no encontrada, fondos insuficientes o no liquidado. Abra el Listado "solo errores" en los items del retorno y trate cada uno por el mensaje.

Y un item en amarillo?

Es un alerta de que el titulo ya estaba pagado antes de este retorno ("Financiero anteriormente pagado"). En general es solo revision: confirme que no haya habido cobro/pago en duplicidad.

Puedo revisar el retorno antes de darlo de baja de verdad?

Si. Procese con Simulado = Si: Quaza lee el archivo y muestra lo que haria, sin dar ninguna baja (los items vienen con "SIMULACION"). Despues, reprocese con Simulado = No para efectivar.

El valor pagado vino distinto del valor del boleto. Por que?

Puede ser intereses/multa por atraso, descuento o pago parcial. Quaza da de baja el titulo y marca el mensaje "Valor original del sistema distinto del retorno" para que usted revise. Los intereses y el costo aparecen en columnas propias en los items del retorno.

Puedo procesar dos retornos al mismo tiempo?

No. Quaza no deja procesar un nuevo retorno mientras otro todavia esta "Procesando" en el mismo dia. Espere a que el anterior finalice.

Un retorno quedo "Fallado". Y ahora?

Revise si el archivo es el de retorno correcto de su banco/cartera. Los retornos no finalizados pueden reprocesarse por el detalle del retorno: Quaza intenta leerlo de nuevo en segundo plano y avisa al terminar.

Remesa/Retorno sirve para debito automatico en cuenta?

Si. El debito en cuenta tiene remesa y retorno propios (archivo en el estandar de debito). El retorno trae la confirmacion del debito o el rechazo (por ejemplo, fondos insuficientes), y Quaza trata las autorizaciones/desautorizaciones de debito del cliente.

La remesa registra boleto y PIX?

La remesa CNAB registra boletos (y el boleto puede traer PIX incorporado segun la cartera). El PIX dinamico puro y la tarjeta se hacen por integracion directa; vea Gateway bancario .

Documentos relacionados

Gateway bancario — el otro camino para hablar con el banco, por integracion directa (en linea), sin intercambio de archivos.
Cobro — como se genera y se cobra el boleto al cliente antes de entrar en la remesa.
Cobros y pagos — revision y baja manual de titulos.
Historial financiero — donde seguir bajas, pagos y movimientos.
Factura — el documento mensual que agrupa los debitos y genera los boletos.