Guía completa para instalar y configurar dispositivos SUNMI D2 MINI y SUNMI V2 PRO con VERTEX POS.

¿Qué es SUNMI?

SUNMI es una marca de terminales de punto de venta con Android integrado. VERTEX POS se conecta directamente con el hardware de SUNMI (impresora, escáner, caja registradora) sin necesidad de drivers adicionales.

Dispositivos Compatibles

Modelo Impresora Escáner Caja Pantalla
D2 MINI ✅ 80mm térmica ✅ 2D integrado ✅ Puerto RJ11 10.1" Full HD
V2 PRO ✅ 58mm térmica ✅ 1D/2D integrado ❌ 5.5" HD
T2 MINI ✅ 80mm térmica ✅ 2D integrado ✅ Puerto RJ11 10.1" Full HD

Instalación Paso a Paso

1. Instalación de la PWA

  1. Abra el navegador Chrome en su dispositivo SUNMI
  2. Navegue a https://vertexerp.app
  3. Inicie sesión con sus credenciales
  4. Toque el menú ⋮ (tres puntos) → "Agregar a pantalla de inicio"
  5. Confirme la instalación
  6. La app VERTEX aparecerá como ícono en la pantalla principal

💡 Tip: También puede instalar desde el banner de instalación que aparece automáticamente.

2. Activar Modo SUNMI

  1. Ingrese al POS y abra una sesión de caja
  2. Vaya a Configuración POS → Impresión
  3. Active el toggle "Modo SUNMI"
  4. El sistema detectará automáticamente el hardware disponible

El modo SUNMI habilita:

  • Impresión directa sin diálogo del navegador
  • Control de la caja registradora (apertura automática)
  • Lectura de códigos de barras integrada

3. Configuración de la Impresora

Ajuste Valor Recomendado
Ancho de papel 80mm (D2 MINI / T2 MINI) o 58mm (V2 PRO)
Corte automático Activado
Logo en ticket Activado (se imprime el logo del negocio)
Copias del recibo 1

#### Prueba de Impresión

  1. Vaya a Configuración POS → Impresión
  2. Seleccione el ancho de papel correcto
  3. Realice una venta de prueba
  4. El ticket se imprimirá automáticamente al completar la venta

4. Escáner de Códigos de Barras

El escáner integrado funciona automáticamente con VERTEX POS:

  • En el POS: Escanee el código de barras del producto → se agrega al carrito automáticamente
  • Spotlight (⌘B): Escanee cualquier código → búsqueda inmediata
  • Tarjetas de Lealtad: Escanee la tarjeta del cliente → identifica automáticamente

⚠️ Importante: Asegúrese de que el escáner esté configurado en modo "Keyboard Wedge" (configuración predeterminada de fábrica).

5. Caja Registradora (Cash Drawer)

Para dispositivos con puerto RJ11 (D2 MINI, T2 MINI):

  1. Conecte la caja registradora al puerto RJ11 del dispositivo
  2. La caja se abrirá automáticamente al completar una venta en efectivo
  3. También puede abrirla manualmente desde Movimientos → Abrir Caja

Solución de Problemas

La impresora no imprime

  1. Verifique que "Modo SUNMI" esté activado en Configuración POS
  2. Reinicie la aplicación PWA
  3. Verifique que el rollo de papel esté correctamente colocado
  4. Si persiste, reinicie el dispositivo SUNMI

El escáner no lee códigos

  1. Limpie la ventana del escáner
  2. Ajuste la distancia (10-30 cm del código)
  3. Verifique que el código de barras no esté dañado
  4. Pruebe con el Spotlight activo (⌘B)

La caja registradora no abre

  1. Verifique la conexión del cable RJ11
  2. Asegúrese de que la caja sea compatible (12V / 24V)
  3. Pruebe la apertura manual desde el menú de Movimientos

Error "SDK no disponible"

Este error indica que la app no está corriendo en un dispositivo SUNMI real. El modo SUNMI solo funciona en hardware oficial SUNMI con el bridge JavaScript nativo.

Especificaciones Técnicas

Comunicación con Hardware

VERTEX POS utiliza el SUNMI JavaScript Bridge inyectado por el sistema Android de SUNMI:

window.sunmiInnerPrinter  → Control de impresora
window.sunmiScanManager   → Control de escáner

Formatos de Impresión Soportados

  • Texto plano — Para tickets estándar
  • QR Code — Para factura electrónica (FEL UUID)
  • Código de barras — Para identificación de documentos
  • Imágenes — Logo del negocio en encabezado

Rendimiento

Métrica Valor
Velocidad de impresión ~200 mm/s
Resolución 203 DPI
Ancho efectivo 72mm (papel 80mm) o 48mm (papel 58mm)
Vida del cabezal ~100 km de impresión

Preguntas Frecuentes

¿Puedo usar VERTEX POS sin dispositivo SUNMI?

Sí. VERTEX POS funciona en cualquier navegador moderno. La impresión se realiza a través del diálogo de impresión del navegador. El modo SUNMI solo agrega impresión directa y control de caja registradora.

¿Necesito internet para imprimir?

No. La impresión es local y funciona incluso en modo offline. Las ventas offline se sincronizan cuando se restablece la conexión.

¿Puedo conectar una impresora USB externa?

No directamente. SUNMI solo soporta su impresora integrada a través del SDK. Para impresoras externas, use la impresión estándar del navegador.

Composable de referencia: composables/pos/useSUNMI.ts

Configuración: /apps/pos/config/general → Sección Impresión