Generación de Cobro — Boleta, QR/QR/PIX, Tarjeta, Carnet
Cobro es cómo la
Mensualidad
(o cualquier débito) se transforma en
algo que el cliente puede pagar — una boleta bancaria, código QR/QR/PIX, enlace de tarjeta de crédito o carnet físico. Sin cobro generado, el cliente no sabe cómo pagar.
El cobro no se crea de la nada — depende de la
Cartera de Cobro del contrato (define el banco/gateway/forma) y de la
Forma de Pago (boleta, QR, tarjeta).
Visión general — flujo completo
┌─────────────────────────────────────────────────────────────────┐
│ MENSUALIDAD GENERADA (Gs. 100.000, vence día 10) │
│ → aún no tiene "boleta para pagar" │
└─────────────────────────────────────────────────────────────────┘
↓
Cron de Cobro corre
(Tarea "Contrato - Crear las Facturas" genera la factura; gateways/bancos registran las boletas vía APIs/CNAB según la cartera)
↓
┌─────────────────────────────────────────────────────────────────┐
│ Lee el contrato → identifica: │
│ • CARTERA del contrato (qué banco/gateway) │
│ • FORMA DE PAGO (boleta/QR/tarjeta) │
└─────────────────────────────────────────────────────────────────┘
↓
┌───────────────┴────────────────┐
↓ ↓
Forma BOLETA Forma QR/QR/PIX
→ genera nuestro número → genera QR code + clave
→ línea digitable → válido por X horas
→ PDF de la boleta → registra en el banco
↓ ↓
└───────────────┬────────────────┘
↓
COBRO registrado en el banco (REMESA CNAB o API)
↓
Cliente recibe y paga
↓
RETORNO CNAB / Webhook trae la baja
↓
Mensualidad vira "Paga"
Glosario
| Término |
Significado |
| Cobro |
Documento concreto para que el cliente pague — boleta, enlace QR, etc. Viene de una mensualidad/débito |
| Cartera de Cobro |
Configuración que define: qué banco, qué gateway, qué modelo de boleta/QR. Cada contrato tiene una cartera |
| Forma de Pago |
Tipo: Boleta, QR/QR/PIX, Tarjeta, Carnet, Débito automático. Cliente puede tener más de una |
| Gateway de pago |
Servicio externo (Asaas, GerenciaNet, Safe2Pay, o directo del banco) que procesa el cobro |
| Nuestro número |
ID único de la boleta en el banco — generado cuando se emite |
| Línea digitable |
Secuencia de números de la boleta que puede copiarse y pagar vía app banco |
| Remesa |
Archivo CNAB enviado al banco con lote de boletas a registrar. Ver Remesa & Retorno
|
| Retorno |
Archivo CNAB que el banco devuelve con bajas de pagos |
| Carnet |
PDF con 12+ boletas del año entero para que el cliente imprima y pague mes a mes |
| QR Code QR/PIX |
Código que el cliente escanea en la app del banco para pagar instantáneo |
| BR Code |
Texto de la clave QR/PIX que puede copiarse (alternativa al QR visual) |
| Débito Automático |
Cliente autoriza al banco a debitar todos los meses — sin necesitar pagar manualmente |
Métodos de pago soportados
| Método |
Cómo funciona |
Velocidad baja |
| Boleta Bancaria |
Cliente paga en cualquier banco hasta la fecha — baja vía retorno CNAB |
1-2 días hábiles |
| QR/PIX |
QR code o clave Copia&Pega — pago instantáneo |
Instantáneo (segundos) |
| Tarjeta de Crédito |
Cliente llena datos o usa tarjeta guardada — gateway procesa |
Inmediato (D+1 al proveedor) |
| Tarjeta Recurrente |
Tarjeta guardada cobra automático todos los meses — sin acción del cliente |
Automático D+1 |
| Carnet |
PDF con varias boletas — cliente paga mensualmente |
1-2 días hábiles cada |
| Débito en Cuenta |
Cliente autoriza al banco a debitar — Quaza envía en archivo CNAB |
Mismo día (si acordado) |
| Dinero en Caja |
Cliente va presencialmente al proveedor a pagar — Quaza da recibo |
Inmediato |
Mix recomendado: ofereça QR/PIX como padrão (custo zero, instantâneo) + boleto como alternativa (cliente "antigo" prefere) + cartão recorrente pra reduzir inadimplência (cliente esquece). Carnet está em declínio mas ainda usado em algumas regiões.
1. Cartera de Cobro — concepto central
Caminho: Financeiro → Cartera de Cobro
La Cartera es el modelo de cobro. Define:
- Qué banco registra la boleta (Itaú, Santander, BBVA, etc.)
- Qual gateway processa cartão/QR/PIX (Asaas, GerenciaNet, Safe2Pay, Sicredi, Sicoob)
- Qué cuenta corriente recibe el dinero
- Qué layout de boleta (logo, instrucciones, intereses, multa)
- Qué formas de pago acepta la cartera
¿Por qué tener múltiples carteras?
| Escenario |
Solución |
| Proveedor con 2 empresas fiscales (multi-RUC) |
1 cartera por empresa — banco diferente |
| Cobro normal vs prepago |
2 carteras con reglas diferentes (intereses, plazo) |
| Cliente residencial vs empresarial |
Carteras con layout/banco apropiado |
| Prueba de nuevo gateway |
Cartera de pruebas aislada |
Campos de la cartera
| Campo |
Qué hace |
| Descripción |
En elme interno (Itaú Principal, QR/PIX Asaas, Cartão Sicredi) |
| Banco |
Qué institución registra la boleta |
| Agencia / Cuenta |
Dónde cae el dinero |
| Convenio / Cartera (banco) |
Código específico del banco para registro |
| Gateway |
Pra QR/PIX/cartão — qual provedor processa |
| Credenciales (API/token) |
Auth para que Quaza llame a la API |
| Layout PDF |
Plantilla de la boleta (logo, instrucciones) |
| Intereses / Multa |
% aplicados tras vencimiento (generalmente 1%/2%) |
| Días tolerancia |
Cuántos días tras vencimiento sin intereses |
| Considera día hábil |
Vencimiento en sábado → atrasa al lunes |
Camino: Financiero → Formas de Pago
Registro de cada tipo de pago que el proveedor acepta. Permite habilitar/deshabilitar y configurar comportamiento (gateway, plazos).
Campos de la forma de pago
| Campo |
Qué hace |
| Descripción |
En elme amigável (Boleto Itaú, QR/PIX Quaza, Cartão Visa) |
| Tipo |
Boleto / QR/PIX / Cartão / Carnet / Caixa / Débito |
| Cartera |
Qué cartera procesa esa forma |
| Permite financiación |
Sí/En el — tarjeta generalmente permite |
| Acepta en el portal |
¿El cliente puede elegir esa forma en el portal? |
| Situación |
Habilitado / Deshabilitado |
Relação Cartera × Forma: 1 carteira pode atender N formas (uma carteira "Asaas" suporta boleto + QR/PIX + cartão). 1 forma específica usa 1 carteira. Cliente em contrato com Cartera X usa as Formas habilitadas dessa Cartera.
Cuándo el sistema genera/regenera cobro
| Evento |
¿Cobro generado? |
| Mensualidad criada (cron) |
Sim — cron de cobrança roda em seguida e gera boleto/QR/PIX |
| Mensualidad vence sem pagar |
Sí — genera nuevo cobro con intereses/multa (si está configurado) |
| Cliente pide 2da vía en el portal |
En el crea nueva — reutiliza la existente (misma línea digitable) |
| Operador hace clic "Reemitir" |
Sí — cancela cobro antiguo, genera nuevo (nuestro número nuevo) |
| Cambio de cartera en el contrato |
Cobros futuros con nueva cartera; pasados continúan con la antigua |
| Renegociación |
Cancela cobros antiguos + genera nuevos para el acuerdo. Ver Renegociación
|
Pre-requisitos para que el cobro se genere
| Requisito |
Dónde verificar |
| Mensualidad existente |
Mensualidad
generada con valor > 0 |
| Contrato com Cartera |
Contrato → campo Cartera preenchido |
| Cartera ativa |
Cartera → Situación=Habilitada |
| Credenciales válidas |
Gateway/banco con auth funcionando (probar vía Configuraciones) |
| Cliente con datos completos |
CI/RUC válido, dirección (para boleta) |
| Fecha de vencimiento futura |
En el se puede generar boleta para fecha ya pasada (algunas reglas) |
Diferença entre Mensualidad × Cobrança: mensalidade é o "valor que cliente deve" (registro contábil). Cobrança é "como ele paga" (boleto/QR/PIX/cartão concreto). Pode haver mensalidade SEM cobrança gerada (ex: carteira inativa) — vira o alerta amarelo "X débitos sem cobrança" no
Panel
.
Trampas frecuentes
1. "Débito abierto sin cobro"
Mensualidad existe, mas cobrança não foi gerada. Causas comuns: Cartera do contrato desabilitada, credencial do gateway expirou, contrato sem Cartera. Verifique
Panel
→ alerta amarilla +
Verificaciones → Sin cobro
.
2. Boleta generada pero el cliente no la recibe
Cobro generado en Quaza pero registro en el banco falló (Remesa CNAB con error, gateway lento). Verifica Remesa → Errores. Sin registro en el banco, el cliente no logra pagar (boleta "ilegal").
3. Línea digitable cambiada — cliente pagó boleta vencida
Cliente tomó boleta antigua, el sistema generó nuevo cobro con nueva línea. Cliente pagó la antigua (no registra). Solución: configurar "Aceptar pago de boleta antigua" en el gateway, o procesar manualmente vía Lanzamiento Manual.
4. QR/PIX expirou — cliente não consegue pagar
QR Code QR/PIX tem validade (geralmente 1-24h). Cliente abriu boleto-QR/PIX 2 dias depois, código já expirou. Cliente precisa pedir 2ª via no portal — Quaza gera novo QR válido.
5. Tarjeta recurrente paró de cobrar
Tarjeta venció, bloqueada, o el cliente cambió. Gateway retorna error → cobro queda pendiente. Configura aviso automático al cliente en
Comunicación
→ "Tarjeta rechazada". Cliente actualiza datos.
6. Cartera inativa — clientes parados na geração
Operador desabilitou Cartera "Itaú" achando que ninguém usa, mas 200 contratos estavam vinculados. Cron de cobrança para. Solução: trocar Cartera em massa antes de desabilitar (Edição Múltipla → Cartera).
7. Cobro en moneda errada (multi-país)
Provedor com filial Paraguay (RUC) gera cobrança em R$ por engano. Configure Cartera por Empresa fiscal, e contrato fica vinculado à empresa correta com moeda local.
Galería de pantallas
Cob carteiras
Cob formaspag
Cob v01 carteira
Guía detallada (migrada de la wiki antigua)
📸 Pantallas del sistema
Las pantallas a continuación muestran cómo el sistema se presenta en cada parte del flujo descrito.
Carteras de Cobranza — agrupan cuentas bancarias y parámetros usados en cada gateway/banco.
¿Qué es una "Cobranza" en Quaza? Cobranza es el documento que cobra el cliente — boleto, PIX, código de carné, link de tarjeta. Es generada cuando una mensualidad o venta vence y precisa ser pagada. El Quaza monta el documento conforme la Cartera de Cobranza elegida, envía al cliente, y baja automáticamente cuando el pago retorna del banco.
Cadena completa: Mensualidad/Venta → débito en abierto → Cobranza generada (boleto/PIX/carné) → enviada al cliente → cliente paga → retorno del banco → cobranza dada de baja.
Métodos de pago suportados
| Método |
Cómo funciona |
Cuándo usar |
| PIX |
Genera código QR Code + chave copia-y-pega. El cliente paga al instante con el banco preferido. |
Cobranzas rápidas, recibo inmediato. Más usado actualmente. |
| Boleto |
Documento bancario con código de barra y vencimiento. Compensa en 1-2 días útiles. |
Cobranzas con plazo, clientes sin app del banco. |
| BOLIX |
Boleto + PIX en un único documento — el cliente elige cómo pagar. |
Mejor de los dos mundos. Default cuando soportado por el banco. |
| Tarjeta |
Link de pago vía gateway (Cielo, Mercado Pago, etc). |
Suscripción, ventas online. |
| Carné |
PDF impreso con varias cuotas (3x, 6x, 12x). |
Cliente que prefiere pagar en la lotería/ventanilla. |
1 El concepto central — Cartera de Cobranza
Control Financiero → Cartera de Cobranza
La Cartera de Cobranza es el "perfil" que define cómo y por dónde una cobranza es generada. Cada cliente/contrato apunta a una cartera, y la cartera determina:
- Banco (Sicredi, BB, Itaú, Caja, etc.)
- Tipo de cobranza (Boleto, PIX, BOLIX, Tarjeta)
- Plazo, intereses, multa, gracia
- Credenciales de gateway (cuando integrado)
- Layout de boleto / chave PIX / configuraciones de remesa
El listado muestra todas las carteras configuradas. Cada línea representa una combinación banco + tipo + tarifa. Botón Agregar (1) crea una nueva cartera.
| Columna |
Qué muestra |
| Descripción |
Nombre interno de la cartera (ej: "Sicredi - Boleto - Tarifa 3,50"). |
| Banco |
Banco/institución de la cartera (Sicredi, Caixa, BB, etc.). |
| RUC/CNPJ |
Documento del titular de la cuenta bancaria. |
| Contratos |
Cantidad de contratos vinculados a esa cartera (link clickeable). |
Cuántas carteras crear: en general una por banco × moneda × tipo. Operación pequeña: 1-3 carteras. Mediana: 5-10. Operación con muchos bancos: 10+. Mantener pocas, claras, bien nombradas.
Al editar una cartera, configura todos los detalles: banco, agencia, cuenta, código de cobranza, tarifas, plazos, intereses, multa, días de protesto, layouts. Cada banco tiene sus propios campos específicos.
Cuidado al cambiar la cartera de un cliente: el cambio solo vale para cobranzas nuevas. Boletos ya emitidos siguen apuntando a la cartera antigua hasta ser pagados o cancelados.
2 Formas de Pago
Control Financiero → Formas de Pago
Antes de la cartera, hay un cadastro más simple: Formas de Pago. Es la lista corta de los medios que la empresa acepta — Dinero, Tarjeta de Crédito, Tarjeta de Débito, Transferencia, Cheque, etc. Las carteras usan eso como referencia.
Tipicamente:
| Forma |
Cuándo aparece |
| Dinero/Efectivo |
Pago en la caja física (lanzamiento manual). |
| Tarjeta Crédito/Débito |
Pago vía gateway (Cielo, Mercado Pago). |
| Transferencia |
TED/PIX no integrado al gateway. |
| Cheque |
Cheque físico — registro manual. |
| Boleto |
Boleto bancario via cartera. |
| PIX |
Cobranza PIX integrada. |
El flujo completo de una cobranza
| Etapa |
Qué ocurre |
Dónde |
| 1. Origen del débito |
Mensualidad generada (cron) o venta creada (manual) |
Mensualidad
/ Ventas
|
| 2. Generación de cobranza |
Sistema usa la Cartera del contrato/venta y monta el documento (boleto/PIX/carné) |
Automático — backend |
| 3. Integración con banco |
Si la cartera tiene Gateway, el sistema envía via API al banco; si no, genera arquivo de remesa CNAB |
Ver Gateway
y Remesa
|
| 4. Envío al cliente |
Email, WhatsApp, link, impresión del carné |
Tarea automática |
| 5. Cliente paga |
En el banco, app, lotería, caja |
Externo |
| 6. Retorno del banco |
Banco confirma pago via webhook (gateway) o arquivo CNAB |
Ver Retorno
|
| 7. Baja automática |
Sistema marca cobranza como Pagada y baja el débito |
Automático |
Cuándo el sistema genera/regenera una cobranza
El sistema tiene 4 reglas de regeneración configurables en la cartera:
| Regla |
Comportamiento |
GERAR_NUNCA |
No regenera nunca — manual solamente. |
GERAR_SE_NAO_EXISTE |
Solo crea si no existe cobranza para ese débito. |
GERAR_SE_CARTEIRA_DIFERENTE |
Regenera si cambió la cartera del cliente. |
GERAR_SE_VALOR_DIFERENTE |
Regenera si el valor del débito cambió. |
GERAR_SE_CARTEIRA_VALOR_DIFERENTE |
Regenera si cartera o valor cambiaron. |
Recomendado: GERAR_SE_CARTEIRA_VALOR_DIFERENTE — protege contra regeneraciones inútiles pero garantiza actualización cuando algo importante cambia.
Pre-requisitos para una cobranza ser generada
| Pre-requisito |
Dónde |
| Cartera de Cobranza configurada y activa |
Control Financiero → Cartera |
| Cliente con cartera vinculada |
Cliente / Contrato → campo Cartera |
| Forma de Pago compatible |
Control Financiero → Forma de Pago |
| Regla de Cobranza vinculada al contrato |
Ver Reglas de Cobranza
|
| Para Gateway: credenciales válidas |
Ver Gateway
|
| Para Boleto sin Gateway: convenio CNAB con el banco |
Ver Remesa/Retorno
|
⚠️ Comportamiento al alterar contrato
Cobranzas (débitos) ya generadas siguen reglas estrictas:
-
Cambió valor del contrato → débitos abiertos sin NF son recalculados. Débitos con NF son preservados.
-
Cambió forma de pago → boletos abiertos NO son re-emitidos.
-
Cambió regla de cobranza → no se reaplica a débitos abiertos.
-
Canceló contrato → débitos abiertos son cerrados.
Detalles en Contrato — Side-effects
.
🔗 Veja também
Documentos relacionados
Profundiza en los temas conexos:
FAQ
¿Puedo tener el mismo cliente con formas diferentes (boleta + tarjeta)?
Sí — depende de la política. Puedes ofrecer "cualquier forma" y el cliente elige en el portal. O fuerzas "solo tarjeta recurrente" para reducir morosidad.
¿Cliente pagó 2x — qué hacer?
Sistema detecta retorno doble. Lanza crédito en la próxima factura. Si el cliente prefiere reembolso, hay flujo de devolución en Recepciones.
¿Por qué la boleta demora 1-2 días para bajar incluso después de pagar?
Banco processa retorno CNAB em horário fixo (geralmente 1x/dia). Quaza importa depois. Pra baixa imediata, use QR/PIX (instantâneo via webhook do gateway).
¿Cliente perdió la boleta — dónde la encuentra?
En el Portal del Cliente
→ Financiero → Obtener 2da vía. Sistema reemite la boleta (mismo nuestro número) por email/WhatsApp.
Como configurar QR/PIX próprio (sem gateway)?
Configure Cartera como "QR/PIX Banco" com sua chave QR/PIX. Quaza gera QR Code com seus dados. Sem gateway, baixa não é automática — precisa conciliação manual via extrato.
Mensualidad R$ 100 mas boleto vem R$ 110 — por quê?
Intereses + multa tras vencimiento. Si el cliente paga tras la fecha, viene con cargos. Configura en Regras
ou Cartera → Juros/Multa.
¿Cómo cambiar de banco/gateway sin afectar cobros existentes?
Crie nova Cartera em paralelo, vincule novos contratos a ela. Os antigos continuam na Cartera velha. Migre gradualmente conforme contratos renovam.