Compujuy | Yagware Docs

📦 Manual de Usuario — Carga de Productos

Sistema: Yagware
Módulo: Productos
Versión: 1.0
Fecha: Abril 2026


Índice

  1. ¿Qué es un producto en el sistema?
  2. Cómo acceder al formulario de producto
  3. Sección: Datos básicos
  4. Sección: Presentaciones
  5. Sección: Imagen del producto
  6. Sección: Descripción
  7. Guardar el producto
  8. Ejemplos completos por tipo de negocio
  9. Preguntas frecuentes

1. ¿Qué es un producto en el sistema?

Un producto es cualquier artículo o servicio que se vende en el negocio. Cada producto tiene:

  • Un nombre único que lo identifica
  • Una categoría (familia) para organizarlo
  • Una o más presentaciones con sus respectivos precios y códigos de barra
  • Opcionalmente una imagen y una descripción adicional

💡 Ejemplo: “Coca Cola” es el producto. “Botella 500ml”, “Lata 354ml” y “Botella 2,25L” son sus presentaciones, cada una con su propio precio y código de barra.


2. Cómo acceder al formulario de producto

  1. En el menú lateral, ir a Productos
  2. Hacer clic en Nuevo producto (botón con ícono ➕)
  3. Se abre el formulario de carga

Para editar un producto existente:

  1. Ir a Productos → Listado
  2. Buscar el producto por nombre o código de barra
  3. Hacer clic en el ícono ✏️ de edición

3. Sección: Datos básicos

Esta sección contiene la información principal del producto.

┌─ Datos básicos ─────────────────────────────────────────────────┐
│                                                                   │
│  Nombre del producto  │  Categoría (familia)  │  Marca           │
│  ──────────────────   │  ──────────────────   │  ──────────────  │
│  [               ]    │  [    Seleccionar ▼]  │  [Seleccionar ▼] │
│                                                                   │
│  Unidad de venta      │  Contenido por unidad                    │
│  ──────────────────   │  ─────────────────                       │
│  [    Seleccionar ▼]  │  [        ]                              │
│                                                                   │
└───────────────────────────────────────────────────────────────────┘

Campos explicados

CampoDescripciónObligatorioEjemplo
Nombre del productoNombre principal del artículo✅ SíCoca Cola, Martillo de carpintero
Categoría (familia)Grupo al que pertenece el producto✅ SíBebidas, Herramientas, Calzado
MarcaMarca del producto✅ SíCoca Cola, Stanley, Adidas
Unidad de ventaUnidad con la que se mide el producto base⬜ OpcionalUnidad, Kilogramo, Litro, Metro
Contenido por unidadCantidad de unidad base que tiene cada unidad de venta⬜ Opcional500 (ml), 1 (kg), 1 (unidad)

Configuración avanzada (engranaje ⚙️)

Al hacer clic en el ícono de engranaje junto a “Datos básicos” se abre el panel de configuración avanzada:

OpciónDescripción
Control de stockDefine si el stock se controla por producto completo o por variante (talle, color). Para zapatek → seleccionar “Por variante”

4. Sección: Presentaciones

Las presentaciones son las distintas formas en que se vende un producto. Todo producto tiene al menos una presentación.

┌─ Presentaciones ──────────────────────────────────────────────────────────────┐
│  Nombre       │ Cant. base │ Precio costo │ Precio venta │ Cod. barra │       │
│ ─────────────────────────────────────────────────────────────────────────     │
│  [Unidad    ] │  [  1,00 ] │  [$ 200,00 ] │  [$ 350,00 ] │ [779000..] │ ➕ ➖ │
│  [Caja x 12 ] │  [ 12,00 ] │  [$ 200,00 ] │  [$ 300,00 ] │ [779001..] │    ➖ │
└───────────────────────────────────────────────────────────────────────────────┘

Campos de cada presentación

CampoDescripciónObligatorioEjemplo
NombreCómo se llama esta presentación✅ SíUnidad, Caja x 12, 1 kg, Par
Cantidad baseCuántas unidades base contiene✅ Sí1, 12, 6, 0.5
Precio costoPrecio al que se compra al proveedor✅ Sí$ 200,00
Precio ventaPrecio al que se vende al cliente✅ Sí$ 350,00
Código de barraCódigo del producto (EAN-13, etc.)⬜ Opcional7790001234567

Cómo agregar más presentaciones

  • Hacer clic en (botón verde) al final de la última fila
  • Se agrega una nueva fila para completar
  • Para eliminar una presentación, hacer clic en (botón rojo) — la primera presentación no puede eliminarse

