Saltearse al contenido
Nappai Documentation

Stripe Product

El componente Stripe Product actúa como el puente entre tu sistema de automatización Nappai y tu tienda o catálogo de productos en Stripe. Stripe es una de las plataformas líderes mundiales para procesar pagos en línea.

Su propósito principal es ayudarte a administrar el ciclo de vida completo de los productos que vendes. Puedes pensar en él como el “archivista digital” de tus artículos: te permite añadir nuevos productos (como un servicio o un producto físico), obtener detalles específicos si los has olvidado, actualizar información (como el precio o la disponibilidad) y eliminar artículos que ya no se venden.

Este componente está optimizado para integrarse con flujos de trabajo automatizados, lo que significa que puedes conectar sus resultados con otros pasos de tu sistema (por ejemplo, después de crear un producto, automáticamente crear un precio para ese producto).

¿Cómo funciona?

Internamente, este componente se comunica con los servidores de Stripe utilizando una conexión segura y las credenciales que tú configuras previamente.

  1. Selección del Modo: Primero, debes indicar cómo deseas interactuar con los datos. Puedes elegir trabajar con un producto específico (buscando por su ID único) o listar todos los productos disponibles en tu cuenta.
  2. Ejecución de la Acción: Dependiendo del modo seleccionado, el componente realizará una de las siguientes acciones:
    • Recuperar (Retrieve): Busca un producto específico usando su código único (ej. prod_123...) y te devuelve toda su información detallada.
    • Listar (List): Recupera una lista de productos según criterios como el número máximo de registros solicitados.
    • Crear (Create): Registra un nuevo producto en Stripe. Para esto, necesitarás proporcionar al menos su nombre y tipo.
    • Actualizar (Update): Modifica la información de un producto existente (por ejemplo, cambiar su descripción o activarlo/desactivarlo).
    • Eliminar (Delete): Borra un producto de tu catálogo en Stripe de forma definitiva.

El componente maneja toda la complejidad técnica de las conversaciones con la API de Stripe por ti, asegurando que los datos que ingresas sean válidos y que la respuesta sea procesada correctamente.

Conexión y Credenciales

Este componente requiere configurar previamente una credencial en el panel de Nappai para poder interactuar con la plataforma de Stripe de forma segura:

  1. Dirígete a la sección de Credenciales en tu panel de Nappai.
  2. Crea una nueva credencial del tipo Stripe API y guarda los campos requeridos (específicamente tu API Key secreta).
  3. En tu flujo de trabajo, selecciona la credencial que acabas de guardar en el campo de entrada Credential de este nodo.

Nota: No es necesario configurar claves o tokens directamente en los campos del componente; todo se gestiona a través de esta selección segura de credencial.

Operaciones

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

  • Create: Crea un nuevo producto en tu catálogo de Stripe. Requiere definir el nombre y el tipo del producto.
  • Retrieve: Obtiene los detalles completos de un producto específico utilizando su ID único.
  • Update: Modifica la información de un producto existente ya registrado en Stripe.
  • Delete: Elimina un producto específico de la base de datos de Stripe.
  • List: Recupera una lista de productos existentes en tu cuenta, permitiendo filtrar por cantidad (límite).

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

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:

  • Operation: Selecciona la acción que deseas realizar con el producto (Crear, Obtener, Actualizar, Eliminar o Listar).
    • Visible en: Todas las operaciones
  • Mode: Define si deseas trabajar con un registro específico (requiere ID) o listar múltiples registros.
    • Visible en: Todas las operaciones
  • Product ID: El identificador único del producto en Stripe (ej. prod_12345). Es necesario para operaciones de obtener, actualizar o eliminar.
    • Visible en: Retrieve, Update, Delete
  • Name: El nombre del producto. Es obligatorio si estás creando un nuevo producto.
    • Visible en: Create, Update
  • Description: Una descripción detallada del producto, visible para los clientes en recibos y correos.
    • Visible en: Create, Update
  • Active: Un interruptor que indica si el producto está disponible para la compra (Verdadero/Falso).
    • Visible en: Create, Update
  • URL: La dirección web pública donde los clientes pueden ver información sobre este producto.
    • Visible en: Create, Update
  • Unit Label: Una etiqueta para la unidad de venta (ej. “asiento”, “token”, “hora”).
    • Visible en: Create, Update
  • Shippable: Indica si el producto es físico y requiere envío.
    • Visible en: Create, Update
  • Statement Descriptor: Texto corto que aparecerá en el extracto de la tarjeta de crédito del cliente (máximo 22 caracteres).
    • Visible en: Create, Update
  • Tax Code: El código de impuestos preconfigurado en Stripe para aplicar al producto automáticamente.
    • Visible en: Create, Update
  • Limit: El número máximo de registros a devolver. Útil para filtrar la lista de productos (máximo 100).
    • Visible en: List

