nuevo registro de Oportunidad y mejora en Configuracion comprobante fiscal

src/docs/electronic-billing/configuration.md

@@ -57,4 +57,233 @@ Cada tipo de documento fiscal que se utilice para generar un CFE (facturas, nota
 
 ::: warning
 Importante: Solo debe existir un tipo de documento fiscal por instancia. No se deben definir diferentes tipos por organización.
-:::
+:::
+
+
+## 1. Introducción
+
+La facturación electrónica permite emitir comprobantes fiscales electrónicos (CFE) desde el sistema, cumpliendo con los requisitos de la DGI y utilizando un proveedor fiscal (Invoicy u otro).
+Este documento detalla:
+
+* Las configuraciones previas necesarias.
+
+* Qué datos son responsabilidad del usuario final.
+
+* El flujo operativo para emitir facturas electrónicas.
+
+* Las validaciones posteriores y controles de errores.
+
+* Consideraciones especiales para Notas de Crédito.
+
+El objetivo es que el usuario pueda comprender el proceso completo y validar la correcta emisión de un CFE sin depender del área técnica, salvo en las configuraciones iniciales.
+
+## 2. Objetivo
+
+Asegurar que el usuario final conozca:
+
+* Qué configuraciones debe verificar antes de emitir un comprobante electrónico.
+
+* Cómo generar una factura electrónica desde el sistema.
+
+* Cómo controlar el estado del envío, errores y rechazos.
+
+* Cómo emitir correctamente una Nota de Crédito electrónica, incluyendo su referencia obligatoria.
+
+## 3. Alcance
+
+Este documento aplica a:
+
+* Facturación electrónica en Uruguay.
+
+* Comprobantes de venta: E-Factura, E-Ticket, E-Nota de Crédito.
+
+* Emisiones individuales o masivas desde los procesos del sistema.
+
+* Validación de CFE enviados mediante proveedor fiscal.
+
+
+## 4. Configuraciones Previas
+
+### 4.1 Configuraciones realizadas por Soporte o Consultor
+
+Estas configuraciones no son responsabilidad del usuario. Están a cargo del área técnica y se dejan establecidas antes de iniciar operación:
+
+**a. Tipo de Documento**
+
+* Definición de documentos electrónicos: E-Factura, E-Ticket, E-Nota de Crédito.
+
+* Marcado del documento como “maneja facturación electrónica”.
+
+* Definición del comportamiento: envío automático al completar.
+
+* Seteo de secuencias, numeración y reglas fiscales.
+
+**b. Proveedor Fiscal / Servidor**
+
+* Configuración de la organización con el proveedor fiscal (Invoicy).
+
+* Certificados, tokens o credenciales de comunicación.
+
+* Parámetros de entorno y URLs de servicios.
+
+**c. Comportamientos fiscales por país**
+
+* Tipificación de CFE según normativa nacional.
+
+* Comportamiento específico según RUT o Cédula.
+
+* El usuario no debe modificar estas configuraciones para evitar inconsistencias.
+
+## 5. Configuraciones Responsabilidad del Usuario
+
+Estas configuraciones deben revisarse cada vez que se crea o modifica un Socio de Negocio.
+
+### 5.1 Datos del Socio de Negocio
+
+En la ventana de Socio de Negocio validar:
+
+**a. Identificación Grupo de Impuesto**
+
+El Grupo de impuestos asociado al socio del negocio define el Tipo de documento fiscal electrónico que se utilizará en el envío a la entidad fiscal.
+
+* Si es RUT → generará E-Factura.
+
+* Si es Cédula → generará E-Ticket.
+
+* Tasa IVA
+
+* Tratamientos especiales
+
+Validar que el número de identificaciòn RUT esté correctamente ingresado y sin errores de formato.
+
+::: note
+Esto determina cómo se calcularán los impuestos en el CFE enviado a la DGI.
+:::
+
+**5.2 Validaciones previas del documento**
+
+Previo a completar la factura:
+
+* Revisar que los ítems tengan impuestos correctos.
+
+* Verificar que el tipo de documento seleccionado sea el correspondiente (E-Factura, E-Ticket, NC).
+
+* En caso de Nota de Crédito, asegurarse de generarla usando “Crear Desde” para arrastrar la referencia obligatoria.
+
+## 6. Flujo General de Emisión de Factura Electrónica
+
+**Paso 1: Crear la Factura**
+
+Crear Documentos por Cobrar:
+
+* Crear una factura manualmente (desde ventana DOcumentos por Cobrar).
+
+* Generar una factura desde un proceso masivo o navegador.
+
+**Paso 2: Completar la Factura**
+
+Al completar:
+
+* El sistema envía automáticamente el CFE al proveedor fiscal, según la configuración del tipo de documento.
+
+* Se genera un registro en la solapa Bitácora de Documentos Electrónicos.
+
+**Paso 3: Validar Bitácora de Documentos Electrónicos**
+
+En esta solapa se visualiza:
+
+* Estado del envío (pendiente, enviado, rechazado, aceptado).
+
+* Mensajes de error o rechazo.
+
+* URL del comprobante electrónico.
+
+* Representación gráfica (PDF).
+
+* Identificadores fiscales (CAE, número fiscal, etc.).
+
+::: note
+Si hubo error, debe corregirse la causa y reenviarse el comprobante.
+:::
+
+**Paso 4: Recepción de Respuesta del Proveedor Fiscal**
+
+El sistema actualiza el estado de forma automática.
+Si el comprobante queda en:
+
+* Firmado → se envió ok.
+
+* Rechazado → debe revisarse mensaje y corregirse.
+
+## 7. Emisión de Nota de Crédito Electrónica
+
+**7.1 Cómo generar una Nota de Crédito válida**
+
+Siempre realizar la NC con la función:
+
+* Crear Desde → Facturas
+
+Esto garantiza que:
+
+* El documento quede vinculado a la factura original.
+
+* Se genere la referencia obligatoria para DGI.
+
+* Se arrastren montos e ítems correctamente.
+
+**7.2 Validación de la relación con la factura**
+
+En la solapa Facturas a Asignar validar:
+
+* Que la factura referenciada esté correcta.
+
+* Si se genera manualmente sin “Crear Desde”, se debe completar esta solapa de forma manual.
+
+## 8. Validaciones Posteriores y Controles
+
+**8.1 Bitácora de Documentos Electrónicos**
+
+Control central del estado del CFE.
+
+Verificar:
+
+* Si está firmado.
+
+* Si fue aceptado/rechazado.
+
+* Mensaje del proveedor.
+
+* Datos de la representación gráfica generada.
+
+**8.2 Errores Comunes**
+
+| Error común                               | Causa probable	                          |  Solución                            |
+| ----------------------------------------- | ------------------------------------------- | ------------------------------------ |
+|    Documento rechazado por RUT inválido   |   Mal ingreso en socio de negocio	          |   Corregir identificación y reenviar |
+| Falta de referencia en Nota de Crédito    |	No se utilizó “Crear Desde”	              |   Completar dato Factura a Asignar   |
+| No hay ninguna CAE para tipo documento    |  Se usó último CFE o está vencido           | Solicitar a DGI nuevo CAE del Tip Doc|
+
+
+## *9. Resultado Esperado del Proceso
+
+Una vez completada la factura:
+
+* El sistema envía el comprobante al proveedor fiscal.
+
+* El proveedor valida y devuelve estado (la devoluciòn se ve en Invoicy en caso de rechazo o autorizado, en Solop ERP, solapa bitácora de documentos electrónicos la comunicación es solo de ida).
+
+* La bitácora muestra el CFE como firmado.
+
+* El PDF fiscal queda disponible.
+
+* El comprobante queda autorizado ante DGI (puede verse este estado en Invoicy)
+
+## 10. Observaciones Finales
+
+* El usuario solo debe revisar los datos del socio y emitir los comprobantes.
+
+* Ninguna configuración fiscal avanzada debería ser modificada por el usuario.
+
+* Siempre verificar la bitácora ante cualquier duda.
+
+* Toda Nota de Crédito debe tener referencia obligatoria.

src/docs/sales-management/README.md

@@ -33,5 +33,6 @@ Esta documentación está destinada a definir cada uno de los procedimientos par
 
 - [Orden de Venta](sales-orders/order)
 - [Propuesta](sales-orders/proposal)
+- [Oportunidades](sales-orders/opportunities)
 - [Tipos de Documentos](sales-orders/document-type)
 - [Reportes de Órdenes](../purchase-management/order-reports)

src/docs/sales-management/sales-orders/README.md

@@ -10,5 +10,6 @@ Esta documentación está destinada a definir cada uno de los procedimientos par
 
 - [Orden de Venta](order)
 - [Propuesta](proposal)
+- [Oportunidades](opportunities)
 - [Tipos de Documentos](document-type)
 - [Reportes de Órdenes](../../purchase-management/order-reports)

src/docs/sales-management/sales-orders/opportunities.md

@@ -0,0 +1,140 @@
+---
+title: Oportunidades
+category: Documentation
+star: 9
+sticky: 9
+article: false
+---
+
+La ventana "Oportunidad" permite registrar y gestionar potenciales ventas futuras con clientes actuales o prospectos. Su objetivo es organizar, planificar y hacer seguimiento de acciones comerciales que puedan derivar en una venta efectiva.
+
+## 🔹 1. ¿Qué es una oportunidad?
+
+Una Oportunidad representa una posibilidad concreta de venta vinculada a un cliente o prospecto. Pueden crearse múltiples oportunidades por cliente, y se utilizan para:
+
+* Planificar y registrar tareas comerciales (llamadas, reuniones, correos, presentaciones).
+
+* Establecer el avance y seguimiento de una potencial venta.
+
+* Generar cotizaciones, orden de venta y proyectos.
+
+## 🔹 2. Alta de una Oportunidad
+
+Para crear una nueva oportunidad se requiere completar los siguientes campos:
+
+* Número de Oportunidad (generado automáticamente o manualmente).
+
+* Cliente: puede ser un cliente registrado o un prospecto (Lead).
+
+* Nombre/Descripción de la oportunidad.
+
+* Usuario asignado / Vendedor.
+
+* Comentarios adicionales.
+
+* Importe estimado de la oportunidad.
+
+* Fecha estimada de cierre (obligatoria).
+
+* Moneda (selección manual).
+
+* Campaña (opcional, permite vincular a campañas de marketing/comercialización activas).
+
+* Contactos del cliente (personas de contacto relevantes).
+
+![Campo](/assets/img/docs/sales-management/sam-sales-image519.png)
+
+## 🔹 3. Actividades y seguimiento
+
+Desde la pestaña Actividades se pueden planificar y registrar acciones comerciales:
+
+* Tipo de solicitud: llamada, correo, reunión, presentación, etc.
+
+* Tema y descripción de la tarea.
+
+* Usuario asignado.
+
+* Fecha de vencimiento.
+
+Estas tareas pueden verse tanto en la pestaña Actividades como en el listado general de solicitudes. Próximamente se incorporará una lista desplegable de acciones rápidas (llamada, correo, etc.).
+
+![Campo](/assets/img/docs/sales-management/sam-sales-image520.png)
+
+## 🔹 4. Etapas de la oportunidad (Embudo de ventas)
+
+Cada oportunidad puede configurarse con una etapa de avance dentro del proceso comercial. Estas etapas permiten:
+
+* Visualizar el Embudo de Ventas.
+
+* Controlar el estado de madurez de cada oportunidad.
+
+::: warning
+⚠️ Observación: Actualmente el orden de etapas no sigue una lógica cronológica. Se recomienda organizar las etapas desde configuración o gestionar una mejora (issue) para permitir drag & drop y orden personalizado.
+También es posible visualizar el embudo agrupado por agente de ventas.
+:::
+
+![Campo](/assets/img/docs/sales-management/sam-sales-image521.png)
+
+## 🔹 5. Creación de Cotizaciones
+
+Cada oportunidad puede generar una o más cotizaciones:
+Accedé a la opción "Crear Cotización".
+
+Seleccioná:
+
+* Tipo de documento: Cotización.
+
+* Almacén (a definir por defecto).
+
+* Lista de precios (a definir por defecto).
+
+* Términos de pago y condiciones.
+
+* Generá la cotización.
+
+::: note
+⚠️ Nota: Actualmente, solo se permite una cotización por oportunidad. Esto será modificado, ya que debe ser posible tener múltiples cotizaciones. También debe habilitarse una visualización clara de todas las cotizaciones vinculadas (fecha, estado, importe).
+:::
+
+![Campo](/assets/img/docs/sales-management/sam-sales-image522.png)
+
+## 🔹 6. Asignación de Recursos
+
+Dentro de cada cotización se pueden agregar recursos (por ejemplo: carteles, pantallas, soportes):
+Definí:
+
+* Tipo de recurso.
+
+* Desde / Hasta (fechas de duración del servicio).
+
+* Cantidad y unidad de medida.
+
+* Los recursos se agrupan en la pestaña "Asignación de Recursos".
+
+::: warning
+⚠️ Importante:
+Actualmente no se calcula automáticamente la cantidad total según fechas o unidades. Esto debe hacerse manualmente.
+:::
+
+* Se sugiere que los recursos se documenten como "tipo de recurso" + cantidad, en lugar de "recurso individual", para evitar errores de interpretación.
+
+![Campo](/assets/img/docs/sales-management/sam-sales-image523.png)
+
+## 🔹 7. Cierre de la oportunidad y creación de proyecto
+
+Una vez seleccionada la cotización ganadora, se puede proceder a:
+
+* Cerrar la oportunidad (marcar como "Cerrada - Ganada").
+
+Luego, utilizar la acción "Crear Proyecto" desde la cotización ganadora.
+
+::: warning
+⚠️ No debe permitirse la creación de proyecto si la oportunidad no está cerrada como "Ganada". Se recomienda revisar esta lógica y automatizar el cierre al momento de crear el proyecto.
+:::
+
+![Campo](/assets/img/docs/sales-management/sam-sales-image524.png)
+
+![Campo](/assets/img/docs/sales-management/sam-sales-image525.png)
+
+## ✅ Conclusión
+La funcionalidad Oportunidades - Vía Pública permite organizar el proceso comercial de forma estructurada, desde el primer contacto hasta la creación del proyecto final, incluyendo cotizaciones, actividades y recursos. Es clave seguir los pasos correctamente para mantener la trazabilidad del proceso y asegurar una gestión eficiente.