Central de Ajuda Quaza Provedores

Mensualidad (ES-PY)

Mensualidad — Quaza

La mensualidad es el cobro recurrente del plan del cliente: todos los meses el Quaza genera un registro por el monto del contrato, con la fecha de vencimiento acordada. Esta guía muestra cómo nace la mensualidad, cómo generarla de forma manual, cómo funciona la generación automática mes a mes, el cálculo proporcional del primer mes y dónde dar seguimiento a todo. Dirigida a quien opera el área financiera del proveedor.

En esta wiki:

Cuándo usar mensualidad (y cuándo NO)

La mensualidad sirve para el cobro recurrente del plan (internet, TV, telefonía) ligado a un contrato. Usa esta pantalla cuando necesites generar, revisar o reemitir el cobro mensual de un cliente.

Usa mensualidad cuando...	NO uses mensualidad cuando...
El cliente tiene un contrato activo con monto mensual definido.	Sea un cobro suelto y único (cuota de instalación, multa) — usá un registro suelto.
Necesitás generar el cobro del mes actual o de meses futuros.	Quieras juntar varias mensualidades de un cliente en una sola boleta — eso lo hace la Factura .
El cliente fue activado a mediados del mes y necesita el monto proporcional.	Quieras configurar intereses, multa o plazos — eso está en las Reglas de Cobranza .
Necesitás reemitir un mes que quedó faltando.	Quieras generar el carné anual de varias boletas — usá el Carné .

Cómo nace la mensualidad

Toda mensualidad parte de un contrato activo. El contrato guarda dos datos clave: el monto mensual y el día de vencimiento. Con base en ellos, el Quaza crea un registro financiero del tipo Mensualidad para cada mes, con el mes de referencia y la fecha de vencimiento correctos.

Ese registro se puede crear de dos maneras, que dan exactamente el mismo resultado:

Manual — abrís la pantalla del cliente o la pantalla de Lanzamiento/Mensualidad y generás el cobro de uno o varios meses al instante.
Automática — una tarea diaria del servidor recorre los contratos y genera, por sí sola, la mensualidad de quien le llegó el turno de cobro. No tenés que hacer nada.

El Quaza nunca genera el mismo mes dos veces: antes de crear, revisa si ya existe un registro de Mensualidad con ese vencimiento para ese contrato. Si existe, lo saltea.

Paso a paso — generar la mensualidad de un cliente

Para generar manualmente el cobro mensual de un cliente específico:

#	Qué hacer
1	Abrí el registro del cliente y entrá en su contrato.
2	Andá a la pestaña Débito del contrato — lista todas las mensualidades ya generadas, con situación, vencimiento y monto.
3	En el menú de acciones del contrato, hacé clic en Generar mensualidad.
4	Elegí la Fecha inicial y la Fecha Final (mes/año). Para generar solo el mes actual, dejá las dos iguales. Para generar varios meses de una vez, elegí un intervalo.
5	Revisá el Monto (ya viene cargado con el valor del contrato) y la Descripción. La tabla del costado muestra una vista previa de los registros que se van a crear y sus vencimientos.
6	Hacé clic en Generar (al instante) o Generar en 2º plano (cuando sean muchos clientes, el sistema procesa y avisa al terminar).
7	Listo: las mensualidades aparecen en estado Abierto en la pestaña Débito y en la pantalla de Lanzamiento/Mensualidad, listas para pasar a boleta/cobro.

El botón Generar mensualidad abre la misma ventana tanto desde el contrato como desde la pantalla de secuencias. La diferencia: desde el contrato apuntás a un cliente; desde la pantalla de secuencias podés apuntar a varios clientes a la vez (por empresa, ciudad, barrio, modelo de la cartera).

Pestaña Débito del contrato: lista todas las mensualidades de ese contrato, con tipo, situación (Pagado), vencimiento, monto y pago. A la derecha, el menú de acciones con el botón Generar mensualidad resaltado.

Flujo de la mensualidad — del contrato al pago

Ciclo de la mensualidad: del contrato activo al registro pagado. La generación puede ser manual (botón en la pantalla) o automática (tarea diaria). En el 1º mes, si la activación cayó a mediados del mes, el sistema suma el monto proporcional. Al pagar, el registro pasa a Pagado (línea punteada = se repite todos los meses).

Glosario

