Guía · Procesos Automáticos

Automatizá la actualización de precio, stock y la exportación de ventas

Con los Procesos Programados de Integraly configurás una tarea que se ejecuta sola, cada cierto tiempo, para mantener tus publicaciones al día o descargar tus ventas — sin tener que abrir Excel ni hacerlo a mano. Esta guía explica, paso a paso, cómo crearlos, sus alternativas y cómo llevarlos a un servidor.

01 Qué es y para qué sirve

Un proceso automático es una tarea que Integraly registra en tu Windows para que se ejecute por sí sola con la frecuencia que elijas (por ejemplo, cada 15 minutos o todos los días a las 7:00). Hay dos grandes tipos:

Precio y/o Stock

Actualiza tus publicaciones

Toma un archivo (CSV o XLSX) con tus códigos y valores, y actualiza en MercadoLibre el precio, el stock, o ambos.

Ventas

Exporta tus ventas

Descarga tus ventas (pagos aprobados) a un archivo por día, con los campos que elijas, listo para tu contabilidad o conciliación.

En un servidor

Corre 24/7 sin Excel

Cualquier proceso se puede exportar para instalarlo en otra PC o servidor y que funcione solo, sin depender de tu Excel.

¿En qué casos conviene?

02 Abrir Procesos Programados

En Excel, con el complemento instalado, entrá a la pestaña Integraly y, en la sección Más funciones, hacé clic en Procesos Programados. (Tené la cuenta de MercadoLibre iniciada con Login.)

Cinta de Integraly con el botón Procesos Programados
Cinta El botón Procesos Programados en la pestaña Integraly.

03 La ventana de procesos

Es el panel central donde ves y administrás todos tus procesos. Cada fila es un proceso; abajo tenés los botones de acción.

Ventana Procesos programados con la lista y los botones
Panel Lista de procesos con Tipo, Cuenta, Archivo/Carpeta, Programación y estado de la Tarea.

Las columnas

ColumnaQué muestra
NombreEl nombre que le pusiste al proceso.
TipoPrecio, Stock, Precio y Stock o Ventas, según lo que hace.
CuentaLa cuenta de MercadoLibre sobre la que opera.
Archivo / CarpetaEl archivo de origen (Precio/Stock) o la carpeta destino (Ventas).
ProgramaciónCada cuánto se ejecuta (cada N minutos/horas, o diario a una hora).
TareaSí/No: si la tarea quedó registrada en el Programador de tareas de Windows.

Los botones

Nuevo
Crea un proceso desde cero.
Editar
Modifica el proceso seleccionado.
Eliminar
Borra el proceso y quita su tarea programada.
Probar ahora
Ejecuta el proceso en el momento, sin esperar a la programación (ideal para verificar que quedó bien).
Exportar a servidor
Genera un .zip autocontenido para llevar el proceso a otra PC o servidor.
Cerrar
Cierra la ventana (los procesos siguen corriendo según su programación).

04 Preparar el archivo (Precio/Stock)

Para los procesos de precio/stock necesitás un archivo CSV o XLSX. La primera fila son los encabezados (nombres de columna) y cada fila siguiente es una publicación. Vas a necesitar una columna clave (para identificar la publicación) y las columnas de precio y/o stock.

Ejemplo de archivo XLSX con columnas Codigo, Precio y Stock
XLSX Encabezados en la fila 1: Codigo, Precio, Stock.
Ejemplo de archivo CSV con columnas Codigo, Precio y Stock
CSV El mismo listado en texto plano, separado por punto y coma.

El archivo CSV se ve así (el separador puede ser ; o ,, se detecta solo):

Codigo;Precio;Stock
ABC123;15659;50
DEF456;24890;32
GHI789;9750;18
JKL234;32150;75
Consejo

Los nombres de las columnas los elegís vos: al crear el proceso le indicás cuál es la columna clave, la de precio y la de stock. No hace falta que se llamen exactamente “Precio” o “Stock”.

05 Crear un proceso paso a paso

Desde la ventana de procesos, hacé clic en Nuevo y seguí estos pasos.

Elegí el tipo de proceso

