> For the complete documentation index, see [llms.txt](https://solaytech.gitbook.io/klug/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://solaytech.gitbook.io/klug/modulos/inventario/productos-and-servicios.md).

# Productos & Servicios

Productos y Servicios centraliza la información de todo lo que vendes y es el punto de partida para controlar inventario, ventas y reportes.

### 1) Listado de productos

Ve a **Inventario → Productos & Servicios**. En la parte superior verás indicadores de **bienes**, **servicios**, productos **con stock**, **sin stock** y **combos**.

<figure><img src="https://560832521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD2edvfE0Auxurv1AYwdh%2Fuploads%2F6SfKogC7i0PE1aVZhpb0%2Finv-productos-lista.jpg?alt=media&amp;token=a16efa05-c48d-4351-8f87-0c387acec036" alt="Listado de productos"><figcaption><p>Listado de productos</p></figcaption></figure>

Cada fila muestra la **imagen del producto** junto al nombre, lo que facilita ubicarlo de un vistazo. Puedes filtrar por **categoría, marca, sucursal**, **tipo** (bien o servicio), **agotados/disponibles**, **estado** y **estado de combo**, o buscar por nombre o código (tecla **F1**). Cada fila muestra código, tipo, precio, marca, categoría, sucursal, stock y disponibilidad. El botón de tres puntos abre las acciones del producto (editar, clonar, eliminar).

{% hint style="info" %}
Los productos marcados como **Agotado** tienen existencia en cero en la sucursal. Los combos muestran la etiqueta **Combo** junto al nombre.
{% endhint %}

### 2) Crear o editar un producto

{% hint style="info" %}
¿Tienes tu catálogo en Excel? Puedes cargarlo de una vez con **Importar** (ver [Importar productos desde Excel o CSV](#6-importar-productos-desde-excel-o-csv)).
{% endhint %}

1. Haz clic en **Nuevo producto** (o en el lápiz de un producto existente).
2. En **Información del producto** completa:
   * **Tipo de producto**: *Bien* (se controla existencia) o *Servicio*.
   * **Código (SKU)**: puedes escribirlo o leerlo con el lector de código de barras.
   * **Nombre del producto** (obligatorio).
   * **Marca**, **Categoría** y **Unidad de medida** (obligatoria).
   * **Logo del producto**: foto del producto (PNG, JPG, SVG o WebP; cuadrada de preferencia; máximo 2 MB). Se sube en cuanto la seleccionas y **Quitar logo** la elimina.
3. En **Precios y estado** (panel derecho) completa **Precio de venta**, **Precio de compra**, **Precio mayorista**, el **Estado del producto** (habilitado para venta), **Uso interno** y **Comisión en venta**.
4. Haz clic en **Guardar cambios**.

<figure><img src="https://560832521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD2edvfE0Auxurv1AYwdh%2Fuploads%2FAtnGT9iC13yHQ4eW7iZe%2Finv-producto-form.jpg?alt=media&amp;token=4a8fbe49-9bf1-4aae-a9da-956bbeeda486" alt="Formulario de producto"><figcaption><p>Formulario de producto</p></figcaption></figure>

{% hint style="warning" %}
Los datos de **Información del producto** son compartidos por todas las sucursales. Los de **Precios y estado** aplican solo a la sucursal indicada en el aviso amarillo.
{% endhint %}

{% hint style="success" %}
**Agrega foto a tus productos.** La imagen aparece en el listado de productos, en el buscador de **Nueva venta**, en el detalle de la venta y en las tarjetas de la **Vista íconos** del punto de venta. Con fotos, el cajero identifica más rápido lo que vende y se reducen errores entre modelos parecidos (por ejemplo, colores o capacidades de un mismo teléfono).
{% endhint %}

En la parte inferior del formulario está la tabla **Sucursales**, donde marcas en qué sucursales existe el producto y su cantidad, y el interruptor **¿Es un producto combo?**. También puedes desplegar **Información adicional** para agregar una descripción y notas internas.

<figure><img src="https://560832521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD2edvfE0Auxurv1AYwdh%2Fuploads%2F6MqajkJduuOS493KI5Rt%2Finv-producto-form-inferior.jpg?alt=media&amp;token=aac0ea1e-04a2-4c08-abed-8e585dd0d644" alt="Parte inferior del formulario: combos y sucursales"><figcaption><p>Parte inferior del formulario: combos y sucursales</p></figcaption></figure>

### 3) Productos combo

Un combo agrupa varios productos que se venden juntos (por ejemplo, *iPhone 12 + Funda MagSafe*).

1. Activa **¿Es un producto combo?** y haz clic en **Configurar combo**.
2. En **Tipo** elige:
   * **Individual**: artículo que siempre se incluye.
   * **Elección**: grupo de opciones entre las que el cliente elige (por ejemplo, *Accesorio*).
   * **Libre**: texto libre sin inventario (por ejemplo, "sin sol").
3. Busca el producto, indica la **cantidad** y haz clic en **Agregar**.
4. Ajusta **cantidad**, **precio** y **visible** de cada artículo. El sistema muestra el **Valor total del combo**.
5. Haz clic en **Listo** y guarda el producto.

<figure><img src="https://560832521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD2edvfE0Auxurv1AYwdh%2Fuploads%2FzkSJJq47YeglAdgOG7sv%2Finv-combo-configurador.jpg?alt=media&amp;token=7bfafd52-40e5-4fd7-8eb8-10135f0e1665" alt="Configurador de combo"><figcaption><p>Configurador de combo</p></figcaption></figure>

### 4) El producto en la venta

Una vez creado, el producto está disponible en **Finanzas → Ventas → Nueva venta** y en **Punto de venta → Mis Ventas → Nueva venta**. En la **Vista íconos** cada producto aparece como una tarjeta con su foto, precio, existencia y categoría; con un clic se agrega al detalle de la venta. El flujo completo se explica en Punto de venta → Mis ventas.

<figure><img src="https://560832521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD2edvfE0Auxurv1AYwdh%2Fuploads%2FP8J2e3h7DWtJ3u85cYjk%2Fpos-venta-iconos.jpg?alt=media&amp;token=e464780a-5cf2-4dc7-993c-c2ba6d764e35" alt=""><figcaption><p>Productos con imagen en la vista de íconos</p></figcaption></figure>

### 5) Pestañas del producto

Al editar un producto aparecen pestañas adicionales:

#### Archivos

Adjunta imágenes adicionales del producto (fotos del empaque, ficha técnica escaneada, etiquetas, etc.) con **Elegir archivos** o arrastrándolas al recuadro. Puedes subir varias a la vez, con un máximo de 10 MB por archivo. Cada archivo de la lista tiene botones para **descargar** y **eliminar**.

{% hint style="warning" %}
Por ahora solo se aceptan imágenes: **jpeg, jpg, png, gif, webp y heic**. Si intentas subir un PDF u otro documento, el sistema lo marca con el error *Extensión inválida* y sube solo los archivos válidos. Si tu ficha técnica está en PDF, guárdala como imagen antes de subirla.
{% endhint %}

<figure><img src="https://560832521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD2edvfE0Auxurv1AYwdh%2Fuploads%2FUfxINgyIqb2EY4irAqh3%2Finv-producto-archivos.jpg?alt=media&amp;token=7a9095ad-8a8d-4d67-a8c9-2252dacee983" alt="Archivos del producto"><figcaption><p>Archivos del producto</p></figcaption></figure>

#### Transacciones

Registra entradas, salidas o traslados de inventario y consulta el historial.

1. Elige el **Tipo de transacción** (por ejemplo, *Ingreso por factura de proveedor*). Los tipos se administran en **Configuración → Tipos de transacción de productos**.
2. Escribe la **Cantidad**, el **Precio de compra** (opcional) y una **Descripción**.
3. Haz clic en el botón de guardar.

<figure><img src="https://560832521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD2edvfE0Auxurv1AYwdh%2Fuploads%2F0NkRKu0Fs77pkLR5K844%2Finv-transaccion-form.jpg?alt=media&amp;token=78bc2fdb-d1da-44e5-be97-736d44966ab4" alt="Nueva transacción"><figcaption><p>Nueva transacción</p></figcaption></figure>

El historial muestra fecha, tipo (**Entrada** o **Salida**), movimiento, cantidad, **stock resultante**, precio de compra, usuario y el enlace a la venta relacionada.

<figure><img src="https://560832521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD2edvfE0Auxurv1AYwdh%2Fuploads%2FPm7yVMm3qYiZBIf8suLR%2Finv-transaccion-creada.jpg?alt=media&amp;token=dcf8b405-62bb-400a-b960-768f8c697c02" alt="Transacción registrada"><figcaption><p>Transacción registrada</p></figcaption></figure>

#### Estadísticas

Muestra la **tendencia de ventas** del producto: unidades vendidas, total facturado, número de ventas y precio promedio, con filtro de fechas y agrupación por mes.

<figure><img src="https://560832521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD2edvfE0Auxurv1AYwdh%2Fuploads%2FZfwr76MIe2mGoIZsPwgz%2Finv-producto-estadisticas.jpg?alt=media&amp;token=28d96f59-556d-4377-b909-291e12f22d58" alt="Estadísticas del producto"><figcaption><p>Estadísticas del producto</p></figcaption></figure>

#### Alertas

Activa **Alertas de bajo stock** para recibir una notificación cuando la existencia baje del **Límite mínimo de stock**. La revisión se hace automáticamente cada noche (hora de Guatemala) con la frecuencia que elijas.

<figure><img src="https://560832521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD2edvfE0Auxurv1AYwdh%2Fuploads%2FO610onwmYbH9IcPJB2sX%2Finv-producto-alertas.jpg?alt=media&amp;token=c6b35b67-acaf-4e66-9302-815ff2a62c6f" alt="Alertas de bajo stock"><figcaption><p>Alertas de bajo stock</p></figcaption></figure>

#### Calendario

Para servicios que se agendan: **Habilitar visibilidad en API**, **Tiempo de servicio** (en horas) y **Descripción** que se muestra al reservar.

<figure><img src="https://560832521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD2edvfE0Auxurv1AYwdh%2Fuploads%2FyXmU64xVNb8l4HyQHz5Q%2Finv-producto-calendario.jpg?alt=media&amp;token=60a2ab41-1d4b-48b9-b2f3-60a6457c1ce1" alt="Configuración de calendario del producto"><figcaption><p>Configuración de calendario del producto</p></figcaption></figure>

### 6) Importar productos desde Excel o CSV

Si ya tienes tu catálogo en una hoja de cálculo, puedes cargarlo completo en lugar de crear los productos uno por uno.

1. En **Inventario → Productos & Servicios**, presiona **Importar**. El diálogo muestra la **sucursal** a la que se importan los productos.
2. Presiona **Descargar plantilla** y llénala en Excel, o usa tu propio archivo con las mismas columnas. Se aceptan archivos **CSV y XLSX** de hasta **2 MB**.
3. Arrastra el archivo al recuadro o haz clic para elegirlo. El sistema lo revisa y muestra una **vista previa** con cuántas filas se crearán, cuántas se actualizarán y cuáles tienen error, junto con el motivo de cada una.
4. Presiona **Importar N filas**. Las filas con error no se importan; las demás sí.

**Columnas de la plantilla:** `codigo`, `nombre`, `tipo` (`bien` o `servicio`; vacío es bien), `categoria`, `marca`, `unidad`, `precio`, `costo`, `existencias`, `duracion_minutos` (solo servicios) y `descripcion`. Las columnas `precio_…` son el precio por tipo de cliente.

* **nombre** y **precio** son obligatorios para los productos nuevos.
* Deja **id** vacío para crear productos. Para **editar** tu catálogo en masa, exporta el listado en CSV (trae el id de cada fila), haz los cambios y vuelve a subirlo.
* Las categorías, marcas y unidades que no existan se crean solas.
* **existencias** solo se usa al crear el producto y se carga en la sucursal actual. Las existencias de un producto que ya existe no cambian por importación.
* Los combos no se importan.

{% hint style="warning" %}
**Formatos de números:** usa punto decimal, por ejemplo `10.50` o `1,250.50`; puedes dejar el símbolo (`Q.18.00` o `Q 6`). El sistema rechaza `28,50` (coma decimal) y `Q.25`, porque puede leerse como Q25 o como 25 centavos.

**Códigos de barras:** da formato de **texto** a la columna en Excel antes de escribirlos. Si no, Excel los convierte a `7.40123E+12` y el código se pierde.
{% endhint %}

#### Importaciones grandes

Hasta 50 filas se guardan al instante. Con más, verás una barra de avance (por ejemplo, «275 de 576 productos») y puedes presionar **Seguir en segundo plano** para continuar trabajando. Al terminar recibes un aviso en la **campana de notificaciones** con el resultado; **Ver detalles** abre el resumen y te permite **descargar las filas con error** para corregirlas y volver a subirlas. Si la importación falla, no se guarda ningún cambio.

{% hint style="info" %}
Para ver el botón **Importar**, tu rol necesita el permiso de importar productos en **Administración → Roles**.
{% endhint %}