Hardware y dispositivos

Lector de código de barras, cámara, balanza, impresora de recibos, cajón de dinero, etiquetas, pantalla del cliente, terminales de tarjeta y cómo usar StorEdge en tablet y celular.

Para: todo el equipo

Lo que necesitas (y lo que no)

Un resumen de cada dispositivo y con qué navegador funciona.

Todo el equipo

Para empezar basta un computador, una tablet o un celular con su navegador. Todo lo demás es opcional. Ningún plan limita el hardware.

DispositivoCómo funcionaNavegador
Lector de código de barras (USB o Bluetooth)Escribe el código en el buscador de Venta activa y termina con Enter, como un teclado.Cualquiera
Cámara como lectorUn botón en Venta activa lee códigos con la cámara del equipo.Cualquiera con cámara y https
Balanza (Torrey)Se conecta por puerto serie (Web Serial). También puedes escribir el peso a mano.Chrome o Edge de escritorio
Impresora de recibos térmicaSe conecta por puerto serie desde el cuadro de cobro.Chrome o Edge de escritorio
Impresora común«Imprimir recibo» usa el diálogo de impresión del sistema.Cualquiera
Cajón de dineroSe abre con un pulso por la impresora: debe estar enchufado a ella.Chrome o Edge de escritorio
EtiquetasPDF o diálogo de impresión del navegador.Cualquiera
Pantalla del clienteUna segunda ventana del mismo navegador, del mismo computador.Cualquiera
Terminal de tarjetaSin integración: cobras en la máquina y anotas el N° de voucher.—
  • La cámara y los puertos serie exigen una conexión segura (https): abre StorEdge desde su dirección oficial.
  • La impresora térmica y la balanza no funcionan en iPhone, iPad ni en Firefox o Safari: ahí se imprime con el diálogo del sistema y el peso se escribe a mano.
  • El navegador te pide permiso cada vez que conectas un puerto nuevo; el selector de puertos siempre es el del navegador.

Nota: La compatibilidad de la impresora, el cajón y la balanza se programó según el estándar ESC/POS y el formato de la Torrey, pero todavía no se probó con equipos reales. Prueba tu equipo antes de abrir al público y avísanos si algo no sale.

Lector de código de barras

Cómo escanear productos con un lector USB o Bluetooth.

Todo el equipo Permiso: Crear ventas

Para StorEdge, un lector es un teclado: no hay nada que conectar ni emparejar dentro del sistema. Enchúfalo (o empareja el Bluetooth con tu equipo) y úsalo con el cursor en el buscador de Venta activa.

  1. En Venta activa, deja el cursor en el buscador («Buscar por nombre, SKU o código de barras...»). En computador con mouse, se enfoca solo; F2 lo enfoca desde cualquier parte.
  2. Escanea el código: el lector lo escribe y manda Enter.

Qué verás

Si un producto tiene exactamente ese código de barras o SKU, se agrega al carrito, el buscador se vacía y el cursor queda listo para el siguiente. Si es el código de una variante, se agrega esa variante directo. Sin coincidencia exacta, solo se filtra la grilla.

  • Un producto por peso abre el cuadro de pesaje; uno con N° de serie abre el selector de serie; uno con variantes escaneado por el código del producto pide Elige una variante.
  • Funciona sin internet con el catálogo guardado en el equipo.
  • En una tablet o celular el buscador no se enfoca solo (para no abrir el teclado en pantalla): toca el buscador una vez antes de escanear.
  • El lector debe terminar cada lectura con Enter (la mayoría viene así). Si el tuyo no, configúralo según su manual.

Errores comunes

El código aparece en otro campo.
El cursor estaba en otro lugar (un cuadro abierto, por ejemplo). Cierra lo que esté abierto y vuelve al buscador.
Escaneo y solo veo «Sin resultados».
Ningún producto tiene ese código de barras ni SKU exactamente. Revísalo en Inventario.
Mi lector es de balanza (código con el peso incluido).
No se lee: el código debe ser igual al código de barras o SKU del producto.

Nota: No hay un indicador de «lector conectado». El Modo de escáner «Lector (teclado)», «Serial» y «Sin escáner» de una terminal se comportan igual: solo «Cámara» cambia algo (muestra el botón de cámara).

La cámara como lector

Escanear con la cámara del celular, la tablet o el computador.

Todo el equipo Permiso: Editar terminales

Activarla

  1. Abre Terminales (menú Operación) y crea o edita una terminal.
  2. En Modo de escáner elige Cámara y toca Guardar.
  3. En Venta activa, elige esa terminal en el selector de terminal de la fila de arriba.

Qué verás

