¿Cómo puedo validar el estado de un despacho mediante la API ?

Cuando trabajas con plataformas de logística como Multivende, es fundamental conocer el estado actual de una orden de despacho. 

Esto permite a los equipos internos automatizar flujos, mejorar la experiencia del cliente y tener visibilidad del avance de las entregas.

Multivende ofrece un endpoint específico para consultar los estados de una orden de despacho y validar en qué etapa del proceso logístico se encuentra.

En este artículo, aprenderás a consultar y mapear el estado de una orden de despacho usando la API de Multivende.

1. ¿Dónde se encuentra el estado del despacho?

El estado de un despacho en Multivende se encuentra en el objeto DeliveryOrder o en el Checkout, a través del campo:

"deliveryOrderStatusId"

Este campo contiene el identificador único del estado actual de la orden de despacho.

2. Obtener los estados posibles con la API

Para interpretar correctamente el deliveryOrderStatusId, debes consultar previamente el listado de estados disponibles.

🔗 Endpoint: Get Delivery Order Status

GET https://app.multivende.com/api/delivery-order-statuses

📌 Ejemplo con cURL

curl --location 'https://app.multivende.com/api/delivery-order-statuses' \
--header 'Authorization: Bearer <Token>'

📥 Ejemplo de respuesta

{
  "entries": [
    {
      "_id": "510a864b-2385-11e7-8642-2c56dc130c0d",
      "name": "DELIVERY_ORDER_STATUSES.Pending.Name",
      "code": "_delivery_order_status_pending_"
    },
    ...
  ]
}

3. Estados comunes de una orden de despacho

A continuación, se listan los valores más habituales del campo code, junto con su posible interpretación:

🔗 Para más información sobre los estados disponibles según el tipo de entrega, consulta el artículo:
Estados de una orden según el tipo de entrega