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 Sales gestiona el ciclo comercial completo de un lote: desde la cotización informativa que el asesor comparte con el cliente, pasando por la reserva con monto fijo y fecha de vencimiento, hasta la venta formal con sus planes de financiamiento, flujo de firmas, estados de seguimiento y operaciones posventa (cancelación y traspaso de titular). El cálculo de amortización vive en Financing y la ejecución de los cobros en Collections; Sales es el punto de origen que alimenta a ambos módulos.

Cotización

Documento informativo para el cliente. No reserva el lote ni congela el precio.

Reserva

Aparta el lote con monto fijo y fecha de vencimiento elegida por el asesor.

Venta

Contrato con hasta 4 planes de financiamiento, estados y flujo de firmas.

​
Modelo de dominio

​
Cotización

La cotización es un instrumento informativo: permite al asesor simular cuotas y plazos con el cliente antes de comprometerse. No está vinculada a ninguna reserva ni a ninguna venta posterior, y no congela el precio del lote — si el precio sube después de cotizar, la cotización no protege el valor anterior.
La vigencia de la cotización se expresa en días y la define el asesor al crearla. Vencida la vigencia, el documento queda como histórico pero no genera ningún efecto sobre el lote. Crear una cotización consume cuota del recurso COTIZACIONES del plan SaaS del tenant.

​
Reserva

AtributoRegla
Monto del apartadoFijo (no porcentaje). El asesor captura el valor exacto.
Fecha de vencimientoEl asesor selecciona la fecha; el sistema no la calcula.
Efecto sobre el loteEl lote pasa de Activo a Reservado.
Efecto al vencerEl lote vuelve a Activo de forma automática (proceso diario). El monto del apartado se pierde — no se devuelve ni se abona.
Efecto en la ventaEl monto de la reserva se descuenta del total a financiar al crear la venta.
Crear una reserva consume cuota del recurso RESERVAS del plan SaaS.

​
Venta

La venta registra el contrato entre el cliente y la inmobiliaria. Sus campos principales son:
CampoDescripción
FolioIdentificador consecutivo generado por el sistema.
Gestor / AsesorUsuario que creó la venta.
ClienteContacto titular de la venta.
Tipo de ventaCrédito o contado (SaleType).
Contrato legalPlantilla seleccionada de LegalDocs.
ObservacionesTexto libre para notas internas.
Porcentaje de moraDefault = tasa de incumplimiento del proyecto; editable por venta.
Una venta puede incluir varios lotes mediante las tablas lotsInline / lotsBlock. La trazabilidad cliente-lote queda registrada en ClientLot, que preserva la historia reserva → venta.

​
Planes de financiamiento

Cada venta admite hasta cuatro planes de financiamiento simultáneos, cada uno con su propia tabla y los mismos atributos (PaymentByPeriod, PeriodInterest, InterestRate, ModalityId, número de cuotas, fecha de inicio, GracePeriod, IsSettled, banderas de aplicar interés / aplicar mora):
PlanSignificado
PrincipalFinanciamiento principal del monto remanente del lote.
Hitch (Enganche)Primer pago; puede configurarse como plan en cuotas.
AdditionalMonto adicional que se resta del total de la venta.
ServicePlanPlan de servicio, por ejemplo mantenimiento.
El RemainingAmount se calcula así: 
RemainingAmount = Precio del lote
                − Monto de reserva
                − Monto de enganche
                − Montos adicionales

Ejemplo:
  Precio del lote    = 100,000
  Reserva            =     500
  Enganche           =     500
  Adicional          =   1,000
  ─────────────────────────────
  RemainingAmount    =  98,000
El primer pago no puede ser menor al enganche definido en la venta. Sin embargo, es válido crear una venta a crédito sin enganche (C21) — en ese caso el saldo a financiar es el precio íntegro del lote.

​
Estados de la venta

EstadoSignificado
PendienteLa venta fue creada pero aún no tiene las firmas requeridas.
ConformeEl contrato tiene la firma del cliente y del usuario de alto nivel.
LiquidadoEl saldo de todos los planes llegó a cero; se habilita la hoja de liquidación.
AnuladoLa venta fue cancelada (puede haber cobros registrados).
Transiciones permitidas: 
Pendiente ──→ Conforme   (al completarse las firmas)
Conforme  ──→ Liquidado  (cuando Collections deja todos los saldos en cero)
Pendiente ──→ Anulado    (cancelación)
Conforme  ──→ Anulado    (cancelación, incluso con cobros ya aplicados)
Solo se pueden registrar cobros sobre ventas en estado Conforme. Las ventas Pendiente no aceptan cobros.

​
Flujos

1

HU-10 · Crear cotización

  1. El asesor captura el lote o monto de referencia, la modalidad, el número de cuotas y la tasa de interés.
  2. El sistema muestra la cuota calculada (usando el motor de Financing).
  3. El asesor ingresa la vigencia en días.
  4. El sistema genera el documento informativo. No reserva, no vende, no congela precio.
  5. Consume cuota del recurso COTIZACIONES del plan SaaS.
