# Manual de Productos

# Catálogo

# Crear un producto

## ¿Qué es / para qué sirve?

Crear un producto lo deja disponible para venderlo en el POS. Aquí defines su
nombre, precio, impuesto y si manejas su inventario.

## Paso a paso

1. Ve a **Productos → Agregar**.
2. Completa la información básica:
   - **Nombre del Producto** (obligatorio).
   - **SKU**: déjalo vacío para que se genere solo, o escribe el tuyo.
   - **Unidad** (ej. unidad, libra), **Categoría** y **Marca** (si las usas).
3. **¿Administrar Stock?**: márcalo si quieres controlar existencias; podrás fijar
   un **Stock de Alerta** para avisos de bajo inventario.
4. Elige el **Tipo Producto**:
   - **Simple**: un producto normal.
   - **Variable**: con variaciones (ej. tallas, sabores).
   - **Combo**: compuesto por otros productos.
5. Define precios e impuesto:
   - **Precio de Compra**, **Margen (%)** y **Precio de Venta**.
   - **Impuesto Aplicable** (ITBMS) y si el precio lo lleva **Incluido** o **No Incluido**.
6. (Opcional) Sube una **Imagen del Producto**.
7. Guarda con **Guardar** (o usa *Guardar y Agregar Stock de Apertura* para cargar
   existencias iniciales).

[CAPTURA: formulario "Agregar Nuevo Producto" con nombre, unidad, tipo y precios]

## Notas y avisos

> - El **tipo de producto** no se puede cambiar después de crearlo.
> - Para vender por peso, usa una unidad que **permita decimales** (ver
>   [Unidades de medida (UOM)](unidades-de-medida.md)).
> - Si manejas precios distintos por tipo de cliente, ve a
>   [Precios por grupo](grupos-de-precio.md).

Temas relacionados:
- [Productos con y sin control de inventario](productos-con-y-sin-inventario.md)
- [Productos combo / recetas](productos-combo.md)
- [Unidades de medida (UOM)](unidades-de-medida.md)

PENDIENTE DE VERIFICAR: campos fiscales (Segmento/Familia CPBS) requeridos para
factura electrónica de personas jurídicas, según tu configuración.

# Importar productos en masa

## ¿Qué es / para qué sirve?

Permite cargar **muchos productos a la vez** desde un archivo Excel, en lugar de
crearlos uno por uno. Ideal al montar el catálogo inicial.

## Paso a paso

1. Ve a **Configuración → Importar Productos** (o desde el menú Productos).
2. Presiona **Descargar Archivo de Plantilla** y ábrela en Excel.
3. Completa una fila por producto siguiendo las columnas de la plantilla. Las más
   importantes:
   - **Nombre** del producto (obligatorio).
   - **Unidad** (debe existir en el sistema).
   - **Gestionar Stock** (1 = sí, 0 = no).
   - **Tipo Producto** (single = simple, variable).
   - **Precio de Venta** e **Impuesto Aplicable** (si lo usas).
4. Guarda el archivo.
5. Vuelve a la pantalla, elige el archivo en **Archivo a Importar** y presiona
   **Enviar**.
6. El sistema valida e informa los productos creados o los errores por fila.

[CAPTURA: pantalla "Importar Productos" con el botón de plantilla y el de Enviar]

## Notas y avisos

> - Las **unidades, categorías, marcas e impuestos** referidos deben coincidir
>   con los nombres ya creados (algunas se crean solas si no existen).
> - Revisa los **errores por fila** que reporte el sistema y corrige el Excel
>   antes de reintentar.
> - Para cargar existencias, hay una importación aparte de **inventario** (por
>   SKU + sucursal + cantidad).

PENDIENTE DE VERIFICAR: columnas obligatorias exactas pueden variar según los
campos personalizados activos en tu negocio.

# Imprimir etiquetas y códigos de barras

## ¿Qué es / para qué sirve?

Genera e imprime **etiquetas con código de barras** para tus productos, con su
nombre y precio, para pegarlas en el empaque y agilizar la venta por escaneo.

## Paso a paso

1. Ve a **Productos → Etiquetas de código de barras**.
2. En el buscador, escribe el nombre o SKU del producto y agrégalo.
3. Indica el **Nº de Etiquetas** a imprimir por producto.
4. Marca qué información mostrar: **Nombre del Producto**, **Precio**,
   **Nombre de la Empresa**, etc.
