Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/DevCarlosRodriguez/Documentacion-Arccnova-2.0/llms.txt

Use this file to discover all available pages before exploring further.

El módulo Reports expone los datos de todos los módulos como reportes operativos descargables. Los reportes se generan al momento de la descarga con los datos actuales del sistema —no se almacenan como archivos— y cubren cuatro áreas: comportamiento de ventas y cartera, flujo real de efectivo, inventario de lotes y directorio de contactos. El backend entrega los datos (filtros, agrupaciones, totales) y el frontend renderiza el documento (patrón RT-29 para documentos operativos). La carta de cobranza sigue esta misma arquitectura dado su carácter de comunicación preventiva.

Categorías de reportes

13 reportes descargables en PDF sobre contratos y cartera de clientes.
ReporteDescripción
Resumen de ventasTotales por estado de venta con agrupación configurable
Detalle de ventasDesglose por venta con planes de financiamiento
Ventas por vendedorProducción individual de cada asesor
Cuotas por cobrarCon semáforo de cobranza por vencimiento
Créditos por cobrarSaldo pendiente por contrato de crédito
Ventas completadasContratos liquidados en el período
Ventas anuladasContratos cancelados con motivo
Ventas por clienteHistorial de compras por persona
Recibos por clienteComprobantes emitidos por cliente
Pagos por clienteMovimientos de cobro por cliente
Vouchers por ventaDetalle de cada pago aplicado a una venta
ContratosListado de contratos generados (Sales / LegalDocs)
Carta de cobranzaVer sección específica más abajo
Filtros compartidos: manzana, tipo de venta, vendedor y rango de fechas.

Carta de cobranza

La carta de cobranza es un documento de carácter extrajudicial preventivo; por sí misma no tiene fuerza ejecutiva. Su generación es manual —cuando el usuario lo decide— y su estructura es fija.
  1. Membrete dinámico de la empresa (logo, nombre, datos de contacto).
  2. Caja destacada: MONTO ADEUDADO: {Total adeudado} en formato moneda.
  3. Destinatario: SEÑOR/A: {Nombre del cliente} + bloque de dirección.
  4. Saludo: De nuestra consideración:
  5. Párrafo de aviso: informa que el cliente mantiene cuotas pendientes de su(s) contrato(s) celebrado(s) con {Nombre de la empresa}.
  6. Tabla de contratos: columnas CONTRATO, LOTE/MANZANA, CUOTAS PENDIENTES, MONTO POR CUOTA, TOTAL ADEUDADO (una fila por venta/contrato del cliente).
  7. Total acumulado: El total acumulado adeudado asciende a {Total}.
  8. Plazo: regularizar dentro de 15 días naturales desde la recepción.
  9. Apercibimiento: de no pagar, la empresa podrá iniciar la resolución del contrato, con pérdida de las cantidades abonadas y del derecho sobre el predio.
  10. Dirección de la empresa (alineada a la derecha).
  11. Nota al pie: Esta comunicación tiene carácter preventivo. La empresa se reserva el derecho de iniciar acciones sin previo aviso.
La carta de cobranza no se dispara automáticamente por número de cuotas vencidas. La rescisión del contrato es una decisión administrativa de la inmobiliaria, fuera del sistema (C31). El comprobante de pago automático es un documento distinto que emite Collections.

Patrón de generación (RT-29)

Los reportes operativos siguen el patrón RT-29: el backend expone los datos (filtros, agrupaciones, totales pre-calculados) y el frontend construye y renderiza el documento para descarga. Los reportes no se almacenan como archivos en el servidor; cada descarga genera el documento con datos frescos.
Usuario solicita descarga


Frontend → GET /api/reports/{tipo}?filtros=...


Backend devuelve dataset (JSON con totales y filas)


Frontend renderiza PDF o Excel y dispara descarga
Los montos en los reportes son multimoneda sin conversión a moneda base (C43). Si una venta está pactada en dólares y otra en pesos, los reportes muestran cada monto en su moneda original.

Matriz de permisos

El módulo de Reportes tiene un esquema de permisos simplificado: un permiso único por reporte. No hay permisos separados por botón o acción.
PermisoDescripción
reports.viewVer el módulo y descargar todos los reportes (C48, RT-06)
Ver es descargar. Quien tiene acceso al módulo puede descargar. No existe un permiso de “solo vista sin descarga”.

Fase de construcción y dependencias

Reports es la Fase 5 en el orden de construcción. Cada reporte se habilita conforme su módulo de datos esté disponible. Un reporte de ventas no puede existir sin que Sales esté construido; un reporte de caja no puede existir sin Collections y Treasury.

Fuente: Sales / LegalDocs

Reportes de ventas, contratos, ventas por vendedor, anuladas, completadas.

Fuente: Collections

Cuotas por cobrar, créditos, pagos por cliente, carta de cobranza.

Fuente: Collections + Treasury

Corte de caja, ingresos, gastos, banco/caja, recibos financieros.

Fuente: Contacts / Properties

Directorio de clientes y prospectos, exportaciones masivas, reporte de lotes.

Reportes de RH (R21)

Los reportes de Recursos Humanos (plantilla de empleados con incidencias, corridas de nómina cerradas, nóminas abiertas, asistencia del período, licencias y catálogos de estructura) son consultas sobre el modelo de Hr sin tablas nuevas en el módulo de Reports. Se habilitan conforme los contextos de Hr estén modelados. Los reportes de incidencias y licencias dependen de que esos contextos estén completamente definidos (R10, R12).

Build docs developers (and LLMs) love