Caja Registradora y Cajón de Efectivo
Guía completa para configurar el cajón de efectivo (cash drawer) con VERTEX POS, incluyendo la apertura automática al completar ventas en efectivo.
¿VERTEX Abre el Cajón Automáticamente?
Sí. Cuando se completa una venta con método de pago efectivo, VERTEX POS envía automáticamente la señal para abrir el cajón de dinero. Esto funciona de dos maneras:
| Configuración | Apertura Automática | Apertura Manual |
|---|---|---|
| Terminal SUNMI (D2 MINI, T2 MINI) | ✅ Vía SDK nativo | ✅ Desde Movimientos → Abrir Caja |
| Impresora térmica USB con puerto RJ11 | ✅ Vía comando ESC/POS | ✅ Desde Movimientos → Abrir Caja |
| Cajón independiente (sin impresora) | ❌ Requiere adaptador | ✅ Manual con llave |
Tipos de Cajones Compatibles
1. Cajón con Puerto RJ11 (Recomendado)
La mayoría de cajones registradoras comerciales utilizan un conector RJ11 (similar a un cable telefónico) para recibir la señal de apertura eléctrica.
| Especificación | Valor Recomendado |
|---|---|
| Voltaje | 12V DC o 24V DC |
| Conector | RJ11 (6P6C) |
| Compartimentos de billetes | 5 |
| Compartimentos de monedas | 5-8 |
| Materiales | Acero con frente plástico ABS |
#### Modelos Populares en Guatemala
| Modelo | Precio Aprox. | Voltaje | Notas |
|---|---|---|---|
| Cajón EC-410 | Q 350 - 500 | 12V/24V | Estándar comercial, muy común |
| Cajón EC-460 | Q 500 - 700 | 24V | Tamaño grande, más compartimentos |
| Cajón tipo flip-top | Q 250 - 400 | 12V | Compacto, ideal para espacios reducidos |
| Cajón SUNMI integrado | Acc. SUNMI | 12V | Compatible directo con terminales SUNMI |
2. Cajón con Cerradura Manual
Si no necesita apertura electrónica, puede usar un cajón con llave. El cajero lo abre manualmente con cada cobro en efectivo. VERTEX seguirá registrando todos los movimientos y el control de caja será idéntico.
Configuración por Tipo de Hardware
Terminales SUNMI (D2 MINI, T2 MINI)
Las terminales SUNMI con puerto RJ11 abren el cajón directamente a través del SDK integrado:
- Conecte el cable RJ11 del cajón al puerto RJ11 de la terminal SUNMI
- En VERTEX, vaya a Configuración POS → Impresión
- Active el "Modo SUNMI"
- El cajón se abrirá automáticamente al completar ventas en efectivo
Eventos que abren el cajón automáticamente:
- ✅ Venta completada con pago en efectivo
- ✅ Venta mixta que incluye efectivo
- ✅ Apertura manual desde Movimientos → Abrir Caja
Eventos que NO abren el cajón:
- ❌ Ventas solo con tarjeta
- ❌ Ventas solo con gift card
- ❌ Ventas con QR o link de pago
Impresoras Térmicas USB con Puerto RJ11
Muchas impresoras térmicas de escritorio (Epson TM-T20, Star TSP100, etc.) incluyen un puerto RJ11 trasero para conectar el cajón. La impresora actúa como puente:
[VERTEX POS] → USB → [Impresora térmica] → RJ11 → [Cajón]- Conecte la impresora al equipo por USB
- Conecte el cajón al puerto RJ11 de la impresora
- Configure la impresora como impresora predeterminada del sistema
- VERTEX enviará el comando ESC/POS de apertura de cajón al imprimir el recibo
Computadora de Escritorio (Sin SUNMI)
Si usa VERTEX POS en una computadora normal:
- Con impresora térmica + cajón RJ11: El cajón se abre al imprimir el recibo
- Sin impresora térmica: El cajón debe abrirse manualmente con llave
- Notificación en pantalla: VERTEX muestra un aviso "Abra el cajón" cuando se completa una venta en efectivo
Apertura Manual del Cajón
Independientemente de la configuración automática, el cajero puede abrir el cajón manualmente en cualquier momento:
- En el POS, vaya a Movimientos (icono de billete)
- Seleccione "Abrir Caja"
- El sistema enviará la señal de apertura al cajón (si está conectado electrónicamente)
- Ingrese el motivo si se requiere autorización de supervisor
⚠️ Nota de seguridad: Las aperturas manuales se registran en el historial de movimientos del turno. El supervisor puede auditar cuántas veces se abrió el cajón fuera de una venta.
Vertex POS como PWA vs App Nativa
Una pregunta frecuente es si VERTEX POS necesita ser una app nativa de Android para funcionar con hardware. La respuesta es no:
| Característica | PWA (VERTEX) | App Nativa |
|---|---|---|
| Se instala como ícono | ✅ | ✅ |
| Funciona offline | ✅ | ✅ |
| Acceso a impresora SUNMI | ✅ JavaScript Bridge | ✅ SDK nativo |
| Apertura de cajón | ✅ JavaScript Bridge | ✅ SDK nativo |
| Lector de códigos | ✅ Keyboard Wedge | ✅ SDK nativo |
| Actualizaciones sin Play Store | ✅ Instantáneo | ❌ Requiere publicación |
| Un solo código para web + Android | ✅ | ❌ |
| Presencia en Play Store | ⚠️ Vía TWA wrapper | ✅ |
Si en el futuro se necesitara presencia en el Play Store, se puede empaquetar la PWA como un TWA (Trusted Web Activity) sin reescribir código. Es un proceso de 1-2 días, no un proyecto separado.
Solución de Problemas
El cajón no abre con SUNMI
- Verifique que el cable RJ11 esté firmemente conectado
- Confirme que "Modo SUNMI" esté activado en Configuración POS
- Verifique la compatibilidad de voltaje (12V vs 24V)
- Pruebe la apertura manual desde Movimientos → Abrir Caja
- Si el cajón funciona con la llave pero no electrónicamente, el solenoide puede estar dañado
El cajón abre con cada venta (incluidas tarjeta)
Este no es el comportamiento esperado. VERTEX solo envía la señal de apertura para ventas con efectivo. Si el cajón abre con todas las ventas:
- Verifique la configuración en Configuración POS → Impresión
- Asegúrese de que la opción "Abrir cajón solo con efectivo" esté activada
El cajón se abre solo parcialmente
- Verifique que no haya billetes o monedas atascando el mecanismo
- Asegúrese de que la superficie sea plana y el cajón tenga espacio libre para deslizar
- Limpie los rieles del cajón con un paño seco
Error "Cash drawer no disponible (sin SUNMI SDK)"
Este mensaje es informativo, no un error. Indica que está usando VERTEX POS en una computadora sin hardware SUNMI. El cajón debe abrirse manualmente o mediante una impresora térmica con puerto RJ11.
Especificaciones Técnicas
Comando de Apertura SUNMI
VERTEX utiliza el método openCashBox() del SDK SUNMI:
window.sunmiInnerPrinter.openCashBox()Este comando envía un pulso eléctrico al puerto RJ11 que activa el solenoide del cajón.
Prioridad de Apertura
El sistema sigue esta prioridad al intentar abrir el cajón:
- SUNMI SDK → Si detecta
window.sunmiInnerPrinter, usaopenCashBox() - Impresora térmica → Si hay impresora configurada, envía el comando ESC/POS de apertura
- Notificación → Si no hay hardware disponible, muestra un aviso en pantalla
Preguntas Frecuentes
¿Puedo usar cualquier cajón de dinero?
Sí, siempre que tenga conector RJ11 para apertura electrónica o cerradura para apertura manual.
¿El cajón registra cuánto dinero hay adentro?
No. El cajón es solo un contenedor físico. El control del dinero lo lleva VERTEX POS mediante los movimientos de caja, ingresos, retiros y el Corte Z.
¿Necesito un cajón especial para SUNMI?
No. Cualquier cajón con conector RJ11 de 12V es compatible con los puertos RJ11 de las terminales SUNMI.
¿El cajón se abre en modo offline?
Sí. La señal de apertura es local y no requiere conexión a internet.
Composable de referencia: composables/pos/usePOSPrinter.ts → openCashDrawer()
SDK SUNMI: composables/pos/useSUNMI.ts → openCashDrawer()
Configuración: /apps/pos/config/general → Sección Impresión