Catálogo e inventario (crear producto y ajuste de stock)

Audiencia: negocio

Objetivo

Crear o editar un producto en el panel, configurar opciones (p. ej. Talla y Color) y cargar existencias con Ajuste manual (por combinación cuando una opción controla stock), sin editar cantidades en la ficha.

Quién puede hacerlo

• Crear o editar el catálogo: permiso de productos.
• Ajuste manual, transferencias e historial: permisos de inventario (editar / ver según la acción). El plan debe incluir Control de inventario.

Antes de empezar

• Establecimiento con bodega (04 — Establecimientos). Cada establecimiento trae una bodega por defecto; podés crear más en Tu negocio → Bodegas (04 — Bodegas).
• Si el ítem se vende en la tienda: Sitio público — Comercio (fotos, peso/empaque, Visible).

Rutas

Pasos — Listado (/products)

1. Catálogo → Productos. Cada fila muestra la foto de catálogo (o iniciales si no hay imagen).
2. Pulsá el nombre o la miniatura para abrir la ficha de consulta (foto, PVP neto, código, costo, tipo, IVA, categoría, existencias y listas de precios). Si el producto controla stock por opción, la ficha también lista Existencias por opción: combinación, SKU, bodega, en mano y disponible. El total de la ficha suma todas las bodegas y el stock que no está asignado a una opción. Esta vista no edita el producto. En el celular, esa tabla se desplaza de lado.
3. El lápiz abre /products/{id}/edit. El basurero elimina (o oculta si hay historial).

Pasos — Crear producto (/products/new)

1. Catálogo → Productos → nuevo producto.
2. Completá identidad (nombre, código de ítem, tipo Bien/Servicio, categoría, foto de catálogo si aplica).
3. Venta y Compra (precios, IVA).
   • Listas de precios: filas Nombre + Precio neto (sin impuestos). Sirven para ofrecer en factura / NP / cotización un precio distinto al de catálogo (p. ej. «Al por mayor»). No cambian el PVP del producto.
4. Inventario (solo bienes):
   • Marcá Controlar inventario de este ítem si vas a llevar existencias.
   • Existencias iniciales y Bodega / sucursal cargan stock al guardar (producto nuevo sin opciones que controlen stock). Si alguna opción tiene Controla stock por valor, el campo se oculta: el stock se carga por combinación.
   • El botón Ajuste manual se ve deshabilitado hasta que guardes. El hover explica que sirve para stock por opción después de guardar.
5. Opciones (talla, color…) (bienes, hasta 2 opciones y 12 valores por opción):
   • Añadir opción → nombre (p. ej. Talla) y valores (p. ej. S (30-33), M (34-37)).
   • Controla stock por valor: marcalo solo si cada valor tiene su propio inventario (p. ej. tallas). Sin marcar, el valor elegido solo se anota en la descripción y el stock es el total del producto (p. ej. color de cordones).
   • Una foto por valor: solo una opción puede tenerlo (normalmente Color). Las fotos se cargan en Sitio web → Fotos por {opción}.
   • Si alguna opción controla stock aparece Combinaciones con stock (máximo 40; con 2 opciones que controlan stock son todas las combinaciones, p. ej. S / Rosa). Cada combinación tiene SKU (POS y descuento de inventario); si lo dejás vacío se genera solo ({código}-{VALOR}). No uses el código de ítem como SKU.
   • Las Existencias de cada combinación son solo lectura. Se cargan con Ajuste manual en Inventario después de guardar. Si el establecimiento tiene varias bodegas, cada fila muestra el saldo de esa bodega (no un solo número del establecimiento). La tabla se desplaza de lado en el celular.
   • Para pasar a controlar stock por una opción, el stock total del producto debe estar en 0 (ajustalo antes). Si desmarcás el control, los saldos de las combinaciones pasan al total del producto (bloqueado si hay unidades reservadas). No se puede quitar un valor con historial de stock.
   • Los productos que tenían Colores se migraron a una opción Color que controla stock y tiene foto por valor.
6. Sitio web si el producto es público (ver comercio o restaurante). En el listado, Ocultar de la web / Mostrar en la web cambia solo is_public: se conservan slug y SEO.
   • Productos sugeridos (solo al editar un producto ya guardado; no en paquetes turísticos): hasta 8 productos que la tienda ofrece junto a este en el carrito y el checkout. Buscá, pulsá +, ordená con ↑ / ↓ y pulsá Guardar sugerencias (se guarda aparte de Actualizar). Sin elegir, la tienda usa productos comprados juntos y de la misma categoría. Detalle en Comercio — Sugerencias y envío gratis.
