Productos

Los productos representan los servicios o recursos facturables de su organización. Cada producto puede tener múltiples precios y soporta jerarquía de un nivel (producto raíz con hijos/add-ons).

Campos del Producto

Campo	Descripción
Nombre	Nombre de visualización (1-255 caracteres)
Slug	Identificador único amigable para URL
Descripción	Detalles sobre el producto
Tipo	Determina el modelo de uso (ver tabla abajo)
Visibilidad	public o private
Label de la unidad	Nombre de la unidad (ej: "usuarios", "GB")
Incremento	Paso mínimo de cantidad (ej: 10 = cantidades 10, 20, 30...)
Obligatorio	Si es necesario para suscribirse
URL del sitio	Enlace a la documentación/página del producto

Tipos de Producto

Tipo	Descripción	Recurrencia
base	Producto estándar recurrente	Recurrente
addon_quantity	Add-on con precio por cantidad	Recurrente
addon_fixed	Add-on con precio fijo	Recurrente
metered	Cobro basado en uso medido	Recurrente (en arrears)
one_time_fixed	Cargo único fijo	Una vez
one_time_quantity	Cargo único por unidad	Una vez

Jerarquía de Productos

Los productos soportan un nivel de jerarquía:

Producto Raíz (parentProductId = null)
├── Producto hijo 1 (add-on)
├── Producto hijo 2 (cargo de setup)
└── Producto hijo 3 (módulo opcional)

Reglas de Jerarquía

• No es posible anidar más de 1 nivel (los hijos no pueden tener hijos)
• Los productos hijos heredan la organización/empresa del padre
• Solo los productos raíz pueden agregarse a planes
• Los productos hijos aparecen como add-ons/opciones del producto padre

Estado y Ciclo de Vida

draft (borrador) → active (activo) → archived (archivado)
        ↓               ↑                    ↓
     DELETE          PUBLISH              RESTORE

Estado	Descripción
draft	En desarrollo, no visible para planes
active	Disponible para planes y suscripciones
archived	Desactivado; no puede usarse en nuevas suscripciones

Reglas

• Archivar: No es posible si es usado por suscripciones activas, en prueba o past_due. Desactiva todos los precios automáticamente
• Restaurar: Vuelve al estado active
• Publicar: Mueve de draft a active

Operaciones en Lote

• Archivar en lote: Archiva múltiples productos
• Eliminar en lote: Elimina productos no utilizados en suscripciones
• Mover a grupo: Mueve productos a un grupo de productos
• Cambiar visibilidad: Modifica la visibilidad de múltiples productos
• Cambiar empresa: Mueve productos a otra empresa

Reordenación

Los productos poseen un campo displayOrder para controlar el orden de visualización en el dashboard y portal. Es posible reordenar mediante drag-and-drop o API.