Término	Qué significa
Mensualidad	El registro financiero recurrente que cobra el valor del plan del cliente en un mes. Tiene mes de referencia, vencimiento, monto y situación.
Recurrencia	La repetición mes a mes del cobro. El mismo contrato genera una mensualidad nueva en cada periodo, siempre en el día de vencimiento acordado.
Proporcional	Cobro parcial del primer mes, cuando el cliente fue activado a mediados del mes. Cobra solo los días entre la activación y el fin del primer periodo, al valor diario del plan.
Vencimiento	El día en que la mensualidad debe pagarse. Viene del contrato (día de vencimiento). Si el mes no tiene ese día, el sistema usa el último día del mes.
Mes de referencia	El mes que representa esa mensualidad (ej.: "Mayo de 2026"). Es distinto del vencimiento: la mensualidad de mayo puede vencer en junio, según la regla de cobranza.
Ciclo de cobranza	El periodo de cada mensualidad. En el modo Mensual, es el mes calendario; en el modo por Vencimiento, es el intervalo de un vencimiento al otro.
Secuencia	Un lote de generación de mensualidades. Cada vez que mandás generar (manual o automático), el Quaza crea una secuencia, registra cuántos registros salieron y el monto total, y guarda el resultado para revisarlo y reprocesarlo si falla.
Registro (Lanzamiento)	Nombre genérico de cualquier cuenta a cobrar en el financiero. La mensualidad es un tipo de registro; también existen registros de servicio, venta, etc.

Configuración — requisitos previos

Para que la mensualidad se genere correctamente, algunos datos deben estar listos de antemano:

Contrato activo Cliente → Contrato

El contrato debe estar activo, con monto mensual mayor que cero y un día de vencimiento definido. Un contrato cancelado o sin monto no genera mensualidad.

Modelo de la cartera Cobranza → Cartera de Cobranza

Define cómo se hará el cobro (boleta, gateway, pix), la moneda y eventuales intereses/multa/tarifa. Toda mensualidad nace ligada a un modelo de cartera.

Reglas de cobranza Cobranza → Reglas de Cobranza

Definen el día de referencia y el periodo de cobranza. Es donde se decide, por ejemplo, si el cobro es por mes calendario o de vencimiento a vencimiento. Más detalles en Reglas de Cobranza .

El modo de operación (Mensual o por Vencimiento) y el uso de proporcional se definen una sola vez en la configuración del financiero, normalmente junto con la implantación. Si no estás seguro de cómo quedó configurado, consultá con quien implantó el proveedor antes de generar de forma masiva.

Proporcional — el primer mes

Cuando el cliente se activa a mediados del mes, no tiene sentido cobrar la mensualidad completa del periodo que ya pasó. Por eso el Quaza calcula el proporcional: cobra solamente los días entre la fecha de activación y el fin del primer periodo, al valor diario del plan (monto mensual dividido por 30).

El proporcional aparece sumado a la primera mensualidad del cliente, con una descripción que explica cuántos días se cobraron. De la segunda mensualidad en adelante, el cobro vuelve a ser el valor completo del plan.

En la ventana Generar mensualidad existe la opción Generar proporcional. Cuando está activa, el valor parcial del primer mes ya entra en la vista previa. El proporcional solo se calcula si el contrato tiene una fecha de activación válida.

Si la activación cayó dentro de la tolerancia de instalación (una cantidad de días antes del vencimiento, configurada en la regla de cobranza), el Quaza puede saltear el cobro del primer mes para no cobrar pocos días. Es a propósito — el cliente empieza a pagar a partir del mes siguiente.

Pantalla de Lanzamiento / Mensualidad

Recepción → Lanzamiento/Mensualidad

Esta es la pantalla central para ver todas las cuentas a cobrar, incluidas las mensualidades. Cada fila trae el cliente, el contrato, la situación, el mes de referencia, el vencimiento, el monto total, el monto aún abierto y el monto ya pagado.

Los filtros de arriba agrupan por situación: Abierto, Atrasado, Pagado, Pago parcial, Exento, Removido y No facturado. Usálos para, por ejemplo, listar solo lo atrasado de un cliente, o revisar todo lo generado en el mes.

Cada fila tiene atajos para editar el registro, generar el cobro/boleta e imprimir. Para ver las mensualidades de un cliente específico, abrí su contrato y usá la pestaña Débito, que filtra solo ese contrato.

El área de Recepción también reúne los registros manuales (movimientos sueltos). Las mensualidades están en el listado principal; los movimientos manuales son para ingresos puntuales que no provienen de un contrato.

Generación masiva (Procesar financieros)

Cuando necesitás generar la mensualidad de muchos clientes de una vez (por ejemplo, cambió el mes y querés correr el cobro de todos), usá la generación masiva. Cada corrida crea una secuencia, que seguís en un listado propio.

