Paso previo antes de obtener la guía de envío.
Antes de consultar o descargar una guía de envío desde Yuju, es importante contar con ciertas configuraciones y conocer el flujo correcto del proceso.
Esta información te permitirá evitar errores, reducir consultas manuales y asegurar que las guías estén disponibles en el momento adecuado, ya sea a través de automatizaciones o mediante el uso de la API.
1. Habilitar la descarga automática de guías
Yuju permite automatizar la descarga de las guías de envío directamente desde la plataforma, evitando la necesidad de realizar consultas manuales a través de la API para cada pedido.
Desde la sección Guías de envío, es posible:
Activar la descarga automática por canal.
Seleccionar el tipo de archivo que deseas recibir (Excel, archivo ZIP con todas las guías, entre otros).
Definir si deseas que Yuju confirme automáticamente los pedidos antes de descargar la guía (esto es indispensable para que la guía esté disponible).
Una vez configurada esta opción, las guías se generan y descargan automáticamente, lo que agiliza significativamente el proceso de despacho y operación logística.
Nota importante: Para poder habilitar la descarga automática de guías, es necesario que las ventas se encuentren previamente confirmadas.
Puedes consultar en la documentación el paso a paso sobre cómo realizar esta configuración.
2. Obtener el ID del pedido para consultar la guía
Para consultar una guía de envío mediante la API, es indispensable contar con el ID del pedido. Existen dos formas de obtenerlo:
Opción 1: Webhook (notificación en tiempo real)
Yuju envía notificaciones en tiempo real cuando se recibe un pedido desde un canal de venta.
En estos eventos (webhooks) se incluye el ID de la orden, el cual puede almacenarse y utilizarse posteriormente para consultar la guía de envío.
Esta opción es ideal si trabajas con integraciones en tiempo real y automatizaciones.
Opción 2: Reporte de ventas
También puedes obtener el ID del pedido a través de los reportes de ventas disponibles en Yuju.
Estos reportes permiten consultar órdenes históricas y extraer el identificador necesario para solicitar la guía de envío cuando sea requerido.
Puedes consultar en la documentación el paso a paso sobre descargar un reporte de Ventas.
3. ¿Cómo usar el endpoint de guías?
La API de Yuju incluye un endpoint específico para obtener las guías de envío de una orden:
id_channel: Identificador del canal de venta (por ejemplo Mercado Libre, Amazon, Shopify, etc.).
id_order: Identificador de la orden de venta.
body: Se puede incluir el formato deseado (general o zpl) y los ítems dentro de la orden para los que deseas generar la guía.
Al llamar a este endpoint, la API devuelve la etiqueta de envío en el formato especificado o un enlace para descargarla.
4. ¿En qué momento consultar la guía?
La guía de un pedido puede no estar disponible inmediatamente después de recibir el evento del pedido (por ejemplo, cuando llega un webhook). Por eso se recomienda lo siguiente:
Esperar al menos 5 minutos después de recibir el webhook para consultar la guía.
Si la guía aún no está disponible, reintentar la consulta después de periodos incrementales (por ejemplo, 10 minutos, 30 minutos, varias horas, etc.).
Esto se debe a que la generación de la guía depende primero de la confirmación del pedido por parte del seller y generación de la guía por parte del marketplace (disponibilización de la etiqueta). En algunos casos los marketplaces pueden demorar en generar la etiqueta, esto suele suceder en las temporadas altas.
5. ¿Qué pasa si la guía no está disponible?
Si la guía aún no está disponible cuando intentas obtenerla (ya sea mediante consulta directa o a través de automatizaciones), puedes:
Configurar reintentos programados, aumentando el intervalo entre ellos hasta que la guía esté disponible.
Si después de varios intentos la guía nunca se genera, puede que el pedido no tenga aún la guía disponible desde el canal externo, lo cual puede requerir verificar el estado en el marketplace.
Importante recordar que la guía no será generada en Yuju si antes no se confirma el pedido adecuadamente desde la plataforma (ya sea manual o automáticamente) ya que sin la confirmación previa no se habilitará la generación de la guía.