Junto al buscador aparece un botón con ícono de cámara («Escanear con la cámara»). Al tocarlo se abre Escanear código: apunta al código de barras o QR y, al leerlo, el producto se agrega como si lo hubiera escaneado un lector. La cámara se apaga después de cada lectura: toca el botón para el siguiente.

  • Lee EAN-13, EAN-8, UPC-A, UPC-E, Code 128, Code 39, ITF y QR, con la cámara trasera. Funciona en cualquier navegador, incluido iPhone, y también sin internet.
  • En el asistente de configuración, el paso de la terminal pregunta «¿Cómo vas a escanear productos?» (Lector físico o Cámara del celular).
  • La terminal elegida no se recuerda: al cargar Venta activa (o cambiar de sucursal) vuelve a la primera terminal por orden alfabético. Si tu celular usa la cámara, vuelve a elegir su terminal.
  • Con «Sin terminal» o con una terminal que no es de cámara, no hay botón de cámara.
  • La linterna («Encender luz» / «Apagar luz») solo existe en Inventario → Nuevo producto → Escanear, no en Venta activa.

Errores comunes

«La cámara solo funciona en una conexión segura (https). Abre StorEdge desde su dirección oficial para escanear.»
Entra desde la dirección oficial de StorEdge (https), no desde una dirección interna.
«No diste permiso para usar la cámara. Actívalo en la configuración del navegador, o escribe el código a mano.»
Permite la cámara para este sitio en el navegador y vuelve a tocar el botón.
«Este dispositivo no tiene una cámara disponible. Escribe el código a mano o usa un lector.»
El equipo no tiene cámara (o el navegador no la ve).
«La cámara está siendo usada por otra aplicación. Ciérrala e inténtalo de nuevo.»
Cierra la otra aplicación o pestaña que la usa.

Balanza

Pesar productos con una balanza Torrey o escribiendo el peso.

Todo el equipo Permiso: Crear ventas

Un producto se pesa si tiene encendido Se vende por peso (balanza) en su ficha. En Venta activa lleva la insignia x peso y su precio se ve como «$X/kg». Al tocarlo (o escanearlo) se abre el cuadro de pesaje, con dos pestañas:

PestañaCómo se usa
Por pesoEscribe el Peso (kg) (hasta 3 decimales) o, con balanza conectada, toca Usar este peso.
Por montoPara una balanza ajena al sistema: escribe el Monto pagado ($) que marcó la balanza y StorEdge calcula el peso por regla de tres («≈ 0.xxx kg»).

Conectar una balanza Torrey

  1. En Por peso, toca Conectar balanza (Torrey) y elige el puerto de la balanza en el selector del navegador.
  2. Espera la lectura («Lectura de la balanza» con el peso en grande).
  3. Toca Usar este peso y luego Agregar.
  • Solo se conecta una Torrey, por puerto serie a 9600 baudios, y solo en Chrome o Edge de escritorio. En otro navegador verás «Tu navegador no soporta conexión directa con balanzas — usa Chrome o Edge de escritorio, o ingresa el peso manualmente abajo».
  • La balanza se desconecta cada vez que cierras el cuadro, así que hay que volver a conectarla (y elegir el puerto) en cada producto pesado. Si te molesta, usa el peso escrito o «Por monto».
  • El peso se lee como un número con punto decimal (por ejemplo 1.234) en kilos. Si tu balanza manda gramos o usa coma, la lectura se queda en «Esperando lectura...» y debes escribir el peso.
  • En el carrito, la cantidad de esa línea es un campo en kg, editable.
  • Un producto en UF, UTM o UTA no se puede vender por peso.

Consejo: El interruptor Caja | Balanza de la fila de arriba cambia la grilla a «Vista por peso»: solo los productos por peso, con tarjetas grandes. Aparece en los rubros que venden por peso, aunque no tengas balanza.

Impresora de recibos

Imprimir con el diálogo del sistema o directo a una impresora térmica.

Todo el equipo Permiso: Crear ventas
OpciónCuándo sirve
Imprimir reciboSiempre está en «¡Compra exitosa!». Abre el diálogo de impresión del sistema: sirve con cualquier impresora instalada (incluida una térmica con su controlador) o «Guardar como PDF». El recibo mide unos 74 mm de ancho, pensado para papel de 80 mm.
Imprimir en térmicaSolo aparece si conectaste una impresora térmica. Manda el ticket directo por el puerto serie y corta el papel.

Conectar una impresora térmica

  1. En Chrome o Edge de escritorio, abre el cuadro Cobrar con un pago en efectivo. Es el único lugar donde aparece el botón.
  2. Toca Conectar impresora / cajón de dinero y elige el puerto de la impresora (suele verse como «USB Serial», «CH340» o «COMx»).
  3. Verás la etiqueta verde Cajón de dinero conectado.

