Productos

Para qué sirve

El catálogo de productos es la lista única de todo lo que vende tu empresa: combustibles (Diésel B5, Gasohol 90, Gasohol 95…), GLP vehicular, GNV, balones de gas, productos de market, lubricantes y servicios. El catálogo es de la empresa (todas las estaciones comparten los mismos productos); lo que cambia por estación es el precio, que se gestiona en Precios.

Del producto dependen el tanque que lo almacena, la manguera que lo despacha, la unidad que va al comprobante electrónico y el color con el que se pinta en el POS y en los gráficos.

Dónde está

Menú:Configuración›Productos/productos

Quién puede

• Ver el catálogo: Permisoproductos.ver
• Crear productos, duplicar, importar, descargar la plantilla y restaurar eliminados: Permisoproductos.crear
• Editar (incluido activar/desactivar): Permisoproductos.editar
• Eliminar: Permisoproductos.eliminar

Las Categorías usan los mismos permisos.

Conceptos

• Tipo: define las reglas del producto (unidad, percepción, stock, código de barras…). Lee Tipos de producto y sus reglas antes de crear productos.
• Nombre corto (POS): el texto de hasta 12 caracteres que aparece en los botones del POS, en las mangueras del mapa de playa y en los tickets. Ejemplos: DB5, G90, G95, GLP.
• Código interno: tu código propio del producto, único en la empresa. Si lo dejas vacío al crear, el sistema asigna el siguiente libre según el tipo (CMB-0001, GLP-0001, GNV-0001, MKT-0001, LUB-0001, BAL-0001; servicios PRD-0001).
• Código de barras: el EAN que viene impreso en el producto (solo market, lubricantes y balones). Si el producto no tiene uno, el sistema puede generarte un código de barras interno.
• Afectación IGV: Gravado (10), Exonerado (20) o Inafecto (30), según el catálogo de SUNAT. Lo normal en un grifo es Gravado (10).
• Precio vigente: la columna de la tabla muestra el precio actual del producto en tu estación activa. Es solo lectura aquí: se cambia en Precios.

Paso a paso

Crear un producto

1. Entra a Productos
   Menú Configuración › Productos. Pulsa Nuevo producto.
2. Elige el tipo
   En Tipo elige, por ejemplo, Combustible líquido. El formulario se ajusta: pone la unidad por defecto, marca o bloquea los interruptores según el tipo y sugiere un color.
3. Escribe nombre y nombre corto
   Por ejemplo Nombre Diésel B5 S-50 y Nombre corto (POS) DB5 (se convierte a mayúsculas).
4. Código interno (opcional)
   Déjalo vacío para que se asigne solo, o pulsa Sugerir código interno para ver cuál tocaría y editarlo.
5. Revisa medida y SUNAT
   Confirma Unidad, Afectación IGV y, si lo tienes, el Código de producto SUNAT.
6. Revisa el comportamiento
   Revisa Sujeto a percepción, Placa obligatoria en factura y Controla stock. Los que estén bloqueados muestran debajo el motivo.
7. Elige un color
   Pulsa un color de la paleta (Color en POS y gráficos) o escribe uno en formato #RRGGBB.
8. Pulsa «Crear producto»
   Verás Producto creado.

Crear un producto de market con código de barras

1. Elige el tipo Market
   Aparecen el campo Código de barras y los botones de ayuda.
2. Lee el código
   Tienes tres opciones: escribirlo, usar un lector de código de barras USB (escribe solo en el campo), o pulsar Escanear código de barras para usar la cámara del equipo (apunta al código; pulsa Cerrar cámara para salir). El botón de cámara solo aparece si el equipo tiene cámara disponible.
3. Si el producto no tiene código
   Pulsa Generar código de barras interno: el sistema propone un EAN-13 de uso interno que empieza por 200 (por ejemplo 2000000000015), que no choca con códigos de fábrica.
4. Atento al aviso de duplicado
   Si ese código ya pertenece a otro producto activo, verás El código 7750182000123 ya existe: Agua San Luis 625 ml. con el botón Abrir ese producto para ir a editarlo en lugar de duplicarlo.

Editar un producto

En la fila, pulsa Editar, cambia lo necesario y pulsa Guardar cambios (verás Producto actualizado.). Al editar, el Código interno es obligatorio.

