Stripe Product

Stripe Product gestiona el catálogo de productos de tu cuenta de Stripe. Un producto es lo que vendes, un artículo o un servicio, con su nombre, su descripción y otros datos. El importe no va en el producto sino en sus precios, que creas con Stripe Price.

Cuándo usarlo

• Das de alta un artículo en tu tienda o en tu ERP y quieres que aparezca también en Stripe.
• Cambias la descripción o la página web de un servicio y quieres actualizarla en Stripe.
• Quieres retirar un producto de la venta marcándolo como inactivo.
• Quieres consultar los productos activos para revisar tu catálogo.

Configuración

Necesitas una credencial Stripe API con la clave secreta de tu cuenta de Stripe. Consulta Credenciales.

Campo	Qué hace
Credential (obligatorio)	La credencial Stripe API de tu cuenta.
Operation (obligatorio)	La acción que realiza el componente. Por defecto, Create. Consulta Operaciones.
Mode	Solo en Get. By ID consulta un producto concreto; All devuelve la lista de productos. Por defecto, By ID.
Product ID	El identificador del producto en Stripe (empieza por prod_). Obligatorio en Delete, Update y Get con By ID.
Name	El nombre del producto. Obligatorio en Create; en Update, solo si quieres cambiarlo.
Description	La descripción del producto. En Create y Update.
Active	En Create y Update, true lo deja a la venta y false lo retira. En Get con All, devuelve solo los productos activos (true) o inactivos (false). Vacío, no se cambia ni se filtra.
URL	La dirección de la página pública del producto. En Create y Update.
Unit Label	Cómo se llama una unidad del producto en los recibos y facturas, por ejemplo licencia o asiento. En Create y Update.
Shippable	true si el producto se envía físicamente, false si no. En Create y Update.
Statement Descriptor	El texto que ve el cliente en el extracto de su tarjeta. Hasta 22 caracteres. En Create y Update.
Tax Code	El código fiscal de Stripe Tax que corresponde al producto, por ejemplo txcd_10000000. En Create y Update.
Limit	Solo en Get con All. Número máximo de productos que se devuelven, entre 1 y 100. Por defecto, 100.

En Update solo se cambian los campos que rellenes; los vacíos se quedan como estaban.

Operaciones

• Create: crea un producto nuevo en tu catálogo.
• Delete: elimina un producto. Stripe solo lo permite si el producto no tiene precios; si los tiene, márcalo como inactivo con Update.
• Get: con By ID devuelve un producto; con All devuelve la lista, filtrada por activos o inactivos si lo indicas.
• Update: cambia los datos de un producto existente.

Resultado

La salida Data devuelve el producto creado, consultado, actualizado o eliminado. Con Get y All, devuelve un elemento por cada producto. Cada elemento incluye el identificador del producto, que necesitarás en Stripe Price y Stripe Plan.

El componente también se puede conectar a un Agente como herramienta, para que el agente decida cuándo usarlo. Consulta Tool Mode.

Ejemplo

Una empresa de software da de alta en Stripe cada nueva licencia que añade a su catálogo.

1. Cuando se aprueba el nuevo producto en tu hoja de catálogo, el flujo recibe su nombre y su descripción.
2. Añade Stripe Product con Operation en Create y pasa esos datos a Name y Description.
3. Pon Unit Label en licencia y Statement Descriptor en MIEMPRESA SOFTWARE.
4. Conecta la salida Data a Stripe Price para crear su precio anual.

Componentes relacionados

• Stripe Price: precios de tus productos.
• Stripe Plan: planes de pago periódico.
• Stripe Subscription: suscripciones de tus clientes.