Plataforma de Cotización y Gestión de Tratos

1. Funcionalidad Principal

El objetivo es implementar una plataforma de cotización y gestión de tratos en un sitio web actual basado en WordPress. Se evaluará si se aprovecha el plugin existente o se desarrolla uno nuevo, integrando las siguientes funcionalidades:

- **Pantalla de Cotización:** 
  Un formulario en el que el usuario ingresa la información necesaria para solicitar una cotización.

- **Pantalla de Resultados:** 
  Tras enviar el formulario, el sistema se conectará con las APIs REST de 5 proveedores para obtener opciones de cotización. Se implementarán:
  - Manejo de errores y reintentos en caso de fallos en las llamadas.
  - Normalización de los datos recibidos (por ejemplo, unificar la forma de mostrar la información del producto).

- **Pantalla de Contratación:** 
  Un formulario adicional que, al completarse, actualizará información en un sistema CRM para gestionar el seguimiento de clientes y tratos.

---
2. Detalle del Formulario de Cotización

El formulario recopilará la información necesaria para la cotización, incluyendo datos identificativos y características del producto, de acuerdo a los requerimientos del negocio. 

**Validaciones y Comportamiento:**
- **Obligatoriedad:** 
  Todos los campos deben completarse; el sistema no permitirá enviar el formulario si falta alguno.

- **Validación Específica:** 
  Se validarán ciertos datos (como la información referente a marca, modelo y año) mediante una API – se planea utilizar la de uno de los proveedores – para asegurar que la información sea correcta. 
  - *Comportamiento ante errores:* El sistema impedirá avanzar y mostrará mensajes claros que indiquen qué información debe corregirse.

---
3. Integración con el CRM

- **Formulario de Cotización:** 
  Al completarse y enviarse, se creará automáticamente un **Contacto** y un **Trato** en el crm utilizando los datos ingresados, mediante conexión vía api.

- **Formulario de Contratación:** 
  Al completarse, se actualizarán campos en ambos módulos (Contacto y Trato) del crm, permitiendo el seguimiento y la actualización de la información ya registrada, también a través de la api.

*Nota:* La integración con el crm se realizará utilizando la documentación técnica disponible y se gestionará vía api.

---
4. Conectividad y Seguridad

- **Integración Backend:** 
  Toda la conectividad e integración con las APIs (de proveedores, CRM, etc.) Se realizará en el **backend** por cuestiones de seguridad.

---

## 5. Usabilidad y Accesibilidad

- **Responsive:** 
  La interfaz debe ser completamente responsive, garantizando un funcionamiento óptimo en dispositivos móviles y de escritorio.

- **Accesibilidad:** 
  Se recomienda evaluar la posibilidad de implementar estándares de accesibilidad (por ejemplo, siguiendo las pautas WCAG) que incluyan:
  - Compatibilidad con lectores de pantalla.
  - Navegación mediante teclado.

- **Usabilidad:** 
  La interfaz debe ser intuitiva y ofrecer:
  - Mensajes de error claros y precisos en caso de validación fallida.
  - Validaciones en tiempo real para guiar al usuario durante el llenado del formulario.
  - Una estructura lógica y ordenada que facilite la comprensión y el flujo del proceso.

---

## 6. Tecnología

- **Backend:** 
  - **Plataforma:** WordPress 
  - **Lenguaje:** PHP

- **Frontend:** 
  La tecnología a utilizar en el frontend es flexible, ya que se tratará de pocas pantallas. Se dará libertad al desarrollador para escoger la solución que mejor se ajuste a los requerimientos funcionales. 
  - **Importante:** La parte del diseño visual y estético será realizada por otra persona, por lo que el desarrollador se enfocará en la implementación de la funcionalidad, integraciones y validaciones.

- **Integraciones Externas:** 
  - **APIs REST:** Conexión con los 5 proveedores para obtener cotizaciones. 
  - **CRM:** Integración para la creación y actualización de Contactos y Tratos mediante API, siguiendo la documentación técnica correspondiente.


---

## 7. Consideraciones Técnicas.

- **Entorno de Desarrollo:** 
  Dado el volumen del proyecto en esta etapa, no se requiere configurar entornos separados (staging/producción) ni procesos continuos de integración. Si bien la integración continua es deseable, no es imprescindible para este proyecto inicial.