Qué verás

La impresora y el cajón comparten una sola conexión. La próxima vez, StorEdge reconecta sola la primera impresora ya autorizada en ese navegador, sin que vuelvas a elegirla. En un navegador sin Web Serial verás «La apertura automática del cajón de dinero solo está disponible en Chrome o Edge de escritorio».

  • El ticket térmico es de texto plano, 32 columnas, sin tildes ni «ñ» (se convierten), sin negritas, sin logo ni código QR. En papel de 80 mm sale angosto y pegado a la izquierda; los renglones largos del encabezado y el pie no se parten.
  • Lleva: sucursal, razón social, RUT, dirección y teléfono; tipo de documento (BOLETA, FACTURA o COMPROBANTE DE APARTADO); líneas, Subtotal, IVA, TOTAL; pagos y Vuelto; garantía y pie. Siempre termina con «Comprobante no valido como boleta electronica (SII)»: es un comprobante interno.
  • La velocidad es fija (9600 baudios); una impresora con otra velocidad imprimiría símbolos extraños.
  • La impresión térmica no es automática: siempre es un botón después de cobrar. Devoluciones, cotizaciones, reportes de caja y Reimprimir usan siempre el diálogo del sistema.
  • Los textos del encabezado, pie y garantía se configuran en Configuración → Recibo.

Errores comunes

Toco «Imprimir en térmica» y no sale nada, ni aparece un error.
Los errores de la impresora no se muestran. Si desenchufaste la impresora, el botón sigue visible pero falla en silencio: recarga la página y vuelve a conectar desde Cobrar.
Ya no me aparece el botón para conectar.
Solo sale cuando el cobro tiene un pago en efectivo y el navegador soporta Web Serial.
La impresora y la balanza se confunden.
Ambas usan puertos serie autorizados en el mismo navegador y la reconexión automática abre el primer puerto autorizado: si ves que la impresora trata de usar el puerto de la balanza, desconecta ambos, recarga y reconecta primero la impresora.

Cajón de dinero

Cuándo se abre y cómo conectarlo.

Todo el equipo Permiso: Abrir cajón sin venta

El cajón no tiene conexión propia: se abre con un pulso que StorEdge manda por la impresora, así que debe estar enchufado a ella (RJ11 o RJ12) y la impresora conectada como se explica arriba.

  • Al confirmar un pago en efectivo (o al cobrar una seña): se abre antes de que termine de guardarse la venta, como en una caja registradora. Si después la venta falla (por ejemplo, cambió un precio), el cajón ya se abrió. Con tarjeta o transferencia no se abre.
  • Abrir cajón (sin venta): botón en la barra de Venta activa (en tablet y celular, dentro de Más), para quien tenga el permiso de abrir el cajón. No pide turno ni mueve el efectivo esperado. Ver Caja y turnos.

Ojo: Si no hay impresora conectada, el cajón no se abre, pero el mensaje igual dice «Cajón abierto.» y se deja la constancia. Si el navegador no soporta puertos serie, abre el cajón con su llave o su botón.

Etiquetas de producto

Imprimir etiquetas con precio y código de barras.

Todo el equipo

Las etiquetas se imprimen desde Inventario → Catálogo (Imprimir en una fila, o Imprimir etiquetas con varios productos seleccionados) y salen por el diálogo del navegador o como PDF, con el tamaño que elijas. No se mandan a la impresora por puerto serie ni usan lenguajes de impresoras de etiquetas (ZPL, TSPL). Todos los pasos y límites están en Catálogo e inventario.

  • Sirve con cualquier impresora que tu sistema vea: de etiquetas con su controlador, o una láser con hojas adhesivas (Hoja A4).
  • El diseño de la etiqueta no se puede editar (sin logo ni SKU visible). Si el tamaño debe salir exacto, descarga el PDF: el navegador puede imponer márgenes al imprimir directo.
  • No se pueden imprimir etiquetas desde Venta activa ni al recibir una orden de compra.

Pantalla del cliente

Una segunda ventana para que el cliente vea su compra.

Todo el equipo
  1. En Venta activa toca Pantalla de cliente (en tablet o celular, dentro de Más). Se abre una ventana nueva; si tu navegador bloquea las ventanas emergentes, permítelas.
  2. Arrastra esa ventana al segundo monitor y ponla en pantalla completa (F11) a mano: no entra sola.

Qué verás

