Los estados de las órdenes dependen del tipo de entrega 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)
Entregas con despacho
En el endpoint Get Checkout entregamos información general del despacho, pero si necesitas información adicional como los documentos o logs de cambio de estado, consulta el endpoint Get delivery order.
Para realizar la integración con los sistemas, se debe hacer 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 re agendó. |
_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. |
_delivery_order_status_partial_cancelled_ |
Uno o algunos de los items de la orden fue cancelado |
-
Multivende - Amazon
- Relación de estados entre Multivende y Amazon
Multivende |
Amazon |
_delivery_order_status_pending_ | unshipped |
_delivery_order_status_handling_ | partiallyShipped |
_delivery_order_status_ready_to_ship_ | closed_summary |
_delivery_order_status_shipped_ | shipped |
_delivery_order_status_delivered_ | delivered |
_delivery_order_status_not_delivered_ | not_delivered |
_delivery_order_status_cancelled_ | cancelled |
-
Multivende - Linio, Dafiti, Falabella
- Relació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 |
-
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 |
El estado solo se cambia en Mercadolibre para los pedidos que no son ME2 excepto el estado cancelado.
-
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 - 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 - Walmart Chile
- Relación de estados entre Multivende y Walmart Chile
Multivende |
Walmart Chile |
_delivery_order_status_pending_ | Created |
_delivery_order_status_handling_ | Acknowledged |
_delivery_order_status_shipped_ | Shipped |
_delivery_order_status_delivered_ | Delivered |
_delivery_order_status_cancelled_ | Cancelled |
-
Multivende - Walmart México
- Relación de estados entre Multivende y Walmart México
Multivende |
Walmart México |
_delivery_order_status_pending_ | On Hold |
_delivery_order_status_pending_ | Created |
_delivery_order_status_ready_to_ship_ | Acknowledged |
_delivery_order_status_shipped_ | Shipped |
_delivery_order_status_delivered_ | Delivered |
_delivery_order_status_cancelled_ | Cancelled |
-
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 - 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 - 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 |
Consideraciones especiales para la información logística por canal de venta:
Cancelaciones parciales para el canal Paris:
Identificar los items cancelados: Para determinar qué artículo o artículos han sido cancelados en una orden de despacho, les instamos a buscar en el campo:
"checkoutLink" -> "externalContent" -> "subOrders "-> items al consultar la venta con Get checkout.
Dentro items, por cada uno de los items, en el campo “status” encontrarán la información detallada sobre la cancelación parcial en caso de que el ítem haya sido cancelado.
- Ejemplo:
"status": {
"id": 31,
"name": "stock_shortage_refunded",
"description": "Reembolsado por falta de stock en la db",
"translate": "Problema con stock",
"cancelable": false
}
Estas indicaciones solo aplican para el caso del marketplace Paris.
Entrega con retiro en tienda
En el endpoint Get Checkout entregamos información general del retiro en tienda, pero si necesitas información adicional como los logs de cambio de estado, consulta el endpoint Get pickup order.
Los estados de retiro en tienda se pueden consultar mediante el endpoint de: GET pick up order statuses.
Estado en Multivende campo code |
Descripción |
pick_up_order_status_pending |
La orden ingresó en el sistema |
pick_up_order_status_received_by_store |
La orden ingresó a la tienda |
pick_up_order_status_completed |
La orden está lista para el despacho. |
pick_up_order_status_cancelled |
La orden fue cancelada |
Actualizar el estado de una orden con retiro en tienda
Para actualizar el estado de una orden con retiro en tienda, lo hacemos mediante el endpoint:
PUT Update pick up order status. Enviando en el body los siguientes parámetros:
"PickUpOrderStatusId": "{{pick_up_order_status_pending_id}}"
"comment": "test comment",
"pickUpClosingComment": "test Pick Up Closing Comment",
"estimatedPickUpDateFrom": "2019-09-08 16:19:06",
"estimatedPickUpDateTo": "2019-09-10 09:19:06",
"effectivePickUpClosingDate": "2019-09-11 16:19:06"
Si tienes dudas sobre este tema contáctanos a través de api@multivende.com y estaremos ¡felices de ayudarte!Equipo Integraciones API Multivende