Mercado Libre: catálogo y pedidos

Integración con Mercado Libre

La integración con Mercado Libre te permite gestionar tu negocio desde Parrot CRM:

• Sincronizar tu catálogo de productos
• Recibir y gestionar pedidos
• Responder mensajes de compradores
• Enviar respuestas automáticas con ChatGPT

Sincronización de catálogo

Cómo funciona

1. Los productos de tu cuenta de Mercado Libre se importan automáticamente
2. Se almacenan en documentos meli-item: dentro de tu base de CouchDB
3. Puedes editar precios, descripciones y fotos desde Parrot
4. Los cambios se sincronizan de vuelta a Mercado Libre

Acceder al catálogo

1. Ve a Configuración → Mercado Libre → Catálogo
2. Verás la lista de productos sincronizados
3. Puedes filtrar por estado (activo/inactivo), precio, etc.

Importar productos

1. Haz clic en “Importar catálogo”
2. Se sincronizan todos tus productos activos de Mercado Libre
3. Los productos aparecen en tu catálogo de Parrot
4. Puedes editar cada producto individualmente

Estructura de productos

type MeliItemDoc = {
    _id: string;           // "meli-item:ITEM_ID"
    type: 'mercadolibre';
    title: string;         // Título del producto
    price: number;         // Precio
    currency_id: string;   // Moneda (MXN, USD, etc.)
    picture_url: string;   // URL de la imagen
    status: string;        // active, inactive
    category_id: string;   // Categoría de ML
    seller: string;        // ID del vendedor
    updated: number;
};

Gestión de pedidos

Ver pedidos

1. Ve a Configuración → Mercado Libre → Pedidos
2. Los pedidos se muestran como una lista con:
   • Número de pedido
   • Cliente
   • Productos
   • Estado
   • Monto total

Estructura de pedidos

type MeliOrderDoc = {
    _id: string;           // "meli-order:ORDER_ID"
    type: 'mercadolibre';
    total_amount: number;  // Monto total
    status: string;        // pending, paid, shipped, etc.
    items: Array<{
        title: string;
        quantity: number;
        unit_price: number;
    }>;
    buyer: {
        name: string;
        email: string;
    };
    shipping: {
        status: string;
        tracking_number: string;
    };
    updated: number;
};

Estado del pedido

Estado	Descripción
Pendiente	Pedido recibido, pendiente de pago
Pagado	Pago confirmado
En preparación	Preparando para envío
Enviado	Pedido enviado
Entregado	Entregado al cliente
Cancelado	Pedido cancelado
Devolución	Solicitud de devolución

Respuestas automáticas para pedidos

1. Ve a Configuración → Respuestas automáticas
2. Crea una respuesta con condición “Mensaje de MercadoLibre”
3. Configura el prompt para que responda con info del pedido
4. El sistema puede enviar info de tracking automáticamente

Webhooks de Mercado Libre

Parrot recibe webhooks de Mercado Libre para:

• Nuevos pedidos
• Cambios de estado del pedido
• Actualizaciones de catálogo
• Mensajes de compradores

Limitaciones

• Solo puedes conectar una cuenta de Mercado Libre por tenant
• El catálogo se sincroniza periódicamente (no en tiempo real)
• Los mensajes de Mercado Libre tienen sus propias políticas de respuesta
• Los webhooks pueden tener un delay de hasta 5 minutos

Tips

• Revisa el catálogo semanalmente para asegurar que los precios estén actualizados
• Configura respuestas automáticas para los estados más comunes de pedidos
• Monitorea los pedidos pendientes regularmente
• Usa etiquetas para clasificar pedidos por prioridad
• Exporta pedidos para análisis de ventas