7. Guardar. Quedás en /products/{id}/edit.

Los servicios no llevan inventario ni opciones de stock.

Pasos — Reglas de precio

Campañas con descuento o precio neto (p. ej. Black Friday). No se llaman «precios dinámicos».

1. Catálogo → Productos → Reglas de precio (/products/pricing-rules) → Nueva regla de precio.
2. Nombre de la campaña y Cliente: todos o uno.
3. Mostrar en la tienda en línea (solo con Todos los clientes; viene marcado): las reglas con cantidad mínima mayor a 1 se anuncian como Precio por mayor en la tienda (ficha del producto, tarjetas del listado y la página /por-mayor). Desmárcalo si no quieres anunciarlas; el descuento se sigue aplicando en el checkout. Las campañas de un cliente nunca se muestran ni se aplican en la tienda.
4. + Agregar regla de precio: aplicar sobre todos / una categoría / un producto, fechas, cantidad mínima, descuento % o precio neto, y si el descuento debe verse en la línea al facturar. El % y el precio van sin IVA (neto, igual que el PVP); el impuesto se calcula al vender. Si marcás mostrar como descuento, el % sigue siendo sobre el neto.
5. Guardar. El motor aplica la regla en factura, cotización, nota de pedido, POS (sin elegir lista de precios) y tienda pública. Si el producto tiene listas de precios, la regla se calcula sobre el precio elegido en la línea (en POS y tienda, sobre el PVP de catálogo). En la tienda, “mostrar como descuento de línea” se guarda en la NP y se copia a la factura al convertir (mismo total que el checkout).

Cómo se cuenta la cantidad mínima: por producto, sumando todas sus líneas (colores, tallas o notas distintas). Ejemplo: regla «Juguetería, mínimo 3, 20 %» → 2 muñecas rosadas + 1 azul = 3 unidades del mismo producto, las tres líneas llevan el 20 %. Tres juguetes distintos (1 de cada uno) no suman entre sí. Vale igual en factura, nota de pedido, cotización, POS, mostrador de restaurante y tienda: al cambiar la cantidad de una línea, las demás líneas del mismo producto se recalculan.

Escalones: si una campaña tiene varias reglas igual de específicas (p. ej. todos los productos: 3+ → 20 %, 12+ → 30 %), gana la de mayor cantidad mínima alcanzada. Una regla de un producto sigue ganando a una de categoría o todos, aunque la otra pida más unidades.

Pasos — Cargar o corregir stock (producto ya guardado)

1. Abrí la ficha /products/{id}/edit → Inventario.
2. Ajuste manual (habilitado) abre el modal Ajuste manual de inventario. También está en el menú Inventario del listado (/products).
3. Elegí sucursal. Si la sucursal tiene más de una bodega, aparece Bodega debajo: el ajuste va a la bodega elegida (por defecto, la bodega por defecto del establecimiento) y Existencias actuales muestra el saldo de esa bodega. Con una sola bodega no hay selector. Si alguna opción controla stock, Opción es obligatoria (elegí la combinación, p. ej. S / Rosa). Si ninguna opción controla stock no hay selector: el ajuste va al total del producto. Guardá el producto antes de ajustar si acabás de añadir un valor nuevo.
4. Cantidad: positivo = ingreso, negativo = salida. Notas opcionales.
5. Registrar ajuste. El modal se cierra; aparece Ajuste de inventario registrado. y se actualizan las existencias en la misma ficha (no te manda al historial).
6. Ver historial de movimientos (/products/inventory/movements?product_id=…) muestra la sucursal, cantidad y opción (combinación). Volver al producto regresa a la ficha.

La pantalla completa /products/inventory/adjust hace el mismo registro (con el mismo selector de Bodega) y vuelve a la ficha del producto con el mismo aviso.

Varias bodegas

Si algún establecimiento tiene más de una bodega activa (04 — Bodegas):

