Documentación

Términos de un pedido

A continuación, se explican los términos y conceptos clave mencionados en la información de un pedido (JSON) para facilitar su comprensión.

Suggest Edits

1. Explicación de los campos ID ORDER y REFERENCE.

En el JSON del pedido (donde se encuentra la información del pedido), siempre se envían dos identificadores del pedido: id order y reference.

En el webhook (estructura normal), siempre se envía elid_order. En el webhook (estructura estandarizada), se envía el ID del carrito (id_pack) para los pedidos de Mercado Libre y elid_order para el resto de los casos.

El ID enviado en el webhook es el ID que se debe utilizar para consultar el pedido, ya sea con estructura normal o estandarizada.

Los canales suelen tener el mismo valor para reference y Id order, pero algunos canales, como Shopify, Falabella, Dafiti y Walmart, tienen valores diferentes.

En tu sistema propio, al importar la información del pedido, puedes utilizar el id order o reference dependiendo de tu necesidad.

Nota importante:

El Id order es un identificador único proporcionado por Yuju (y el canal, cuando lo proporciona), y el reference es un identificador proporcionado por el canal.

Ten en cuenta que la columna ID pedido que se muestra en la tabla de pedidos de Yuju (interfaz de Yuju Marketplace > Ventas) corresponde al reference. No se visualiza en la interfaz el id_order.


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