Salidas

El componente devuelve información estructurada que puedes utilizar en pasos posteriores de tu automatización.

  • Product: Un objeto completo con toda la información del producto (id, nombre, precios, estado, etc.).
  • Product ID: El identificador único generado o confirmado para el producto. Es muy útil para conectar con otros nodos que necesiten saber qué producto se creó o se modificó.
  • Status: Indica si la operación fue exitosa (ej. “success”, “updated”, “deleted”) o si hubo un error.
  • Error Message: Si ocurre un fallo, este campo contiene el mensaje detallado explicando la causa del error.

Ejemplo de Respuesta JSON

A continuación, se muestra un ejemplo de cómo se ve la salida del campo Product cuando se recupera o crea un producto exitosamente. Puedes usar estos campos (como id, name, active) en componentes siguientes de tu flujo. json { “id”: “prod_Oe8tY2xZ9AbC1d”, “object”: “product”, “active”: true, “name”: “Servicio de Suscripción Premium”, “description”: “Acceso completo a todas las funciones avanzadas”, “type”: “service”, “created”: 1678886400, “updated”: 1678886400, “images”: [ “https://tusitio.com/images/producto.jpg” ], “shippable”: false }

Conectividad

Este componente es un nodo central en la gestión de catálogos de ventas. Lógicamente, suele conectarse de la siguiente manera:

  • Entradas: Recibe datos de otros componentes que generan información de productos, como un formulario de entrada de datos, una base de datos interna o una API externa que proporciona descripciones de productos.
  • Salidas: Sus salidas (Product ID y Product) suelen conectarse a componentes que dependen de ese producto específico, como:
    • Stripe Price: Para crear el precio asociado a ese producto.
    • Stripe Subscription: Para crear suscripciones basadas en ese producto.
    • Stripe Invoice: Para generar facturas que incluyan ese producto.
    • Webhooks: Para notificar a otros sistemas que un producto ha sido creado o actualizado.

Ejemplo de Uso

Escenario: Crear un nuevo producto de servicio

  1. Conecta el componente Stripe Product.
  2. En el campo Operation, selecciona Create.
  3. En el campo Name, escribe “Suscripción Premium”.
  4. En Active, asegúrate de que esté configurado en True (activo).
  5. Ejecuta el flujo.
  6. El componente devolverá un Product ID. Puedes conectar esa salida al campo Product ID de un componente Stripe Price para asociarle un precio automáticamente.

Consideraciones de Seguridad

  • Manejo de Credenciales: Asegúrate de nunca escribir tus claves de API de Stripe directamente en el código de tus flujos o en campos de texto abiertos. Utiliza siempre la sección de Credenciales de Nappai, ya que esta se maneja de forma segura y encriptada.
  • Validación de IDs: Al operar con “Retrieve”, “Update” o “Delete”, verifica que el Product ID sea correcto. Eliminar un producto con un ID incorrecto podría resultar en la pérdida de datos no deseados si hay errores tipográficos en los datos de entrada.