Mercado Libre - Obtener Envio

Descripcion

Este modulo permite consultar el estado del envio, tracking, etiqueta y direccion de entrega de una venta.

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
`shipment_id`	string	Condicional	ID del envio
`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 Envio

Estado	Descripcion
`pending`	Pendiente
`handling`	En preparacion
`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 envio por ID

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

Obtener envio 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
}

Informacion completa

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

Campos del Envio

Campo	Descripcion
`id`	ID del envio
`status`	Estado actual
`substatus`	Sub-estado detallado
`tracking_number`	Numero de seguimiento
`tracking_method`	Metodo de envio
`date_created`	Fecha de creacion
`receiver_address`	Direccion de entrega
`sender_address`	Direccion de origen
`shipping_option`	Opcion de envio
`cost`	Costo del envio

Workflows de Ejemplo

Seguimiento automatico

[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}
Documentacion: 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 envios
La etiqueta solo esta disponible para Mercado Envios
Los estados varian segun el tipo de envio (ME, Flex, Colecta)

Nodos Relacionados

MeliGetOrders - Obtener ordenes con informacion de envio
MeliSendMessage - Notificar al comprador sobre el envio
MeliGetUser - Obtener datos del comprador