Se abre un cuadro que pregunta “¿Qué tipo de proceso querés crear?”. Elegí Precio y/o Stock o Exportación de Ventas y hacé clic en Continuar.

Cuadro para elegir el tipo de proceso
Tipo Precio y/o Stock, o Exportación de Ventas.

Completá los datos del proceso

Para un proceso de Precio y/o Stock se abre este formulario. Más abajo está explicado campo por campo.

Formulario de proceso de Precio y Stock
Formulario Configuración de un proceso de Precio y/o Stock.

Campo por campo

Nombre
Cómo vas a identificar el proceso en la lista (ej. “Precio Base”).
Cuenta MeLi
La cuenta de MercadoLibre sobre la que se aplican los cambios. Debe estar iniciada en el complemento.
Archivo (CSV/XLSX)
El listado con los datos. Usá Examinar para seleccionarlo.
Actualizar
Tildá Actualizar precio, Actualizar stock o ambos. Según lo que tildes se habilitan las columnas correspondientes.
Clave
Cómo se identifica cada publicación: por Id (de MercadoLibre) o por SKU (tu código). Con SKU, un mismo código puede actualizar varias publicaciones.
Columna clave
El nombre de la columna del archivo que contiene la clave (ej. Codigo).
Columna precio
El nombre de la columna con el precio (si actualizás precio).
Columna stock
El nombre de la columna con el stock (si actualizás stock).
El precio del archivo es
Precio de publicación (se aplica tal cual) o Monto a recibir (calcula el precio para que te quede ese neto). Ver la sección siguiente.
Omitir si el valor ya coincide
Si el precio/stock ya es el mismo, no reenvía el cambio (marca “sin cambios”). Recomendado.
Programación
Cada N minutos, Cada N horas o Diario a las (HH:MM). Definís la frecuencia.
Activo
Registra la tarea en Windows. Si lo destildás, el proceso queda guardado pero no se ejecuta solo.
Log
Obligatorio: elegí TXT y/o Excel. Es el registro de cada corrida.
Carpeta logs
Opcional: dónde guardar los logs. Si lo dejás vacío, usa una carpeta por defecto.

Al finalizar, Aceptar guarda el proceso y —si está Activo— registra la tarea programada.

06 Alternativas y opciones

Estas tres decisiones definen cómo se comporta el proceso. Elegilas según tu operatoria.

Qué actualiza: precio, stock o ambos

Solo Precio

Ajuste de precios

Actualizás solo el precio (por ejemplo, según una lista que cambia seguido). El stock queda como está.

Solo Stock

Control de stock

Actualizás solo las cantidades. Ideal para sincronizar inventario varias veces al día.

Precio y Stock

Sincronización total

Actualizás ambos en la misma corrida, desde un único archivo.

Cómo se interpreta el precio del archivo

OpciónQué haceCuándo usarla
Precio de publicación El valor del archivo se publica tal cual como precio de venta. Cuando ya tenés el precio final que querés mostrar.
Monto a recibir (calcula precio) El valor del archivo es el neto que querés cobrar. El sistema calcula el precio de publicación de cada aviso contemplando la comisión de ML y el costo de envío, para que te quede ese neto. Tras aplicarlo, vuelve a verificar el neto real y, si hace falta, lo ajusta. Cuando querés fijar tu ganancia y que el precio se calcule solo — incluso si el mismo producto tiene distintas condiciones de venta.

Cómo se identifica cada publicación

ClaveQué esDetalle
IdEl identificador de MercadoLibre (ej. MLA123456789).Apunta a una publicación exacta.
SKUTu código interno (seller_custom_field).Un mismo SKU puede resolver a varias publicaciones: se actualizan todas.

Cada cuánto se ejecuta

Cada N minutos
Para stock que cambia mucho (ej. cada 10 o 15 minutos).
Cada N horas
Para actualizaciones periódicas (ej. cada 6 horas).
Diario a las
Una vez por día a la hora que indiques (ej. 08:00).

07 Proceso de Ventas

Si al crear elegiste Exportación de Ventas, se abre este formulario. En vez de un archivo de origen, definís una carpeta destino donde se guardan los archivos de ventas (uno por día).

