QuetzaLink Docs
Nivel OrganizaciónProductos

Campos del Producto

Referencia completa de todos los campos disponibles al crear o editar un producto

Esta página documenta todos los campos disponibles en el formulario de productos. Los campos se organizan por sección tal como aparecen en la interfaz.

Información Básica

CampoTipoRequeridoDescripción
NombreTexto✅ SíNombre comercial del producto. Máximo 200 caracteres.
Nombre en facturaTextoNoNombre simplificado para tickets y facturas. Si está vacío, usa el nombre principal.
SKUTextoNoStock Keeping Unit. Código interno único. Si está vacío, se genera automáticamente con formato "SKU-XXXXX".
Código de barrasTextoNoCódigo EAN-13 para escaneo. Se genera automáticamente si está vacío. Debe ser único en la organización.
DescripciónTexto largoNoDescripción detallada del producto. Útil para tienda en línea.

Clasificación

CampoTipoRequeridoDescripción
CategoríaSelectorNoCategoría a la que pertenece el producto. Facilita la búsqueda y organización.
Proveedor principalSelectorNoProveedor predeterminado para órdenes de compra.

Unidad de Medida

CampoTipoRequeridoDescripción
UnidadSelector✅ SíCómo se mide/vende el producto.
Permitir decimalesCheckboxNoHabilita cantidades fraccionarias (ej: 1.5 kg, 2.3 metros). Solo disponible para unidades compatibles.

Opciones de unidad:

  • unidad - Productos individuales
  • caja - Paquetes cerrados
  • paquete - Grupos de productos
  • kg - Kilogramos (a granel)
  • litro - Líquidos
  • metro - Telas, cables, etc.

Precios

CampoTipoRequeridoDescripción
Precio de costoMonedaNoCosto de adquisición sin IVA. Base para calcular utilidad.
Margen %PorcentajeNoPorcentaje de ganancia sobre el costo. Se calcula automáticamente si cambias el precio de venta.
Precio de ventaMoneda✅ SíPrecio al público con IVA incluido.
Tasa de IVASelector✅ SíPorcentaje de impuesto. Opciones: 0%, 5%, 12%, 15%.

Fórmulas de Cálculo

Precio sin IVA = Precio de venta ÷ (1 + Tasa IVA / 100)
Utilidad = Precio sin IVA - Costo
Margen % = (Utilidad ÷ Costo) × 100

Ejemplo con IVA 12%:

  • Costo: Q100.00
  • Margen deseado: 30%
  • Precio sin IVA: Q130.00
  • Precio de venta (con IVA): Q145.60

Control de Inventario

CampoTipoRequeridoDescripción
Stock mínimoNúmeroNoCantidad para generar alerta de stock bajo. Por ubicación.
Visible en ventasCheckboxNoSi está activo, el producto aparece en el POS. Desactívalo para productos que solo se venden en línea o en combos.

Imágenes

CampoTipoRequeridoDescripción
Imagen principalArchivoNoFoto del producto. Formatos: JPG, PNG. Tamaño máximo: 5MB.
Foto de ubicaciónArchivoNoFoto que muestra dónde se almacena físicamente el producto en bodega. Útil para empleados nuevos.

Inventario por Ubicación

CampoTipoRequeridoDescripción
UbicaciónReferencia-Sucursal o bodega
CantidadNúmero-Stock actual en esa ubicación (solo lectura, se modifica vía ajustes/compras/ventas)
Stock mínimo localNúmeroNoOverride del stock mínimo para esta ubicación específica

El inventario no se edita directamente desde el producto. Para explicar o corregir stock, revisa Movimientos de Inventario Local y las Recepciones de Compra.

Configuración Tienda en línea (Plan con Tienda en línea)

CampoTipoRequeridoDescripción
Publicar en tiendaCheckboxNoHace visible el producto en el storefront público.
Precio onlineMonedaNoPrecio específico para ventas online. Si está vacío, usa el precio de venta estándar.
Descripción largaTexto enriquecidoNoDescripción detallada para la página del producto.
SlugTextoNoURL amigable (ej: "camiseta-polo-premium"). Se genera del nombre si está vacío.

Variantes (Plan Emprendedor+)

CampoTipoRequeridoDescripción
AtributosMulti-selectorNoCaracterísticas que varían (Color, Talla, Material).
VariantesListaNoCombinaciones generadas. Cada variante puede tener su propio SKU, código de barras, precio y stock.

Ver Variantes para más detalles.

Campos del Sistema (Solo Lectura)

CampoDescripción
IDIdentificador único del producto
CreadoFecha y hora de creación
ActualizadoÚltima modificación
Creado porUsuario que creó el producto

Relaciones

El producto se relaciona con:

EntidadRelaciónDescripción
CategoríaPertenece aUn producto tiene una categoría
ProveedorReferenciaProveedor principal para compras
UbicaciónMuchos a muchosStock independiente por ubicación
VariantesUno a muchosUn producto puede tener múltiples variantes
VentasReferenciado enHistorial de ventas del producto
ComprasReferenciado enHistorial de compras del producto

On this page