Este proyecto automatiza la sincronización de nuevos productos desde Jumpseller hacia Multivende. Su objetivo es facilitar la gestión de catálogos para tiendas en línea, eliminando procesos manuales.
Cada día, el sistema:
- Obtiene los productos creados en las últimas 24 horas en Jumpseller.
- Filtra aquellos con stock mayor a 0.
- Los guarda en el mantenedor (con estado
PENDING). - Luego los procesa de uno en uno mediante un job de Redis, y los envía a Multivende.
- Una vez Multivende responde exitosamente, el estado del producto pasa a
COMPLETED.
El proyecto está desarrollado en Nest.js, y usa:
- Cron jobs para ejecutar automáticamente el flujo una vez al día.
- Redis para manejar trabajos en segundo plano.
git clone <URL-DEL-REPOSITORIO>
cd <nombre-del-proyecto>Recomendamos usar pnpm:
pnpm installTambién puedes usar yarn o npm si lo prefieres:
yarn install
# o
npm installpnpm start:devAsegúrate de tener instalados previamente:
- Node.js
- Git
Crea un archivo .env en la raíz del proyecto con las variables necesarias. Puedes guiarte por el archivo .env.example incluido en el repositorio.
Además, asegúrate de tener en tu base de datos una colección llamada multivendetokens con el siguiente formato:
{
"accessToken": "string",
"merchantId": "string",
"urlMultivende": "https://app.multivende.com/api"
}
⚠️ Por ahora, este token debe insertarse manualmente en la base de datos. Se planea automatizar este proceso en futuras versiones.
Una vez esté todo configurado, puedes iniciar el proceso de sincronización enviando una petición POST desde Postman o similar:
POST http://localhost:8000/backend/v1/process/products
Selecciona el tipo none (sin body).
Esto disparará el flujo completo: petición a Jumpseller, almacenamiento en base de datos y envío de productos a Multivende.
❓ Importante: Asegúrate de que en Jumpseller existan productos nuevos creados en las últimas 24 horas y que tengan al menos 1 unidad de stock y que cuenten con SKU. Si no hay productos que cumplan estas condiciones, no se procesará nada.
Para propósitos de prueba, puedes crear productos manualmente desde Jumpseller con stock y SKU para verificar que el flujo funcione correctamente.
Producto en la base de datos:
Producto en Multivende:
Posman
Por motivos de tiempo, no alcancé a grabar la demo del sistema. Sin embargo, estoy completamente disponible para realizarla en vivo o enviarla grabada si así lo requieren
Este proyecto está en constante mejora. ¡Se agradecen sugerencias, issues y pull requests!
Con cariño 💖, Gina 🧶