Cómo automatizar la configuración de pedidos de Amazon Easy Ship a través de la API de Multivende

En este artículo, aprenderás cómo automatizar la configuración de tus pedidos de Amazon Easy Ship utilizando la API de Multivende. Si necesitas información sobre el funcionamiento de Amazon Easy Ship, consulta el artículo: Cómo gestionar tus pedidos de Amazon Easy Ship en Multivende.

1. Identificar Órdenes de Amazon Easy Ship

Para gestionar los pedidos de Amazon Easy Ship, primero debes identificar el deliveryOrderId y el ID de la conexión con el marketplace correspondiente. Asegúrate de que la orden pertenezca a la modalidad de Easy Ship verificando el campo shippingMode con los siguientes valores:

• "pri-ez-mx"
• "expd-ez-mx"
• "expr-ez-mx"
• "std-ez-mx"

Puedes verificar esto utilizando cualquiera de los siguientes endpoints:

• Get checkout light: Si la venta tiene más de un deliveryOrder con diferentes modalidades logísticas, el valor indicado será "múltiple". Caso contrario el shippingMode traerá los valores asociados a Easy ship de Amazon.
• Get checkout: se valida el shippingMode dentro de cada deliveryOrder.
• Get deliveryOrder: se valida directamente el valor del shippingMode.

2. Consultar las Dimensiones del Paquete

Para obtener las dimensiones del paquete, utiliza el endpoint Get dimensions of item packages. Esta información es esencial para la consulta de horarios de recolección. La API responderá con un formato similar al siguiente:

[
  {
    "packageDimensionsAndWeight": {
      "asin": "XXXXXXXXXX",
      "packageDimensions": {
        "length": 12,
        "width": 12,
        "height": 12,
        "unit": "Cm"
      },
      "packageWeight": {
        "value": 12,
        "unit": "G"
      }
    }
  }
]

 

3. Consultar Horarios de Recolección

Para obtener los horarios de recolección disponibles, usa el endpoint Post available time slots. Envía los parámetros de dimensiones del paquete obtenidos en el paso anterior o establece tus propias medidas:

{
  "packageDimensionsAndWeight": {
    "packageDimensions": {
      "length": 0,
      "width": 0,
      "height": 0,
      "unit": "Cm"
    },
    "packageWeight": {
      "value": 0,
      "unit": "G"
    }
  }
}

La respuesta incluirá bloques de horarios disponibles para la recolección. Toma nota de los parámetros slotId, startTime y endTime del bloque que mejor se ajuste a tus necesidades:

 

{
  "packageDimensionsAndWeight": {
    "packageDimensions": {
      "length": 12,
      "width": 12,
      "height": 22,
      "unit": "Cm"
    },
    "packageWeight": {
      "value": 23,
      "unit": "G"
    }
  },
  "listHandoverSlots": [
    {
      "handoverMethod": "PICKUP",
      "slotId": "xxxxxxxxxxxxxxxxxxxx",
      "startTime": "2024-08-02T13:00:00-06:00",
      "endTime": "2024-08-02T18:00:00-06:00"
    },
    {
      "handoverMethod": "PICKUP",
      "slotId": "xxxxxxxxxxxxxxxxxxxx",
      "startTime": "2024-08-05T13:00:00-06:00",
      "endTime": "2024-08-05T18:00:00-06:00"
    }
  ]
}

 

4. Programar la Recolección

Para programar la recolección de tu pedido, utiliza el endpoint Post create scheduled packages. Envía los parámetros obtenidos del paso anterior para fijar el horario de recolección:

{
  "deliveryOrderId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "amazonOrderIdsAndPackageTimeSlots": [
    {
      "slotId": "xxxxxxxxxxxxxxxxx",
      "startTime": "2024-08-02T13:00:00-06:00",
      "endTime": "2024-08-02T18:00:00-06:00"
    }
  ]
}

 

5. Impresión de Etiquetas

La impresión de etiquetas para Amazon Easy Ship se realiza a través del flujo estándar de generación de etiquetas. Consulta el artículo: ¿Cómo generar y consultar etiquetas de los Marketplace? para obtener instrucciones detalladas.

Ten en cuenta que una vez generada la URL de los documentos de despacho, dispones de 15 minutos para descargarla. La URL caducará después de este tiempo. Si necesitas descargar los documentos nuevamente, realiza un nuevo llamado al endpoint Get delivery order y busca la URL en deliveryOrderDocuments.

Consideraciones Adicionales:

Para verificar el rango de fechas de recolección de una orden ya programada o validar si ya la orden tiene programado un envío, consulta los siguientes campos, si tienen información es que ya el despacho se encuentra programado:

• "pickUpDeliveryDateTo"
• "pickUpDeliveryDateFrom"

Esto lo puedes hacer a través de los endpoints Get delivery order o Get checkout

Si tienes dudas o necesitas asistencia, puedes escalar un ticket a través de este enlace y nuestro equipo estará encantado de ayudarte.

Equipo Integraciones API Multivende