El cliente ve el nombre de la sucursal, la lista de productos con el monto de cada línea y el TOTAL en grande. Al terminar la venta ve «¡Compra exitosa!» por 6 segundos y vuelve a la espera.

  • Es una segunda ventana del mismo navegador y el mismo computador: no se sincroniza entre dispositivos, así que no sirve una tablet aparte aunque tenga la sesión abierta.
  • No muestra cantidades, descuentos, IVA, vuelto ni medios de pago.
  • Si abres la ventana con el carrito ya cargado, dice «Esperando productos...» hasta el siguiente cambio del carrito. Si recargas Venta activa o cambias de pantalla, la ventana del cliente deja de actualizarse hasta que vuelvas a tocar el botón.
  • Exige la sesión iniciada en ese navegador y no tiene configuración.

Terminales de tarjeta

StorEdge no se conecta a tu máquina de tarjetas.

Todo el equipo Permiso: Crear ventas

No hay ninguna integración con terminales ni pinpads (Transbank, Getnet, Redcompra, Mercado Pago…). Cobras en la máquina aparte y en StorEdge eliges el medio de pago (por ejemplo «Tarjeta (presencial)») y anotas el N° de voucher, en el campo bajo el monto: «N° de voucher (obligatorio)» u «(opcional)» según cómo esté configurado ese medio.

  • Solo el efectivo da vuelto y entra al cajón y al arqueo.
  • Si el total cambia mientras el cobro estaba abierto y ya había un voucher, el aviso dice «Anula el voucher N° X en la máquina y vuelve a pasar la tarjeta por $Y.»
  • Sin conexión, todo pago que no sea efectivo exige la referencia y la venta queda por revisar: «Este pago NO se autoriza aquí: solo se registra». Se recomienda cobrar en efectivo (ver Modo sin conexión).

Tablet y celular

Cómo se adapta StorEdge a cada equipo, y cómo instalarlo como app.

Todo el equipo
EquipoCómo lo reconoce StorEdgeQué cambia
CelularMenos de 768 px de ancho.Productos a pantalla completa y una barra «N productos · total [Cobrar]» que sube el carrito como hoja desde abajo (se cierra con ✕, tocando lo oscuro o arrastrando). Las ventanas se abren como hojas inferiores.
TabletDe 768 a 1279 px y pantalla táctil.Productos y carrito lado a lado; las herramientas secundarias van en Más.
ComputadorEl resto.La disposición de siempre.
  • El modo táctil (botones, listas y campos más grandes, y campos a 16 px para que el iPhone no haga zoom) se activa solo en cualquier equipo táctil, y puede forzarse por sucursal en Configuración → Pantalla de venta.
  • En modo táctil el buscador no se enfoca solo y no se ofrecen los atajos de teclado.
  • La edición del precio en línea del catálogo no existe en celular ni tablet vertical: usa Editar.
  • La impresora térmica por USB y el cajón no existen en iOS ni en navegadores sin Web Serial: allí se imprime con el diálogo del sistema.

Instalar StorEdge como app

  1. Abre Configuración → App móvil (grupo Equipo y sistema).
  2. En Chrome o Edge toca Instalar app. En iPhone o iPad: Compartir → Agregar a pantalla de inicio → Agregar. En Brave: menú ⋮ → Instalar app.... En Firefox no se puede instalar.

Qué verás

La app queda con ícono propio, sin la barra del navegador y abre en el POS. Se actualiza sola. Instalada o no, la cámara y los puertos serie se comportan igual.

Nota: La jornada de prueba con equipos reales (tablet, celular, lector Bluetooth, impresora, modo avión, app instalada) todavía no se hace: lo que depende de ellos puede comportarse distinto. Detalle de la instalación en Configuración.

Lo que el hardware no hace (todavía)

Límites a tener en cuenta.

Todo el equipo
  • No se integra con terminales de tarjeta ni pinpads: el voucher se anota a mano.
  • No hay puente local ni impresión por red, por Bluetooth o por USB directo: solo puerto serie del navegador.
  • Balanza: solo Torrey, con un formato todavía sin verificar contra un equipo real, sin reconexión automática y sin etiquetas con peso incluido.
  • Impresora: ticket de texto de 32 columnas, sin logo ni códigos, sin ancho de papel configurable, sin impresión automática ni reintentos; los errores no se muestran.
  • Etiquetas: sin lenguajes de impresora de etiquetas; diseño fijo.
  • Pantalla del cliente: no entre dispositivos y no muestra cantidades.
  • Lector: sin indicador de conexión; el modo «Serial» no está implementado.
  • No emite boleta ni factura electrónica del SII.

¿Algo no calza con lo que ves en tu pantalla, o falta algo? Escríbenos a info@hannoverindustries.cl.