Flujo Comercial — Proceso Principal

Módulo: CRM / Comercialización
Tipo: process
Estado: planificado
Fecha: 2026-03-18

---

Descripción

Proceso que modela el ciclo de vida comercial desde el registro de la oportunidad hasta la generación de los documentos de Producción y Venta. Toda oportunidad se registra como un registro CRM Comercial, independientemente de su origen. Si proviene de una licitación, se marca con los flags es_licitacion y opcionalmente tiene_poliza dentro del mismo registro CRM.

---

Diagrama del proceso

flowchart LR
    Inicio([Inicio]) --> RegistroCRM[Registrar CRM<br/>Comercial]

    RegistroCRM --> Flags["Marcar flags:<br/>es_licitacion?<br/>tiene_poliza?"]
    Flags --> VentaConcretada{"Venta<br/>Concretada?"}

    VentaConcretada -->|No| SeguimientoLlamada{"Seguimiento<br/>Llamada?"}
    VentaConcretada -->|Si| ConfirmaNota[Confirmar Nota de Pedido]

    SeguimientoLlamada -->|Si| RegistroCRM
    SeguimientoLlamada -->|No| Fin([Fin])

    ConfirmaNota --> PedidoProduccion[Pedido a Produccion]
    ConfirmaNota --> NotaVenta[["NV creada automáticamente"]]

    PedidoProduccion -.-> DocPedido[Doc: Pedido a Produccion]
    NotaVenta -.-> DocNota[Doc: Nota de Venta]

    DocPedido -.-> A1([A1 Produccion])
    DocNota -.-> A2([A2 Administracion])

---

Registro de la oportunidad

Toda oportunidad comercial se registra como un registro CRM Comercial (extensión tipo comercial). Al crear el registro, se marcan los flags según corresponda:

Flag	Default	Cuándo marcar
es_licitacion	false	Cuando la oportunidad proviene de una convocatoria formal de licitación
tiene_poliza	false	Cuando la operación cuenta con póliza de seguro de garantía (solo aplica si es_licitacion = true)

Pasos:

1. Registrar CRM Comercial → ver extension-comercial
2. Marcar flags es_licitacion y tiene_poliza según corresponda → ver licitacion-resource, poliza-seguro-resource
3. Continúa en ¿Venta Concretada?

Modelo futuro: Los datos detallados de licitación (número, fechas, montos, estados) y de póliza (aseguradora, vigencia, cancelación) se vincularán como entidades relacionadas al CRM en una etapa posterior. Ver licitacion-resource.

---

Decisiones del proceso

¿Venta Concretada?

Resultado	Siguiente paso
Sí	Confirmar Nota de Pedido
No	¿Seguimiento Llamada?

¿Seguimiento Llamada?

Resultado	Siguiente paso
Sí	Vuelve a Registrar CRM Comercial (iteración)
No	Fin del proceso

---

Camino de venta exitosa

Cuando la venta se concreta:

1. Confirmar Nota de Pedido — el usuario CRM comercial (la persona asignada al tipo comercial del CRM) confirma el pedido antes de enviarlo a producción. El flag es_licitacion del CRM de origen se propaga automáticamente a la Nota de Pedido y Nota de Venta.

Nota de Venta (documento central): Al confirmar la Nota de Pedido, el sistema genera automáticamente la Nota de Venta con estado pedido_confirmado. No es una acción manual del comercial. Esta NV acompañará todo el flujo hasta la facturación y cobro, siendo actualizada por Producción, Administración y Tesorería. Ver: nota-venta-resource

2. Pedido a Producción — se genera el pedido para el área de producción.
   • Genera Doc: Pedido a Producción → deriva a A1 Producción
3. Nota de Venta generada automáticamente — al confirmar la Nota de Pedido, el sistema crea automáticamente la Nota de Venta con estado pedido_confirmado. El comercial accede a ella desde la card 'Nota de Venta' en Tab 2 del registro CRM para ver o editar sus datos.
   • Genera Doc: Nota de Venta → deriva a A2 Administración

Los documentos A1 y A2 son independientes y se generan en sus respectivos pasos.

Documentos ISO generados al confirmar la venta

Al confirmar la Nota de Pedido, el sistema genera para impresión dos documentos ISO:

Documento	Propósito
Confirmación de Nota de Pedido	Confirma la orden de venta al cliente
Pedido a Producción	Orden de producción para el área de fabricación

Ambos son documentos impresos generados por el sistema (informes/reportes), no documentos manuales externos. Son parte de los entregables del paso de confirmación de venta.

Diagrama de secuencia: venta exitosa

