Cheaf Docs
Orders

Ciclo de Vida de una Orden en el Flujo de Creación

Ciclo de vida de una orden en el flujo de creación

Este documento describe de forma clara y no técnica los posibles estados ("status") que puede tener una orden durante su ciclo de vida en el proceso de creación, así como las situaciones que llevan a cada estado. Está basado en la documentación funcional y el glosario del sistema.


Ciclo de Vida Específico de una Orden en el Proceso de Creación

A continuación se describe, paso a paso y de manera clara, el destino de una orden (su status) en cada fase del proceso de creación, según los posibles resultados de cada etapa.

1. Validaciones Iniciales

  • Si alguna validación falla (tienda cerrada, método de pago no permitido, cupón inválido, carrito vacío, país incorrecto, versión de app no compatible, límites de compra superados):
    • La orden NO se crea o, si se intenta crear, se marca como Cancelada (8).

2. Creación y Verificación de la Orden

  • Si la marca tiene límite de paquetes y el usuario lo supera:
    • La orden NO se crea (no se asigna status, se rechaza antes de avanzar).
  • Si hay un error al generar el código de barras (duplicado):
    • La orden NO se crea (sin status, proceso interrumpido).

3. Procesamiento de Inventario (Stock)

  • Si algún producto no tiene suficiente stock:
    • La orden se marca como Sin stock (7).
    • Se revierte cualquier cambio en inventario.
    • El usuario es notificado del error.

4. Cálculo y Proceso de Pago

  • Si el cupón no es válido (por reglas de la tienda, monto mínimo, expirado, ya usado, etc.):
    • La orden se marca como Cupón inválido (16).
    • Se revierte el stock de los productos del carrito.
  • Si el método de pago no es válido o el proveedor de pagos falla:
    • La orden se marca como No pagada (6) o Error en método de pago (17).
    • Se revierte el stock de los productos del carrito.
  • Si el pago es exitoso:
    • La orden avanza a Solicitada (3).

5. Configuración de Entrega (Delivery)

  • Si la entrega se configura correctamente:
  • Si falla la integración logística (por ejemplo, Uber Direct, Deliverect):
    • La orden se marca como Cancelada (8).
    • Se revierte el stock de los productos del carrito.
    • Si el pago fue con tarjeta, se reembolsa el monto como créditos Cheaf al usuario.
    • Se notifica al usuario y al equipo de soporte.

6. Finalización y Notificaciones

  • Si todo el proceso es exitoso:

    • La orden finaliza como Solicitada (3).
    • Se notifica a la tienda.
  • Si ocurre un error en la integración con sistemas externos o al guardar la localización:

    • Dependiendo del punto del error, la orden puede quedar como Solicitada (3), pero se registra el incidente y se notifica al soporte.

Este ciclo de vida resume de manera precisa los caminos posibles de una orden durante su creación, según las reglas y validaciones del sistema.


Resumen de Transiciones Comunes

  • Una orden inicia como Pre-ordenada (0).
  • Si pasa validaciones e inventario, avanza a Solicitada (3).
  • Si falla alguna validación, inventario o integración, puede terminar como Cancelada (8) o Sin stock (7).
  • Si el pago falla, puede quedar como No pagada (6), Error en método de pago (17) o Cupón inválido (16).
  • Si hay problemas en la entrega o retiro, puede quedar como No cumplida por el usuario (4), No cumplida por la tienda (12), No cumplida (9) o Respuestas diferentes (13).
  • Si requiere revisión, pasa a En revisión (14).

Notas

  • Algunos estados pueden alcanzarse por acciones del usuario, la tienda o el sistema.
  • El ciclo de vida puede variar en casos especiales de integración, promociones o validaciones adicionales según país, tienda o marca.
  • Para más detalles, consultar la documentación funcional y el glosario de órdenes.