2

HU-11 · Reservar un lote

  1. El asesor selecciona un lote en estado Activo.
  2. Captura el monto fijo del apartado y la fecha de vencimiento.
  3. El lote pasa a estado Reservado.
  4. Consume cuota del recurso RESERVAS del plan SaaS.
3

HU-12 · Vencimiento de reserva

  1. Proceso automático diario: el sistema detecta reservas vencidas.
  2. El lote vuelve a estado Activo automáticamente.
  3. El monto del apartado se pierde — no se devuelve ni se abona al cliente.
  4. El registro histórico de la reserva se conserva.
4

HU-13 · Crear venta desde una reserva

  1. El asesor busca al cliente; el sistema localiza su reserva vigente, arrastra el lote y el monto. El front solo envía el ReservationId; el backend calcula los montos.
  2. Si no hay reserva: el asesor selecciona un lote Activo directamente.
  3. Se configuran los planes de financiamiento (Principal, Hitch, Additional, ServicePlan).
  4. Se selecciona la plantilla del contrato en LegalDocs; el detalle del flujo de firmas es responsabilidad del módulo LegalDocs.
  5. La venta nace en estado Pendiente y pasa a Conforme al completarse las firmas.
  6. El lote pasa a estado Vendido. Consume cuota del recurso VENTAS del plan SaaS.
5

HU-38 · Cancelar venta

  1. El usuario con el permiso protegido de eliminar ventas (o CEO / Admin) inicia la cancelación.
  2. Captura la razón de cancelación; el sistema solicita la contraseña de acción (RT-09 a RT-11).
  3. Efectos: el lote vuelve a Activo, el contrato queda anulado en el histórico, la venta pasa a Anulado.
  4. El dinero ya abonado no se devuelve. La operación es válida aunque la venta tenga cobros realizados.
6

HU-39 · Traspaso de titular

  1. El usuario con permiso de actualizar ventas ejecuta el traspaso al nuevo titular (contacto).
  2. No se genera contrato nuevo ni nuevas firmas. No hay costo para el cliente final.
  3. La amortización no se ve afectada.
  4. El historial de pagos queda reasignado al nuevo titular; deja de aparecer a nombre del anterior.
7

HU-40 · Cambio de fecha de pago

El cambio de fecha de la próxima cuota no requiere aprobación y no recalcula intereses. Solo mueve la fecha de vencimiento.
8

HU-41 · Editar enganche

El enganche solo puede modificarse desde el módulo de Ventas y únicamente si la venta no tiene cobros realizados. En cuanto se registra el primer cobro, este campo queda bloqueado; la única edición permitida con cobros es el traspaso de titular.

​
Reglas de negocio

ClaveRegla
RN-01La cotización es informativa: no se vincula a reserva/venta y no congela el precio.
RN-02Reserva con monto fijo; al vencer, liberación automática y anticipo perdido.
RN-03La venta desde reserva arrastra los datos; el monto lo calcula el backend (no el front).
RN-04Primer pago ≥ enganche definido; es válido crear una venta a crédito sin enganche (C21).
RN-05Estados: Pendiente → Conforme → Liquidado / Anulado, con las transiciones de la sección anterior.
RN-06Solo se cobra sobre ventas en estado Conforme.
RN-07Cancelación: razón + autorizacion protegida (o CEO/Admin); sin devolución; lote a Activo.
RN-08Traspaso: sin contrato nuevo, sin costo, historial reasignado al nuevo titular.
RN-09Cambio de fecha de pago sin aprobación ni recalculo de intereses.
RN-10El enganche solo se puede actualizar si la venta no tiene cobros realizados.
RN-11La tasa de mora es propia de la venta (default = tasa del proyecto, editable).
RN-12Multimoneda: la venta se pacta en una moneda; el cobro convierte al tipo de cambio del día del pago.

​
Matriz de permisos

Los permisos del módulo se agrupan bajo G. Comercial:
RecursoAcciones estándarAcciones protegidas
VentasLeer, Crear, ActualizarEliminar (requiere contraseña de acción)
CotizacionesLeer, Crear—
ReservasLeer, Crear, Actualizar—
La acción protegida “Eliminar ventas” requiere que el usuario ingrese su contraseña de sesión al momento de confirmar la cancelación (RT-09 a RT-11). Los usuarios CEO y Admin pueden cancelar sin ese permiso explícito.

​
Puntos abiertos

  1. Catálogo SaleType — Existe en el código v1, pero los valores exactos (crédito, contado, etc.) no están documentados formalmente. Confirmar con el equipo antes de implementar el seeder.
  2. Detalle del flujo de firmas en pantalla — Quién dispara el envío digital al cliente se especifica en el módulo LegalDocs; aquí solo se documenta el efecto sobre el estado de la venta.

Build docs developers (and LLMs) love

Get started for freeTalk to us