Los estados de las órdenes dependen del tipo de retiro que haya seleccionado el cliente, por lo que puede variar según esta condición.
Tipos de entrega para una Orden
Para obtener los diferentes tipos de entrega que puede tener una orden se debe consultar el Endpoint Get delivery types. Actualmente contamos con dos tipos de entrega posibles, las cuales, en el response de la solicitud se obtiene el campo code, que puede tener los siguientes valores:
- “_delivery_type_delivery” = Despacho (el producto se envía a una dirección dada por el comprador).
- "_delivery_type_store_pickup" = Retiro (el producto lo retira el comprador en la dirección de la bodega asociada al stock del producto).
- "_delivery_type_mix" = Mixto (La orden está compuesta por varios productos de los cuales tiene retiro en tienda y despacho)
Órdenes con Despacho
Para realizar la integración con los sistemas, se debe realizar un mapeo de los estados de las órdenes en Multivende y el sistema con el que se va a integrar. Para ello, se consulta al endpoint Get Delivery Order Status el cual retorna un array con todos los estados posibles de una orden en Multivende.
Del response se deben guardar los campos _id y code, que deben ser mapeados con los estados del sistema.
A continuación, se detallan los posibles estados de las ventas en Multivende y su relación con los estados de las ventas en los canales.
Multivende
Estado en Multivende campo code |
Descripción |
_delivery_order_status_pending_ |
La orden ingresó en el sistema. |
_delivery_order_status_handling_ |
Se está preparando la orden para el envío. |
_delivery_order_status_ready_to_ship_ |
La orden está lista para el despacho. |
_delivery_order_reschedule_ |
La orden se reagendó. |
_delivery_order_status_shipped_ |
La orden se ha enviado. |
_delivery_order_status_delivered_ |
La orden se ha entregado. |
_delivery_order_status_not_delivered_ |
La orden no se entregó. |
_delivery_order_status_cancelled_ |
La orden se ha cancelado. |
_delivery_order_status_under_review_ |
La orden está en revisión. |
Multivende - Mercado Libre
Relación de estados entre Multivende y Mercado Libre
Multivende |
Mercado Libre |
_delivery_order_status_pending_ |
pending |
_delivery_order_status_handling_ |
handling |
delivery_order_status_ready_to_ship_ |
ready_to_ship |
_delivery_order_status_shipped_ |
shipped |
_delivery_order_status_delivered_ |
delivered |
_delivery_order_status_not_delivered_ |
not_delivered |
_delivery_order_status_cancelled_ |
cancelled |
Multivende - VTEX
Relación de estados entre Multivende y VTEX
Multivende |
VTEX |
_delivery_order_status_under_review_ |
window-to-cancel
|
_delivery_order_status_pending_ |
ready-for-handling
|
_delivery_order_status_handling_ |
handling |
_delivery_order_status_shipped_ |
invoiced (Solo si esta el DTE cargado)
|
_delivery_order_status_cancelled_ |
cancelled |
Multivende - Ripley
Relación de estados entre Multivende y Ripley
Multivende |
Ripley |
_delivery_order_status_pending_ |
shipping
|
_delivery_order_status_shipped_ |
shipped
|
_delivery_order_status_delivered_ |
received
|
_delivery_order_status_cancelled_ |
cancelled |
Multivende - Shopify
Relación de estados entre Multivende y Shopify
Multivende |
Shopify |
_delivery_order_status_pending_ |
null
|
delivery_order_status_ready_to_ship_ |
confirmed
|
_delivery_order_status_shipped_ |
in_transit
|
_delivery_order_status_delivered_ |
delivered |
_delivery_order_status_not_delivered_ |
failure |
Multivende - Paris
Relación de estados entre Multivende y Paris
Multivende |
Paris |
_delivery_order_status_pending_ |
null
|
_delivery_order_status_handling_ |
confirmed
|
_delivery_order_status_shipped_ |
in_transit
|
_delivery_order_status_delivered_ |
delivered |
_delivery_order_status_not_delivered_ |
failure |
_delivery_order_status_cancelled_ |
failure |
Multivende - Magento
Relación de estados entre Multivende y Magento
Multivende |
Magento |
_delivery_order_status_pending_ |
pending, new, pending payment, pending payPal
|
_delivery_order_status_handling_ |
processing, on hold, payment review
|
_delivery_order_status_delivered_ |
invoiced |
_delivery_order_status_cancelled_ |
closed, canceled |
Multivende - Linio, Dafiti, FalabellaRelación de estados entre Multivende y Linio, Dafiti, Falabella
Multivende |
Linio, Dafiti, Falabella |
_delivery_order_status_pending_ |
pending, processing
|
_delivery_order_status_handling_ |
return_waiting_for_approval, return_shipped_by_customer, return_rejected
|
_delivery_order_status_ready_to_ship_ |
ready_to_ship
|
_delivery_order_status_shipped_ |
shipped
|
_delivery_order_status_delivered_ |
delivered |
_delivery_order_status_not_delivered_ |
returned |
_delivery_order_status_cancelled_ |
failed, canceled |
¿Cómo actualizar los estados de una orden?
Puedes obtener el campo _id del endpoint Get checkout dentro del arreglo de DeliveryOrder, el cual es necesario para actualizar el estado de la entrega.
La actualización del estado se debe realizar según el tipo de retiro.
Despachos
Los siguientes datos pueden actualizarse por el endpoint Update delivery order status:
- "DeliveryOrderStatusId” = actualizar el estado del despacho según el _id correspondiente del endpoint Get Delivery Order Status
- "comment" = un comentario al despacho
Para actualizar el número y url de tracking debes usar el endpoint Update delivery order
Si tienes dudas sobre este tema contáctanos a través de api@multivende.com y estaremos ¡felices de ayudarte!
Equipo Integraciones API Multivende