13 Carrito de Compras y Pedidos Múltiples por WhatsApp con Checkout Sistema SaaS Multi-Tenant
Duración: 10 minDescripción
🎓 Lección 13: Carrito de Compras y Pedidos Múltiples por WhatsApp en SaaS Multi-Tenant
Objetivo General: Implementar un sistema funcional de carrito de compras del lado del cliente en un entorno multi-inquilino (multi-tenant), permitiendo a los usuarios acumular productos, gestionar cantidades dinámicamente y procesar el checkout consolidado enviando el detalle completo del pedido directamente al WhatsApp de la tienda.
🚀 Pasos Clave con Timestamps
- 🛒 Estructuración e Interfaz del Carrito de Compras: Integración del componente visual y la gestión de estado local para acumular ítems seleccionados por el usuario en la tienda activa.⏱️ 01:15
- ➕ Añadir Productos y Modificar Cantidades: Desarrollo de las funciones JavaScript/Blade para incrementar, decrementar y eliminar artículos del carrito en tiempo real sin recargar la página.⏱ 04:30
- 🧮 Cálculo Dinámico de Subtotales y Total General: Sincronización automática de precios, cantidades y divisas tomadas desde los ajustes del tenant para reflejar el monto total exacto antes del checkout.⏱️ 08:10
- 📝 Captura de Datos del Cliente en el Checkout: Incorporación del formulario de checkout para registrar el nombre, dirección de entrega y notas adicionales del comprador.⏱️ 11:45
- 📲 Formateo y Envío del Pedido Consolidado a WhatsApp: Construcción automatizada de la plantilla de mensaje formateada con lista de productos, cantidades, total a pagar y datos del cliente orientada a la API de WhatsApp (wa.me).⏱️ 15:20
🛠️ Comandos y Rutas Principales
| Tipo | Comando / Ruta | Descripción |
|---|---|---|
| 💻 Terminal | php artisan make:controller Tenant/CarritoController | Crea el controlador para administrar las acciones del carrito y checkout del tenant. |
| 🌐 Ruta HTTP | GET /carrito | Renderiza la vista principal del carrito de compras (CarritoController@index). |
| 🌐 Ruta HTTP | POST /carrito/agregar | Endpoint o acción para procesar la adición de productos al carrito en sesión/almacenamiento local. |
| 🌐 Ruta HTTP | GET /checkout | Muestra el formulario final de confirmación de datos del pedido (CarritoController@checkout). |
🔒 Buenas Prácticas y Seguridad
- 💾 Persistencia Aislada por Tenant en Client-Side: Si utilizas localStorage para guardar el estado del carrito en el navegador, prefija las claves con el subdominio o ID del inquilino (ej. carrito_express_items) para evitar que los productos de una tienda se mezclen con los de otra.
- 🛡️ Validación Server-Side de Precios y Stock: No confíes únicamente en los montos calculados en el navegador. Al procesar o registrar pedidos, revalida siempre los precios unitarios y la disponibilidad de inventario desde la base de datos del tenant.
- 🔤 Codificación Correcta del Mensaje de WhatsApp: Aplica encodeURIComponent() en JavaScript o urlencode() en PHP para formatear saltos de línea (%0A), negritas (*) y caracteres especiales al construir la URL de redirección a WhatsApp API.
- 🚦 Control de Flujo en Carritos Vacíos: Deshabilita la acción de checkout e impide el envío del mensaje si el carrito no contiene artículos activos, mostrando mensajes de retroalimentación claros (empty state).