Para qué sirve#
Es el catálogo de productos y servicios de tu empresa: nombre, categoría, descripción, precio, imágenes, datos propios y extras opcionales. El catálogo se consulta desde la pantalla Productos, desde la pestaña «Productos» del panel de información de los contactos y se usa en las oportunidades (campo «Producto» y filtro por producto).
Quién puede usarlo y cómo llegar#
- Consultar: todos los usuarios. Menú lateral → Productos (ícono de caja), dirección
/productos. El título de la pantalla es «Gestión de productos». - Crear, editar, activar/desactivar y eliminar: solo administradores. Para los demás, el formulario se abre en modo lectura («Producto» con el botón Cerrar) y el menú de cada fila ofrece solo «Ver producto».
- La estructura del catálogo (categorías, campos personalizados y adicionales) se administra en Configuración → Gestión de productos; ver Configuración de productos.
La lista#
Barra superior#
| Control | Qué hace |
|---|---|
| Buscador («Buscar por nombre, categoría o descripción...») | Filtra mientras escribes, sin distinguir mayúsculas ni tildes. Busca en el nombre, la categoría, la descripción y los valores de los campos personalizados. |
| Todas las categorías | Filtra por una categoría. |
| Todos los estados | Filtra por ACTIVO o INACTIVO. |
| Columnas (ícono) | Elige qué columnas ver; Restablecer vuelve a las predeterminadas. Se recuerda en tu navegador. |
| Agregar producto | Solo administradores. Abre el formulario. |
Columnas#
| Columna | Qué muestra | Por defecto |
|---|---|---|
| Producto o servicio | Miniatura de la portada (o un ícono si no tiene imágenes) y el nombre. No se puede ocultar. | Visible |
| Categoría | Etiqueta con el color de la categoría. | Visible |
| Precio | Con formato «$ 1.250.000» (punto como separador de miles, coma para decimales; hasta 2 decimales). | Visible |
| Adicionales | Cuántos adicionales tiene. Solo existe si la función de adicionales está activada. | Visible (si está activada) |
| Estado | ACTIVO (verde) o INACTIVO (gris). | Visible |
| Descripción | Texto de la descripción. | Oculta |
| Cada campo personalizado | Su valor («Sí»/«No» en los interruptores). | Oculta |
Cambiar el estado: el administrador hace clic en la etiqueta ACTIVO/INACTIVO de una fila («Clic para desactivar» / «Clic para activar») y el cambio es inmediato. Un producto inactivo no se ofrece al elegir producto en una oportunidad, pero sigue en el catálogo.
Seleccionar y eliminar varios productos (solo administrador)#
La primera columna de la tabla tiene una casilla por producto, y en el encabezado una casilla que marca todos los de la página. Al marcar uno o más productos aparece arriba, junto al botón «Agregar producto», el contador («2 seleccionados») con los botones Eliminar y Quitar selección.
- Las filas marcadas se resaltan; la selección se conserva al cambiar de página o de filtro.
- Eliminar pide confirmación («¿Eliminar 2 productos? Se borran también sus imágenes y adicionales. Esta acción no se puede deshacer.») y, al aceptar, borra todos de una vez; un aviso negro confirma cuántos se eliminaron. Máximo 500 por vez.
- Las oportunidades que tenían esos productos quedan sin producto (no se borran).
- Quien no es administrador no ve las casillas.
Paginación#
Abajo: «Mostrando N de M», selector «Mostrar 20 / 50 / 100 por página» (20 por defecto) y flechas con «Página N de M». Si no hay productos: «Todavía no hay productos.» (al administrador, si no hay categorías, se le recuerda «Primero crea una categoría en Configuración > Gestión de productos.»). Si la búsqueda no encuentra nada: «Ningún producto coincide con la búsqueda.»
Menú de la fila (⋮)#
- Editar producto (administrador) o Ver producto.
- Eliminar producto (solo administrador). Confirma con «¿Eliminar «nombre»? Se borran también sus imágenes y adicionales. Esta acción no se puede deshacer.»
También puedes hacer clic en cualquier parte de la fila para abrir el producto.
Crear o editar un producto#
Pulsa Agregar producto (o abre uno existente). El formulario tiene dos columnas: a la izquierda los datos y a la derecha las imágenes.
| Campo | Qué hace | Valores | Por defecto |
|---|---|---|---|
| Categoría \* | Grupo del catálogo al que pertenece. | Una de las categorías creadas. | La primera de la lista |
| Producto o servicio \* | Nombre. | Hasta 200 caracteres. | Vacío |
| Descripción | Detalle del producto o servicio. | Hasta 5.000 caracteres. | Vacío |
| Precio \* | Precio base. | Número de 0 en adelante, con hasta 2 decimales (acepta coma o punto). | Vacío |
| Campos personalizados | Los que definió el administrador, agrupados bajo el nombre de su grupo («Otros datos» o «Datos adicionales» si no tienen grupo). Los obligatorios llevan \*. | Según el tipo: texto (hasta 500 caracteres), número, lista de opciones o interruptor. | Vacíos |
| Adicionales | Extras con nombre y precio (ver abajo). Solo aparece si la función está activada. | Hasta 50. | Ninguno |
| Imágenes | Fotos del producto (ver abajo). | Hasta 5. | Ninguna |
El estado no se edita en el formulario: un producto nuevo queda activo y se cambia con la etiqueta de la lista.
Imágenes#
- Hasta 5 imágenes por producto, en JPG, PNG, WEBP o GIF, de hasta 5 MB cada una.
- Pulsa Agregar para elegir uno o varios archivos. Cada imagen muestra una estrella (usar como portada) y una × (quitar).
- Una sola imagen es la portada (etiqueta verde «PORTADA»). Por defecto es la primera que cargues; puedes cambiarla con la estrella. La portada es la miniatura de la lista y la imagen principal en el panel de información.
- Las imágenes solo se muestran a usuarios que hayan iniciado sesión.
Listas de distribución#
En el formulario del producto, la sección Listas de distribución permite asociarlo a una o varias listas de distribución (marcas las casillas; solo aparecen las listas de tipo correo electrónico que están activas; se crean en Listas de distribución).
- Buscar: si hay varias listas aparece un campo de búsqueda por similitud: no distingue mayúsculas ni tildes, tolera errores de escritura («exel avanzdo» encuentra «Curso Excel Avanzado») y no importa el orden de las palabras. Las listas más parecidas salen primero y los interruptores que ya marcaste se conservan aunque estén ocultos por el filtro.
- Qué hace: cuando un pedido con ese producto queda pagado por completo, el contacto se agrega solo a esas listas. Así puedes enviarle después difusiones de ese producto, curso o servicio.
- Cuándo: únicamente al quedar pagado (un pedido pendiente o con un pago parcial no agrega a nadie). Si el contacto ya está en la lista no se duplica; si una lista se elimina, se ignora.
- Compras de la tienda web y de WooCommerce: las líneas que llegan solo con el nombre «Producto — descripción» se reconocen por el nombre cuando coincide con un solo producto del catálogo. Las compras pagadas que importa el conector de WooCommerce también agregan al contacto a las listas del curso.
- Compras anteriores: al asociar listas a un producto no se agrega a quienes ya habían comprado; para eso existe un recorrido de todas las compras (
scripts/asignar_listas_compradores.php, primero en modo simulación). Se ejecutó el 22-oct-2026: 27 compradores quedaron en las listas de sus cursos. - Constancia: en la línea de tiempo del pedido queda «El contacto se agregó a las listas de distribución: …».
- Bajas: quien se dio de baja de una lista sigue dado de baja: estar en la lista no reactiva su suscripción.
Adicionales#
Son extras con su propio nombre (hasta 150 caracteres) y precio. Pulsa Agregar adicional, completa «Nombre del adicional» y «Precio» y usa la × para quitar uno. Los renglones totalmente vacíos se ignoran.
Paso a paso: crear un producto#
- Asegúrate de que exista al menos una categoría (Categorías de productos). Si no, Connecto avisa «Primero crea al menos una categoría en Configuración > Gestión de productos.»
- Productos → Agregar producto.
- Elige la Categoría, escribe el nombre y el precio, y completa lo demás.
- (Opcional) Agrega imágenes y marca la portada.
- Pulsa Guardar. Mientras guarda, el botón dice «Guardando…».
Validaciones y mensajes#
| Mensaje | Cuándo |
|---|---|
| «Escribe el nombre del producto o servicio.» | Nombre vacío. |
| «Elige la categoría del producto.» | Categoría no válida. |
| «Escribe un precio válido (0 o más).» | Precio vacío, negativo o no numérico. |
| «La descripción es demasiado larga (máximo 5.000 caracteres).» | Descripción excede el límite. |
| ««campo» es obligatorio.» / ««campo» debe ser un número.» / ««campo»: elige una de las opciones.» | Problemas con un campo personalizado. |
| «Cada adicional necesita un nombre.» / «El adicional «X» necesita un precio válido.» / «Máximo 50 adicionales por producto.» | Problemas con los adicionales. |
| «Un producto puede tener hasta 5 imágenes.» | Más de 5 imágenes. |
| ««archivo» supera los 5 MB.» / ««archivo» no es una imagen válida (JPG, PNG, WEBP o GIF).» | Archivo no admitido. |
| «Solo un administrador puede gestionar los productos.» | Un usuario sin permiso intentó escribir. |
Valor editable#
El interruptor Valor editable del formulario del producto decide si su valor se puede escribir a mano al agregarlo a un pedido o a una cotización:
- Apagado (predeterminado): el producto usa siempre el precio del catálogo (o el de la referencia elegida si tiene varios precios) y el campo de valor aparece bloqueado en el pedido y la cotización. Los descuentos de línea y el descuento general siguen funcionando.
- Encendido: el valor del catálogo queda como valor sugerido y quien arma el pedido o la cotización puede escribir otro valor. Sirve para abonos, servicios a convenir o montos que se definen en cada venta.
Las líneas libres (sin producto del catálogo) siempre admiten el valor que escribas. Un pedido o una cotización que ya tenía un valor distinto del catálogo (creado antes de este cambio o por la API) se puede seguir editando sin que ese valor se pierda. Las integraciones por API v1 no cambian: pueden seguir enviando su valor.
Los productos en el panel de información#
En el chat y al responder un correo, el panel de información del contacto tiene una pestaña Productos que lista todo el catálogo: imagen, nombre, descripción, categoría, precio y la marca «INACTIVO» cuando corresponde. Al hacer clic en una tarjeta se abre la información completa del producto (galería de imágenes, categoría, estado, precio, descripción, campos personalizados por grupo y adicionales); el botón Productos vuelve a la lista. Si pasó más de un minuto desde la última carga, al abrir la pestaña se vuelve a pedir el catálogo. Ver Panel de información.
Avisos y casos especiales#
- Al guardar un producto, las reglas de cupones que lo usan por referencia se conservan mientras la referencia siga existiendo; si quitas una referencia, desaparece su regla en los cupones.
- Al eliminar un producto, las oportunidades que lo tenían quedan sin producto (no se borran).
- Eliminar un producto borra también sus imágenes y adicionales.
- El precio de un producto no se copia solo al valor de una oportunidad: el valor de la oportunidad se escribe aparte.
<!-- Fuente: tenant-app/public/productos/index.php, tenant-app/public/api/productos.php, tenant-app/public/media/producto.php, shared/src/Core/Productos.php, shared/js/info-panel-productos.js, tenant-app/views/partials/info_panel.php, db/migrations/0079_productos.sql -->