#	Paso
1	Abrí la pantalla de secuencias (Listar secuencias) y hacé clic en Procesar financieros.
2	Definí el intervalo (Fecha inicial / Fecha Final) y los filtros: empresa, modelo de la cartera, ciudad, barrio, regla de vencimiento. Podés apuntar a todos los clientes o solo a un recorte.
3	Revisá la descripción y las opciones (generar proporcional, generar cobros) y hacé clic en Generar en 2º plano. Para muchos clientes, usá siempre el 2º plano.
4	El Quaza procesa en segundo plano y envía una notificación al terminar, con la cantidad de registros generados y el monto total.
5	Seguí el resultado en el listado de secuencias: situación (Procesando, Finalizado, Finalizado con errores, Fallado), ítems generados y monto.

Listar secuencias: cada fila es un lote de generación de mensualidades, con código, cliente, cantidad de contratos, monto total, horarios de inicio/fin, situación y empresa. El botón Procesar financieros (esquina superior) abre la ventana para generar un lote nuevo.

Si una secuencia termina como Finalizado con errores o Fallado, abrí su registro para leer el mensaje de error por contrato y usá el botón Reprocesar. El reprocesamiento solo rehace lo que faltó — no duplica lo que ya se generó.

Estados de una mensualidad

Cada mensualidad (registro) tiene una situación que muestra en qué punto del ciclo de cobranza está:

Situación	Qué significa	Próxima acción
Abierto	Mensualidad generada y aún no pagada. Puede estar dentro o fuera del plazo.	Generar el cobro/boleta y esperar el pago.
Pagado	El cliente canceló la mensualidad. Muestra la fecha y el monto pagado.	Nada — ciclo concluido para ese mes.
Dado de baja	El registro se cerró sin un pago normal (cancelado, exento o ajustado).	Revisar el motivo en el historial del registro.

En el listado, los filtros Atrasado, Pago parcial y Exento son recortes de la situación Abierto/Pagado combinados con fecha y monto — ayudan a encontrar casos específicos sin cambiar el estado de fondo.

Tareas automáticas

La generación automática de las mensualidades la hacen tareas que corren en el servidor en un horario programado. Hacen solas lo que vos harías por la pantalla — solo tenés que entender qué hace cada una para saber a quién recurrir cuando algo no se generó.

Tarea	Qué hace
Financiero - Procesar secuencia	Procesa los lotes de generación de mensualidad en segundo plano (es la misma rutina que dispara el botón Procesar financieros). Es la tarea que de hecho crea las mensualidades del mes.
Contrato - Crear las facturas	Cuando el módulo de Facturas está activo, agrupa las mensualidades abiertas de cada contrato en una factura única, en el día de referencia configurado.
Contrato - Enviar las facturas	Envía las facturas generadas al cliente (por correo), luego de la creación.
Financiero - Aviso de vencimiento	Avisa al cliente (correo/SMS) sobre mensualidades por vencer o vencidas, según los días configurados.
Financiero - Documento recurrente	Genera documentos recurrentes sueltos (cobros fijos que no provienen de un contrato), en el día de inclusión definido.
Financiero - Actualiza valor	Recalcula el monto de registros abiertos (intereses, multa, descuento por pago anticipado) según la regla de cobranza.

Quién enciende, apaga y define el horario de estas tareas es el administrador del servidor (por la crontab) — no se puede hacer desde la pantalla. La pantalla Admin → Tareas solo muestra las tareas registradas, la descripción y cuándo corrieron por última vez. Si la mensualidad del mes no se generó sola, el primer paso es confirmar con el responsable si la tarea de procesar secuencia está activa.

Pantalla Admin → Tareas: lista las rutinas automáticas, con descripción, tiempo límite y última modificación. Resaltada, la tarea Contrato - Crear las facturas. Esta pantalla solo informa — encender/apagar y programar lo hace el administrador del servidor.

Trampas frecuentes

Un contrato sin monto o cancelado no genera mensualidad. Si el cliente reclama que no recibió cobro, revisá que el contrato esté activo y con monto mensual mayor que cero.

El vencimiento no es el mes de referencia. La mensualidad de mayo puede vencer en junio. Al revisar un cliente, mirá la columna Mes de referencia, no solo el vencimiento.

Un mes ya generado no se genera de nuevo. Si mandás generar un mes que ya existe, el Quaza lo saltea — por eso "no apareció nada" a veces significa que ya estaba generado, no que falló.

El proporcional es solo del primer mes. Si el valor de la primera mensualidad salió "quebrado", es el proporcional de los días de mediados del mes — no es un error. De la segunda en adelante vuelve al valor completo.

