Editar producto (fichas, niveles y control de stock)

Formulario para crear o editar un producto dentro de la estructura de niveles (familia, grupo, categoría, producto). Permite definir tipo de cuenta, códigos, unidad de medida, disponibilidad, control de inventario y cuentas contables; además administra lotes y vencimientos, listas de precios, proveedores, parámetros para comercio electrónico y herramientas de cálculo de stock mínimo según ventas históricas y tiempo de reposición.

📘 Propósito

El formulario Editar producto se abre desde Administrar productos y sirve para crear o modificar un ítem de inventario dentro de la estructura de categorías configurada para la empresa (familia > grupo > categoría > producto).

Aquí se definen todas las características principales del producto: clasificación, códigos, unidad de medida, disponibilidad para venta, control de inventario, lotes, precios, proveedores, datos para comercio electrónico y parámetros para calcular stock mínimo.

🏗️ Niveles y categoría superior

La estructura de niveles se toma de la configuración de la empresa (formulario Empresas > Categorías de productos): puede tener de 1 a 4 niveles.
- 1 nivel: Producto.
- 2 niveles: Categoría > Producto.
- 3 niveles: Grupo > Categoría > Producto.
- 4 niveles: Familia > Grupo > Categoría > Producto.
Categoría superior:
- Es el padre del ítem actual (familia, grupo o categoría).
- Al elegirla, el sistema calcula automáticamente el Nivel siguiente y sugiere si el producto será Movimiento (último nivel) o Grupo (nivel intermedio).
- También hereda valores por defecto de la categoría superior: tipo (materia prima / mercadería / fabricado), unidad de medida, control de inventario, moneda, tipo de producto, cuentas contables, disponibilidad, etc.
Una vez existen movimientos de inventario, la configuración de niveles de la empresa ya no debe cambiarse, para no romper la estructura de códigos y categorías.

🧾 Ficha Detalles

Campo	Descripción
Categoría superior	Nodo padre del producto. Determina el nivel y ayuda a generar el código. Puede ocultarse cuando la empresa está configurada con 1 solo nivel.
Tipo de cuenta	Grupo o Movimiento. Los grupos sirven como categorías, los movimientos son productos que se compran/venden y generan asientos contables.
Nivel	Muestra si el registro es Familia, Grupo, Categoría o Producto, según la configuración (`NivCatPro`). El producto final siempre es nivel 4.
Clasificación	Casillas de selección: Materia prima Compra-venta (mercadería) Fabricado (producto elaborado) eCommerce: disponible para publicación web. Afiliado: productos vendidos por afiliados. Destajo: habilita parámetros adicionales de pago por destajo. Al menos una de las opciones principales (materia prima, mercadería o fabricado) es obligatoria.
Código	Código interno generado automáticamente según la categoría superior y la cantidad de dígitos configurada por nivel. El sistema evita duplicados y busca el siguiente número disponible dentro del grupo.
Código b	Código del fabricante o código interno alternativo. En ventas, compras e inventario se mostrará este código; si está vacío se usará el Código principal.
Descripción	Nombre descriptivo del producto. Es obligatorio.
Notificar antes del vencimiento	Días de anticipación para considerar la fecha de vencimiento de lotes en reportes y alertas.
Unidad de medida	UMedida (unidad, caja, vial, etc.). Puede crearse una nueva unidad al escribirla y aceptar cuando el sistema pregunte si desea agregarla.
Disponibilidad	Venta: el artículo aparece en los documentos de ventas. Privado: solo para uso interno (no se ofrece en la lista de ventas).
Control de inventario	Si está marcado, las ventas, compras, entradas y salidas afectan el stock del producto y se validan los saldos. Si está desmarcado, el sistema permite vender sin controlar existencias.
Cuentas contables	Compra, Costo y Venta: cuentas del plan contable para los asientos automáticos (inventario, costo de ventas e ingresos). El botón Actualizar plan de cuentas refresca la lista desde la base contable.

Antes de guardar, el sistema verifica que exista código, descripción, unidad de medida y al menos una clasificación (materia prima / mercadería / fabricado).

