Obtener un pedido

Consulta de Información de Pedidos en Yuju

Yuju proporciona dos opciones para acceder a la información de los pedidos: normal y estandarizada.

Te recomendamos utilizar únicamente una de las dos opciones para el 100% de tus pedidos - normal o estandarizada - para evitar recibir notificaciones duplicadas de un mismo pedido. Por esta razón, es crucial que te suscribas únicamente a los webhooks de una de las dos opciones que mejor corresponda a tu necesidad.

Opción 1: Estructura Normal

Yuju devuelve la información del pedido sin cambiar la estructura proporcionada por el marketplace. Haz clic aqui para consultar la estructura de cada canal.

Opción 2: Estructura Estandarizada

Yuju presenta la información de los pedidos de todos los canales en una misma estructura estandarizada, facilitando la lectura de las diferentes estructuras de pedidos.

Explicación General para Ambas Opciones

1. Términos.

Al determinar si un pedido debe ser despachado por el vendedor o si es de tipo FULL, se utiliza el campo ff_type con los siguientes valores:

• fbm: Pedido tipo vendedor.
• fbc: Pedido tipo marketplace (FULL).
• mix: Pedido mixto, con algunos SKUs marcados como fbm y otros como fbc.

2. Explicación de los campos Id order y reference.

En el JSON del pedido (es donde viene toda la información del pedido) se envían siempre dos campos clave: ID order y reference.

En el webhook – estructura normal – se envía siempre el ID order. En el webhook – estructura estandarizada – se envía el ID carrito(id_pack) para pedidos de Mercado Libre carrito y se envía el id_order para los demás casos.
Es ese ID enviado en el webhook que debes utilizar para consultar el pedido que sea con estructura normal o estandarizada.

Por lo general los canales tienen el mismo valor para reference y ID order pero para algunos canales, como Shopify y Walmart, tienen un valor distinto.

Al momento de importar la info del pedido a tu sistema, para tu campo correspondiente al identificador del pedido, puedes hacerlo con el ID order o el reference, según tu necesidad.

Nota importante:

El Id order es un identificador único por parte de Yuju (y del canal cuando lo proporciona) y el reference es un identificador que proporciona el marketplace.

Ten en cuenta que el ID mostrado en la tabla de pedidos de Yuju (interfaz de Yuju Marketplace > Ventas) corresponde al reference.

Por lo tanto, si deseas tener un ID de pedido idéntico entre tu propio sistema, Yuju y los marketplaces, debes utilizar el reference.

📘

Tip importante

Para recibir la URL de la guía de envío en la información del pedido (en el JSON para ambas estructuras), debes previamente habilitar la confirmación de pedidos y la descarga automática de guías. Para saber cómo hacerlo, da clic aquí.

La variable existe dentro de items > Shipments > label_url

Importante: Si tomas el pedido de inmediato, es posible que la guía aún no esté disponible. Te recomendamos

• Opción 1: Esperar 5 minutos después de recibir el webhook antes de consultar el pedido para obtenerla.
• Opción 2: Consultar el pedido de inmediato después de recibir el webhook porque quieres descontar stock lo antes posible, y si aún no está disponible la guía, ejecutar unos reintentos hasta que esté disponible (reintento 1: 10 minutos después. Reintento 2: 30 minutos después. Reintento 3: 6 horas después.).

📘

Video Tutorial: Cómo Consultar Pedidos de Forma Efectiva.