Presentaciones y variantes (talle/color)

Si el negocio vende productos con variantes (ej: zapatería con talles y colores), cada variante es una presentación separada. Al expandir la fila (▶) se pueden cargar los atributos de esa variante (ej: Talle 38, Color Negro).

⚠️ Prerrequisito: Para usar variantes se necesita:

  1. Tener configurados los Atributos de variante (Talle, Color, etc.) en Configuración → Atributos de variante — ver Manual de Configuración de Atributos de Variante
  2. Habilitar “Control de stock por variante” en la configuración avanzada del producto (ícono ⚙️)

Si no hay atributos configurados, el sistema mostrará el mensaje “No hay atributos configurados” al expandir la fila.


5. Sección: Imagen del producto

Permite agregar una o más fotos del producto.

  • Hacer clic en el área de imagen o arrastrar y soltar una foto
  • Formatos aceptados: JPG, PNG, WEBP
  • Tamaño recomendado: mínimo 300x300 píxeles

💡 La imagen es opcional pero ayuda a identificar el producto al momento de la venta.


6. Sección: Descripción

Campo de texto libre para agregar información adicional del producto:

  • Materiales
  • Instrucciones de uso
  • Observaciones internas
  • Características técnicas

Opcional. No aparece en el comprobante de venta, es solo para uso interno.


7. Guardar el producto

Una vez completados los campos obligatorios:

  1. Hacer clic en el botón 💾 Guardar
  2. El sistema valida los datos
  3. Si hay errores, se muestran en rojo debajo de cada campo
  4. Si todo es correcto, aparece un mensaje de confirmación ✅

Para limpiar el formulario sin guardar, hacer clic en 🔄 Limpiar.


8. Ejemplos completos por tipo de negocio


8.1 Kiosco

Los kioscos manejan productos de venta unitaria con código de barra, generalmente con presentación única o por caja.


Ejemplo 1: Alfajor Havanna

CampoValor
NombreAlfajor Havanna Chocolate
CategoríaGolosinas / Alfajores
MarcaHavanna
Unidad de ventaUnidad
Contenido por unidad1

Presentaciones:

NombreCant. basePrecio costoPrecio ventaCódigo barra
Unidad1$ 350,00$ 550,007790001000012
Caja x 1212$ 320,00$ 500,007790001000029

Ejemplo 2: Gaseosa Coca Cola

CampoValor
NombreCoca Cola
CategoríaBebidas / Gaseosas
MarcaCoca Cola
Unidad de ventaUnidad
Contenido por unidad1

Presentaciones:

NombreCant. basePrecio costoPrecio ventaCódigo barra
Lata 354ml1$ 250,00$ 400,007790001100010
Botella 500ml1$ 300,00$ 500,007790001100027
Botella 1,5L1$ 500,00$ 850,007790001100034
Botella 2,25L1$ 650,00$ 1.100,007790001100041

Ejemplo 3: Chicles Beldent

CampoValor
NombreChicles Beldent Menta
CategoríaGolosinas / Chicles
MarcaBeldent
Unidad de ventaUnidad

Presentaciones:

NombreCant. basePrecio costoPrecio ventaCódigo barra
Blister1$ 80,00$ 150,007790002000011
Display x 2020$ 70,00$ 130,007790002000028

Ejemplo 4: Tarjeta SUBE (sin precio de costo)

CampoValor
NombreTarjeta SUBE
CategoríaServicios
MarcaSUBE
Unidad de ventaUnidad

Presentaciones:

NombreCant. basePrecio costoPrecio ventaCódigo barra
Unidad1$ 0,00$ 600,00

8.2 Verdulería

Las verdulerías trabajan principalmente con productos por peso (kilogramo) y algunos productos por unidad. El precio cambia según el mercado, por lo que se actualiza frecuentemente.

💡 Clave: seleccionar Kilogramo como unidad de venta para que en la venta se pueda ingresar el peso exacto.


Ejemplo 1: Papa

CampoValor
NombrePapa
CategoríaVerduras / Tubérculos
MarcaSin marca
Unidad de ventaKilogramo
Contenido por unidad1

Presentaciones:

NombreCant. basePrecio costoPrecio ventaCódigo barra
1 kg1$ 400,00$ 700,00
Bolsa 5 kg5$ 380,00$ 650,00

Ejemplo 2: Tomate

CampoValor
NombreTomate Redondo
CategoríaVerduras / Frutas de temporada
MarcaSin marca
Unidad de ventaKilogramo

Presentaciones:

NombreCant. basePrecio costoPrecio venta
1 kg1$ 500,00$ 900,00