Generación masiva para muchos clientes: usá el 2º plano. Generar al instante para miles de contratos puede agotar el tiempo. El 2º plano procesa en segundo plano y avisa al terminar.

Límite de mensualidades abiertas. Si el proveedor configuró un límite de mensualidades pendientes, los contratos por encima del límite pueden tener la nueva mensualidad marcada como irregular (no va al envío bancario) hasta que el cliente se regularice.

La cobranza unificada cambia la regla. Los contratos ligados a una cobranza unificada no generan mensualidad por separado — entran en la boleta única del contrato principal. Revisá que el contrato no esté unificado antes de extrañar la ausencia.

Una secuencia con error necesita reprocesamiento. Una secuencia "Finalizado con errores" dejó contratos atrás. Leé el error por contrato y reprocesá — no alcanza con mandar generar de nuevo desde cero.

Preguntas frecuentes

¿La mensualidad es siempre mensual? ¿Puede ser semanal o anual?

El nombre es "mensualidad" porque el ciclo estándar es mensual. El periodo de cobranza se define en la configuración del financiero y en las reglas de cobranza; el uso más común es mes a mes.

¿Puedo generar la mensualidad de un mes que ya pasó (retroactivo)?

La generación masiva cubre el intervalo que elijas, pero el sistema evita crear vencimientos iguales o anteriores a hoy en algunos casos. Para acertar un mes faltante, generá desde el contrato eligiendo el mes exacto; si no aparece, es porque ya existe o el vencimiento ya pasó.

Generé una mensualidad por error. ¿Cómo la quito?

Abrí el registro en la pantalla de Lanzamiento/Mensualidad y usá la opción de quitar/dar de baja. Los registros removidos aparecen en el filtro Removido. Si ya se convirtió en boleta registrada en el banco, cancelá primero el cobro.

¿Por qué la primera mensualidad del cliente vino con un valor distinto?

Casi siempre es el proporcional: el cliente se activó a mediados del mes y el Quaza cobró solo los días hasta el fin del primer periodo. La descripción del registro explica cuántos días se cobraron.

¿Cómo veo todas las mensualidades de un cliente?

Abrí el contrato del cliente y andá a la pestaña Débito — lista todas las mensualidades de ese contrato. Para ver las de todos los contratos, usá la pantalla de Lanzamiento/Mensualidad filtrando por el cliente.

¿La tarea automática tiene un horario fijo?

El horario lo define el administrador del servidor en la crontab. La pantalla Admin → Tareas muestra la última vez que corrió, pero no permite cambiar la programación.

¿Un cliente con 2 contratos genera 2 mensualidades?

Sí, cada contrato activo genera su propia mensualidad — salvo que los contratos estén en cobranza unificada, en cuyo caso entran en una sola boleta del contrato principal.

¿Cuál es la diferencia entre mensualidad y factura?

La mensualidad es el registro de un mes de un contrato. La factura agrupa varias mensualidades (o varios contratos) en un documento/boleta única. Veá Factura .

¿Por qué un contrato no generó mensualidad en la corrida masiva?

Motivos comunes: contrato inactivo o sin monto, mes ya generado, vencimiento ya pasado, contrato en cobranza unificada, o activación dentro de la tolerancia de instalación. El detalle queda en el resultado de la secuencia.

¿Puedo cambiar el monto de la mensualidad al momento de generar?

En la ventana Generar mensualidad existe el campo Monto, que viene cargado con el valor del contrato. Editar ese valor depende del permiso de tu usuario; sin él, el campo queda de solo lectura.

¿Qué es "Generar en 2º plano"?

Es procesar la generación en segundo plano, sin trabar la pantalla. Usálo siempre que sean muchos clientes: el sistema procesa y manda una notificación al terminar.

¿La mensualidad se convierte en boleta automáticamente?

La mensualidad nace como registro en estado Abierto. Según la configuración de la cartera y de las reglas de cobranza, pasa a boleta/cobro (al instante o por tarea). El seguimiento de la boleta y de la respuesta del banco queda en el área de Cobranza.

Documentos relacionados

Profundizá en los temas conexos:

Factura — agrupa varias mensualidades en una sola boleta
Cobranza — cómo la mensualidad pasa a boleta y se da de baja el pago
Reglas de Cobranza — día de referencia, periodo, intereses, multa y plazos
Carné — genera el PDF anual con varias boletas de una vez
Contrato y Factura — dónde se definen el monto mensual y el día de vencimiento
Historial Financiero — visión consolidada de lo que el cliente debe y pagó