Formulario de proceso de Ventas
Formulario Configuración de un proceso de exportación de Ventas.

Campo por campo

Nombre
Nombre del proceso en la lista.
Cuenta MeLi
La cuenta cuyas ventas se exportan.
Carpeta destino
Dónde se guardan los archivos. Se genera un archivo por día.
Formato archivo
CSV o XLSX.
Días a obtener
Solo hoy o Últimos N días (incluye el día actual).
Campos a exportar
Tildás qué datos incluir: Fecha de aprobación/pago, Payment Id, Order Id, Estado, Monto total, Monto neto recibido, Comisión, Método de pago y más.
Programación
La frecuencia (típicamente Diario a las).
Activo
Registra la tarea programada.
Carpeta logs
Opcional: dónde guardar el registro de cada corrida.

Las ventas se toman por fecha de aprobación del pago, en hora local.

08 Probar y revisar el log

Antes de dejarlo automático, conviene verificar que todo quede bien.

Probar ahora

Seleccioná el proceso en la lista y hacé clic en Probar ahora. Se ejecuta en el momento (sin esperar la programación) y genera el archivo/log, para que veas el resultado real.

El log de cada corrida

Cada ejecución escribe un registro con una línea por cambio y un resumen final:

Dónde queda

El log se guarda en la carpeta de logs que indicaste (o en la carpeta por defecto). Podés elegir formato TXT y/o Excel.

09 La tarea en el Programador de tareas

Cuando el proceso está Activo, Integraly lo registra como una Tarea Programada de Windows. Podés verla —y confirmar que quedó creada— en el Programador de tareas.

Cómo abrirlo

Abrí el menú Inicio y buscá “Programador de tareas”.

Buscar Programador de tareas en el menú Inicio
Inicio Buscá “Programador de tareas”.

Dónde queda la tarea

Dentro del Programador, andá a Biblioteca del Programador de tareas → carpeta “Integraly”. Ahí se crea una tarea por cada proceso, con su nombre.

Carpeta Integraly en el Programador de tareas con una tarea por proceso
Carpeta Integraly Cada proceso es una tarea, con su Estado y su Desencadenador (la frecuencia).
Nota

No necesitás tocar nada acá: Integraly crea, actualiza y elimina la tarea por vos (con los botones de la ventana de procesos). Esta vista sirve para confirmar que quedó registrada o para revisar su estado.

10 Exportar a un servidor

Si querés que el proceso corra en otra PC o en un servidor 24/7 (sin necesidad de tener Excel abierto), usá Exportar a servidor. Genera un .zip autocontenido con todo lo necesario.

Cuadro para guardar el ZIP de exportación del proceso
Exportar Se guarda un .zip con el nombre del proceso.

Qué contiene el ZIP

Cómo instalarlo en el servidor

Copiá la carpeta al servidor

Descomprimí el ZIP en el servidor, por ejemplo en C:\Integraly\MiProceso.

Ajustá las rutas

Abrí Jobs\<nombre>.json con un editor de texto y corregí las rutas para el servidor: ArchivoOrigen (Precio/Stock), CarpetaDestino (Ventas) y, opcionalmente, CarpetaLogs. Dejá el archivo de origen en esa ruta.

Probalo

Doble clic en _ejecutar.cmd. Verificá que diga Totales sin errores y que se genere el log.

Programalo

Clic derecho en instalar-tarea.cmdEjecutar como administrador. Queda registrada la tarea con la frecuencia configurada. Para quitarla, usá desinstalar-tarea.cmd.

Requisitos del servidor

Windows con .NET Framework 4.5.1 o superior (4.8 recomendado) y salida a internet (hacia api.mercadolibre.com, api.mercadopago.com y el backend de Integraly).

Sesión de Windows

La tarea corre cuando hay una sesión iniciada. Si el servidor no tiene una sesión abierta, configurá la tarea en el Programador de tareas con “Ejecutar tanto si el usuario inició sesión como si no”.

Seguridad

El archivo Jobs\<nombre>.json contiene el token de acceso a tu cuenta de MercadoLibre. Tratá esa carpeta como información sensible y no la compartas.

11 Buenas prácticas