Ejemplo 3: Banana

CampoValor
NombreBanana
CategoríaFrutas / Tropicales
MarcaSin marca
Unidad de ventaKilogramo

Presentaciones:

NombreCant. basePrecio costoPrecio venta
1 kg1$ 600,00$ 1.000,00
Docena1$ 400,00$ 700,00

Ejemplo 4: Lechuga

CampoValor
NombreLechuga Capuchina
CategoríaVerduras / Hoja
MarcaSin marca
Unidad de ventaUnidad

Presentaciones:

NombreCant. basePrecio costoPrecio venta
Unidad1$ 250,00$ 450,00

Ejemplo 5: Zapallo Anco

CampoValor
NombreZapallo Anco
CategoríaVerduras / Calabazas
MarcaSin marca
Unidad de ventaKilogramo

Presentaciones:

NombreCant. basePrecio costoPrecio venta
1 kg1$ 350,00$ 600,00
Mitad1$ 350,00$ 600,00
Entero1$ 300,00$ 550,00

8.3 Ferretería

Las ferreterías manejan gran variedad de productos, incluyendo artículos que se venden por metro, por unidad o por caja. Es importante organizar bien las categorías (familias).

💡 Si la ferretería vende productos con variantes de medida, material o color (ej: caños, perfiles, pinturas por color), se puede usar el sistema de variantes. En ese caso, configurar primero los atributos en Configuración → Atributos de variante — ver Manual de Configuración de Atributos.


Ejemplo 1: Martillo

CampoValor
NombreMartillo de carpintero 500g
CategoríaHerramientas / Percusión
MarcaStanley
Unidad de ventaUnidad

Presentaciones:

NombreCant. basePrecio costoPrecio ventaCódigo barra
Unidad1$ 3.500,00$ 5.800,007791234560011

Ejemplo 2: Tornillo cabeza phillips

CampoValor
NombreTornillo Cabeza Phillips 3.5 x 25mm
CategoríaFijaciones / Tornillos
MarcaGenérico
Unidad de ventaUnidad

Presentaciones:

NombreCant. basePrecio costoPrecio ventaCódigo barra
Unidad1$ 15,00$ 30,00
Bolsa x 2525$ 12,00$ 25,007791234560028
Caja x 200200$ 10,00$ 20,007791234560035

Ejemplo 3: Cable eléctrico

CampoValor
NombreCable Unipolar 2.5mm Normalizado
CategoríaElectricidad / Cables
MarcaPrysmian
Unidad de ventaMetro
Contenido por unidad1

Presentaciones:

NombreCant. basePrecio costoPrecio ventaCódigo barra
1 metro1$ 280,00$ 480,00
Rollo 100m100$ 260,00$ 450,007791234560042

💡 Al vender por metro, en la pantalla de venta se ingresa la cantidad exacta (ej: 3.5 metros).


Ejemplo 4: Pintura látex

CampoValor
NombrePintura Látex Interior Blanco
CategoríaPintura / Látex
MarcaAlba
Unidad de ventaUnidad

Presentaciones:

NombreCant. basePrecio costoPrecio ventaCódigo barra
Cuarto (1L)1$ 1.800,00$ 3.000,007791234560059
Medio (2L)1$ 3.200,00$ 5.500,007791234560066
Galón (4L)1$ 5.800,00$ 9.500,007791234560073

Ejemplo 5: Cinta métrica

CampoValor
NombreCinta Métrica 5 metros
CategoríaHerramientas / Medición
MarcaStanley
Unidad de ventaUnidad

Presentaciones:

NombreCant. basePrecio costoPrecio ventaCódigo barra
Unidad1$ 1.200,00$ 2.100,007791234560080

8.4 Zapatería

Las zapaterías manejan productos con variantes de talle y color. Cada combinación (ej: talle 38 negro, talle 39 marrón) es una presentación diferente con su propio stock y código de barra.


⚠️ Configuración previa obligatoria

Antes de cargar calzado con variantes, se deben completar dos pasos previos:

Paso 1 — Configurar los atributos de variante

Ir a Configuración → Atributos de variante y crear los atributos necesarios:

AtributoModoValores sugeridos
TalleOpciones predefinidas35, 36, 37, 38, 39, 40, 41, 42, 43, 44
ColorOpciones predefinidasNegro, Blanco, Marrón, Azul, Rojo, Verde

Ver instrucciones completas en: Manual de Configuración de Atributos de Variante

Paso 2 — Activar control de stock por variante en el producto

Al crear el producto, hacer clic en el ícono ⚙️ junto a “Datos básicos” y seleccionar “Control de stock: Por variante”.

