Cross-module — cómo Financiero, Fiscal y Stock conversan (integración transversal)
Esta wiki es una visión transversal: explica cómo los módulos del Quaza se conectan. Facturar genera asiento financiero + emite documento fiscal + da baja en stock. Es el "cómo todo se encaja".
📸 Pantallas del sistema
Las pantallas a continuación muestran cómo el sistema se presenta en cada parte del flujo descrito.
Dashboard financiero — vista consolidada cross-module: contadores de débitos por vencer, recibos del día, alertas de morosidad. Es el punto donde Financiero × Fiscal × Stock convergen visualmente.
🔄 Los 4 Modos de Tributación — cuándo la factura es generada
| Modo |
Cuándo NF es generada |
Cuándo usar |
| Manual |
Operador genera individualmente. |
Empresas que conferen cada factura antes. |
| Por Recibimiento (caja) |
Cuando el cliente paga el débito. |
Régimen caja — paga impuesto solo sobre lo recibido. |
| En la Creación |
Cuando débito es generado. |
Régimen competencia — cliente recibe factura junto al boleto. |
| Por Vencimiento |
En el día del vencimiento. |
Registro de competencia exactamente en el vencimiento. |
El modo es configurable por empresa fiscal y puede ser sobrescrito por contrato.
↩️ Estorno de Pago — efecto cascada
- Marca débito de vuelta como "Abierto".
- Si era de renegociación, reabre los débitos originales.
- NF emitida puede precisar Nota de Crédito.
- Movimiento de caja estornado.
- Histórico financiero registra.
🔁 Renegociación — efectos
| Etapa |
Qué pasa |
| Crear renegociación |
Agrupa débitos antiguos + multas/juros. |
| Aceptar acuerdo |
Débitos antiguos cierran. Nuevo débito creado. |
| NF antiguas |
NO son canceladas automáticamente. |
| NF nueva |
Generada conforme modo de tributación. |
| Cancelar renegociación |
Reabre antiguos, cancela nuevo. NF puede precisar NC. |
🔧 Equipo × Login Radius × Contrato — vinculación 3-way
-
Stock — equipo sale del almoxarifado, vinculado al cliente en Comodato.
-
Cliente/Contrato — equipo referenciado en contrato.
-
Red (Radius) — equipo vinculado al login Radius (controla banda).
Por qué importa: al cambiar equipo, actualizar en los 3 lugares — olvidar uno genera inconsistencia.
🛒 Venta + Stock + NF — flujo de venta con producto físico
- Operador crea venta con producto + valor.
- Sistema genera débito financiero.
- Categoría del producto define tipo de NF (NFe 55 / NFSe).
- Si vinculada a OS, stock baja cuando OS cierra. Si no, baja inmediata.
- Equipamentos rastreables vinculados al cliente.
- Cliente paga → débito liquidado → caja actualizada.
📥 NF Recibo + Compra + Stock + Pago — flujo de entrada
- Cadastra NF de Recibo (o importa XML).
- Vincula a Compra.
- Marcar como movimentada → entrada en stock.
- Equipamentos rastreables ganan serial individual.
- Genera débito a pagar al proveedor.
- Pago liquida débito + actualiza caja.
🔓 Reabrir débito o cancelar factura — efectos
| Operación |
Qué afecta |
| Reabrir débito pago |
Status vuelve a abierto. NF NO se cancela. Para cancelar NF, usar Nota de Crédito. |
| Cancelar factura |
Generalmente exige NC. |
| Estornar pago |
Débito vuelve a abierto, caja estorna. Si liquidaba renegociación, reabre originales. |
| Cancelar venta |
Operador elige retornar productos al stock. Débito vira cancelado. |
🔀 Múltiples Empresas Fiscales — cuidados
- Empresa fiscal padrón por tipo de factura (NFe, NFSe, SVA).
- Empresa por tipo de contrato — hasta 5.
- Categoría de producto aponta para empresa específica.
- Cambiar empresa fiscal de contrato — NFs ya emitidas mantienen empresa antigua.
⏰ Tareas crontab cross-module
| Tarea |
Módulos |
Función |
| Aviso de Vencimiento (201) |
Financiero + Comunicación |
SMS/email/WhatsApp lembrando vencimiento. |
| Generar Mensualidad (1301) |
Contrato + Financiero |
Genera débitos mensuales. |
| Generar NFs Pago (510 / 522) |
Financiero + Fiscal |
Modo "Por Recibimiento" — genera NF al pagar. |
| Transmitir NFe (511) |
Fiscal |
Envía NFe/NFCom al SEFAZ. |
| Aviso Cantidad Mínima |
Stock + Comunicación |
Notifica saldo bajo. |
| Validador Saldo |
Stock |
Confere saldo general × detallado. |
| Bloqueo Automático |
Cliente + Red + Comunicación |
Bloquea morosos (estado → Radius → aviso). |
📋 Resumen
En una frase: Contrato → Mensualidad → Débito → (modo tributación) → NF → Pago → Caja. Stock entra cuando hay producto físico. Equipamiento rastreable vincula Stock ↔ Cliente ↔ Red.
PADRÓN OPERACIONAL — FLUJO COMÚN
─────────────────────────────────
1. Cadastro inicial / configuración
│
▼
2. Permisos definidos por rol
│
▼
3. Operación normal:
┌──────────────────────────────────┐
│ - input del operador / cron │
│ - validación automática │
│ - persistencia en la BD │
│ - log de auditoría │
│ - notificación (si aplica) │
└──────────────┬───────────────────┘
│
▼
4. Revisión / supervisión
│
┌──────┴──────┐
▼ ▼
OK normal Desvío detectado
│ │
▼ ▼
Histórico Acción correctiva +
alerta al supervisor
📚 Documentos relacionados
Glosario
| Término |
Significado |
| Quaza |
Sistema ERP/BSS para ISP — gestión integrada de cliente, financiero, fiscal, técnico. |
| Contrato |
Vínculo formal entre cliente y empresa. |
| Factura |
Documento de cobranza generado a partir del contrato. |
| Auditoría |
Revisión sistemática para detectar inconsistencias. |
| Permiso |
Derecho de acceso/edición vinculado a rol o usuario. |
| API REST |
Interfaz programática para integración con sistemas externos. |
| Cron / crontab |
Agendador de tareas que ejecuta en horarios definidos. |
| Webhook |
Notificación automática que sistema externo recibe. |
| Centro de costo |
Dimensión transversal — filial, proyecto, sector. |
| Conciliación |
Proceso de garantizar que extracto bancario coteja con Quaza. |
Trampas frecuentes
1. Falta de validación post-configuración. Cadastro hecho sin teste real = atrapa el error en producción. Siempre teste con dato dummy antes.
2. Permisos mal definidos. Operador con acceso de admin = riesgo. Defina roles claros.
3. No entrenar equipo nuevo.
4. Cambiar configuración sin registrar. Quién cambió, cuándo, por qué — se pierde rastro.
5. Ignorar alertas/notificaciones.
6. Operaciones masivas sin dry-run. Antes de aplicar a 1000 registros, teste con 5.
Preguntas frecuentes
¿Cómo empezar a usar este módulo?
Configure los pre-requisitos listados arriba, haga un teste en ambiente seguro (o con pocos registros), valide con el equipo, y solo después active en producción.
¿Necesito permiso especial para acceder?
Sí. Cada rol (operador/supervisor/admin) tiene permisos distintos. Confirme con el administrador del Quaza.
¿Puedo integrar con sistemas externos?
Vía API REST del Quaza. Webhooks notifican eventos importantes. Consulte el equipo técnico para credenciales.
¿Qué pasa si hay error?
Los logs quedan en el panel de tareas/auditoría. Configure alertas (email/Slack) para fallas críticas — no confíe en nadie mirando log manualmente.
¿Cómo acompañar cambios?
Cada registro tiene histórico (timestamp, usuario, acción). Use el filtro de auditoría para rastrear modificaciones sospechosas.
¿El módulo funciona multi-filial?
Sí — vía centro de costo (filial) atribuido al asiento. Reportes filtran por filial.
Buenas prácticas operacionales
Esta sección reúne hábitos que proveedores experimentados adoptan para evitar problemas recurrentes en este módulo. Aplicación consistente hace diferencia grande en el largo plazo — diferencia entre operación caótica y operación previsible.
Revisión periódica
Reserve 30 minutos por semana para revisar el estado del módulo: lo que corrió, lo que falló, lo que quedó pendiente. Anomalía detectada temprano cuesta 10× menos que descubierta tarde.
Documentación de procedimientos
Cree checklists internos para operaciones recurrentes — apertura/cierre del mes, procesamiento en lote, corrección de inconsistencias. No dependa de quien "sabe de memoria" — funcionario puede salir, enfermar, tener día malo.
Backup antes de operaciones masivas
Cualquier cambio que afecte 100+ registros debe ser precedido de backup o export. Restaurar una alteración masiva equivocada es caro; prevenir es simple.
Comunicación con cliente
Cambios que impactan al cliente (precio, cobranza, regla) deben comunicarse con antelación. Cliente sorprendido reclama; cliente avisado entiende.
Indicadores acompañados
Defina 2-3 indicadores que miden la salud del módulo. Acompañe semanalmente. Cuando alguno sale del rango esperado, investigue antes de volverse problema visible.