5. Elige el **Ajuste del Código de Barras** (formato/tamaño de etiqueta).
6. Presiona **Imprimir Etiquetas**.

[CAPTURA: pantalla "Imprimir Etiquetas" con productos, cantidad y opciones a mostrar]

## Notas y avisos

> - El formato de etiqueta debe coincidir con el papel/rollo de tu impresora.
> - Los campos **Nº de Lote** y **Fecha de Caducidad** solo aplican si tu negocio
>   los maneja; en restaurante normalmente no se usan.

# Categorías y marcas

## ¿Qué es / para qué sirve?

Son las clasificaciones que ordenan tu catálogo. Las **categorías** agrupan
productos (ej. "Bebidas") y las **marcas** identifican al fabricante. (Las
unidades de medida tienen su propia página:
[Unidades de medida (UOM)](unidades-de-medida.md)).

## Crear una categoría

1. Ve a **Productos → Categorías**.
2. Presiona **Agregar**, escribe el **Nombre** y guarda.
3. Puedes crear **subcategorías** dentro de una categoría.

[CAPTURA: listado de categorías con el botón Agregar]

## Crear una marca

1. Ve a **Productos → Marcas**.
2. Presiona **Agregar**, escribe el **Nombre de la Marca** y una breve descripción.
3. Guarda.

## Notas y avisos

> - Si **categorías** o **marcas** no aparecen al crear productos, actívalas en
>   los ajustes del negocio (pestaña Producto).
> - Para definir cómo se mide y vende cada producto, ve a
>   [Unidades de medida (UOM)](unidades-de-medida.md).

# Productos combo / recetas

## ¿Qué es / para qué sirve?

Un **producto combo** es un producto que se **arma con otros productos**. Se vende
como uno solo (ej. "Combo Almuerzo" = arroz + pollo + bebida), pero por dentro
está compuesto por sus **componentes**. En este sistema, lo que se llama
**"receta"** corresponde a este tipo de producto: al vender el combo, se consume
el inventario de los productos que lo forman.

## Crear un combo

1. Ve a **Productos → Agregar**.
2. Completa la información básica (nombre, unidad, categoría).
3. En **Tipo Producto**, elige **Combo**.
4. En la sección del combo:
   - Busca cada **producto componente** por nombre/SKU y agrégalo.
   - Indica la **Cantidad** de cada componente.
   - El sistema muestra el **costo** de cada línea y el **Importe Total Neto**
     (la suma de los costos).
5. Define el precio de venta del combo con el **Margen (%)** o el
   **Precio de Venta**.
6. Guarda.

[CAPTURA: formulario de producto Combo con los componentes, cantidades y el Importe Total Neto]

## Cómo afecta el inventario

- El combo en sí normalmente **no maneja su propio stock**: el control se lleva
  por sus **componentes**.
- Al **vender un combo**, el sistema **descuenta el inventario de cada
  componente** según las cantidades de la receta.
- Por eso, los componentes sí deben tener **¿Administrar Stock?** activado si
  quieres que se descuenten (ver
  [Productos con y sin control de inventario](productos-con-y-sin-inventario.md)).

## Consultar combos / recetas

Existe el reporte **Combos y Recetas** que lista los productos combinados con su
detalle (Manual de Reportes).

## Notas y avisos

> - El **tipo Combo no se puede cambiar** después de crear el producto: defínelo
>   bien desde el inicio.
> - Mantén actualizados los **costos de los componentes**: el costo del combo se
>   calcula sumándolos.

PENDIENTE DE VERIFICAR: si el descuento de inventario de los componentes al vender
un combo está activo por defecto o depende de la configuración del producto.

# Productos con y sin control de inventario

## ¿Qué es / para qué sirve?

Al crear un **producto simple** decides si el sistema **controla su inventario** o
no, con la casilla **¿Administrar Stock?**. La elección cambia cómo se comporta el
producto al venderlo.

## Producto CON control de inventario

Marca **¿Administrar Stock?**.

- El sistema **lleva la cuenta de existencias**: suma al comprar/ajustar y resta
  al vender.
- Puedes fijar un **Stock de Alerta** para avisos de bajo inventario.
- Aparece en los reportes de **stock** y su valor en el inventario.

**Úsalo para:** productos físicos contables (bebidas embotelladas, productos
empacados, mercancía).

## Producto SIN control de inventario

Deja **¿Administrar Stock?** desmarcado.

