Automatización · Operación y reportes
Guardar el reporte semanal de pedidos de Mercado Libre en Google Sheets
Recorre una semana cerrada de pedidos visibles de Mercado Libre Colombia y guarda en Sheets un agregado por estado, sin datos de compradores y con aprobación.
¿Cómo guardo en Google Sheets un reporte semanal verificable de mis pedidos de Mercado Libre?
Ejecutas la tarea manualmente con el lunes de una semana que ya terminó y una fila vacía de la pestaña Weekly Meli. El Met genera un UUID aleatorio, consulta una sola cuenta de Mercado Libre Colombia y recorre como máximo 20 páginas o 1.000 órdenes candidatas. Filtra el intervalo exacto desde el lunes a las 00:00 hasta el lunes siguiente a las 00:00, sin incluir ese último borde, y devuelve conteos e importes total_amount por estado, unidades y los 20 productos con más unidades. No devuelve comprador, pago ni número de orden. Si la lectura no queda completa, no escribe. Si queda completa, muestra el UUID, el hash, el rango y los 13 valores; solo después de tu aprobación hace una escritura RAW y relee la fila. El resultado sirve para operación: no es ingreso neto, ganancia ni dinero liquidado.
Qué la pone en marcha
Cuando alguien lo pide
Una persona ejecuta la tarea con week_start, que debe ser lunes de una semana ya cerrada en America/Bogota, el spreadsheet_id y una fila vacía exacta entre A2:M2 y A3500:M3500 de la pestaña Weekly Meli. No hay cron ni recurrencia implícita.
Una tarea de ejecución manual: alguien del equipo la corre con un botón, o se la pide al Met por chat.
Quién la ejecuta
Met de operación del marketplace
No tiene nombre propio sembrado. Su oficio es cerrar una semana acotada sin convertir datos de pedidos en contabilidad ni copiar información de compradores a una hoja. La aprobación separa la lectura del marketplace de la única escritura externa.
Qué hay que tener conectado
- Mercado Libre Operar tienda y pedidos
- Google Workspace Automatizar y colaborar
4 pasos · 5 herramientas
El procedimiento, paso a paso
Cada paso muestra la herramienta que se ejecuta. Son las del conector real: si una dejara de existir, esta página no compilaría.
- 1
Confirmar la cuenta y conservar solo el sitio del vendedor
La consulta de cuenta confirma que las credenciales corresponden al vendedor esperado y que site_id es MCO antes de pedir una semana. La herramienta devuelve únicamente el id técnico, nickname, country_id y site_id; no expone nombre, apellido ni correo. Si el sitio no es Colombia o la cuenta no es la esperada, se detiene. La herramienta semanal vuelve a consultar /users/me y revalida MCO: este primer paso sirve para que la persona detecte una conexión equivocada antes del recorrido, no sustituye el gate técnico.
- 2
Cerrar una sola semana colombiana y probar que la lectura está completa
El Met crea un UUID v4 aleatorio y opaco, sin correo, teléfono, nombre ni número de pedido, y llama la herramienta con el lunes elegido. La cuenta autenticada debe ser MCO y todos los importes deben venir en COP. La consulta pide desde ese lunes 00:00 hasta el lunes siguiente 00:00 y luego aplica localmente el intervalo semiabierto: una orden del domingo a las 23:59:59 entra y una del lunes siguiente a las 00:00 no. Recorre páginas de 50, hasta 20 y 1.000 órdenes. Si cambia paging.total, falta o se repite un ID, una página termina antes de tiempo, aparece otra moneda o se supera el techo, devuelve complete:false. Ese resultado se muestra como incompleto y nunca pasa a Sheets.
- 3
Comprobar la pestaña, los encabezados y una fila vacía
La metadata debe mostrar la pestaña exacta Weekly Meli. Sus columnas A:M son operation_key, report_hash, week_start, week_end, timezone, site_id, currency_id, visible_order_count, item_units, order_amount_total, orders_by_status, amount_by_status y products_by_units_top_20. Una lectura acotada permite elegir una sola fila entre 2 y 3500 que esté completamente vacía. Si falta la pestaña, cambiaron los encabezados o hay cualquier valor en la fila, la tarea se detiene; no cambia a otra pestaña ni a un rango aproximado.
- 4
Mostrar, esperar aprobación y escribir una sola vez
El resultado complete:true trae el UUID, un SHA-256 que cubre la clave y el reporte completo, y los agregados sin datos del comprador. El Met muestra ese UUID, el hash, la fila A:M elegida y los 13 valores completos en su orden, incluidas las tres celdas JSON. También deja visibles los límites: total_amount por estado actual no es ingreso, no incluye comisiones, retenciones, envíos, devoluciones ni conciliación de Mercado Pago, y la vista de vendedor no expone todas las cancelaciones. Solo una aprobación explícita de ese contenido habilita confirmar=true; un cambio de semana, rango o valor invalida la aprobación y obliga a mostrar un hash nuevo. Tras aprobar, la herramienta dedicada vuelve a exigir Weekly Meli, el UUID, hash, reporte y confirmar=true. Relee A1:M1 y los 13 encabezados exactos; luego prelee la fila y solo si sigue vacía hace un único values.update RAW con retry:false. Relee las 13 celdas y, ante una respuesta incierta, no reenvía el update: solo reconoce éxito si todo coincide. Prelectura y update no son CAS; otro escritor todavía puede intervenir, por lo que no se promete unicidad atómica.
Antes de empezar
Qué necesitas tener listo
Ninguno de estos puntos lo resuelve el Met. Si falta uno, la automatización se detiene ahí.
-
Una cuenta de vendedor de Mercado Libre Colombia autorizada
Conecta por OAuth la cuenta MCO que se quiere reportar. La herramienta confirma site_id MCO antes de recorrer órdenes y usa solo ese vendedor; no mezcla cuentas ni países.
-
Una hoja con la pestaña Weekly Meli y 13 encabezados fijos
Prepara el archivo con la pestaña y las columnas A:M indicadas en el segundo paso, y comparte acceso con la misma cuenta de Google autorizada en Meteor. Las filas de datos permitidas son 2 a 3500.
-
La semana y la fila que se van a aprobar
Elige el lunes de una semana ya terminada en Colombia y una fila vacía. El Met genera el UUID y el hash; no los construyas con nombres, pedidos u otros datos identificables.
Los límites
Qué NO resuelve esta automatización
Preferimos decirlo aquí que descubrirlo en la implementación.
-
No se ejecuta solo cada lunes. Es una tarea manual por semana cerrada; programarla exige un scheduler real y versionado que esta receta no presupone.
-
No es un reporte de ingresos, utilidad, caja disponible ni liquidación de Mercado Pago. Los importes son total_amount de órdenes visibles agrupados por su estado actual.
-
No calcula comisiones, retenciones, costo de envío, devoluciones ni contracargos. Esos datos necesitan fuentes y una conciliación distintas; aquí no se estiman.
-
No garantiza ver todas las cancelaciones: la búsqueda como vendedor filtra algunas de esa vista. Tampoco escribe si hay más de 1.000 órdenes candidatas o la paginación no queda estable.
-
No ofrece exclusión mutua entre escritores. Google Sheets separa la prelectura del update; una carrera concurrente puede ocupar o sobrescribir la fila y exige inspección humana, nunca retry.
Preguntas frecuentes
Preguntas sobre esta automatización
Porque suma total_amount de las órdenes que la vista del vendedor devuelve y las agrupa por su estado actual. No descuenta comisiones, retenciones, envío o devoluciones y no consulta la liquidación de Mercado Pago. Llamarlo ingreso neto sería mezclar contratos distintos.
Sí. El intervalo local incluye el lunes inicial y todo el domingo hasta antes del lunes siguiente a las 00:00. Como la API reduce la precisión del filtro de fecha, la herramienta pide el borde y vuelve a filtrar cada date_created localmente.
La herramienta devuelve complete:false antes de escribir. Hay que reducir el período con una herramienta futura que conserve las mismas garantías o ejecutar un proceso asíncrono diseñado para ese volumen; esta receta no parte la semana ni presenta una muestra como completa.
Sí, existe esa carrera porque leer y actualizar son dos llamadas, no una comparación atómica. La herramienta reduce el riesgo con fila exacta, clave, hash, prelectura, un solo update y relectura, pero ante concurrencia se inspecciona el rango y nunca se reintenta a ciegas.
Sigue por aquí
Otras automatizaciones con las mismas herramientas
Marketplaces
Mantener precio y stock al día entre la tienda y Mercado Libre
¿Cómo evito vender en Mercado Libre algo que ya se agotó en mi tienda?
- Arranca:
- a una hora fija
- Pasos:
- 5, con 11 herramientas reales
- Necesita:
- Mercado Libre · WooCommerce
Marketplaces
Publicar el catálogo de WooCommerce en Mercado Libre sin arriesgar la cuenta
¿Cómo subo mi catálogo de WooCommerce a Mercado Libre sin que me rechacen las publicaciones?
- Arranca:
- cuando alguien lo pide
- Pasos:
- 6, con 12 herramientas reales
- Necesita:
- Mercado Libre · WooCommerce
Atención y agendamiento
Responder «¿dónde va mi pedido?» de Mercado Libre por WhatsApp
¿Cómo respondo el estado de un pedido de Mercado Libre sin entrar al panel del vendedor?
Atención al cliente
- Arranca:
- cuando el cliente escribe
- Pasos:
- 5, con 10 herramientas reales
- Necesita:
- Mercado Libre · CRM de Meteor
Operación y reportes
Crear un dashboard interno con IA desde Google Sheets
¿Cómo creo un dashboard con IA desde los datos que ya tengo en Google Sheets?
- Arranca:
- cuando alguien lo pide
- Pasos:
- 6, con 5 herramientas reales
- Necesita:
- Google Workspace · Páginas de Meteor
¿Quieres esta automatización corriendo con tus datos?
Te la mostramos con tus cuentas conectadas, no con una demostración enlatada.