Escritorio, PWA y modo offline

oPOS se puede usar de tres formas distintas, y no son tres nombres para lo mismo: son tres formas de instalar la misma aplicación con capacidades diferentes. La que elijas define si vas a poder imprimir por red, si recibís las notificaciones con la app cerrada y qué pasa exactamente cuando se corta internet a mitad de una venta.

La decisión es simple en la mayoría de los casos. En una tablet o un celular de mostrador conviene la PWA, porque queda un ícono en la pantalla y se abre como una app. En una computadora de caja con impresora de red conviene la app de escritorio, porque es la única que puede mandar el ticket directo a la impresora. Y en una notebook sin impresora de red alcanza con el navegador.

La aplicación de escritorio es la única forma de imprimir por red (WiFi o Ethernet). Si tenés una impresora térmica de red en el mostrador, el navegador no te va a servir: vas a tener que instalar oPOS Desktop en esa computadora.

Recetas rápidas

Atajos para resolver lo más frecuente sin leer la página entera

Instalar oPOS en la computadora del local: Si esa caja tiene impresora térmica de red, pedí el instalador .exe que entrega oPOS → instalalo en Windows → la app se agrega al menú de inicio → abrila e ingresá la clave de activación en mayúsculas y sin espacios. Es la única forma de imprimir por red: en el navegador no existe.
Activar la licencia de la app de escritorio: Abrí oPOS Desktop por primera vez → escribí la clave, que tiene formato OPOS-ABCD-1234, en mayúsculas y sin espacios → confirmá. El modelo es una licencia por equipo, no por usuario: la misma persona puede entrar en tres computadoras, pero cada computadora necesita su propia clave.
Instalar oPOS en el celular o la tablet: Entrá a oPOS en el navegador → tocá el banner Instalar oPOS o el ícono de la barra de direcciones → confirmá. En iPhone y iPad no existe ese botón: usá Compartir → Agregar a pantalla de inicio. Con la app instalada llegan las notificaciones push aunque la app esté cerrada.
Imprimir por WiFi sin el diálogo del navegador: Instalá oPOS Desktop en esa caja → cargá la IP de la Impresora y el Puerto, que casi siempre es 9100 → tocá Probar impresión de red. En el navegador no hay forma de mandar el ticket directo a una impresora de red.
Trabajar sin internet: Vendé con la conexión caída: las ventas, los turnos y los movimientos de caja se guardan en el equipo → vigilá el indicador de arriba hasta que diga Sincronización completa. Cuando vuelve la señal sube solo, siempre en este orden: turnos, ventas, cierre de caja y facturas pendientes. Es un respaldo de emergencia, no una modalidad de trabajo.
Limpiar la caché: Andá a Ajustes → Datos generales → Mantenimiento de la App → tocá Limpiar Caché y Recargar App → confirmá. Borra la copia local de la app, no los datos de negocio. En oPOS Desktop este paso ocurre automáticamente en cada arranque, así que no lo hagas a mano.

Las tres formas de usar oPOS

Forma	Qué es	Dónde se instala	Ideal para
Navegador	Entrás a la dirección de tu negocio y usás oPOS en una pestaña.	No se instala nada.	Notebooks, computadoras de escritorio, equipos compartidos.
PWA	La app instalable desde el navegador: ícono en el escritorio y se abre sin barra de direcciones.	Android, iOS, macOS, Windows, ChromeOS.	Tablets y celulares de mostrador.
oPOS Desktop	Programa de escritorio para Windows con licencia por equipo.	Instalador `.exe`.	Cajas con impresora de red y equipos que necesitan trabajar con conexión inestable.

1) Navegador

Es la forma más directa: abrís Chrome, Edge, Safari o Firefox, entrás a la dirección de tu negocio y elegís tu usuario con su PIN. No hay que instalar nada y todo lo demás funciona igual que en las otras dos opciones.

Los cuatro navegadores tienen soporte completo, pero hay dos diferencias prácticas que conviene conocer:

Chrome y Edge dan acceso a WebUSB y al puerto serie, que es lo que permite usar la impresora USB, la balanza por cable y el display LED.
Safari y Firefox funcionan bien para vender, consultar y cobrar, pero en los periféricos por cable no tienen acceso directo. En esos casos se usa el diálogo de impresión del sistema o se instala la PWA de escritorio.

Si tu flujo depende de la balanza por cable, del display LED o de la impresión USB directa, usá Chrome o Edge. Ver Notificaciones y pantalla y Pagos, facturación e impresión.

2) PWA (app instalable desde el navegador)

La PWA es la misma aplicación web, pero instalada. La diferencia práctica es que se abre sin barra de navegador, con su propio ícono, y queda habilitada para recibir notificaciones aunque tengas la app cerrada.

El nombre de la PWA es Instalar oPOS. La vas a encontrar en distintos lugares según el equipo:

