Saltearse al contenido
Nappai Documentation

PrestaShop Category

En Nappai, automatizar tus procesos es sencillo, incluso si no conoces programación. Este componente funciona como un puente seguro entre tu sistema de automatización y tu tienda en PrestaShop. Te permite visualizar, buscar y administrar las categorías de productos de tu catálogo de manera eficiente, manteniendo todo organizado y sincronizado.

¿Cómo funciona?

Este componente se conecta directamente a tu tienda PrestaShop para obtener y gestionar las categorías de productos. Piensa en él como un asistente inteligente que habla con tu tienda en nombre tuyo:

  • Consulta y Listado: Puedes pedirle que te traiga una lista completa de categorías o filtrarla según criterios específicos (por ejemplo, solo las categorías activas).
  • Gestión Estructurada: Te ayuda a organizar tu catálogo definiendo jerarquías (categorías padre e hijo) y actualizando estados (activos/inactivos).
  • Automatización Fluida: Internamente, se encarga de toda la comunicación técnica con PrestaShop. Tú solo configuras qué necesitas y el componente te devuelve los datos listos para usar en otros pasos de tu flujo de trabajo.

Conexión y Credenciales

Este componente requiere configurar previamente una credencial en el panel de Nappai para poder interactuar con tu tienda PrestaShop de forma segura:

  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 (URL de la tienda y Clave de API).
    • Nota: Puedes generar tu clave API en el panel de administración de PrestaShop yendo a Parámetros Avanzados > Webservice. Asegúrate de activar el servicio web y otorgar los permisos necesarios.
  3. En tu flujo de trabajo, selecciona la credencial que acabas de guardar en el campo Credential de este nodo.

Entradas

Modo de Mapeo (Mapping Mode)

Este componente cuenta con un modo especial llamado “Mapping Mode” (Modo de Mapeo). Cuando activas este modo mediante el interruptor correspondiente, 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. Puedes dejarlos vacíos si no deseas filtrar o modificar nada en particular.

  • Operation: Permite seleccionar la acción principal que deseas realizar en PrestaShop.
  • Query Type: Define si deseas obtener el listado completo de categorías o recuperar los detalles de una categoría específica por su identificador.
  • Category ID: El identificador único de una categoría para consultarla, actualizarla o eliminarla.
  • Max Results: Establece el número máximo de categorías a devolver en una búsqueda, útil para controlar la cantidad de datos procesados.
  • Category Name: El nombre de la categoría para buscar una específica o definirla al crear una nueva.
  • Description: Una descripción detallada de la categoría que se mostrará en la tienda.
  • Parent Category: Indica la categoría padre, permitiendo organizar la estructura jerárquica de tu catálogo.
  • Active: Indica si la categoría debe estar visible (activa) u oculta (inactiva) en la tienda.

Salidas

Al ejecutar este componente, recibirás los datos procesados en el campo Data. Esta salida contiene toda la información recopilada sobre las categorías, lista para ser utilizada en los siguientes pasos de tu automatización, como por ejemplo, enviar datos a un CRM, actualizar inventarios o generar reportes.

Ejemplo de Respuesta JSON

A continuación, se muestra cómo se verían los datos de salida cuando el componente recupera correctamente las categorías. Este ejemplo te ayudará a identificar qué información puedes mapear en componentes posteriores de tu flujo. json { “categories”: [ { “id”: “105”, “name”: “Electrónica”, “active”: true, “level_depth”: 1, “image_url”: “https://mi-tienda.com/img/c/105.jpg”, “description”: “Dispositivos y accesorios electrónicos”, “parent_id”: null }, { “id”: “106”, “name”: “Smartphones”, “active”: true, “level_depth”: 2, “image_url”: “https://mi-tienda.com/img/c/106.jpg”, “description”: “Teléfonos móviles y accesorios”, “parent_id”: “105” } ], “pagination”: { “total”: 2, “limit”: 50, “offset”: 0, “current_page”: 1 }, “status”: 200 }

Conectividad

Este componente se integra naturalmente en flujos de trabajo de automatización de e-commerce:

  • Entradas: Los campos como Category ID, Parent Category o Max Results suelen recibir datos de entrada de otros componentes, como filtros de búsqueda, listas de productos importados o inputs manuales del usuario.
  • Salidas: La salida Data se conecta lógicamente a componentes de procesamiento de datos, como actualizaciones de inventario, sincronización con sistemas de gestión (ERP/CRM), generación de reportes o validación de estructuras de catálogo. Esto permite que la información de las categorías fluya automáticamente hacia otras herramientas de tu ecosistema.

Ejemplo de Uso

Imagina que deseas sincronizar las categorías activas de tu tienda PrestaShop con tu sistema de gestión de clientes.

  1. Añade el componente PrestaShop Category a tu flujo.
  2. Selecciona tu credencial de PrestaShop configurada previamente.
  3. En el campo Query Type, elige obtener el listado de categorías.
  4. En Max Results, define cuántas categorías quieres procesar por página.
  5. Activa el filtro Active si solo deseas las categorías visibles en la tienda.
  6. El componente devolverá los datos en Data.
  7. Conecta esta salida al siguiente componente, por ejemplo, un nodo de Crear/Actualizar Contactos, para que cada categoría se convierta en un registro organizado en tu base de datos.

Consejos y Mejores Prácticas

  • Utiliza el filtro Active para trabajar solo con categorías visibles y evitar errores en procesos posteriores.
  • Configura Max Results adecuadamente si tienes un catálogo grande; esto ayuda a evitar tiempos de espera prolongados y mejora el rendimiento de la automatización.
  • Usa el Modo de Mapeo para renombrar campos o transformar datos según necesites en el siguiente paso de tu flujo.
  • Verifica siempre la estructura de la respuesta JSON antes de mapear datos en componentes subsiguientes.
  • Para categorías jerárquicas, asegúrate de validar que el Parent Category esté configurado correctamente para mantener la estructura lógica de tu tienda.

Consideraciones de Seguridad

  • La seguridad de tu tienda está protegida mediante credenciales de API. Asegúrate de guardar tus credenciales en Nappai de forma segura y compartir solo con usuarios autorizados.
  • El componente utiliza conexiones seguras (HTTPS) para comunicarse con PrestaShop, garantizando que la información se transfiera de manera cifrada.
  • Revisa los permisos de tu clave API en PrestaShop; otorga solo los permisos necesarios para las operaciones que realizas en Nappai.