Desarrollo de Aplicación Web para Cotizaciones Autónomas

Catálogo FS es una aplicación web pública que permite a los clientes generar cotizaciones de forma autónoma, consultando el catálogo de productos en tiempo real a través de la API del sistema interno de ventas de la empresa. Catálogo FS opera como una aplicación web desplegada en hosting externo (VPS DigitalOcean, responsabilidad de la empresa) que se integra con el sistema interno de ventas mediante una API REST. El cliente nunca interactúa directamente con el sistema interno de la empresa. Flujo principal del usuario 1. El cliente accede a Catálogo FS desde su navegador. 2. Se autentica con usuario, contraseña y código MFA enviado por email. 3. Busca productos por nombre, código o categoría (consulta a API FS). 4. Agrega productos al carrito y ajusta cantidades. 5. Genera la cotización: la descarga en PDF o Excel y el sistema la envía automáticamente a FS. 6. Ferretería Santiago recibe la cotización en su sistema interno. Flujo Completo: Del Cliente al Gestor de Abastecimiento (Vendedor) Esta sección describe el ciclo de vida completo de una autocotización, desde que el cliente la genera en Catálogo FS hasta que el Gestor de Abastecimiento la procesa en el sistema de ventas para continuar el flujo de venta habitual. Descripción del flujo: ● El cliente construye su selección de productos en Catálogo FS y genera la autocotización. ● Catálogo FS envía la autocotización vía POST /api/cotizaciones al sistema de ventas interno de la empresa. ● El sistema de ventas interno inserta la autocotización en la tabla cabecera y el campo id (IDENTITY) se genera automáticamente. El sistema retorna ese número en la respuesta del POST. ● Catálogo FS recibe el número de autocotización y lo muestra al cliente en pantalla. Además, lo incluye de forma destacada en el documento PDF y Excel descargable, para que el cliente pueda referenciarlo al comunicarse con FS. ● Cuando el cliente decide comprar, genera una Orden de Compra (OC) dirigida a la empresa, referenciando el número de autocotización en el documento o en el correo electrónico que la acompaña. ● El Vendedor recibe la OC, extrae el número de autocotización y la consulta en el sistema de ventas mediante GET /api/cotizaciones/{id}. ● Desde el sistema de ventas , el vendedor activa el proceso sistémico que convierte la autocotización en una cotización formal en el sistema de ventas y genera la Nota de Pedido. ● El flujo normal de procesamiento de pedidos de la empresa continúa sin cambios desde este punto. 9.2 Contrato de la API: POST /api/cotizaciones Para que el flujo funcione correctamente, el endpoint de recepción de autocotizaciones en sistema de ventas debe cumplir el siguiente contrato: Campo Descripción Método POST /api/cotizaciones Autenticación API Key (Bearer token) provisto por FS a Catálogo FS Acción en sistema de ventas Inserta cabecera + líneas en la tabla cabecera. El id IDENTITY se genera automáticamente al insertar. Respuesta esperada HTTP 201 Created + { "id": 10047 } — el número IDENTITY generado por la BD Uso del número Catálogo FS lo muestra en pantalla y lo incluye prominentemente en el PDF y Excel descargable por el cliente Consulta por vendedor GET /api/cotizaciones/{id} — visible desde sistema de ventas para el vendedor, con autenticación interna

Project ID: 40554706