Plataforma	Dónde aparece	Qué hacer
Android / Chrome	Banner Instalar oPOS, o el ícono de instalación en la barra de direcciones.	Tocá el botón Instalar.
iPhone / iPad	Botón Compartir de Safari.	Tocá Compartir y luego Agregar a pantalla de inicio.
macOS (Safari)	Menú Archivo.	Archivo → Agregar al Dock.
Windows / ChromeOS / Edge	Banner Instalar oPOS o el ícono de instalación.	Tocá Instalar.

En iOS el mensaje exacto que muestra oPOS es: “Tocá Compartir y luego ‘Agregar a pantalla de inicio’ para instalar la app.” En Safari de macOS, la vía es Archivo → Agregar al Dock.

Una vez instalada, la PWA aparece con su ícono junto a las demás apps del equipo. Se abre en su propia ventana y, en la mayoría de los dispositivos, mantiene la sesión abierta entre visitas.

Las notificaciones push solo llegan con la app cerrada si la PWA está instalada. Con la pestaña abierta en el navegador llegan igual, pero si cerrás la pestaña dejás de recibirlas. Ver Notificaciones y pantalla.

Los atajos de instalación

En algunos equipos, además del ícono de la PWA, oPOS ofrece accesos directos que apuntan directo a una pantalla:

Atajo	A dónde te lleva
Instalar oPOS	Instala la aplicación.
Ir al POS	Abre directo en el punto de venta.
Ver Dashboard	Abre directo en el panel de control.

Son útiles en una tablet del mostrador: con un toque al ícono Ir al POS ya estás vendiendo, sin pasar por la pantalla de acceso.

3) Aplicación de escritorio (oPOS Desktop)

oPOS Desktop es un programa que se instala en Windows y se abre como cualquier otra aplicación de escritorio. No es una copia reducida de oPOS: es el mismo sistema, pero con permisos de sistema que el navegador no puede dar.

Se instala con el instalador que entrega oPOS. Una vez instalada, se agrega al menú de inicio y aparece con su ícono.

Qué gana la app de escritorio

Estas tres capacidades solo existen en oPOS Desktop. Son la razón principal para instalarla en una caja.

Capacidad	En el navegador	En oPOS Desktop
Impresión por red (IP)	No disponible. Usás el diálogo de impresión del sistema o WebUSB.	Sí. El ticket va directo a la impresora WiFi o Ethernet por IP y puerto.
Caché y base local	Limitada, administrada por el navegador.	Sí. Guarda datos para trabajar con conexión inestable.
Licencia por equipo	No aplica.	Sí. Cada computadora se activa con una licencia propia.

Impresión por red (IP)

Es la diferencia más importante y la que más problemas resuelve. Con oPOS Desktop configurás la IP de la impresora y el puerto (casi siempre 9100), y el ticket sale solo, sin diálogos y sin depender del navegador.

En el navegador no hay forma de mandar un ticket directo a una impresora de red: o se usa el diálogo de impresión del sistema, que abre una vista previa y a veces imprime con el formato equivocado, o se usa WebUSB con una impresora conectada por cable.

El botón Probar impresión de red manda un ticket de prueba sin necesidad de hacer una venta. Es el primer paso cuando configurás una impresora nueva.

La impresión por red solo funciona en la app de escritorio. En web, la impresión usa el diálogo del navegador o USB. Ver Pagos, facturación e impresión.

Caché y base de datos local

La app de escritorio guarda en el equipo una copia local de los datos que necesita para trabajar: catálogo de productos, clientes, presupuestos y operaciones del turno. Eso permite seguir vendiendo con una conexión inestable, que es la diferencia entre una venta perdida y una venta que se registra dos minutos más tarde.

Licencia por equipo

Cada computadora que usa oPOS Desktop se activa con su propia clave. El modelo es una licencia por equipo, no una licencia por usuario: el mismo usuario puede entrar en tres computadoras distintas, pero cada computadora necesita su clave.

En Ajustes → Datos generales aparece el bloque OPOS Desktop con la opción Cambiar licencia desktop si necesitás vincular el equipo a otro local.

Licencia de escritorio

La primera vez que abrís oPOS Desktop, la app te pide una clave de activación antes de dejarte entrar.

Aspecto	Detalle
Formato	Tipo `OPOS-ABCD-1234`.
Cómo se escribe	En mayúsculas y sin espacios.
Qué hace si es correcta	El equipo queda activado para tu negocio.
Dónde se cambia	Ajustes → Datos generales → OPOS Desktop → Cambiar licencia desktop.
Quiénes la necesitan	Solo las computadoras con oPOS Desktop instalada. Navegador y PWA no piden clave.

