15 Gestión de Clientes Pedidos y Ventas con Control de Stock, Ticket en SaaS Multi-Tenant Laravel

Duración: 15 min
Módulo: Operaciones, Clientes, Control de Ventas e Inventario Lección 2 de 2

¡Contenido Exclusivo!

Adquiere este curso para tener acceso inmediato a esta y a **todas las lecciones Premium**.

Inscribirse Ahora por $10.00 Acceso instantáneo de por vida y código fuente incluido.

Descripción

🎓 Lección 15: Gestión de Clientes, Pedidos, Control de Stock y Generación de Tickets en Laravel SaaS Multi-Tenant

Objetivo General: Implementar el flujo completo de checkout público y administración interna para pedidos en cada tienda inquilina (tenant), incluyendo la actualización automatizada de inventario con reversión de stock, gestión del ciclo de vida de clientes y emisión de tickets térmicos imprimibles.

🚀 Pasos Clave con Timestamps

  • 📂 Estructura de Vistas y Rutas para Clientes y Pedidos: Revisión de las vistas Blade para la gestión de pedidos (index, show, imprimir) y clientes (index, show, edit), asociadas a sus respectivos controladores dentro del espacio de nombres Tenant.⏱️ 00:44
  • 🛑 Validación del Límite de Inventario en Tiempo Real: Demostración del comportamiento del selector de cantidad en el catálogo e-commerce, el cual impide al comprador superar las existencias disponibles de un producto.⏱️ 04:14
  • 📝 Registro del Checkout Público y Método firstOrCreate: Procesamiento del pedido público con storePublic, registrando o actualizando el cliente mediante su número de teléfono único y descontando las unidades compradas del stock.⏱️ 05:02
  • 🔔 Panel de Administración y Notificaciones de Pedidos: Recepción de nuevos pedidos en el panel de control del tenant con contadores dinámicos en tiempo real para estados pendientes.⏱️ 07:14
  • 🔄 Transición de Estados de Pedido (Pendiente ➔ En Proceso ➔ Completado): Actualización interactiva del flujo de trabajo del pedido e integración de notificaciones al cliente vía WhatsApp.⏱️ 08:34
  • 🧾 Generación de Ticket Comprobante Térmico: Renderizado de la vista optimizada para impresión en formato pos-ticket de 80mm/58mm con detalles del cliente y los productos adquiridos.⏱️ 09:53
  • ↺ Reversión Automática e Integridad de Stock al Cancelar/Eliminar: Mecanismo en las acciones update y destroy que reabastece las unidades descontadas al catálogo cuando un pedido es anulado o eliminado.⏱️ 12:42

🛠️ Comandos y Rutas Principales

TipoComando / RutaDescripción
💻 Artisanphp artisan make:controller Tenant/PedidoControllerGenera el controlador principal para la gestión de ventas, stock y tickets.
💻 Artisanphp artisan make:controller Tenant/ClienteControllerGenera el controlador para el expediente y ciclo de vida de los clientes.
🌐 Ruta HTTPPOST /pedido/publicoProcesa el checkout del cliente, crea/actualiza el perfil y descuenta stock (PedidoController@storePublic).
🌐 Ruta HTTPGET /pedidos/{id}/imprimirGenera la vista optimizada para impresión de ticket de caja (PedidoController@imprimir).
🌐 Ruta HTTPPUT /pedidos/{id}/estadoActualiza el estado funcional del pedido (PedidoController@updateStatus).

🔒 Buenas Prácticas y Seguridad

  1. ⚛️ Transacciones de Base de Datos Atomic (DB::transaction): Encapsula el registro del pedido, la inserción de los detalles y el descuento de stock dentro de una transacción (DB::beginTransaction()). Si falla el descuento de inventario, la venta completa se revierte sin dejar estados inconsistentes.
  2. 🔄 Reversión Garantizada de Stock (Stock Rollback): Al cancelar o eliminar un pedido previamente registrado, asegúrate de devolver las cantidades exactas al stock del producto mediante operaciones incrementales atómicas ($producto->increment('stock', $cantidad)).
  3. 📱 Identificación de Cliente por firstOrCreate con Teléfono Sanitizado: Utiliza el número de teléfono limpio como clave natural para consolidar el historial de compra y métricas de consumo de cada usuario sin forzar registros con contraseña.
  4. 📄 Estilos CSS Optimizados para Impresión Térmica (@media print): Diseña la vista del ticket con reglas @page { size: auto; margin: 0mm; } para asegurar una salida gráfica impecable en impresoras térmicas de 58mm u 80mm sin cabeceras web no deseadas.