- El producto **se puede vender siempre**, sin descontar existencias.
- No aparece con cantidad en los reportes de stock.

**Úsalo para:** servicios y preparados donde no quieres contar unidades (ej. un
"jugo natural", un "servicio de domicilio"), o cuando el control lo llevas por los
**ingredientes** mediante un combo (ver
[Productos combo / recetas](productos-combo.md)).

## Paso a paso

1. Crea o edita el producto (ver [Crear un producto](crear-producto.md)).
2. Marca o desmarca **¿Administrar Stock?** según el caso.
3. Si lo activas, define el **Stock de Alerta** (opcional) y carga el
   **stock de apertura**.
4. Guarda.

[CAPTURA: campo "¿Administrar Stock?" y el Stock de Alerta en el formulario de producto]

## Notas y avisos

> - Un producto **sin** control de stock nunca se queda "sin existencias": se
>   vende aunque no tengas inventario cargado.
> - Si un producto debería descontar inventario y no lo hace, revisa que tenga
>   **¿Administrar Stock?** activado.

# Unidades de medida (UOM)

## ¿Qué es / para qué sirve?

Las **unidades de medida (UOM)** definen cómo se mide y vende cada producto:
unidad, libra, litro, caja, etc. El sistema permite crear unidades sueltas o
**relacionarlas entre sí** con equivalencias (por ejemplo, comprar por caja y
vender por unidad).

## Crear una unidad

1. Ve a **Productos → Unidades → Agregar**.
2. Completa:
   - **Nombre** completo (ej. Kilogramo).
   - **Nombre Corto** / abreviatura (ej. kg).
   - **Permitir Decimal**: *Sí* para lo que se vende por **peso o fracción**
     (ej. carne por libra); *No* para lo que se vende entero (ej. botellas).
3. Guarda.

[CAPTURA: cuadro "Agregar Unidad" con Nombre, Nombre Corto y Permitir Decimal]

## Nomenclador: relacionar unidades (equivalencias)

Al **editar** una unidad puedes definir su **tipo** respecto a una unidad de
referencia. Hay tres casos:

1. **Es una unidad de referencia (base).** No depende de otra.
   *Ejemplos:* Libra, Litro, Unidad.

2. **Más grande que una unidad de referencia.** Contiene varias de la base.
   El sistema lo expresa como **“1 [esta unidad] = N [referencia]”**.
   *Ejemplo:* 1 **Caja** = 12 **Unidades**.

3. **Más pequeña que una unidad de referencia.** Es una fracción de la base.
   Se expresa como **“1 [referencia] = N [esta unidad]”**.
   *Ejemplo:* 1 **Libra** = 16 **Onzas**.

Mientras escribes el valor, una **vista previa** te muestra la equivalencia
resultante (ej. *“1 Caja = 12 Unidades”*) para confirmar que quedó bien.

[CAPTURA: edición de unidad mostrando los tres tipos (base / más grande / más pequeña) y la vista previa de equivalencia]

## Para qué sirven las equivalencias

Te permiten, por ejemplo, **comprar por caja** y que el sistema descuente el
inventario **por unidad**, o **comprar por libra** y vender **por onza**, sin
hacer cuentas manuales.

## Notas y avisos

> - Si una unidad **ya está en uso**, cambiar su equivalencia **afecta productos
>   y transacciones existentes**. El sistema te lo advierte: hazlo con cuidado.
> - Marca **Permitir Decimal** correctamente desde el inicio: define si el
>   producto se puede vender en fracciones.
> - Al crear un producto, en **Unidades Relacionadas** puedes habilitar sus
>   múltiplos (compra/venta en distintas unidades).

# Variaciones (productos variables)

## ¿Qué es / para qué sirve?

Una **variación** es una característica con varias opciones (ej. **Talla**: S, M,
L; o **Sabor**: Fresa, Chocolate). Un **producto variable** es el que se vende en
distintas variaciones, cada una con su propio SKU y precio.

Primero creas la **plantilla de variación** (reutilizable) y luego la usas al
crear el producto variable.

## Crear una plantilla de variación

1. Ve a **Productos → Variaciones → Agregar**.
2. Escribe el **Nombre de la Variación** (ej. "Talla").
3. Agrega los **Valores de Variación** (ej. S, M, L) con el botón **+**.
4. Guarda.

[CAPTURA: cuadro "Agregar Variación" con el nombre y la lista de valores]

## Usar variaciones en un producto