:::warning Atención Si el producto ya está en uso (tiene tanques, mangueras, precios vigentes o programados, o ítems de venta), no puedes cambiarle el tipo ni la unidad. El sistema te dirá en qué está usado, por ejemplo: No se puede cambiar el tipo o la unidad de el producto: está en uso (2 tanque(s), 4 manguera(s), 1 precio(s)). :::

Duplicar un producto

Útil para cargar variantes (por ejemplo, la misma gaseosa en otro tamaño). Pulsa Duplicar en la fila: se abre Nuevo producto con todos los datos copiados excepto el código interno, el código de barras y el precio. Ajusta el nombre y pulsa Crear producto.

Desactivar un producto

Edita el producto y apaga Activo. Un producto inactivo deja de ofrecerse para vender y para configurar tanques o mangueras.

• No puedes desactivarlo mientras tenga uso operativo: tanques activos, mangueras o precios vigentes/programados. Mensaje: No se puede desactivar el producto: está en uso (…). Retira primero sus mangueras, tanques y precios.
• El historial de ventas no impide desactivarlo.
• Reactivar un producto de un tipo que requiere módulo (market, GNV) vuelve a comprobar que tu plan lo incluya.

Eliminar un producto

1. Pulsa «Eliminar»
   Se abre Eliminar producto: Se eliminará el producto "…". Si está en uso (tanques, mangueras, precios o ventas) el sistema lo impedirá: en ese caso desactívalo. ¿Continuar?
2. Confirma
   Pulsa Eliminar. Si se pudo, verás Producto eliminado.

Un producto que ya se vendió alguna vez no se puede eliminar: No se puede eliminar el producto: está en uso (15 ítem(s) de venta). Desactívalo en su lugar tras retirar sus precios y mangueras.

Restaurar un producto eliminado

Crea un producto nuevo con el mismo código interno del eliminado. El sistema pregunta (diálogo Registro dado de baja): Existe un producto eliminado con el código CMB-0001. ¿Quieres restaurarlo con su historial? Pulsa Restaurar: vuelve el producto original con todo su historial (verás Registro restaurado.).

Descargar el QR de un producto

Pulsa Descargar QR en la fila: se descarga una imagen PNG con un código QR que contiene el código de barras del producto (o, si no tiene, su código interno). Úsalo para góndolas o inventarios.

Imprimir etiquetas de góndola

Marca las casillas de los productos (puedes cambiar de página y seguir marcando) y pulsa Imprimir etiquetas. Detalle en Importar productos y etiquetas.

Campos

Identificación

Campo	¿Obligatorio?	Descripción
TipoLista	Sí	Uno de los 7 tipos. Al cambiarlo se recalculan unidad, interruptores y color sugerido.
CategoríaLista	No	Agrupación libre (Bebidas, Snacks, Lubricantes…). "Sin categoría" si no aplica.
NombreTexto	Sí	Hasta 100 caracteres. Ej.: Gasohol 95 Plus.
Nombre corto (POS)Texto	Sí	Hasta 12 caracteres, en mayúsculas. Ej.: G95.
Código internoTexto	No	Hasta 30 caracteres, en mayúsculas, único entre productos activos. Opcional al crear (se asigna solo); obligatorio al editar.
Código de barrasTexto	No	Hasta 30 caracteres, único entre productos activos. Solo aparece en tipos que lo admiten.

Medida y SUNAT

Campo	¿Obligatorio?	Descripción
UnidadLista	Sí	Galones (GAL), Metros cúbicos (M3), Unidades (UND), Kilogramos (KG) o Litros (LT). Solo se aceptan las del tipo: si eliges otra verás "Unidades permitidas: …".
Peso del balónLista	No	10 kg o 45 kg. Solo para Balón de GLP (obligatorio en ese tipo).
Densidad (kg/L)Número	No	Solo si la unidad es GAL. Hasta 4 decimales, mayor que 0 y hasta 2. Sirve para sugerir el peso bruto en las guías de remisión.
Peso bruto unitario (kg)Número	No	Solo si la unidad es UND. Mayor que 0, hasta 3 decimales (por ejemplo, un balón de 10 kg lleno ≈ 23.5 kg con envase). Para las guías de remisión.
Afectación IGVLista	No	Gravado (10), Exonerado (20) o Inafecto (30). Por defecto Gravado.
Código de producto SUNATTexto	No	Hasta 20 caracteres. Código del catálogo de productos de SUNAT; aparece también en los datos del reporte de precios a Osinergmin.

