Órdenes y pedidos
Dos tipos de órdenes
El sistema maneja dos tipos de órdenes, cada una con su propio endpoint de creación:
Orden de reserva
Generada desde el carrito cuando contiene items reservables (experiencias, estadías).
POST /api/ordenes
Orden de pedido
Generada desde el carrito cuando contiene productos de catálogo (tienda, café) o desde WhatsApp.
POST /api/pedido o /api/ordenes
Estructura de una orden
codigo: identificador único (ej: ORD-XXXXXXXX)
estado: pendiente_pago | pagado | completado | cancelado
cliente: nombre, email, teléfono, origen
reservas: array de reservas generadas (si aplica)
precio_total: suma de todos los items
moneda: COP
checkout_url: URL de pago Bold (si aplica)
metadata.items: items de pedido (para órdenes de catálogo)
Flujo de orden desde el carrito
- El cliente hace checkout desde el carrito unificado.
- El endpoint
POST /api/ordenesrecibe los items del carrito y datos del cliente. - Se busca o crea el cliente en Strapi (por email o teléfono).
- Para cada item reservable, se crea una reserva individual (ocupando slot o rango).
- Para cada item de pedido (catálogo), se guarda en
metadata.items. - Se calcula el precio total.
- Si hay items que requieren pago online, se genera un payment intent en Bold.
- Se retorna el código de orden, estado, total y checkout_url.
Flujo de pedido por WhatsApp
- El cliente envía su pedido por WhatsApp.
- El equipo registra el pedido vía
POST /api/pedido. - Se crea la orden con los items del pedido (nombre, precio, cantidad).
- La orden nace en estado "pendiente_pago" sin pasarela de pago (el pago se coordina por WhatsApp).
- Las notas del pedido pueden incluir dirección de entrega.
Gestión de órdenes desde el panel
Desde el panel administrativo en /ordenes puedes:
- Ver todas las órdenes con filtros por estado.
- Ver detalle de una orden (items, cliente, reservas vinculadas).
- Cambiar el estado de la orden.
- Registrar pagos manualmente para órdenes que se pagan en sitio.
¿Te fue útil esta guía?