La clave se escribe en mayúsculas y sin espacios. Un espacio pegado por accidente entre los bloques es la causa más común de que la activación no funcione. Si sigue rechazando la clave, revisá que no tenga guiones agregados ni espacios ocultos.

Cambiar la licencia de un equipo

Si vendiste el equipo, lo cambiaste de local o reinstalaste Windows, la clave vieja ya no corresponde. El camino es:

Entrá a Ajustes → Datos generales.
Buscá el bloque OPOS Desktop.
Tocá Cambiar licencia desktop.
Escribí la nueva clave, en mayúsculas y sin espacios.
Confirmá.

El equipo queda vinculado al local de la clave nueva. Si la clave es de otro negocio, oPOS no te deja activarla.

Ver la versión y buscar actualizaciones

Desde Ajustes → Datos generales → Mantenimiento de la App tenés dos acciones:

Acción	Qué hace
Actualizar estado	Te dice qué versión tenés instalada y si hay una nueva disponible.
Buscar actualizaciones	Busca una versión nueva y, si la hay, la descarga.

Conviene revisar el estado una vez por semana, sobre todo antes de un fin de semana largo o de un evento con mucha venta. Una versión actualizada es la que más problemas de conexión resuelve, porque cada mejora del modo offline se suma en la versión nueva.

Modo offline

El modo offline existe para una sola situación concreta: el internet se corta mientras estás vendiendo. No es para trabajar todo el día sin conexión, y no reemplaza una conexión estable.

La idea es simple: oPOS guarda la venta en el equipo, te deja seguir operando, y sube todo solo cuando vuelve la señal.

El modo offline es un respaldo de emergencia, no una modalidad de trabajo. Está pensado para un corte de internet de algunos minutos, no para operar el negocio entero sin conexión.

Qué funciona sin internet

Estas operaciones se ejecutan en el equipo y se sincronizan después:

Función	Qué pasa exactamente
Registrar ventas	Se guardan en el equipo y se sincronizan solas cuando vuelve la conexión.
Consultar el catálogo	Productos, clientes y presupuestos que ya habías cargado están en caché.
Abrir y cerrar turnos	Se puede abrir y cerrar un turno sin conexión.
Registrar movimientos de caja	Ingresos, retiros y transferencias entre cajas quedan registrados localmente.
Generar PDFs	Los comprobantes y reportes se generan en el equipo.
El POS sigue mostrando productos	La grilla funciona y el lector de códigos sigue agregando al carrito.

Qué NO funciona sin internet

Estas operaciones dependen de una respuesta del servidor y quedan sin efecto mientras no haya señal:

Función	Qué pasa
Entrar al sistema (login y PIN)	No se puede iniciar sesión sin conexión. Ver Qué vas a ver al entrar.
Cobrar con QR de Mercado Pago	Necesita generar y verificar el QR online.
Cobrar con terminal Point	La confirmación del cobro llega por webhook.
Verificar transferencias bancarias	La comparación del monto se hace con la cuenta conectada.
Emitir la factura electrónica en el momento	La factura se encola y se emite al volver la conexión.
Consultar datos fiscales de clientes en ARCA	La consulta de CUIT y condición de IVA es online.
Ver el panel de control y los reportes	No se cargan sin conexión. Ver Inicio y reportes.
Ver el historial de ventas	El historial se consulta en el servidor. Ver Ventas, devoluciones y clientes.
Cambiar la configuración	Los ajustes de Ajustes requieren conexión.
El catálogo público y los pedidos online	El link del catálogo y la lista de pedidos son online. Ver Catálogo online y entregas.
Recibir notificaciones nuevas	Los avisos push requieren conexión en el momento.

La factura electrónica es el caso que más confunde: la venta se registra igual y la factura queda encolada. Cuando vuelve la conexión se emite sola. Lo que no podés hacer es cobrar dos veces la misma venta creyendo que no se guardó.

Los indicadores de conexión

En la parte superior de la pantalla aparece un indicador que cambia según el estado. Son cinco estados y cada uno dice algo concreto:

Indicador	Qué significa
Sin conexión	La app sigue activa y guarda las ventas de forma local.
Sincronizando operaciones	Está subiendo lo pendiente.
Ventas pendientes	Hay N operaciones esperando para sincronizarse.
Sincronización completa	No queda nada por subir.
Error al sincronizar	Hubo un problema al sincronizar. Reintentando…

El que importa vigilar es Ventas pendientes con su número. Si ves Ventas pendientes: 3, sabés exactamente cuántas operaciones están todavía en el equipo y no llegaron al servidor.

El ciclo normal de un corte

Se corta internet. Aparece Sin conexión.
Seguís vendiendo. Cada venta queda en el equipo y el contador de pendientes sube.
Vuelve la conexión. Aparece Sincronizando operaciones.
oPOS sube todo y termina en Sincronización completa.