Comportamiento

Campo	¿Obligatorio?	Descripción
Sujeto a percepciónInterruptor	No	Solo editable en combustible líquido.
Placa obligatoria en facturaInterruptor	No	Si está activo, la factura de este producto exige placa.
Controla stockInterruptor	No	Según el tipo puede estar fijo.
Stock mínimoNúmero	No	Visible si controla stock. Número mayor o igual a 0, hasta 3 decimales.
Color (hex)Texto	No	Formato #RRGGBB, por ejemplo #1E88E5. También se elige con la paleta de arriba.
ActivoInterruptor	No	Apagado = inactivo.

Columnas y filtros de la tabla

Columna	Qué muestra
(casilla)	Selección para imprimir etiquetas.
Producto	Punto de color, nombre y nombre corto.
Código	Código interno y, debajo, código de barras.
Tipo	Tipo de producto.
Unidad	Unidad y, entre paréntesis, la unidad SUNAT.
Categoría	Nombre de la categoría o "—".
Precio vigente	Precio actual en la estación activa, por ejemplo S/ 16.4900, o "—" si no tiene.
Estado	Activo o Inactivo.

Filtros sobre la tabla: Todos los tipos, Todas las categorías y Todos / Activos / Inactivos. El buscador encuentra por nombre, nombre corto, código interno o código de barras.

Acciones por fila: Duplicar, Descargar QR, Editar y Eliminar (cada una visible según tus permisos). Arriba: Categorías, Plantilla, Importar y Nuevo producto.

Estados y reglas

• Los valores fijos del tipo no se pueden contradecir: el sistema rechaza el cambio, no lo corrige en silencio.
• La unidad SUNAT siempre la calcula el sistema.
• Códigos interno y de barras únicos entre productos activos.

Mensajes de error frecuentes y qué hacer

Mensaje	Por qué pasa	Qué hacer
"Ya existe un producto con ese código interno."	Otro producto activo lo usa.	Usa Sugerir código interno o cambia el código.
"Ya existe un producto con ese código de barras."	El EAN ya está cargado en otro producto.	Pulsa Abrir ese producto en el aviso y edita el existente.
"Unidad no permitida para market (permitidas: UND, KG, LT)."	La unidad no corresponde al tipo.	Elige una de las permitidas.
"El balón de GLP debe pesar 10 o 45 kg."	Falta el peso o no es 10/45.	Elige el Peso del balón.
"El nombre corto admite como máximo 12 caracteres."	Nombre corto muy largo.	Acórtalo: GASOHOL95 → G95.
"El color debe ser hexadecimal #RRGGBB."	Color mal escrito.	Usa la paleta o escribe por ejemplo #43A047.
"Tu plan no incluye el módulo «market» necesario para este tipo de producto. Mejora tu plan para habilitarlo."	El tipo requiere un módulo que tu plan no tiene.	Mejora tu plan o usa otro tipo.
"No se puede eliminar el producto: está en uso (…)"	Tiene tanques, mangueras, precios o ventas.	Desactívalo en su lugar (retirando antes mangueras, tanques y precios).
"Categoría no encontrada."	La categoría fue eliminada mientras editabas.	Recarga la página y elige otra categoría.

Relación con otros módulos

• Tipos de producto y sus reglas · Categorías · Importar productos y etiquetas
• Tanques: solo aceptan combustible líquido y GLP vehicular activos.
• Surtidores y mangueras: cada manguera despacha un producto.
• Precios: el precio por estación.
• El market y el POS usan este catálogo: ver POS de market y Configuración.

Ejemplo

Catálogo inicial típico de un grifo en Lima:

Nombre	Nombre corto	Tipo	Unidad	Código interno
Diésel B5 S-50	DB5	Combustible líquido	GAL	CMB-0001
Gasohol 90	G90	Combustible líquido	GAL	CMB-0002
Gasohol 95	G95	Combustible líquido	GAL	CMB-0003
GLP vehicular	GLP	GLP vehicular	GAL	GLP-0001
Balón de gas 10 kg	BAL10	Balón de GLP	UND	BAL-0001
Aceite 20W-50 1/4 gal	ACE2050	Lubricante	UND	LUB-0001

Con un precio vigente de S/ 16.49 por galón, la columna Precio vigente del Diésel B5 muestra S/ 16.4900 en la estación activa.