Saltearse al contenido
Nappai Documentation

PrestaShop Order

PrestaShop Order

El componente PrestaShop Order es tu conexión directa con los pedidos de tu tienda PrestaShop. Imagina que este componente es un asistente digital que habla con tu tienda online por ti.

Su propósito principal es ayudarte a gestionar las compras de tus clientes. Con él, podrás recuperar listas de pedidos, ver la información detallada de una compra específica o incluso cambiar el estado de un pedido (por ejemplo, marcarlo como “enviado”). Es un “envoltorio ligero”, lo que significa que se encarga de toda la comunicación técnica con PrestaShop para que tú solo te preocupes por decidir qué datos necesitas.

¿Cómo funciona?

Cuando ejecutas este componente, este actúa como un mensajero entre tu flujo de automatización y tu tienda PrestaShop.

  1. Preparación: Tú le indicas qué necesitas (por ejemplo, “quiero ver los pedidos de los últimos 24 horas” o “quiero los detalles del pedido #1234”).
  2. Conexión: El componente se conecta a la API de PrestaShop utilizando la credencial que configuraste previamente.
  3. Acción: Realiza las consultas necesarias. Si pediste una lista, te devolverá los pedidos ordenados. Si pediste un detalle, te dará toda la información sobre ese producto y cliente específico.
  4. Resultado: Te entrega la información en un formato organizado (JSON) que puedes usar en pasos siguientes de tu flujo, como enviar un correo o guardar en una base de datos.

No necesitas preocuparte por los códigos de programación o las claves de la API en este nodo; todo lo gestionamos a través de las opciones que verás abajo.

Conexión y Credenciales

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

  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 API de PrestaShop).
    • Nota: Puedes generar tu clave API (Webservice Key) en tu panel de administración de PrestaShop en Parámetros Avanzados > WebService. Asegúrate de activar la opción y otorgar los permisos necesarios.
  3. En tu flujo de trabajo, selecciona la credencial que acabas de crear en el campo Credential de este componente.

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 (por ejemplo, escribes el ID del pedido manualmente).
  • Mapped (Mapeado): Conectas la salida de otro componente anterior para usar su resultado como valor (por ejemplo, usar el ID que viene de un filtro).
  • Javascript: Escribes código Javascript para calcular el valor dinámicamente según tus reglas.

Esta flexibilidad te permite crear flujos de trabajo más dinámicos y conectados, adaptando los datos según sea necesario.

Campos de Entrada

Los siguientes campos están disponibles para configurar este componente. Puedes usarlos tanto para ver pedidos como para modificarlos, dependiendo de la lógica de tu flujo:

  • Query Type: Especifica cómo deseas consultar los pedidos. Por ejemplo, puedes elegir obtener una lista general, buscar por un ID específico o obtener pedidos recientes de las últimas 24 horas.

    • Visible en: Este campo define el comportamiento principal de la consulta.

  • Order ID: Si necesitas obtener detalles específicos o actualizar un pedido, escribe aquí el identificador único del pedido en PrestaShop. Si dejas este campo vacío, el componente asumirá que quieres trabajar con una lista de pedidos.

  • Max Results: Define el número máximo de pedidos que quieres recuperar en una sola consulta. Esto es útil para no sobrecargar tu sistema si tienes miles de pedidos; por defecto, suele devolver los primeros 100.

  • New Order Status: Si tu objetivo es actualizar un pedido, utiliza este campo para indicar el nuevo estado que deseas asignar (por ejemplo, cambiar de “Pendiente” a “Procesando”).

Salidas

Cuando el componente se ejecuta correctamente, produce una salida principal llamada Data que contiene toda la información recuperada o modificada. Esta salida es un objeto JSON que puedes enviar a otros componentes (como un filtro, un correo o una base de datos).

Ejemplo de Respuesta JSON

A continuación, se muestra un ejemplo realista de lo que recibirás en la salida Data cuando recuperas un pedido o una lista. Esto te ayudará a identificar qué variables puedes usar en los siguientes pasos de tu flujo: json { “orders”: [ { “id”: 1054, “reference”: “PR-2023-089”, “customer_name”: “Juan Pérez”, “customer_email”: “juan.perez@ejemplo.com”, “total_paid”: 150.00, “currency”: “EUR”, “order_status”: “Processing”, “date”: “2023-10-25 14:30:00”, “products”: [ { “name”: “Camiseta Premium”, “quantity”: 2, “price”: 25.00 }, { “name”: “Pantalón Chino”, “quantity”: 1, “price”: 100.00 } ] } ], “success”: true, “error_message”: null }

Nota: Dependiendo de la operación elegida, la estructura puede variar ligeramente. Si obtienes detalles de un solo pedido, el JSON será más conciso y centrado en ese registro.

Conectividad

Este componente se conecta lógicamente con otros nodos para automatizar procesos de comercio electrónico:

  • Conexiones de Entrada: Suele recibir datos de componentes que filtran información (como “Filter Data” o “Get Recent Activity”). Por ejemplo, podrías conectar un componente que detecta nuevos pedidos en PrestaShop para que este componente los analice en detalle.
  • Conexiones de Salida: La salida Data es muy versátil. Puedes conectarla a:
    • Herramientas de Email: Para notificar al cliente sobre el estado de su pedido.
    • Bases de Datos: Para guardar un historial de ventas fuera de PrestaShop.
    • Generadores de Contenido: Para extraer nombres o montos y personalizar mensajes de IA.

Ejemplo de Uso

Escenario: Quieres obtener los detalles de un pedido específico para verificar si el cliente pagó correctamente antes de autorizar un envío.

  1. Componente Anterior: Un componente que detecta un evento de “Nuevo Pedido” y extrae el Order ID.
  2. PrestaShop Order:
    • Configura Credential con tu clave de PrestaShop.
    • En Order ID, arrastra la salida del “Order ID” del paso anterior.
    • En Query Type, asegúrate de seleccionar la opción para obtener detalles por ID.
  3. Resultado: El componente devuelve un JSON con Data que incluye el total_paid y el estado del pedido.
  4. Siguiente Paso: Un componente “IF” (Si/Entonces) verifica si el pago es correcto y autoriza el envío.

Consejos y Mejores Prácticas

  • Modo de Desarrollo: Tienes en cuenta que este componente está marcado como “en fase de desarrollo” (is_development = True). Esto significa que podría haber cambios menores en su comportamiento o parámetros antes de su versión estable. Te recomendamos probarlo en un entorno de pruebas si es posible.
  • Paginación: Si tienes miles de pedidos, es recomendable usar el campo Max Results en conjunto con otros componentes de paginación para no saturar la memoria del sistema y asegurar que obtienes todos los registros de forma eficiente.
  • Manejo de Errores: Si la operación falla, el componente devuelve una bandera success: false. Configura tu flujo para revisar esto y enviar una notificación de alerta en caso de error de autenticación o de red.

Consideraciones de Seguridad

  • Protección de API Key: Asegúrate de que la credencial de tipo PrestaShop que configuras tenga los permisos mínimos necesarios (solo lectura o solo lo que necesites para actualizar estados). Nunca compartas la URL de tu panel de administración con esta clave públicamente.
  • Validación de Entradas: Al usar el modo de mapeo, verifica que los IDs de pedido que envías sean válidos para evitar errores de “Pedido no encontrado”.