Si en el paso 4 no termina y aparece Error al sincronizar, el equipo sigue con operaciones locales. No cierres el turno ni apagues la computadora: oPOS reintenta solo.

Cuando vuelve la conexión

oPOS sube lo pendiente solo, sin que tengas que hacer nada, y lo hace en un orden fijo:

Orden	Qué se sube primero	Por qué en ese orden
1	Turnos y movimientos de caja	Son la base: sin el turno abierto no se puede asociar nada.
2	Ventas	Necesitan el turno al que pertenecen.
3	Cierre de caja	Depende de todas las ventas del turno.
4	Facturas pendientes	Se emiten al final, con los datos ya sincronizados.

El orden no es casual: es la única secuencia en la que cada cosa puede referenciar a la anterior. Por eso nunca te va a pedir subir las ventas antes que el turno.

Si no puede sincronizar, oPOS reintenta cada 10 segundos automáticamente. No hace falta que recargues la página ni que cierres y abras la app: dejalo quieto y el indicador te va a avisar cuando termine.

Limpiar caché

Cuando la app muestra datos viejos, o no toma una actualización que sabés que está disponible, el primer paso es limpiar la caché.

Dato	Detalle
Dónde	Ajustes → Datos generales → Mantenimiento de la App.
Botón	Limpiar Caché y Recargar App.
Confirmación	Sí, pide confirmación antes de borrar.
Qué hace	Borra la caché local y recarga la página.
Cuándo sirve	Datos viejos, una actualización que no se aplica, la app trabada después de un corte.
App de escritorio	Este paso ocurre automáticamente en cada arranque. No tenés que hacerlo a mano.

Limpiar la caché no borra datos de negocio: borra la copia local de la app. Tus ventas, productos y clientes siguen intactos en el servidor. Aun así, esperá a que termine la sincronización antes de hacerlo.

Cerrar sesión sin internet

Si intentás cerrar sesión cuando no tenés conexión, oPOS te avisa: “Conectate a internet para cerrar la sesión del equipo de forma segura.”

La sesión se mantiene hasta que haya conexión. No se cierra, no se pierde y no se bloquea el equipo.

Situación	Qué pasa
Intentás salir sin conexión	Aparece el aviso. La sesión sigue abierta.
La conexión vuelve después	Podés cerrar sesión normalmente.
Dejás el equipo sin cerrar sesión	El equipo queda con sesión activa hasta el próximo reinicio o cierre manual.

El motivo es de seguridad: cerrar sesión es lo que libera el equipo para que otra persona entre, y hacerlo sin conexión impide dejar registro de quién cerró y cuándo.

En resumen: cuál instalar

Situación de tu negocio	Qué instalás
Tablet o celular de mostrador, sin impresora	PWA desde el navegador.
Notebook con impresora USB	Navegador en Chrome o Edge, o PWA en Chrome.
Computadora con impresora WiFi o Ethernet	oPOS Desktop.
Tablet o celular con impresora Bluetooth	PWA. La impresión pasa por el diálogo del sistema.
Tablet o celular con impresora de red	La impresión por red no existe en el navegador: conectala por USB o Bluetooth, o usá una computadora con oPOS Desktop.
Internet inestable en el mostrador	oPOS Desktop, por la base local.
Equipos compartidos, sin datos guardados en el equipo	Navegador, y cerrá sesión al terminar.

Problemas frecuentes

Síntoma	Qué revisar
La app no toma una actualización	Limpiá caché y recargá, o reiniciá la app de escritorio.
Vendí sin internet y no aparece la venta	Sincronizá: la venta queda pendiente hasta que vuelva la conexión. Mirá el banner.
No me deja cerrar sesión	Necesitás internet. Es por seguridad, para no perder datos.
El QR no funciona sin internet	Necesita conexión. Cobrá en efectivo o transferencia manual.
¿Puedo usar dos computadoras?	Cada una necesita su propia activación. El administrador puede revocarlas.
La impresora por red no imprime	Esa función solo existe en la app de escritorio, no en el navegador.
No aparece el banner Instalar oPOS	En iOS el botón no existe: se instala desde Compartir → Agregar a pantalla de inicio.
La app quedó trabada después de un corte largo	Limpiar Caché y Recargar App en Ajustes, o reiniciá la app de escritorio.
Me pide la clave de licencia y no la tengo	Es la licencia de oPOS Desktop. Pedila a soporte o al administrador del negocio.
Vendí offline y el stock no se actualizó	El stock se descuenta en el equipo y se sincroniza junto con la venta. Revisá el indicador de pendientes.
La factura quedó sin emitir después de un corte	Es lo esperado: se encola y se emite al volver la conexión. Reintentá desde Ventas → Facturar si sigue pendiente.
Las notificaciones dejan de llegar	Con la pestaña cerrada en el navegador no llegan. Instalá la PWA. Ver Notificaciones y pantalla.