1. Al [crear un producto](crear-producto.md), elige **Tipo Producto = Variable**.
2. En **Agregar Variación**, presiona **+** y elige la **plantilla** (ej. "Talla").
3. Por cada valor (S, M, L) completa:
   - **SKU** (opcional), **Precio de Compra** (con/sin impuesto), **% Margen** y
     **Precio de Venta**.
   - (Opcional) imágenes de la variación.
4. Puedes agregar **más de una variación** (ej. Talla y Color) y guardar.

[CAPTURA: tabla de variaciones del producto con SKU, precios por valor]

## Notas y avisos

> - Las plantillas de variación se **reutilizan** en muchos productos: créalas una
>   vez.
> - Al **editar** un producto variable, el nombre de la variación no se cambia,
>   pero sí sus valores y precios.

PENDIENTE DE VERIFICAR: algunas etiquetas de la pantalla de producto variable
pueden aparecer en inglés ("Add Variation") según la versión.

# Precios

# Precios por grupo

## ¿Qué es / para qué sirve?

Un **grupo de precios** te deja tener listas de precio distintas para el mismo
producto (por ejemplo "Minorista" y "Mayorista"). Luego asignas un grupo a un
cliente o lo eliges en la venta.

## Paso a paso

1. Crea o edita un producto.
2. Usa el botón **Guardar y Agregar Precio por Grupo** (aparece si ya tienes
   grupos de precio configurados).
3. En la pantalla **Agregar Precios de Grupo de Precio de Venta**, escribe el
   precio del producto para cada grupo.
4. Guarda.

[CAPTURA: tabla de precios por grupo de un producto]

Para ver los precios por grupo de un producto, usa el icono **$** en el listado
de productos.

## Notas y avisos

> - Los grupos de precio se crean en **Productos → Grupos de precio de venta**;
>   si no tienes ninguno, primero créalos ahí.
> - En el POS, el grupo se aplica automáticamente si el cliente tiene uno
>   asignado, o puedes elegirlo (ver Manual del Cajero: *Cambiar el grupo de precios*).

# Inventario

# Cargar stock inicial (apertura)

## ¿Qué es / para qué sirve?

El **stock inicial (de apertura)** son las existencias con las que arranca un
producto en el sistema (lo que ya tienes en bodega al empezar a usarlo). Se carga
de dos formas: **producto por producto** o **en masa por archivo**.

## Opción A — Al crear/editar el producto

1. Al crear o editar el producto, usa el botón **Guardar y Agregar Stock de
   Apertura** (requiere que el producto tenga **¿Administrar Stock?** activado).
2. Se abre la pantalla **Añadir Stock de Apertura**, con una sección **por cada
   sucursal**.
3. Por cada producto/variación y sucursal, escribe:
   - **Cantidad**.
   - **Costo Unitario (antes de impuestos)**.
   - (Opcional, si aplica) **Fecha de Caducidad** y **Número de Lote**.
   - El **Subtotal** se calcula solo; usa **+** para agregar más lotes.
4. Presiona **Guardar**.

[CAPTURA: pantalla "Añadir Stock de Apertura" con cantidad, costo y subtotal por sucursal]

## Opción B — Importar stock inicial en masa

1. Ve a **Productos → Importar Stock Inicial**.
2. Presiona **Descargar Archivo de Plantilla** y complétala en Excel:
   - **SKU** (obligatorio).
   - **Ubicación** (opcional; si la dejas vacía, va a la primera sucursal).
   - **Cantidad** (obligatorio).
   - **Costo Unitario (antes de impuestos)** (obligatorio).
   - **Número de Lote** y **Fecha de Caducidad** (opcionales, si los usas).
3. Sube el archivo en **Archivo para Importar** y presiona **Enviar**.

[CAPTURA: pantalla "Importar Stock Inicial" con la plantilla y el botón Enviar]

## Notas y avisos

> - El stock inicial registra el **costo de compra**, por eso afecta el valor de
>   tu inventario.
> - Es distinto de **Importar inventario** (Ajuste de Stock), que solo corrige
>   cantidades sin precio — ver
>   [Importar inventario](../manual-compras-inventario/importar-inventario.md).
> - Para productos sin control de inventario, no aplica el stock de apertura.
> - **Número de lote** y **fecha de caducidad** solo aplican si tu negocio los
>   maneja; **en restaurante normalmente no se usan**, deja esos campos vacíos.