Glosario de conceptos Modelo de Orden

Orden

Una “orden” es una solicitud que realiza un usuario para comprar productos en una tienda a través del sistema.

---

Campos principales de la Orden

• Usuario de la aplicación (app_user_id): La persona que realiza la compra.

• Costo (cost): El valor total que debe pagar el usuario por la orden.

• Estado de la orden (status): Indica en qué etapa se encuentra la orden, por ejemplo: solicitada, completada, cancelada, sin stock, en revisión, entre otras.

• Tipo de pago (payment_type): Forma en que el usuario paga la orden, por ejemplo: tarjeta o efectivo.

• Tienda (store_id): El establecimiento donde se realiza la compra.

• Fecha de creación (created_at): El momento en que se creó la orden.

• Uso de créditos (used_credits): Indica si el usuario utilizó créditos para pagar parte de la orden.

• Valor de créditos usados (credits_used): La cantidad de créditos que el usuario usó en la orden.

• Uso de cupón (used_coupon): Indica si el usuario aplicó un cupón de descuento en la orden.

• Valor del cupón (coupon_value): El valor del descuento aplicado por el cupón.

• Fecha de actualización (updated_at): El momento en que se modificó por última vez la orden.

• Fecha de entrega (delivered_at): El momento en que la orden fue entregada al usuario.

• Número de orden (order_number): Un número único que identifica la orden.

• Motivo de cancelación (cancel_reason): Razón por la cual la orden fue cancelada, como: el usuario no recogió, la tienda estaba cerrada, no había stock, entre otras.

• Comentario de cancelación (cancel_reason_comment): Detalles adicionales sobre la razón de la cancelación.

• Para entrega a domicilio (for_delivery): Indica si la orden debe ser entregada en la dirección del usuario.

• Entregada (delivered): Indica si la orden fue entregada correctamente o no.

• ID de pago (payment_id): Identificador único del pago asociado a la orden.

• Fecha de solicitud (request_timestamp): Momento en que el usuario realizó la solicitud de la orden.

• Fecha de recolección (collection_timestamp): Momento en que el usuario recogió la orden en la tienda.

• Fecha de cancelación (cancellation_timestamp): Momento en que la orden fue cancelada oficialmente.

• Deuda (debt): Indica si existe un monto pendiente de pago por parte del usuario en la orden.

• Marca de la tarjeta (card_brand): Marca de la tarjeta bancaria utilizada para el pago (por ejemplo, Visa, Mastercard).

• Pago de deuda por el usuario (user_debt_payment): Monto de la deuda que el usuario ha pagado en relación con la orden.

• Completada por la tienda (completed_by_store): Indica si la tienda confirmó que la orden fue completada.

• Stock devuelto (stock_returned): Indica si los productos de la orden fueron devueltos al inventario de la tienda.

• Costo de entrega (delivery_cost): El costo real del servicio de entrega, sin considerar créditos.

• Tarifa de entrega cobrada (delivery_fee): El costo de entrega que se le cobra al usuario, considerando posibles descuentos o créditos.

• Créditos usados para entrega (credits_used_for_delivery): La cantidad de créditos usados para cubrir el costo de entrega.

• Código de barras (barcode): Un identificador único para la orden, usado para escanearla.

• Pago exitoso en MercadoPago (mp_payment_success): Indica si el pago por MercadoPago fue realizado con éxito.

• Stock devuelto (stock_returned): Indica si los productos de la orden fueron devueltos al inventario.

• Descuento directo (direct_discount): Descuento aplicado directamente al total de la orden.

• Completada parcialmente por el usuario (partial_completed_by_user): Indica si el usuario completó solo una parte de la orden.

• Envío a domicilio (for_delivery): Indica si la orden es para entrega en la dirección del usuario.

• Seguimiento de pedido (tracking_url): Enlace para que el usuario pueda ver el estado de su pedido en tiempo real.

Tipos de pago posibles en una Orden

El campo payment_type indica la forma en que el usuario paga la orden. Los valores posibles son:

• Tarjeta (0): El usuario paga con una tarjeta bancaria (crédito o débito).
• Efectivo (1): El usuario paga con dinero en efectivo al momento de recoger o recibir la orden.

Estados posibles de una Orden

A continuación se muestran todos los valores posibles para el campo "status" de una Orden y su significado:

• Pre-ordenada (0): La orden fue solicitada antes de estar lista para ser procesada.
• Completada (1): La orden se entregó correctamente al usuario.
• Cancelada tarde (2): La orden fue cancelada después del tiempo permitido.
• Solicitada (3): La orden fue solicitada por el usuario y está en proceso.
• No cumplida por el usuario (4): El usuario no pudo completar la orden.
• Cancelada por restaurante (5): El restaurante anuló la orden.
• No pagada (6): La orden no fue pagada.
• Sin stock (7): No había productos disponibles para completar la orden.
• Cancelada (8): La orden fue anulada por alguna razón.
• No cumplida (9): La orden no pudo ser completada.
• Esperando respuesta del usuario (10): Se requiere que el usuario responda para continuar con la orden.
• Esperando respuesta de la tienda (11): Se requiere que la tienda responda para continuar con la orden.
• No cumplida por la tienda (12): La tienda no pudo completar la orden.
• Respuestas diferentes (13): El usuario y la tienda dieron respuestas diferentes sobre el estado de la orden.
• En revisión (14): La orden está siendo evaluada por el sistema o el equipo de soporte.
• En cancelar y comprar (15): La orden está en proceso de cancelación y nueva compra.
• Cupón inválido (16): Se intentó usar un cupón no válido en la orden.
• Error en método de pago (17): Hubo un problema con el método de pago.
• Pre-cancelada (18): La orden fue cancelada antes de procesarse completamente.