Saltearse al contenido
Nappai Documentation

PrestaShopProduct

Este componente actúa como un puente inteligente entre tu sistema de automatización Nappai y tu tienda online basada en PrestaShop. Su propósito principal es permitirte gestionar tu catálogo de productos de forma fluida: puedes buscar información, crear nuevos ítems, actualizar detalles existentes o eliminar productos directamente desde tus flujos de trabajo.

¿Cómo funciona?

El componente se comunica con la API de Webservice de PrestaShop. Al configurar las credenciales de acceso, Nappai se autentica de forma segura para interactuar con los datos de tu tienda.

Internamente, este componente es muy flexible. Utiliza un sistema de “Mapeo de Datos” que te permite tomar información de otras partes de tu automatización (por ejemplo, el nombre de un producto recibido de un formulario web) y usarla dinámicamente en las entradas de este nodo, sin necesidad de escribir valores fijos manualmente.

Conexión y Credenciales

Este componente requiere configurar previamente una credencial en el panel de Nappai para poder interactuar con el servicio externo:

  1. Dirígete a la sección de Credenciales en tu panel de Nappai.
  2. Crea una nueva credencial del tipo PrestaShop y guarda los campos requeridos.
  3. Importante: Para obtener estas credenciales en PrestaShop, debes ir al panel de administración de tu tienda, entrar en Parámetros Avanzados > Webservice y crear una clave habilitando la opción ‘Activate web service’.
  4. En tu flujo de trabajo, selecciona la credencial guardada en el campo de entrada Credential de este nodo.

Entradas

Este componente cuenta con un modo especial llamado “Mapping Mode” (Modo de Mapeo). Cuando activas este modo mediante el interruptor, se habilita una entrada adicional llamada “Mapping Data” y cada campo de entrada te ofrece tres formas diferentes de proporcionar datos:

  • Fixed (Fijo): Escribes el valor directamente en el campo.
  • Mapped (Mapeado): Conectas la salida de otro componente para usar su resultado como valor.
  • Javascript: Escribes código Javascript para calcular el valor dinámicamente.

Esta flexibilidad te permite crear flujos de trabajo más dinámicos y conectados.

Campos de Entrada

Los siguientes campos están disponibles para configurar este componente:

  • Operation: Selección de la acción a realizar.
  • Query Type: Tipo de consulta para obtener la lista de productos o uno específico por ID.
  • Product ID: Identificador del producto para obtener, actualizar o eliminar.
  • Max Results: Número máximo de productos a devolver.
  • Filter by Category: Filtro de productos por categoría.
  • Product Name: Nombre del producto.
  • Description: Descripción detallada del producto.
  • Price: Precio del producto.
  • Quantity: Cantidad de stock disponible.
  • Category: Categoría del producto.
  • Active: Indica si el producto está activo y es visible en la tienda.
  • Reference (SKU): Código de referencia o SKU del producto.
  • Image URL: URL pública de la imagen del producto (jpg, png) a subir a PrestaShop.

Salidas

El componente devuelve información estructurada sobre el producto gestionado. Esta información se devuelve como un objeto completo que incluye metadatos, precios, stock y estado.

Ejemplo de Respuesta JSONjson

{ “id”: 123, “reference”: “REF-001”, “price”: 29.99, “quantity”: 50, “active”: true, “description”: “Descripción detallada del producto”, “category”: “Electrónica”, “last_update”: “2023-10-27T10:00:00Z” }

Conectividad

  • Entradas: Este componente suele conectarse a salidas de otros nodos que procesan datos de entrada, como formularios de nuevos productos, importaciones de hojas de cálculo (CSV/Excel) o triggers de ventas.
  • Salidas: Los datos de salida (Data) suelen conectarse a nodos de acción, como:
    • Gestión de Bases de Datos: Para guardar el estado actualizado.
    • Envío de Correos/Notificaciones: Para confirmar al usuario que el producto se creó o actualizó correctamente.
    • Otras Integraciones de E-commerce: Para sincronizar stock con otros marketplaces.

Ejemplo de Uso

Escenario: Actualización de Stock Automática Imagina que vendes productos en múltiples plataformas.

  1. Usas un componente para obtener la lista de ventas de otro sitio.
  2. Conectas esa salida al campo Product ID de este componente.
  3. Usas el Mapping Mode para tomar la cantidad vendida y restarla del stock actual.
  4. Configuras el campo Quantity con el valor calculado.
  5. Ejecutas el flujo para que PrestaShop actualice automáticamente el inventario.

Consejos y Mejores Prácticas

  • Pruebas en Entorno de Desarrollo: Este componente está marcado como parte de un entorno de pruebas (is_development). Se recomienda probar tus automatizaciones en un entorno “sandbox” o de pruebas antes de aplicarlas a tu tienda en producción para evitar cambios no deseados en el catálogo real.
  • Manejo de Límites de Conexión: PrestaShop puede tener límites en la cantidad de peticiones por minuto. Si estás actualizando miles de productos, considera usar el campo Max Results o dividir tus automatizaciones para no sobrecargar la tienda.
  • Validación de Imágenes: Para el campo Image URL, asegúrate de que la URL sea pública y accesible directamente (ej. un enlace directo a un archivo .jpg), ya que la API de PrestaShop requiere acceso directo para procesar la imagen.

Consideraciones de Seguridad

  • Protección de Claves API: Nunca compartas la clave API de PrestaShop generada en el paso de credenciales. Únicamente debe ser utilizada por componentes oficiales dentro de tu panel de automatización Nappai.
  • Permisos de Acceso: Asegúrate de que la clave API que crees en el panel de PrestaShop tenga solo los permisos necesarios (lectura/escritura) para la función que estás automatizando, siguiendo el principio de mínimo privilegio.