WooCommerce

WooCommerce es un componente de Nappai que te permite leer, crear, actualizar y eliminar datos en tu tienda WooCommerce directamente desde tu dashboard. Con él puedes, por ejemplo, obtener la lista de productos, añadir un nuevo pedido o actualizar el estado de un envío, todo sin salir de la plataforma.

¿Cómo funciona?

El componente se conecta a la API REST de WooCommerce usando una credencial que ya has configurado en Nappai. Cuando seleccionas una operación (Get, Create, Update o Delete) y rellenas los campos necesarios, el componente envía una solicitud HTTP al endpoint correspondiente de WooCommerce y devuelve la respuesta como un objeto de datos que puedes usar en el resto de tu flujo.

Si activas el Mapping Mode, el componente puede procesar varios registros a la vez. En lugar de enviar una sola solicitud, envía una solicitud por cada registro de la entrada “Mapping Data”, lo que facilita la automatización de tareas en lote.

Operaciones

Este componente ofrece varias operaciones que puedes seleccionar según lo que necesites hacer. Solo puedes usar una operación a la vez:

• Get: Recupera una lista o un único recurso de WooCommerce (por ejemplo, productos, pedidos, clientes).
• Create: Crea un nuevo recurso en WooCommerce (por ejemplo, un nuevo producto o pedido).
• Update: Modifica un recurso existente en WooCommerce (por ejemplo, actualizar el precio de un producto).
• Delete: Elimina un recurso de WooCommerce (por ejemplo, borrar un producto).

Para usar el componente, primero selecciona la operación que necesitas en el campo Operation (Operación).

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, 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. Cada campo puede estar visible en diferentes operaciones:

• Data: Datos para crear o actualizar entidades.
  • Visible en: Create, Update, Delete
• Entity: Tipo de recurso con el que trabajar (por ejemplo, products, orders, customers).
  • Visible en: Get, Create, Update, Delete
• Operation: Operación que quieres ejecutar.
  • Visible en: Get, Create, Update, Delete
• Entity ID: ID del recurso que quieres obtener, actualizar o eliminar.
  • Visible en: Get
• Limit: Número máximo de entidades que quieres devolver.
  • Visible en: Get
• Mapping Mode: Habilita el modo de mapeo para procesar múltiples registros en lote.
  • Visible en: Get, Create, Update, Delete
• Order By: Campo por el que ordenar los resultados (añade - al principio para orden descendente, por ejemplo, -date).
  • Visible en: Get
• Search: Palabra o frase para filtrar los resultados. Si lo dejas vacío, no se aplica filtro.
  • Visible en: Get
• Credential: Selecciona la credencial de tipo WooCommerce API que ya has configurado en Nappai.
  • Visible en: Get, Create, Update, Delete
• Mapping Data: (solo visible cuando el Modo de Mapeo está activado) Lista de registros que se procesarán en lote.

Nota: Antes de usar el componente, asegúrate de haber creado una credencial WooCommerce API en la sección de credenciales de Nappai y de seleccionarla en el campo Credential.

Salidas

• Result: La respuesta de la API de WooCommerce, que puede ser una lista de objetos o un único objeto, dependiendo de la operación. Este dato se puede usar en los siguientes pasos de tu flujo para continuar con otras tareas o para mostrar información al usuario.

Ejemplo de Uso

Obtener los 10 primeros productos

1. Operation: Get
2. Entity: products
3. Limit: 10
4. Order By: -date (para obtener los más recientes primero)
5. Credential: Selecciona la credencial “WooCommerce API” que configuraste.

El componente devolverá un objeto con la lista de productos, que puedes pasar a otro componente para mostrarlos en una tabla o procesarlos de otra forma.

Crear un nuevo producto

1. Operation: Create
2. Entity: products
3. Data:

   {
     "name": "Camiseta Nappai",
     "type": "simple",
     "regular_price": "29.99",
     "description": "Camiseta de algodón con logo Nappai."
   }

4. Credential: Selecciona la credencial “WooCommerce API”.

El componente enviará la solicitud POST a WooCommerce y devolverá el objeto del producto creado en la salida Result.

Componentes Relacionados

• WooCommerceCustom – Base del componente que gestiona la lógica de conexión y operaciones comunes con WooCommerce.
• DataInput – Tipo de entrada usado para enviar datos JSON a la API.
• DropdownInput – Tipo de entrada usado para seleccionar la entidad y la operación.

Consejos y Mejores Prácticas

• Usa el Mapping Mode cuando necesites procesar listas de productos o pedidos en lote; evita enviar una solicitud por cada registro manualmente.
• Aprovecha el campo Search para filtrar resultados y reducir la cantidad de datos que recibes, lo que mejora el rendimiento.
• Cuando crees o actualices recursos, valida los datos en el campo Data antes de enviarlos para evitar errores de la API.
• Si necesitas ordenar por fechas, recuerda usar el prefijo - para obtener resultados en orden descendente.

Consideraciones de Seguridad

• La credencial WooCommerce API contiene la URL de la tienda, la clave de consumidor y el secreto de consumidor. No compartas esta credencial con usuarios que no necesiten acceso a la tienda.
• Asegúrate de que la credencial esté configurada con los permisos mínimos necesarios (por ejemplo, solo lectura si solo vas a usar la operación Get).
• Guarda la credencial en un lugar seguro dentro de Nappai y revisa periódicamente los permisos y el acceso concedido.