Una vez completados estos pasos, al expandir (▶) cada fila de presentación aparecerán los selectores de Talle y Color.


Ejemplo 1: Zapatilla deportiva

CampoValor
NombreZapatilla Running Air Max
CategoríaCalzado / Deportivo
MarcaNike
Unidad de ventaPar
Control de stockPor variante

Presentaciones (una por cada talle y color):

NombreCant. basePrecio costoPrecio ventaCódigo barraTalleColor
Talle 38 Blanco1$ 15.000,00$ 25.000,00779000038001138Blanco
Talle 39 Blanco1$ 15.000,00$ 25.000,00779000039001139Blanco
Talle 40 Blanco1$ 15.000,00$ 25.000,00779000040001140Blanco
Talle 38 Negro1$ 15.000,00$ 25.000,00779000038002238Negro
Talle 39 Negro1$ 15.000,00$ 25.000,00779000039002239Negro
Talle 40 Negro1$ 15.000,00$ 25.000,00779000040002240Negro

💡 Para agregar cada fila hacer clic en ➕. Al desplegar la fila (▶) seleccionar el Talle y el Color correspondiente.


Ejemplo 2: Bota de cuero

CampoValor
NombreBota Cuero Texana
CategoríaCalzado / Botas
MarcaRingo
Unidad de ventaPar
Control de stockPor variante

Presentaciones:

NombreCant. basePrecio costoPrecio ventaCódigo barraTalleColor
Talle 37 Marrón1$ 18.000,00$ 32.000,00779000137001137Marrón
Talle 38 Marrón1$ 18.000,00$ 32.000,00779000138001138Marrón
Talle 39 Negro1$ 18.000,00$ 32.000,00779000139002239Negro
Talle 40 Negro1$ 18.000,00$ 32.000,00779000140002240Negro

Ejemplo 3: Ojotas

CampoValor
NombreOjotas Playa
CategoríaCalzado / Sandalias
MarcaHavaianas
Unidad de ventaPar

Presentaciones (sin variantes si solo hay un color):

NombreCant. basePrecio costoPrecio ventaCódigo barra
Talle 35/361$ 3.000,00$ 5.500,007790002350011
Talle 37/381$ 3.000,00$ 5.500,007790002370011
Talle 39/401$ 3.000,00$ 5.500,007790002390011
Talle 41/421$ 3.200,00$ 5.800,007790002410011

Ejemplo 4: Zapatilla infantil

CampoValor
NombreZapatilla Infantil Velcro
CategoríaCalzado / Infantil
MarcaBublegummers
Unidad de ventaPar
Control de stockPor variante

Presentaciones:

NombreCant. basePrecio costoPrecio ventaTalleColor
Talle 20 Azul1$ 5.000,00$ 9.000,0020Azul
Talle 22 Azul1$ 5.000,00$ 9.000,0022Azul
Talle 24 Rosa1$ 5.000,00$ 9.000,0024Rosa
Talle 26 Rosa1$ 5.000,00$ 9.000,0026Rosa

9. Preguntas frecuentes

¿Puedo cargar un producto sin código de barra?
Sí. El código de barra es opcional. El producto se puede buscar por nombre al momento de la venta.

¿Qué pasa si el precio cambia?
Se puede editar el producto en cualquier momento desde Productos → Listado → ✏️ Editar. Solo hay que modificar el precio de venta en la presentación correspondiente y guardar.

¿Puedo tener el mismo producto en diferentes precios para diferentes clientes?
Sí, a través de las Listas de precios (menú Configuración). Se puede asignar una lista de precios por cliente o por tipo de cliente.

¿Cuántas presentaciones puede tener un producto?
No hay límite. Se pueden agregar tantas presentaciones como sean necesarias (unidad, docena, caja, medio kilo, etc.).

¿Qué es la “cantidad base”?
Es la cantidad de unidades mínimas que contiene esa presentación. Por ejemplo, si la unidad de venta es “Kilogramo” y la presentación es “Bolsa 5kg”, la cantidad base es 5.

¿Puedo desactivar un producto sin eliminarlo?
Sí. En la configuración avanzada del producto existe un campo “Activo”. Al desactivarlo, el producto no aparece en la búsqueda de ventas pero se conserva el historial.

¿Cómo cargo productos de verdulería que varían de precio todos los días?
Cargar el producto normalmente y actualizar el precio de venta cuando cambie. También se puede usar la función de actualización masiva de precios desde el listado de productos.


Manual generado para el sistema Yagware — Módulo de Productos