Uno de los métodos de integración que Yuju te ofrece es por medio de un archivo compartido. A través de una carpeta FTP o SFTP compartida entre el seller y Yuju, intercambiamos información de productos, inventarios y ventas.
Esta integración está pensada para sellers que:
- Trabajan con un sistema cerrado o con poca flexibilidad (que no tiene API o Web Service disponible).
- Manejan sus propios archivos de productos.
- Manejan limitaciones de seguridad para realizar una conexión directa vía API.
------------------ Índice ------------------
- ¿Cómo funciona esta integración?
- Paso a paso para la integración del módulo
- Estructura de la carpeta FTP
- Frecuencias de lectura de carpetas
- Templates de archivos
---------------------------------------------
¿Cómo funciona esta integración?
Para productos:
El vendedor genera automáticamente su propio archivo de productos y lo deposita en el FTP.
- Yuju toma la información del archivo cada cierto tiempo por definir y sube automáticamente los productos e inventarios a Yuju.
Para pedidos:
Yuju exporta los pedidos de los marketplaces en tiempo real, genera un archivo por pedido y lo coloca en el FTP.
- Los pedidos entran en tu flujo interno de logística en tiempo real en tu archivo de pedidos.
Paso a paso para la integración del módulo
Se requiero que se envíe al KAM de Yuju la siguiente información para realizar la implementación:
- ¿Qué desean conectar a través del FTP? Importación de ventas, creación de productos, actualización de stock y precios. Se puede elegir todas o combinar las opciones.
- Definición de frecuencia de lectura de archivos.
- Accesos a la carpeta FTP.
Estructura de la carpeta FTP
Yuju propone la siguiente estructura de carpetas:
- Carpeta → Productos
- Carpeta → Omitidos
- Carpeta → Procesados
- Carpeta → Ventas
En todo caso, para la carpeta de ventas podríamos tener las siguientes variaciones:
"simple" ➝ Usa una única carpeta definida en la configuración (sin subcarpetas).
# - "marketplace" ➝ Crea una subcarpeta por ID del marketplace (id_channel). Ej: /Ventas/1901
# - "ff_type" ➝ Crea una subcarpeta según el tipo de envío: "fbm" o "fbc". Ej: /Ventas/fbm
# - "combined" ➝ Crea una subcarpeta combinando marketplace y tipo de envío. Ej: /Ventas/1901-fbm
Para los archivos se requiere un prefijo para diferenciarlos, se propone lo siguiente:
NUEVO_NOMBRE DEL ARCHIVO_FECHA
STOCK_NOMBRE DEL ARCHIVO_FECHA
PRICE_NOMBRE DEL ARCHIVO_FECHA
Notas:
- Se puede usar un solo archivo para stock y precio.
- Se podrían usar otros prefijos, pero nos deben indicar cuál se va a manejar.
- Se debe indicar si los archivos cuentan con un encabezado o no.
Frecuencias de lectura de carpetas
- Creación de productos: 1 vez al día - Todos los días a las 2:45 a.m. UTC.
- Actualización de stock y precio: Cada 2 horas.
- Mapeo de productos: 1 vez al día - Todos los días a la 1:00 a.m. UTC.
Templates de archivos
En el siguiente link se podrá visualizar los templates que tiene Yuju disponibles, cada uno viene con su respectiva explicación.
TXT/CSV: https://drive.google.com/
Actualmente solo se soporta txt, csv (siguiendo los formatos del drive), si se requiere usar otros formato o template, estará sujeto a evaluación y/o cotización.
Para cualquier duda y/o aclaración, ponte en contacto con tu KAM asignado o escribiendo a soporte@yuju.io.