Sincronizar el inventario desde tu sistema administrativo
Cómo enviar a Mercasist cada 5 minutos el inventario que exporta tu sistema (Profit, Valery, Saint u otro), para que la existencia y los precios se actualicen solos en MercadoLibre, Cashea y tu tienda web.
En resumen: tu sistema exporta el inventario a un archivo y una tarea de Windows lo envía a Mercasist cada 5 minutos. Mercasist actualiza el precio y la existencia de tus artículos y después lleva los cambios a MercadoLibre, Cashea y tu tienda web.
1. Qué necesitas
- Un sistema administrativo que exporte el inventario a un archivo CSV o de texto: Profit, Valery, Saint u otro. Si usas Odoo no hace falta, porque Mercasist se conecta directo a Odoo (ver Conexiones Odoo).
- Una computadora con Windows 10 u 11 que pueda leer ese archivo y que quede encendida y con internet.
- El mismo código (SKU) para cada producto en tu sistema y en Mercasist: es lo que une cada fila del archivo con su artículo.
- Tu código de sincronización, que te damos al activar el servicio.
Es un servicio adicional, con una tarifa mensual por cada sistema o sucursal que conectes. Se cotiza aparte, según tu sistema y tu archivo.
2. Cómo se activa
1 Envíanos una muestra del archivo
Exporta el inventario como lo hace tu sistema y envíalo a Soporte. Indica qué columna trae el código, la existencia, el precio y la moneda, y si manejas varios almacenes.
2 Preparamos la carga
Adaptamos Mercasist al formato de tu archivo y lo probamos con la muestra sin tocar tu inventario, para comprobar qué cambiaría antes de activarla.
3 Recibes tu código de sincronización
Es un código de letras y números, único para tu sistema o sucursal. Con él programas el envío (sección 3).
4 Revisamos la primera subida
Cuando tu tarea envíe el primer archivo, comprobamos contigo que tus artículos se hayan actualizado bien (sección 5).
3. Programar el envío en Windows
Windows 10 y 11 ya traen curl.exe, el programa que envía el archivo. No hay que instalar nada.
Paso 1: la carpeta y el archivo
Crea la carpeta C:\mercasist y configura tu sistema para que exporte el inventario ahí, siempre con el mismo nombre, por ejemplo C:\mercasist\inventario.csv. Si tu sistema puede programar la exportación, que la repita cada pocos minutos: cada envío manda el archivo que haya en ese momento.
Paso 2: el archivo de envío
Abre el Bloc de notas, pega estas líneas y cambia TU_CODIGO por tu código de sincronización. Guárdalo como C:\mercasist\enviar.bat, con Tipo: Todos los archivos.
@echo off echo %date% %time%>> C:\mercasist\envios.log curl.exe -sS -F "hash=TU_CODIGO" -F "file=@C:\mercasist\inventario.csv" https://www.mercasist.com/inventario/hook/index.php >> C:\mercasist\envios.log 2>&1 echo.>> C:\mercasist\envios.log
Cada vez que corre, anota en C:\mercasist\envios.log la fecha, la hora y la respuesta de Mercasist. Si tu archivo está en otra ruta, cámbiala en la tercera línea; si la ruta tiene espacios, déjala dentro de las comillas.
Paso 3: pruébalo
Haz doble clic en enviar.bat y abre envios.log con el Bloc de notas. Si todo está bien, la última respuesta empieza así:
{"resp":"ok","message":"archivo guardado", ...
Si dice otra cosa, búscala en la sección 4.
Paso 4: prográmalo cada 5 minutos
Abre el Símbolo del sistema (escribe cmd en el menú Inicio) y ejecuta:
schtasks /Create /SC MINUTE /MO 5 /TN "Mercasist inventario" /TR "C:\mercasist\enviar.bat"
Así, la tarea corre solo mientras tu sesión de Windows está abierta y muestra una ventana negra en cada envío. Para que corra aunque nadie haya iniciado sesión, y sin ventana, abre el Programador de tareas, busca Mercasist inventario, entra en Propiedades y marca Ejecutar tanto si el usuario inició sesión como si no. Windows te pedirá la contraseña de tu usuario.
Para detener el envío, borra la tarea:
schtasks /Delete /TN "Mercasist inventario" /F
Si prefieres programarlo tú
Cualquier programa puede hacer el envío. Es un POST con multipart/form-data:
| Dato | Valor |
|---|---|
| Dirección | https://www.mercasist.com/inventario/hook/index.php |
Campo hash | Tu código de sincronización. |
Campo file | El archivo del inventario. |
Ejemplo en Python, con la librería requests:
import requests
with open(r"C:\mercasist\inventario.csv", "rb") as archivo:
respuesta = requests.post(
"https://www.mercasist.com/inventario/hook/index.php",
data={"hash": "TU_CODIGO"},
files={"file": archivo},
timeout=120,
)
print(respuesta.json())
Mercasist responde con el código HTTP 200 aunque haya un error. Para saber si funcionó, revisa que la respuesta traiga "resp":"ok".
4. Qué significa cada respuesta
| Respuesta | Qué significa | Qué hacer |
|---|---|---|
"resp":"ok", archivo guardado | Mercasist recibió el archivo y lo procesa en unos segundos. | Nada. |
usuario no encontrado | El código no corresponde a ninguna sincronización. | Revisa que lo copiaste completo, sin espacios ni comillas de más. Si sigue igual, escríbenos. |
hash requerido | Falta el código. | Revisa el campo hash del envío. |
archivo no enviado | No llegó el archivo. | El campo tiene que llamarse exactamente file. |
error de subida: N | El archivo no llegó bien: 1 o 2, es demasiado grande; 3, llegó incompleto; 4, no llegó ningún archivo. | Revisa que el archivo exista y no esté vacío. Si es muy grande, escríbenos. |
metodo no permitido | Se abrió la dirección en el navegador. | La dirección solo sirve para el envío; no se abre en el navegador. |
Una línea que empieza con curl: | El envío no salió de tu computadora. | curl: (26): no encuentra el archivo, revisa la ruta. curl: (6), (7) o (28): no hay conexión con Mercasist, revisa tu internet. |
| Cualquier otro mensaje | Un problema de nuestro lado. | Escríbenos con la línea del registro. |
5. Comprobar que funciona
- En tu computadora:
envios.logsuma una respuesta con"resp":"ok"cada 5 minutos. - En Mercasist: los precios y las existencias de tus artículos cambian unos segundos después de cada envío. Cada cambio de existencia queda en el historial de inventario como Ajuste por archivo csv.
- En MercadoLibre: cambian solo las publicaciones que tienen su artículo asociado y la sincronización activa (ver Asociación de inventario y Sincronización de inventario). Mercasist envía los cambios cada 15 minutos de 8:00 a 18:59 y una vez por hora el resto del día.
- En Cashea y en tu tienda web: los cambios llegan desde MercadoLibre, a Cashea cada 30 minutos y a la tienda web una vez por hora durante el día.
6. Cómo se usa tu archivo
- Cada fila se une con tu artículo por el código (SKU).
- Si el artículo existe, se actualizan el título, el precio y la moneda cuando cambian, y se ajusta la existencia.
- Si el código no existe en Mercasist, se crea un artículo nuevo.
- Los artículos que no vienen en el archivo no se tocan.
- Una existencia negativa se toma como 0.
- El precio queda en la moneda que trae el archivo: no se convierte.
- Si llegan varios envíos seguidos, se procesa el último.
En el alta podemos acordar otras reglas, por ejemplo poner en 0 la existencia de lo que no viene en el archivo.
No cambies el formato del archivo sin avisarnos. La carga está hecha para las columnas, el orden y el separador de tu archivo. Si cambian, tus artículos pueden quedar con datos equivocados.
7. Cuidados
- Tu código de sincronización es una clave. Quien lo tenga puede reemplazar tu inventario y, con él, tus publicaciones. No lo compartas ni lo publiques, y guárdalo solo en el archivo de envío. Si crees que alguien más lo tiene, escríbenos y te damos uno nuevo.
- Cópialo tal cual, en minúsculas. Si lo escribes en mayúsculas, Mercasist responde
"resp":"ok"pero tu inventario no se actualiza. - La computadora tiene que quedar encendida y con internet. Si los envíos se detienen, tu inventario en Mercasist se queda con los últimos datos recibidos, y tus publicaciones también.
- Para dejar el servicio, borra la tarea (sección 3) y avísanos para darlo de baja.
8. Problemas frecuentes
| Lo que pasa | Qué revisar |
|---|---|
envios.log no suma respuestas nuevas. | La tarea no está corriendo. En el Programador de tareas, revisa que Mercasist inventario esté habilitada y cuándo fue su última ejecución, y que la computadora esté encendida. Si la tarea corre solo con la sesión abierta, se detiene al cerrar la sesión. |
Responde "resp":"ok", pero tus artículos no cambian. | Que tu sistema esté volviendo a exportar el archivo (su fecha de modificación tiene que ser reciente) y que el código esté en minúsculas. Si las dos cosas están bien, escríbenos. |
| Cambia en Mercasist, pero no en MercadoLibre. | Que la publicación tenga su artículo asociado y la sincronización activa. Después, espera el siguiente ciclo (sección 5). |
| Un artículo aparece repetido. | El código no es igual en tu sistema y en Mercasist (por ejemplo, un espacio o un guion de más). Corrígelo en uno de los dos para que coincidan. |
Si algo no cuadra, escríbenos a Soporte con la última línea de envios.log.