Estructura estandarizada

Este endpoint permite consultar las ordenes de todos los canales con una misma estructura estandarizada.

Suggest Edits

🚧

Endpoint bajo solicitud

Este recurso se habilita únicamente para las cuentas que lo solicitan. Si deseas utilizarlo, por favor haz tu solicitud a este correo. Te lo habilitaremos dentro de 48 horas.

Estructura

Yuju procesa las órdenes de todos los canales de ventas (marketplaces y ecommerce propio) para entregar en este endpoint una misma estructura.

En esta estructura estandarizada, el pedido siempre viene de la siguiente forma:

  • Todos los SKUs comprados del carrito están dentro de un solo pedido.
  • La cantidad de piezas agrupada por SKU. Cada línea de SKU muestra la cantidad de piezas vendidas del SKU correspondiente.

Ejemplo:

  • Línea 1: SKU 1 / 1 pieza.
  • Línea 2: SKU 2 / 3 piezas.

📘

Notas Importantes:

  • Para órdenes de carrito, el id_order a usar debe ser el pack_id.
  • Cuando se unifican ítems en uno solo, se genera un nuevo id_item basado en los ítems que lo componen.

Endpoint

GET https://api.tp.yuju.io/std-orders/?id_channel=4301$id_order=50035

Debes usar Query Params para este endpoint

Parámetros de consulta

Query ParamDescripciónEjemplo
id_orderId de la orden50035
id_channelId del canal4301

Respuesta

{
    "id_shop": 1088955,
    "id_channel": 4301,
    "id_order": "DBG0210232023",
    "billing_address": null,
    "cart_orders": null,
    "coupon": null,
    "currency": "cop",
    "customer": {
        "first_name": "David",
        "last_name": "Beltran",
        "email": "[email protected]",
        "phone": null,
        "phone2": null,
        "nickname": null,
        "customer_id": null,
        "doc_type": null,
        "doc_number": null
    },
    "customer_detail": null,
    "delivery_deadline": null,
    "discounts": [],
    "extra": {},
    "extra_charges": [],
    "ff_type": "fbm",
    "fulfillment_type": null,
    "invoice": {
        "error": "",
        "pk": "",
        "required": "0",
        "rfc": "",
        "status": ""
    },
    "marketplace_fee": 0,
    "meli_chat_status": null,
    "notes": false,
    "paid_total": 2899.99,
    "paid_total_to_seller": 0,
    "payment_accredited_at": "2023-10-25T00:00:00",
    "payment_detail": null,
    "payment_method": "",
    "payment_references": null,
    "reference": "REF01",
    "seller_shipping_cost": 0,
    "shipping_address": null,
    "shipping_cost": 0,
    "shipping_detail": null,
    "tags": null,
    "total": 2899.99,
    "order_components": null,
    "progress": [
        {
            "name": "paid",
            "status": "done"
        },
        {
            "name": "ready_to_ship",
            "status": "done"
        },
        {
            "name": "shipped",
            "status": "pending"
        },
        {
            "name": "delivered",
            "status": "pending"
        }
    ],
    "status": "open",
    "order_updated_at": "2023-10-25T00:00:00",
    "order_created_at": "2023-10-25T00:00:00",
    "actions": [
        "cancel",
        "set_shipped",
        "set_delivered"
    ],
    "claims": [],
    "items": [
        {
            "id_shop": 1088955,
            "id_channel": 4301,
            "id_order": "DBG0210232023",
            "channel_sku": "NKJAIR",
            "combo_components": [],
            "comments": null,
            "currency": "cop",
            "delivery_time": null,
            "extra": null,
            "extra_charges": [],
            "ff_type": "fbm",
            "id_product": null,
            "is_combo": false,
            "marketplace_fee": 0,
            "name": "NKJAIR",
            "price": 2899.99,
            "product": {
                "id_product": null,
                "id_parent": null,
                "upc": null,
                "ean": null,
                "isbn_10": null,
                "isbn_13": null,
                "color": null,
                "size": null,
                "custom_variation": null,
                "custom_variation_name": null,
                "stock": null,
                "price": null,
                "color_text": null,
                "discount": null,
                "discount_to": null,
                "discount_from": null,
                "special_price": null,
                "special_price_amz": null,
                "special_price_linio": null,
                "secondary_color": null,
                "asin": null,
                "gtin": null,
                "jan": null,
                "mpn": null,
                "part_number": null,
                "model": null,
                "brand": null,
                "official_store_id": null,
                "images": [],
                "is_virtual": false,
                "name": null,
                "custom_s1": null,
                "custom_s2": null,
                "custom_s3": null,
                "custom_s4": null,
                "custom_s5": null,
                "custom_i1": null,
                "custom_i2": null,
                "custom_i3": null,
                "custom_i4": null,
                "custom_i5": null,
                "custom_f1": null,
                "custom_f2": null,
                "custom_f3": null,
                "custom_f4": null,
                "custom_f5": null,
                "cost": null,
                "channel_stock": null,
                "shipping_width": null,
                "shipping_height": null,
                "shipping_depth": null,
                "dimensions_unit": null,
                "weight": null,
                "weight_unit": null,
                "tags": null,
                "msrp": null,
                "product_code_sat": null,
                "measure_unit_code_sat": null
            },
            "product_id": "NKJAIR",
            "product_original_price": null,
            "product_special_price": null,
            "sku": "NKJAIR",
            "id_item": "NKJAIR",
            "quantity": 1,
            "item_components": null,
            "shipments": [
                {
                    "buffering_date": null,
                    "carrier": null,
                    "quantity": 1,
                    "status_history": {
                        "date_shipped": null,
                        "date_returned": null,
                        "date_first_visit": null,
                        "date_delivered": null,
                        "date_not_delivered": null,
                        "date_created": null,
                        "date_cancelled": null,
                        "date_first_printed": null,
                        "date_handling": null,
                        "date_ready_to_ship": null,
                        "date_delivered_estimated": null
                    },
                    "id_item": "NKJAIR",
                    "label_url_2": null,
                    "id": null,
                    "tracking_code": null,
                    "tracking_url": null,
                    "status": "ready_to_ship",
                    "label_url": null
                }
            ]
        }
    ]
}

Updated 6 months ago