Guía completa para configurar y utilizar lectores de códigos de barras y códigos QR 2D con VERTEX POS.

Tipos de Lectores Compatibles

VERTEX POS es compatible con cualquier lector de códigos que funcione en modo Keyboard Wedge (emulación de teclado). Esta es la configuración estándar de fábrica de la mayoría de escáneres.

Tipo Formatos Uso Principal Conexión
Láser 1D EAN-13, UPC-A, Code 128 Productos con código de barras lineal USB / Bluetooth
Imager 2D Todos los 1D + QR, DataMatrix, PDF417 Productos + tarjetas de lealtad + QR USB / Bluetooth
Integrado SUNMI 1D + 2D completo Todo (viene integrado en la terminal) Interno
Cámara del dispositivo QR (mediante app) Tarjetas de lealtad, gift cards Interno

Modelos Recomendados para Guatemala

Modelo Tipo Precio Aprox. Conexión Recomendado Para
Honeywell Voyager 1200g Láser 1D Q 350 - 500 USB Tiendas con productos estándar
Honeywell Xenon 1950g Imager 2D Q 800 - 1,200 USB Farmacias y tiendas premium
Netum L8BL Imager 2D Q 250 - 400 Bluetooth POS móvil y tablets
Tera HW0002 Imager 2D Q 200 - 350 USB + Bluetooth Uso general económico
SUNMI integrado Imager 2D Incluido Interno Terminales SUNMI

💡 Recomendación: Para farmacias, utilice un lector 2D que pueda leer tanto códigos de barras lineales como QR. Esto permite escanear tarjetas de lealtad y gift cards además de productos.

Instalación

Lectores USB (Computadora o Tablet)

  1. Conecte el lector al puerto USB de la computadora o tablet
  2. El sistema operativo lo reconocerá automáticamente (no necesita drivers)
  3. Abra VERTEX POS y navegue al módulo de ventas
  4. Escanee un producto — el código aparecerá automáticamente en la barra de búsqueda
  5. ¡Listo! El producto se agrega al carrito

Lectores Bluetooth

  1. Encienda el lector y active el modo Bluetooth
  2. En su dispositivo, vaya a Configuración → Bluetooth → Emparejar
  3. Seleccione el lector (aparecerá como "HID Keyboard" o nombre del modelo)
  4. Una vez emparejado, el lector funciona igual que uno USB

Lector Integrado SUNMI

El lector de las terminales SUNMI está siempre activo. No requiere configuración adicional. Consulte la guía de Configuración de Terminal SUNMI para más detalles.

Uso en VERTEX POS

Búsqueda de Productos

Cuando escanea un código de barras en el POS:

  1. El lector envía el código como si fuera "tecleado" instantáneamente
  2. VERTEX busca en la base de datos local (IndexedDB) por match exacto de código de barras
  3. Si encuentra un solo resultado, lo agrega directamente al carrito
  4. Si encuentra múltiples resultados, muestra la lista para seleccionar
  5. Si no encuentra resultados, muestra "Producto no encontrado"

⚠️ Importante: Asegúrese de que los productos tengan el campo "Código de barras" registrado en el inventario para que el escaneo funcione correctamente.

Spotlight de Búsqueda (⌘B)

El acceso directo ⌘B (o Ctrl+B) activa la barra de búsqueda universal "Spotlight". Desde aquí puede:

  • Escanear un código de barras para buscar el producto
  • Escanear una tarjeta de lealtad para identificar al cliente
  • Escanear un código QR de gift card

Tarjetas de Lealtad

Los códigos QR de las tarjetas de lealtad VERTEX tienen el formato:

https://vertexerp.app/gc/GC-XXXXXX

Al escanear una tarjeta de lealtad:

  1. VERTEX detecta que es un código QR de tarjeta de lealtad
  2. Normaliza el input (corrige caracteres si el teclado está en español)
  3. Extrae el código de la tarjeta (ej: GC-04E1C8)
  4. Identifica automáticamente al cliente asociado

