Mercado Libre - Obtener Ordenes

Descripcion

Este modulo permite consultar las ventas de tu cuenta de Mercado Libre con filtros por estado, fecha, comprador y mas.

Configuracion

Credenciales

Este modulo requiere credenciales de tipo Mercado Libre (OAuth) con los siguientes campos:

Campo	Descripcion
`access_token`	Token de acceso OAuth valido

Parametros

Campo	Tipo	Requerido	Descripcion
`credentials_id`	string	Si	ID de las credenciales
`order_id`	string	No	ID de orden especifica
`seller_id`	string	No	ID del vendedor
`status`	string	No	Estado de la orden
`buyer_id`	string	No	Filtrar por comprador
`tags`	string	No	Filtrar por etiquetas
`date_from`	string	No	Fecha desde (ISO 8601)
`date_to`	string	No	Fecha hasta (ISO 8601)
`sort`	string	No	Ordenamiento
`limit`	number	No	Ordenes por pagina (max 50)
`offset`	number	No	Desplazamiento

Estados de Orden (status)

Valor	Descripcion
`confirmed`	Confirmada
`payment_required`	Pendiente de pago
`payment_in_process`	Pago en proceso
`partially_paid`	Parcialmente pagada
`paid`	Pagada
`partially_refunded`	Parcialmente reembolsada
`cancelled`	Cancelada

Tags de Orden

Valor	Descripcion
`not_delivered`	No entregado
`delivered`	Entregado
`pack_order`	Orden de carrito

Salida

{
  "success": true,
  "orders": [
    {
      "id": 2000001234567890,
      "status": "paid",
      "status_detail": {...},
      "date_created": "2024-01-15T10:30:00.000-03:00",
      "buyer": {
        "id": 123456789,
        "nickname": "COMPRADOR123"
      },
      "order_items": [...],
      "payments": [...],
      "shipping": {...},
      "total_amount": 89999
    }
  ],
  "total": 250,
  "offset": 0,
  "limit": 50,
  "message": "50 ordenes obtenidas"
}

Ejemplo de Uso

Obtener orden por ID

{
  "credentials_id": "meli_cuenta",
  "order_id": "2000001234567890"
}

Ordenes pagadas

{
  "credentials_id": "meli_cuenta",
  "status": "paid",
  "limit": 50
}

Ordenes pendientes de envio

{
  "credentials_id": "meli_cuenta",
  "status": "paid",
  "tags": "not_delivered"
}

Ordenes de hoy

{
  "credentials_id": "meli_cuenta",
  "date_from": "2024-01-15T00:00:00.000-03:00",
  "date_to": "2024-01-15T23:59:59.000-03:00"
}

Ordenes de un comprador

{
  "credentials_id": "meli_cuenta",
  "buyer_id": "123456789"
}

Ordenes entregadas

{
  "credentials_id": "meli_cuenta",
  "tags": "delivered",
  "sort": "date_desc"
}

Campos de la Orden

Campo	Descripcion
`id`	ID unico de la orden
`status`	Estado de la orden
`date_created`	Fecha de creacion
`date_closed`	Fecha de cierre
`buyer`	Informacion del comprador
`order_items`	Productos de la orden
`payments`	Pagos asociados
`shipping`	Informacion de envio
`total_amount`	Monto total
`currency_id`	Moneda
`tags`	Etiquetas de la orden
`pack_id`	ID del carrito (si aplica)

Workflows de Ejemplo

Procesar ordenes nuevas

[Webhook orden pagada] -> [MeliGetOrders] -> [Crear pedido ERP] -> [Preparar envio]

Sincronizacion de ventas

[Schedule c/15min] -> [MeliGetOrders pagadas] -> [Actualizar sistema] -> [Notificar]

Reporte diario

[Schedule 23:00] -> [MeliGetOrders del dia] -> [Generar reporte] -> [Email]

Seguimiento de entregas

[Schedule c/hora] -> [MeliGetOrders not_delivered] -> [Verificar tracking] -> [Alerta]

Uso con ExecuteScript

// Analizar ventas del dia
const ordenes = ctx.data.orders;

const resumen = {
  total_ordenes: ordenes.length,
  total_ventas: ordenes.reduce((sum, o) => sum + o.total_amount, 0),
  ticket_promedio: ordenes.length > 0
    ? ordenes.reduce((sum, o) => sum + o.total_amount, 0) / ordenes.length
    : 0,
  por_estado: {}
};

ordenes.forEach(o => {
  resumen.por_estado[o.status] = (resumen.por_estado[o.status] || 0) + 1;
});

ctx.data = resumen;

// Preparar ordenes para fulfillment
const ordenes = ctx.data.orders;

ctx.data = ordenes
  .filter(o => o.status === 'paid' && o.shipping?.status === 'ready_to_ship')
  .map(o => ({
    order_id: o.id,
    buyer_name: o.buyer.nickname,
    items: o.order_items.map(i => ({
      title: i.item.title,
      quantity: i.quantity,
      sku: i.item.seller_custom_field
    })),
    shipping_id: o.shipping.id
  }));

API Utilizada

API: Mercado Libre Orders API
Endpoint: GET /orders/search, GET /orders/{id}
Documentacion: https://developers.mercadolibre.com/

Notas

El limite maximo por peticion es 50 ordenes
Las fechas deben estar en formato ISO 8601 con timezone
El campo pack_id indica ordenes de carrito (multiples items)
Para mas detalles de envio, usar meliGetShipment
Las ordenes incluyen informacion basica del comprador

Nodos Relacionados

MeliGetShipment - Obtener detalles de envio de una orden
MeliGetItems - Obtener informacion de los items vendidos
MeliSendMessage - Enviar mensaje al comprador
MeliGetUser - Obtener datos del comprador