Pimberly Product Tool

El Pimberly Product Tool te permite obtener detalles de un producto a partir de su número de referencia. Conecta tu dashboard de Nappai a la API de Pimberly y extrae los atributos que necesites, como título, precio, dimensiones, origen, etc.

¿Cómo funciona?

Cuando introduces el número de referencia del producto, el componente hace una llamada a la API de Pimberly.

• run_model: utiliza AsyncPimberlyChannelAPI para solicitar los datos del producto de forma asíncrona y devuelve la respuesta como un objeto Data.
• build_tool: crea un objeto BaseTool que encapsula la lógica de la API, permitiendo que otros módulos de Nappai lo invoquen de manera más sencilla.

El componente no procesa datos localmente; todo el trabajo lo hace la API de Pimberly. Solo necesitas una credencial válida para autenticarte.

Entradas

Campos de Entrada

• Related Product Attribute Details in Pimberly:
  Especifica los atributos que quieres que la API devuelva. Se escribe una lista separada por comas.
  Ejemplo por defecto:

  Primary ID,Categorisation,Title,Serie,Series Compatibility,Special Amount,Short Description,Amount,Currency,Base Quantity Condition,Measure Unit Condition,Origin Country,ST Length,ST Width,ST Height,ST Volume,ST Net Weight,ST Gross Weight,ST Weight Unit,ZCE Length,ZCE Width,ZCE Height,ZCE Unit,ZCE Volume,ZCE Volume Unit,ZCE Net Weight,ZCE Gross Weight,ZCE Weight Unit,Operating environment,Remarks,Cable section admitted (mm),Connector type,Electricity metre,Frequency (Hz),Intensity (A),IP Rating,Operating temperature range (ºC),Product parameter adjustment / display,Sales lines,SEO description,URL Website

• Product Reference Nr.:
  El número de referencia único del producto que quieres consultar.

Credencial requerida
Este componente necesita una credencial de tipo Pimberly API.

1. Ve a la sección de credenciales de Nappai y crea una nueva credencial llamada Pimberly API.
2. Ingresa tu Pimberly API Key (se guarda como contraseña).
3. En el componente, selecciona la credencial que acabas de crear en el campo Credential.

Salidas

• Data:
  Resultado de la consulta a la API, encapsulado en un objeto Data. Puedes usarlo para mostrar la información en tu dashboard o para pasarla a otros componentes.

• Tool:
  Un objeto BaseTool que representa la herramienta de búsqueda de productos. Útil si quieres reutilizar la lógica en flujos más complejos.

Ejemplo de Uso

1. Añade el componente “Pimberly Product Tool” a tu flujo.
2. Selecciona la credencial Pimberly API en el campo Credential.
3. Introduce el número de referencia del producto (por ejemplo, 12345).
4. Define los atributos que deseas obtener (puedes usar el valor por defecto o limitarlo a, por ejemplo, Title,Amount,Currency).
5. Ejecuta el flujo.
6. La salida Data contendrá un JSON con los atributos solicitados, listo para mostrarse en tu dashboard o para ser procesado por otro componente.

Consejos y Mejores Prácticas

• Limita los atributos: Pedir solo los campos que realmente necesitas reduce el tiempo de respuesta y el ancho de banda.
• Reutiliza la herramienta: Si necesitas buscar productos en varios lugares de tu flujo, usa la salida Tool para evitar crear múltiples instancias.
• Maneja errores: Añade un componente de manejo de errores para capturar fallos de la API y mostrar mensajes claros al usuario.
• Actualiza la credencial: Si cambias tu API Key, actualízala en la sección de credenciales y vuelve a seleccionar la credencial en el componente.

Consideraciones de Seguridad

• La API Key se almacena de forma segura en la sección de credenciales de Nappai; no aparece en la interfaz de usuario del componente.
• Asegúrate de que solo usuarios autorizados tengan acceso a la credencial y al componente.
• Si compartes el flujo, verifica que la credencial no se exprese accidentalmente en los logs o en la salida del flujo.

---