Mercado Libre - Obtener Usuario

↩ Parte de la integración Mercado Libre.

Descripción

Este modulo permite consultar información de usuarios, ya sea el usuario autenticado (tu cuenta) o información publica de otros usuarios como compradores o vendedores.

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
`user_id`	string	No	ID del usuario a consultar
`get_me`	boolean	No	Obtener usuario autenticado
`include_reputation`	boolean	No	Incluir datos de reputación
`include_address`	boolean	No	Incluir direcciones (solo propio)

Salida

{
  "success": true,
  "user": {...},
  "user_id": 123456789,
  "nickname": "VENDEDOR_PRO",
  "email": "vendedor@email.com",
  "first_name": "Juan",
  "last_name": "Perez",
  "country_id": "AR",
  "seller_reputation": {
    "level_id": "5_green",
    "power_seller_status": "platinum",
    "transactions": {
      "completed": 1500,
      "canceled": 10
    }
  },
  "message": "Usuario VENDEDOR_PRO obtenido correctamente"
}

Ejemplo de Uso

Obtener mi información

{
  "credentials_id": "meli_cuenta",
  "get_me": true
}

Obtener usuario por ID

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

Mi información con reputación

{
  "credentials_id": "meli_cuenta",
  "get_me": true,
  "include_reputation": true
}

Mi información con direcciones

{
  "credentials_id": "meli_cuenta",
  "get_me": true,
  "include_address": true
}

Información completa de mi cuenta

{
  "credentials_id": "meli_cuenta",
  "get_me": true,
  "include_reputation": true,
  "include_address": true
}

Campos del Usuario

Campo	Descripción
`id`	ID único del usuario
`nickname`	Nombre de usuario publico
`email`	Email (solo usuario propio)
`first_name`	Nombre
`last_name`	Apellido
`country_id`	Pais (AR, MX, BR, etc.)
`site_id`	Sitio (MLA, MLM, MLB, etc.)
`seller_reputation`	Reputación como vendedor
`buyer_reputation`	Reputación como comprador
`status`	Estado de la cuenta
`user_type`	Tipo de usuario

Niveles de Reputación

Nivel	Color	Descripción
`1_red`	Rojo	Reputación muy baja
`2_orange`	Naranja	Reputación baja
`3_yellow`	Amarillo	Reputación regular
`4_light_green`	Verde claro	Buena reputación
`5_green`	Verde	Excelente reputación

Power Seller Status

Estado	Descripción
`gold`	Vendedor Gold
`platinum`	Vendedor Platinum
`null`	Sin calificación

Workflows de Ejemplo

Verificar reputación de comprador

[Orden recibida] -> [MeliGetUser buyer_id] -> [Evaluar riesgo] -> [Decidir accion]

Monitor de reputación propia

[Schedule diario] -> [MeliGetUser me + reputation] -> [Verificar cambios] -> [Alerta]

Obtener datos para facturación

[Orden pagada] -> [MeliGetUser] -> [MeliGetUser address] -> [Generar factura]

Uso con ExecuteScript

// Evaluar riesgo de comprador
const comprador = ctx.data.user;

let riesgo = 'bajo';
let notas = [];

// Verificar reputacion
const reputacion = comprador.buyer_reputation;
if (!reputacion) {
  riesgo = 'medio';
  notas.push('Sin historial de compras');
} else if (reputacion.canceled_transactions > 3) {
  riesgo = 'alto';
  notas.push(`${reputacion.canceled_transactions} compras canceladas`);
}

// Verificar antiguedad
const fechaRegistro = new Date(comprador.registration_date);
const diasRegistro = (Date.now() - fechaRegistro) / (1000 * 60 * 60 * 24);
if (diasRegistro < 30) {
  riesgo = riesgo === 'bajo' ? 'medio' : 'alto';
  notas.push('Cuenta nueva (< 30 dias)');
}

ctx.data = {
  buyer_id: comprador.id,
  nickname: comprador.nickname,
  nivel_riesgo: riesgo,
  notas: notas,
  aprobar_automatico: riesgo === 'bajo'
};

API Utilizada

API: Mercado Libre Users API
Endpoint: GET /users/me, GET /users/{id}
Documentación: https://developers.mercadolibre.com/

Notas

El email solo esta disponible para el usuario autenticado
Las direcciones solo estan disponibles para el usuario propio
La información de otros usuarios es publica y limitada
La reputación de vendedor incluye métricas de ventas
La reputación de comprador incluye métricas de compras

Nodos Relacionados

MeliGetOrders - Obtener ordenes del usuario
MeliGetItems - Obtener items del vendedor
MeliGetQuestions - Obtener preguntas del usuario