Conoce la información de los estados de una de orden de acuerdo al tipo de entrega que maneje el vendedor.
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 los despachos en Multivende y su relación con los estados de los despachos 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 |
Estados que se sincronizan desde Multivende a los canales de ventas
- Multivende -> Amazon
| Multivende | Amazon |
| _delivery_order_status_ready_to_ship_ | Shipped (Para MFN) |
| _delivery_order_status_shipped_ | Shipped (Para Seller Flex/SmartConnect) |
| _delivery_order_status_cancelled_ | Cancelled (Para Seller Flex/SmartConnect/AFN/FBA) |
- Multivende -> Falabella
| Multivende | Falabella |
| _delivery_order_status_handling_ | packed_by_marketplace (Avisa que el paquete está cerrado) |
| _delivery_order_status_ready_to_ship_ | ready_to_ship (Avisa a la logística para retiro) |
| _delivery_order_status_shipped_ | shipped |
| _delivery_order_status_cancelled_ | Canceled |
- Multivende -> Dafiti
| Multivende | Dafiti |
| _delivery_order_status_handling_ | Marca preparación/packing en Dafiti |
| _delivery_order_status_ready_to_ship_ | Ready to ship (Dropshipping/Crossdocking) |
| _delivery_order_status_shipped_ | Shipped (Crossdocking) |
| _delivery_order_status_cancelled_ | Canceled (Dropshipping/Crossdocking) |
| _delivery_order_status_not_delivered | Canceled (Dropshipping/Crossdocking) |
- Multivende -> Ripley
| Multivende | Ripley |
| _delivery_order_status_handling_ | SHIPPING IN PROGRESS |
| _delivery_order_status_shipped_ | SHIPPED |
| _delivery_order_status_cancelled_ | CANCELED (si la orden está avanzada la cambia a estado refund) |
- Multivende -> Mercado Libre
| Multivende | Mercado Libre |
| _delivery_order_status_shipped_ | shipped (ME1,custom) |
| _delivery_order_status_delivered_ | delivered(ME1,custom) |
| _delivery_order_status_cancelled_ | not_delivered con subestado returning_to_sender (ME1) |
| _delivery_order_status_cancelled_ | cancelled (Custom) |
| _delivery_order_status_ready_to_ship_ | ready_to_ship (Aplica para ME2 con tiempo de fabricación) |
- Multivende -> Paris
| Multivende | Paris |
| _delivery_order_status_cancelled_ | unable_to_fulfill (Nota: Es el único estado que empuja MV hacia Paris) |
- Multivende -> Walmart CL/MX
| Multivende | Walmart |
| _delivery_order_status_handling_ | Acknowledged (Solo en Walmart CL) |
| delivery_order_status_ready_to_ship_ | Acknowledged (Solo en Walmart MX) |
| _delivery_order_status_shipped_ | Shipped (Sólo en Walmart MX) |
| _delivery_order_status_delivered_ | Delivered (Solo en Walmart CL) |
| _delivery_order_status_cancelled_ | Cancelled (MX y CL) |
-
Multivende -> Magento
-
No se envía actualizaciones de estados de Multivende a Magento
-
- Multivende -> Shopify
| Multivende | Shopify |
| _delivery_order_status_ready_to_ship_ | CONFIRMED (Confirma la preparación) |
| _delivery_order_status_shipped_ | IN_TRANSIT |
| _delivery_order_status_delivered_ | DELIVERED |
| _delivery_order_status_cancelled_ | FAILURE (Cancela o revierte el fulfillment) |
- Multivende -> VTEX
| Multivende | VTEX |
| _delivery_order_status_handling_ | Handling (Obligatorio para iniciar la ruta en VTEX) |
| _delivery_order_status_shipped_ | Partial Invoice (Envía la Factura/Boleta e inyecta el tracking) |
| _delivery_order_status_delivered_ | Delivered |
| _delivery_order_status_cancelled_ | Cancelled |
- Multivende -> TikTok
| Multivende | TikTok |
| _delivery_order_status_cancelled_ | Cancelled (Solo si estaba impaga o esperando envío) |
Nota: TikTok Shop sólo maneja cancelaciones, cualquier otro estado no es admitido hacia el canal, para realizar una cancelación hacia el canal remoto, el estado del pedido den TikTok Shop debe estar en UNPAID o AWAITING_SHIPMENT.
- Multivende -> Mirakl (Coppel / TotalPlay)
| Multivende | Mirakl (Coppel / TotalPlay) |
| _delivery_order_status_handling_ | acceptOrder (La orden pasa a SHIPPING en Mirakl) |
| _delivery_order_status_shipped_ | confirmOrder (La orden pasa a SHIPPED en Mirakl) |
| _delivery_order_status_cancelled_ | cancelOrder (Rechaza la compra) o refundOrder (Reembolsa si ya estaba enviada) |
- Multivende -> T1 / Claro Shop
| Multivende | T1 |
| _delivery_order_status_cancelled_ | cancel_order |
-
Multivende -> Prestashop
- No se envía actualizaciones de estados de Multivende a Prestashop
- Multivende -> BigCommerce
| Multivende | Dafiti |
| _delivery_order_status_ready_to_ship_ | Awaiting Shipment |
| _delivery_order_status_shipped_ | Shipped |
| _delivery_order_status_delivered_ | Completed |
| _delivery_order_status_cancelled_ | Cancelled |
Sub estados de los despachos:
Los sub estados aportan trazabilidad detallada sobre incidencias en la última milla, causas de no entrega o motivos de cancelación. El campo code es el identificador estándar que se utiliza para homologar las respuestas del endpoint Get delivery order substatuses
1. Estados de Tránsito y Última Milla (En Camino / Próximos a Entrega)
| Código Multivende (code) | Nombre / Etiqueta | Descripción |
_delivery_order_sub_status_out_for_delivery_ |
En camino / En reparto | El paquete salió del centro de distribución y se encuentra en ruta hacia el domicilio del comprador. |
_delivery_order_sub_status_soon_deliver_ |
Próximo a entregar | El transportista se encuentra en las inmediaciones o en la parada previa a la dirección de destino |
_delivery_order_sub_status_at_the_door_ |
En la puerta | El repartidor ha llegado a la dirección del destinatario para intentar la entrega física. |
2. Incidencias de Intento de Entrega / Dirección (No Entregado Temporal)
| Código (code) | Nombre / Etiqueta | Descripción |
_delivery_order_sub_status_receiver_absent_ |
Destinatario ausente | Se realizó la visita en la dirección indicada, pero no hubo quien recibiera el pedido. |
_delivery_order_sub_status_bad_address_ |
Dirección incorrecta | La dirección de destino está incompleta, mal numerada o no existe. |
_delivery_order_sub_status_not_localized_ |
Domicilio no localizado | El operador logístico no logró ubicar el inmueble o las referencias indicadas son insuficientes. |
_delivery_order_sub_status_unauthorized_receiver_ |
Receptor no autorizado | La persona presente en el domicilio no está facultada para recibir el paquete o no cuenta con identificación requerida. |
_delivery_order_sub_status_dangerous_area_ |
Zona peligrosa | El courier no pudo ingresar a la zona por motivos de riesgo o seguridad pública. |
_delivery_order_sub_status_impassable_zone_ |
Zona intransitable | Vía bloqueada, obras, inundación o imposibilidad geográfica de acceso para el transporte. |
_delivery_order_sub_status_others_ |
Otros motivos | Otra incidencia operativa en el intento de entrega no categorizada previamente. |
3. Incidencias Documentales y Fiscales en Tránsito
| Código (code) | Nombre / Etiqueta | Descripción |
_delivery_order_sub_status_documentation_issue_ |
Problema de documentación | Falta guía de despacho, etiqueta ilegible o inconsistencias en los documentos de traslado. |
_delivery_order_sub_status_taxes_issue_ |
Problema de impuestos | Paquete retenido por cobro de aranceles o impuestos aduaneros/locales pendientes. |
_delivery_order_sub_status_fiscalization_issue_ |
Retenido por fiscalización | Retención por parte de entidades regulatorias o tributarias (ej. SII, SAT, DIAN) durante el transporte. |
_delivery_order_sub_status_fiscal_issue_ |
Problema fiscal | Error administrativo o inconsistencia con el documento tributario emitido para la venta. |
4. Rechazos, Daños y Devoluciones
| Código (code) | Nombre / Etiqueta | Descripción |
_delivery_order_sub_status_damaged_ |
Producto dañado / averiado | El paquete o su contenido sufrió roturas o deterioros durante la manipulación o traslado. |
_delivery_order_sub_status_rejected_by_buyer_ |
Rechazado por el comprador | El cliente rehusó recibir el paquete al momento de la entrega (por error en la compra, demora, etc.). |
_delivery_order_sub_status_returned_ |
Devuelto al origen | El envío completó su ciclo de devolución y fue retornado a la bodega o centro logístico del vendedor. |
| Código (code) | Nombre / Etiqueta | Descripción |
_delivery_order_sub_status_customer_requested_ |
Cancelación solicitada por el cliente | El comprador pidió cancelar el pedido antes de la entrega. |
_delivery_order_sub_status_seller_cancelled_ |
Cancelado por el vendedor | El comercio canceló proactivamente la orden de despacho. |
_delivery_order_sub_status_out_of_stock_ |
Quiebre de stock | Cancelación originada por falta de inventario disponible para preparar el pedido. |
_delivery_order_sub_status_fraud_suspected_ |
Sospecha de fraude | Bloqueo o cancelación por alertas de seguridad, riesgo financiero o suplantación. |
_delivery_order_sub_status_shipment_issue_ |
Problema operativo de envío | Error en la generación del despacho, asignación de courier o rotura de bulto en bodega previa al despacho. |
_delivery_order_sub_status_mediation_ |
En mediación / Reclamo | Cancelación derivada de una disputa o reclamo formal abierto en el marketplace. |
_delivery_order_sub_status_internal_ |
Motivo interno | Cancelación derivada de reglas operativas internas del vendedor o la plataforma. |
6. Subestatus Específicos por Canal de Venta
Shopify
| Código (code) | Nombre / Etiqueta | Descripción |
_delivery_order_sub_status_shopify_declined_ |
Declinado en Shopify | La transacción o el pedido fue rechazado por las pasarelas o reglas de riesgo de Shopify. |
_delivery_order_sub_status_shopify_inventory_ |
Inventario Shopify | Cancelación o desestimación de despacho por inconsistencias de inventario en Shopify. |
_delivery_order_sub_status_shopify_staff_ |
Personal de Shopify | Cancelación manual efectuada por el personal/staff administrativo de la tienda Shopify. |
Walmart
| Código (code) | Nombre / Etiqueta | Descripción |
_delivery_order_sub_status_walmart_pricing_error_ |
Error de precio en Walmart | Cancelación del pedido debido a una discordancia o error en el precio publicado en Walmart. |
_delivery_order_sub_status_walmart_address_not_serviceable_ |
Dirección sin cobertura Walmart | La dirección proporcionada está fuera del rango de cobertura o de entrega definido por Walmart. |
Para saber como actualizar los estados a un despacho, puedes revisar este artículo.
Equipo Integraciones API Multivende
0 comentarios
El artículo está cerrado para comentarios.