"order_components": [
    {
      "id_order": "64563167704511",
      "reference": "64563167704511",
      "status": "open",
      "progress": [
        {
          "name": "paid",
          "status": "done"
        },
        {
          "name": "ready_to_ship",
          "status": "done"
        },
        {
          "name": "shipped",
          "status": "pending"
        },
        {
          "name": "delivered",
          "status": "pending"
        }
      ],
      "ff_type": "fbm"
    },

2. Estados

Una orden en Yuju tiene diferentes estados: uno general a nivel Yuju llamado status para indicar si el pedido está cerrado (close) o abierto (open) y otro estado especifico sobre el pago y logística identificado comoprogress.

A continuación, te mostramos los estados más comunes que puede tener el campoprogress:

  1. Pendiente/pending: El pedido ha sido generado pero el pago no ha sido realizado aún.
  2. Pagado/paid: El pago ha sido aprobado.
  3. Confirmado/ready_to_ship: El vendedor aceptó el pedido y está preparando el pedido en la bodega.
  4. Enviado/shipped: El pedido ha sido despachado y está en tránsito hacia el comprador.
  5. Entregado/delivered: El comprador ha recibido el pedido a su domicilio.
  6. Cancelado/canceled: El pedido ha sido cancelado antes de su envío.
  7. Devolución: El comprador ha devuelto el pedido después de recibirlo.

Nota: Yuju pone un pedido como cerrado (close) cuando está cancelado, devuelto o entregado. Sino está como abierto.


    "progress": [
        {
            "name": "paid",
            "status": "done"
        },
        {
            "name": "ready_to_ship",
            "status": "done"
        },
        {
            "name": "shipped",
            "status": "pending"
        },
        {
            "name": "delivered",
            "status": "pending"
        }
    ],

3. Descuentos/cupones

Algunos marketplaces brindan a sus clientes un descuento adicional mediante un cupón, el cual puede ser asumido total o parcialmente por los propios canales. Queríamos compartir estos cupones en la información del pedido (cuando el canal lo permita).

Para Mercado Libre, incluimos también los descuentos de campañas (algunos se llaman oferta otras campaña).

Notas importantes:

  • Un pedido puede tener varios cupones y descuentos.
  • Covered_by indica si el cupón está asumido por el marketplace (entity=channel) o asumido por el vendedor (entity=merchant) y el monto total asumido (amount).
  • En el siguiente ejemplo, el primer cupón está asumido al 100% por el marketplace (entity=channel) porque el covered_by > amount es igual al campo amount (60). El segundo cuadro es un descuento por oferta asumido al 100% por el vendedor (entity=merchant).

Este último punto permite al vendedor comprender la razón detrás de las diferencias (que aparece en ciertos casos) entre el precio de venta y el monto pagado. Al leer este campo, sabrás si el descuento proviene de un cupón o de una oferta parcialmente asumida por el marketplace.

4. Tipo de envío: ¿Quién envía el pedido?

Para identificar quién envía el pedido, revisa la línea que contiene el campoff_type. Este campo solo puede tener una de las 3 opciones:

  • fbm: Fulfillment By merchant, es decir pedido enviado por el vendedor.
  • fbc: Fulfillment By Channel, es decir pedido enviado por el marketplace (FULL).
  • mix: Pedido mixto, con algunos SKUs marcados como fbm y otros como fbc.

El campo ff_type está a nivel pedido y a nivel item. A nivel pedido, puede tener una de las 3 opciones aunque mix es muy poco común pero a nivel item solo es posible fbm o fbc. Un pedido mixto es un pedido que tiene al menos un item fbm y al menos otro item fbc.

 "ff_type": "fbm",

5. Fecha límite de despacho

La fecha límite de despacho se visualiza en el campo sla>due_date.

 "ff_type": "fbm",
  "sla": {
    "due_date": "2025-03-14T04:59:59+00:00"
  },

6. Tags

El campo tags indica el método de envío. En el caso de MercadoLibre, estos tags indican información relevante sobre la logística utilizada.

  • me1: ME1 es el flete dinámico, donde el vendedor es quien realiza el envío.
  • me2: ME2 es cuando Mercado Libre genera la guía.
  • Flex: Los envíos Flex de Mercado Libre se visualizan comologistic_self_service 
 "ff_type": "fbm",
  "sla": {
    "due_date": "2025-03-14T04:59:59+00:00"
  },
  "tags": [
    "shipment_me2",
    "logistic_self_service"
  ],

7. Carrier

En el campocarrier, a nivel del ítem, muestra la paquetería encargada del envío. Este campo aparece para cada ítem dentro del pedido, indicando qué transportista se encargará de su entrega. Únicamente disponible cuando el canal lo indica.

"sku": "1112",
            "id_order": "7418877797910",
            "combo_components": [],
            "product_special_price": null,
            "tracking_code": "MELI310264",
            "discounts": [],
            "extra": null,
            "delivery_time": null,
            "price": "11000.0",
            "product_original_price": null,
            "shipments": [],
            "carrier": "Prioritario a domicilio",
            "ff_type": "fbc",
            "is_combo": false,
            "channel_sku": "1111",
            "extra_charges": [],
            "product_id": "MXX299",
            "coupon_value": null,
            "currency": "mxn",
            "comments": null,
            "quantity": 1,
            "status": "ready_to_ship",
            "name": "Macbook",
            "coupon_code": null,
            "providers": [],
            "marketplace_fee": "1650.0",
            "id_product": null

8. Canal

El campo id_channel, a nivel de pedido, indica el canal específico a través del cual se realizó la venta. Cada canal cuenta con un identificador único que permite distinguir el origen del pedido (por ejemplo: Mercado Libre, Amazon, tienda propia, etc.).

    "id_channel": 13,
    "notes": false,
    "customer": {
        "customer_id": null,
        "doc_number": null,
        "phone": null,
        "last_name": "Zam",
        "phone2": null,
        "doc_type": null,
        "email": "[email protected]",
        "first_name": "Ana",
        "nickname": null
    },

El id_channel se visualiza desde la sección de Yuju > Configuración > Tiendas > Canales.


📘

Nota Importante:

Ciertos campos aparecen varias veces en el pedido, tanto a nivel del pedido como a nivel del ítem (SKU). ¡No es un error! Estas duplicaciones son normales: muestran tanto una información a nivel del pedido como a nivel del ítem.

Por ejemplo, si el envío será gestionado por el marketplace o por el vendedor, si se ha aplicado un cupón de descuento en el pago, etc.

Updated 19 days ago