• Ficha del producto → Inventario: la tabla pasa de Existencias por establecimiento a Stock por bodega (columnas Establecimiento, Bodega, En mano, Disponible). Una bodega inactiva solo aparece mientras todavía tenga stock.
• Transferencia (/products/inventory/transfer): además de sucursal de origen / destino aparecen Bodega de origen y Bodega de destino. Podés transferir dentro del mismo establecimiento entre dos bodegas distintas. Si origen y destino son el mismo lugar (mismo establecimiento y misma bodega) aparece «El origen y el destino deben ser distintos (otro establecimiento u otra bodega).».
• Historial (/products/inventory/movements): filtro Todas las bodegas / una bodega junto al filtro de sucursal; la columna de sucursal muestra la bodega debajo.
• Bajo stock (/products/inventory/low-stock): mismo filtro por bodega; sin filtro, el umbral se compara con el total del establecimiento o del negocio.
• Documentos: factura, nota de pedido, POS y compras/recibidos descuentan o ingresan stock en la bodega elegida en el documento (selector Bodega). Una factura generada desde una nota de pedido usa la bodega de la nota. Las notas de crédito devuelven el stock a la bodega donde salió la venta original. Liquidaciones de compra usan la bodega por defecto. En compras (factura de compra, Registrar inventario, liquidación) de un producto con stock por opción hay que elegir la opción en cada línea: el stock entra en esa combinación.
• Bodega asignada al empleado (06): factura, nota de pedido y POS la usan (bloqueada para quien no puede cambiar de establecimiento). Ajuste y Transferencia (bodega de origen) solo la preseleccionan; se puede cambiar.

Con una sola bodega por establecimiento no ves ningún selector y todo funciona como antes.

Movimientos de receta (restaurante): si un plato tiene receta (Restaurante → Recetas), al enviarlo a cocina sus ingredientes salen del inventario con el motivo Consumo receta; si se anula mientras seguía Enviado, vuelven con Devolución receta. Si no alcanzaba el stock, la nota del movimiento indica el faltante (p. ej. «Faltante 0,5 kg»). Ver Sitio público — Restaurante.

Resultado esperado

• Producto creado o actualizado en /products/{id}/edit.
• Stock por sucursal (y por combinación) coherente con los ajustes; facturas, notas de pedido, POS y tienda descuentan la combinación elegida.
• Con varias bodegas, cada movimiento queda en la bodega del documento o del ajuste, visible en Stock por bodega e Historial.

Si algo falla

• No ves Ajuste manual o está gris → el producto aún no está guardado, es un servicio, o falta permiso / prestación de inventario.
• Ajuste manual gris con el aviso «Cambiaste las opciones que controlan stock…» → marcaste o desmarcaste Controla stock por valor, o agregaste / quitaste valores de esa opción, y todavía no guardaste. Pulsá Guardar y volvé a abrir el producto: el ajuste ya usa la nueva configuración (por combinación o solo el total). Al desmarcar, el stock de cada valor se suma al total del producto.
• «Elegí una opción» al registrar → el ítem controla stock por opción; el ajuste sin opción no suma a ninguna combinación.
• Ajustaste stock pero la combinación sigue en «—» → guardá el producto después de añadir el valor, luego usá Ajuste manual en Inventario y elegí la combinación en el modal.
• «Para controlar stock por opción, primero dejá en 0 el stock total del producto» al guardar → ajustá el total a 0 con Ajuste manual, marcá Controla stock por valor y cargá cada combinación.
• Factura o NP no emite / stock 0 con existencias a la vista → el disponible es el de esa opción en la bodega del documento, no el total de la familia. Si el mensaje nombra otra bodega, elegí esa bodega o transferí el stock. Si dice que hay unidades sin opción (suele pasar con compras registradas antes de elegir opción en la línea), esas no se venden en la línea de color: en Ajuste manual, misma bodega, restalas con Sin opción (legado / corregir) y sumalas en la combinación correcta. Ver 07 — Factura y 16 — Nota de pedido.
• Importar cantidades masivas → 23 — Importar / exportar.
• ¿Qué pasa al Eliminar un producto en Catálogo? Si el producto tiene historial de stock, aparece en facturas, notas, guías, liquidaciones, cotizaciones, notas de pedido o recibidos, o está en una receta (plato o ingrediente), queda eliminado (oculto): desaparece del catálogo, buscadores, Mesas, recetas y la tienda en línea, pero los documentos, las recetas que lo referencian y el historial de inventario lo siguen mostrando. Los borradores que ya lo tenían se pueden emitir. Su código queda libre: podés crear o importar un producto nuevo con el mismo código. Un producto sin historial ni recetas se borra por completo.

Relacionados

• 07 — Emitir factura
• 16 — Nota de pedido
• 22 — POS
• 23 — Importar / exportar catálogo
• 27 — Directorio de contactos
• Sitio público — Comercio
• Sitio público — Restaurante (recetas)

Última revisión: 2026-10-31

Si este flujo cambia en el producto, actualizá esta página.