Mercado Libre - Obtener Envío

↩ Parte de la integración Mercado Libre.

Descripción

Este modulo permite consultar el estado del envío, tracking, etiqueta y dirección de entrega de una venta.

Configuración

Credenciales

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

Campo	Descripción
access_token	Token de acceso OAuth valido

Parámetros

Campo	Tipo	Requerido	Descripción
credentials_id	string	Si	ID de las credenciales
shipment_id	string	Condicional	ID del envío
order_id	string	Condicional	ID de la orden (alternativo)
include_tracking	boolean	No	Incluir historial de tracking
include_label	boolean	No	Incluir datos de etiqueta

Se requiere shipment_id O order_id

Estados de Envío

Estado	Descripción
pending	Pendiente
handling	En preparación
ready_to_ship	Listo para enviar
shipped	En camino
delivered	Entregado
not_delivered	No entregado
cancelled	Cancelado

Salida

{
  "success": true,
  "shipment": {...},
  "shipment_id": 41234567890,
  "status": "shipped",
  "substatus": "in_transit",
  "tracking_number": "ABC123456789",
  "tracking_method": "correo_argentino",
  "receiver_address": {
    "street_name": "Av. Corrientes",
    "street_number": "1234",
    "city": "Buenos Aires",
    "state": "AR-C",
    "zip_code": "1043"
  },
  "tracking_history": [...],
  "message": "Envio 41234567890 obtenido correctamente"
}

Ejemplo de Uso

Obtener envío por ID

{
  "credentials_id": "meli_cuenta",
  "shipment_id": "41234567890"
}

Obtener envío de una orden

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

Incluir historial de tracking

{
  "credentials_id": "meli_cuenta",
  "shipment_id": "41234567890",
  "include_tracking": true
}

Incluir datos de etiqueta

{
  "credentials_id": "meli_cuenta",
  "shipment_id": "41234567890",
  "include_label": true
}

Información completa

{
  "credentials_id": "meli_cuenta",
  "order_id": "2000001234567890",
  "include_tracking": true,
  "include_label": true
}

Campos del Envío

Campo	Descripción
id	ID del envío
status	Estado actual
substatus	Sub-estado detallado
tracking_number	Número de seguimiento
tracking_method	Método de envío
date_created	Fecha de creación
receiver_address	Dirección de entrega
sender_address	Dirección de origen
shipping_option	Opción de envío
cost	Costo del envío

Workflows de Ejemplo

Seguimiento automático

[Webhook envio] -> [MeliGetShipment] -> [Actualizar estado] -> [Notificar cliente]

Impresion de etiquetas

[Orden pagada] -> [MeliGetShipment label] -> [Generar PDF] -> [Imprimir]

Monitor de entregas

[Schedule c/hora] -> [Obtener envios shipped] -> [MeliGetShipment tracking] -> [Verificar]

Uso con ExecuteScript

// Verificar estado de entrega
const envio = ctx.data.shipment;

const estadoFinal = ['delivered', 'not_delivered', 'cancelled'];

ctx.data = {
  shipment_id: envio.id,
  esta_en_transito: envio.status === 'shipped',
  esta_entregado: envio.status === 'delivered',
  requiere_accion: envio.status === 'not_delivered',
  tracking: envio.tracking_number,
  direccion: `${envio.receiver_address.street_name} ${envio.receiver_address.street_number}`,
  ciudad: envio.receiver_address.city
};

API Utilizada

• API: Mercado Libre Shipments API
• Endpoint: GET /shipments/{id}
• Documentación: https://developers.mercadolibre.com/

Notas

• El shipment_id se obtiene de la orden (order.shipping.id)
• El historial de tracking puede no estar disponible para todos los envíos
• La etiqueta solo esta disponible para Mercado Envíos
• Los estados varian según el tipo de envío (ME, Flex, Colecta)

Nodos Relacionados

• MeliGetOrders - Obtener ordenes con información de envío
• MeliSendMessage - Notificar al comprador sobre el envío
• MeliGetUser - Obtener datos del comprador