🏷️ Ficha Lotes

Permite administrar los lotes del producto y su fecha de vencimiento.

Lote: código o número de lote impreso en el producto.
FecVen: fecha de vencimiento del lote.
Vigente: indica si el lote está disponible para ser usado en movimientos.

El sistema utiliza estos datos para seleccionar el lote al registrar entradas, salidas, ventas o traspasos y para análisis posteriores (vencimientos próximos, rotación por lote, etc.).

💰 Ficha Precios

Moneda de los precios de este producto: selecciona la moneda en la que se expresan los precios (por ejemplo Bs).
Tabla de precios:
- Tipo de precio: corresponde a la tabla de tipos de precio (detalle, mayorista, distribuidor, etc.).
- Precio: valor para el tipo de precio y moneda seleccionados.

Estos precios son los que se proponen en los documentos de ventas según el tipo de precio elegido para el cliente o la operación.

🚚 Ficha Proveedores

Lista de proveedores vinculados al producto. Cada fila guarda un proveedor habitual.
Botón Obtener proveedores desde las compras: busca en el historial de compras del producto y llena automáticamente la lista con los proveedores encontrados.

Esta ficha resulta útil para reportes, estadísticas y para filtrar sugerencias de pedidos de compra por proveedor.

🛒 Ficha Comercio electrónico

Se utiliza cuando la base de datos está publicada en SQL Server y se integra con un sistema de comercio electrónico.

Url foto miniatura: imagen pequeña para listados.
Url foto principal: imagen grande o principal del producto.
Descripción resumen (255 caracteres): texto corto para mostrar en listados o tarjetas de producto.
Descripción ampliada (HTML): permite redactar una ficha técnica con formato (títulos, listas, etc.) que se mostrará en la página web del producto.
Botón Registrar + fotos: ayuda a cargar y vincular las imágenes desde el sistema de archivos o servidor web.

Si el servidor no es SQL Server, esta ficha puede estar deshabilitada o sin origen de datos.

📊 Ficha Control de stock

Herramientas para analizar el movimiento del producto y definir stock mínimo y stock máximo.

Estado:
- Activo: el producto participa en las sugerencias de pedidos.
- Baja: se oculta de las sugerencias de reposición.
Fecha primera compra / botón Obtener fecha de la primera compra: toma la fecha de la primera entrada registrada.
Fecha última venta / botón Obtener fecha de la última venta: toma la fecha de la venta más reciente.
Periodo en días: rango de días que se considera para calcular el promedio de ventas. Al modificarlo se ajustan las fechas inicial y final.
Días de provisión: tiempo (en días) que demora desde que se hace el pedido al proveedor hasta que la mercadería llega al almacén.
Ventas en el periodo y botón Obtener ventas del periodo a evaluar: suma de unidades vendidas dentro del rango de fechas.
Ventas promedio/día: calculadas automáticamente como Ventas en el periodo ÷ Periodo en días.
Stock mínimo determinado: se puede calcular con el botón Calcular stock mínimo, que aplica la fórmula: Stock mínimo = Días de provisión × Ventas promedio/día. También puede escribirse manualmente.
Stock máximo: cantidad máxima deseada, según capacidad de almacenamiento, capacidad de compra y proyecciones de ventas.

Estos parámetros se utilizan en los reportes de control de stock y en las sugerencias de pedidos de compra para evitar quiebres y sobrestock.

🧷 Botones principales

Guardar: valida los datos obligatorios y guarda el producto.
Cancelar: cierra el formulario sin guardar cambios.

⚠️ Reglas y recomendaciones

No duplique manualmente códigos: el sistema se encarga de generar el siguiente código disponible dentro de la categoría superior.
Evite cambiar la configuración de niveles de productos de la empresa una vez haya movimientos en almacén.
Marque Control de inventario solo en productos que realmente se gestionan en stock; servicios y conceptos sin inventario deben quedar sin control.
Use las cuentas contables correctas para que los asientos automáticos de compras, ventas y ajustes sean coherentes con la contabilidad.