sequenceDiagram
    actor Comercial
    participant CRM as CRM Comercial
    participant NP as Nota de Pedido
    participant NV as Nota de Venta
    participant Prod as Produccion
    participant Admin as Administracion
    participant Sistema

    Comercial->>CRM: Registrar oportunidad
    Note over CRM: flags: es_licitacion, tiene_poliza
    Comercial->>CRM: Evaluar: venta concretada?

    alt Venta concretada
        Comercial->>NP: Confirmar Nota de Pedido
        Note over NP: modalidad A/B/C/D<br/>bonificaciones<br/>forma de pago
        Sistema->>NP: Generar Conf NP (RE-COM003) rev.01
        Sistema->>NV: Crear NV automáticamente (estado: pedido_confirmado)
        Sistema->>NV: Generar NV (RE-COM004) rev.01
        Sistema->>Prod: Doc A1: Pedido a Produccion
        Sistema->>Admin: Doc A2: Nota de Venta
        Sistema-->>Comercial: Email a facturacion
        Sistema-->>Comercial: Email a comisiones

        opt Modificacion post-confirmacion
            Comercial->>NP: Modificar datos
            Sistema->>NP: Nueva revision (rev.02)
            Sistema->>Prod: Reimprime Pedido + email cambios
            Sistema->>NV: Actualiza si impacta datos financieros
        end
    else No concretada
        Comercial->>CRM: Seguimiento o cierre
    end

---

Documentos generados

Documento	Paso origen	Destino	Referencia
Doc: Pedido a Producción	Pedido a Producción	A1 Producción	flujo-produccion-process
Doc: Nota de Venta	Confirmación de Nota de Pedido (automático)	A2 Administración	nota-venta-desde-crm-process

Camino sin fabricación: Cuando la Nota de Venta no requiere fabricación (stock disponible, servicio, etc.), el Doc A2 va directamente a Administración sin pasar por Producción. La NV pasa de pedido_confirmado directo al flujo de Administración, sin los estados intermedios de Producción.

---

Reglas de negocio

• [x] TBD: ¿La Nota de Pedido puede confirmarse sin póliza vigente cuando es_licitacion=true? Resuelto: Sí, permitir confirmar sin póliza. Luego se puede agregar o relacionar la póliza cuando exista.
• [x] TBD: ¿El Aviso de Cancelar Póliza requiere acción manual o es automático? Resuelto — DESCARTADA/DIFERIDA: Por el momento solo se marcan flags es_licitacion y tiene_poliza en el CRM. No se profundizará en el tratamiento de estos datos en esta etapa.
• [x] TBD: ¿El origen se bifurca en dos caminos (Licitación vs Llamada)? Resuelto: No. Todo se unifica en un registro CRM Comercial. Si proviene de licitación, se marca con flag. El modelo detallado de licitación queda como anexo futuro.
• [x] TBD: ¿Cuántos seguimientos de llamada se permiten antes de forzar cierre? Resuelto: Parámetro configurable (no hardcodeado). La cantidad máxima de seguimientos se define por configuración.
• [x] TBD: ¿La Nota de Pedido y el Pedido a Producción son el mismo documento o dos distintos? Resuelto: Son dos documentos ISO distintos generados por el sistema. La Confirmación de Nota de Pedido confirma la orden de venta. El Pedido a Producción es la orden de producción.
• [x] Modificaciones post-confirmación: ¿Quién puede modificar el pedido después de confirmado y cómo se notifica a Producción? Resuelto: Solo el vendedor original o Administracion pueden modificar un pedido confirmado. Produccion NO tiene permisos de modificacion. Tras modificar, el sistema debe reimprimir el Pedido a Produccion y enviar email a Produccion detallando los cambios. Los documentos ISO (Nota de Venta, Confirmacion de NP, Pedido a Produccion) deben imprimirse para cumplir con la norma ISO. El sistema debe enforcar estos permisos (no es solo procedimiento operativo).
  • Fuente: "Modificaciones Luego de Analizar el DFD.docx", definiciones del cliente
• [x] Rol de Produccion en modificaciones: ¿Produccion es pasiva (solo recibe doc corregido + email) o puede hacer ajustes operativos propios? Resuelto: Produccion es actor pasivo: solo recibe el documento corregido + email de notificacion. No realiza ajustes operativos propios. El modelado actual en flujo-produccion-process.md donde Produccion modifica con versionado NO aplica y debe corregirse.
  • Fuente: "Modificaciones Luego de Analizar el DFD.docx", definiciones del cliente

---

Estados del proceso

Estado	Descripción
en_seguimiento	El proceso está activo, esperando concreción de venta
perdido	El registro CRM no derivó en venta
concretado	La venta fue confirmada, documentos generados
cancelado	Se cerró sin seguimiento

---

Casos de uso

Actor	Acción
Comercial	Registra oportunidad como CRM Comercial (con flags es_licitacion/tiene_poliza según corresponda)
Comercial	Evalúa si la venta se concretó
Comercial	Confirma la nota de pedido (el sistema crea la NV automáticamente en este paso)
Sistema	Genera Doc: Pedido a Producción al completar el paso
Sistema	Genera Doc: Nota de Venta automáticamente al confirmar la Nota de Pedido
Comercial/Admin	Modifica NP o NV post-confirmacion → genera nueva revision + reimprime documentos afectados + email
Producción	Recibe Doc A1 (ver A1 Producción)
Administración	Recibe Doc A2 (ver A2 Administración)