Gift Cards

El proceso de escaneo de gift cards es idéntico al de tarjetas de lealtad. VERTEX distingue automáticamente entre ambas por el tipo de código.

Configuración del Modo Keyboard Wedge

La mayoría de lectores vienen configurados en modo Keyboard Wedge de fábrica, que es el modo correcto para VERTEX. Si su lector no funciona:

Verificar el Modo

  1. Abra cualquier aplicación de texto (Bloc de notas, Word, etc.)
  2. Escanee un código de barras
  3. Si el código aparece como texto escrito, está en modo correcto
  4. Si no aparece nada o aparecen caracteres extraños, necesita reconfigurarlo

Reconfigurar a Keyboard Wedge

Consulte el manual de su lector para escanear el código de configuración "USB HID Keyboard" o "Keyboard Wedge Mode". La mayoría de manuales incluyen un QR de configuración.

Configuración de Teclado Español

Si el lector interpreta mal algunos caracteres (por ejemplo, lee Ñ en vez de :), VERTEX tiene un sistema de normalización automática que corrige los caracteres más comunes:

Caracter leído Caracter real
Ñ o ñ : (dos puntos)
— (em-dash) / (barra)
' (comilla) - (guión)
Ç o ç ; (punto y coma)
¿ ? (signo interrogación)

Esta normalización es automática y transparente para el usuario.

Solución de Problemas

El lector no agrega productos al carrito

  1. Verifique que el cursor esté en la barra de búsqueda del POS
  2. Confirme que el producto tiene un código de barras registrado en el inventario
  3. Pruebe escanear el código con la barra de búsqueda enfocada

El lector lee caracteres extraños

  1. Verifique que el lector esté en modo Keyboard Wedge
  2. Confirme la configuración de idioma del teclado del sistema operativo
  3. VERTEX normaliza los caracteres automáticamente, pero el teclado del sistema debe estar en el idioma correcto

El lector Bluetooth se desconecta frecuentemente

  1. Verifique que la batería del lector esté cargada
  2. Asegúrese de que no haya interferencia (distancia máxima ~10 metros)
  3. Re-empareje el dispositivo si persiste el problema

Los códigos QR no se leen correctamente

  1. Un lector 1D laser no puede leer QR — necesita un lector 2D imager
  2. Ajuste la distancia de lectura (5-20 cm para 2D)
  3. Asegúrese de que la pantalla o impresión del QR tenga buen contraste

Formatos de Código de Barras Soportados

Formato Tipo Uso Común
EAN-13 1D Productos de consumo masivo
EAN-8 1D Productos pequeños
UPC-A 1D Productos importados (USA)
Code 128 1D SKUs internos, logística
Code 39 1D Industria, inventarios
QR Code 2D Tarjetas lealtad, links
DataMatrix 2D Farmacéuticos, trazabilidad
PDF417 2D Documentos de identidad

Preguntas Frecuentes

¿Necesito un lector especial para VERTEX?

No. Cualquier lector que funcione en modo Keyboard Wedge (la mayoría del mercado) es compatible.

¿Puedo usar el lector de la cámara del celular?

Sí, para códigos QR de tarjetas de lealtad y gift cards. Para códigos de barras de productos, un lector dedicado es mucho más rápido y confiable.

¿El lector funciona en modo offline?

Sí. VERTEX busca primero en la base de datos local (IndexedDB) que se sincroniza automáticamente. Los productos escaneados se encontrarán incluso sin internet.

¿Puedo usar dos lectores al mismo tiempo?

Sí. Puede tener un lector USB fijo y uno Bluetooth portátil conectados simultáneamente.

Composable de referencia: composables/useScannerNormalization.ts

Búsqueda de productos: composables/pos/useProductSearch.ts

Base de datos local: composables/pos/useOfflineStore.ts