La caja en el navegador, instalada o en escritorio: qué cambia en impresión, llave, red local y sin internet

Qué hace

La caja es una sola aplicación de Flutter. La misma aplicación corre de cuatro maneras: en una pestaña del navegador, instalada desde el navegador como aplicación, como aplicación en una computadora (Mac o Windows) y en un teléfono o una tableta. Casi todo es el mismo código en todas; sólo cambian las piezas que dependen del equipo. Esto es lo que cambia:

• Cómo se dice que corre. En «Acerca de esta caja» (en «Configuración») hay una línea que dice «Aplicación instalada en este equipo» (aplicación de computadora o de teléfono), «Instalada como aplicación · tiene su propia ventana» (navegador, abierta como aplicación) o «En una pestaña del navegador · se puede cerrar sin querer».
• Dónde guarda los datos. En la aplicación de computadora y de teléfono la base de la caja es un archivo del sistema, que nadie desaloja. En el navegador es un nombre dentro del almacenamiento del sitio, y el navegador puede desalojarlo cuando le aprieta el espacio; la caja le pide que no lo haga y en «Acerca de esta caja» dice si lo concedió.
• Impresión. El cuadro de imprimir del sistema está en todos los equipos. «Impresión directa» se ofrece sólo en la caja del navegador: es el programa que se instala en la computadora para que una pestaña pueda imprimir por cable o por red. La caja instalada en una computadora (Mac o Windows) ni la ofrece ni la necesita, porque manda ella misma el ticket a la impresora (si traía guardada la Impresión directa, pasa sola a lo mismo sin ella), y en un teléfono o una tableta tampoco existe. «Impresora de tickets por cable» se ofrece en la computadora (la impresora dada de alta en el sistema) y en la caja instalada en un teléfono o una tableta Android («La que conectas a este aparato con un cable USB (OTG)», lee imprimir por cable USB desde la tableta); en iPhone y iPad sale apagada, porque iOS no deja a una app hablarle a una impresora USB, y en el navegador también. «Impresora de tickets por Bluetooth» se ofrece en el teléfono y la tableta (Android, iPhone y iPad): en Android es «La que emparejaste con este teléfono» y en iPhone y iPad «La que la caja encuentra cerca de este aparato» (lee imprimir por Bluetooth desde el teléfono); en la computadora y en el navegador no sale. «Impresora de tickets en la red» se ofrece en la computadora y en el teléfono, que le hablan solos a la impresora por su dirección IP, pero no en el navegador, que no puede hacerlo: ahí lo hace «Impresión directa». La caja abierta en el navegador de un celular o de una tableta es «navegador» para todo esto: le aparece «Impresión directa», pero ahí no hay dónde instalarla, así que su ticket sale por el cuadro de imprimir del aparato. En la caja instalada en una computadora, una tableta o un teléfono, «Buscar impresoras» encuentra la impresora de red sin escribir su dirección; en el navegador no se ofrece.
• La llave de la caja. En el navegador es una llave de WebCrypto que no se puede exportar, guardada en el almacén del navegador; las credenciales y la sesión van en la base local. En Mac, iPhone, iPad y Android la llave y los secretos van en el llavero del sistema. En Windows no hay adaptador al llavero del sistema: la llave de firma se guarda en la base local.
• Cobrar sin internet. Depende del negocio, del equipo y de un permiso. Sin turnos ni PIN, el permiso es la sesión de quien abrió la caja, en cualquier equipo: 7 días sin conectarse si entró la persona dueña, 24 horas si entró otra. Con cajeros con turno y PIN es un permiso firmado; sin él, sólo una Mac o un aparato con iOS se acreditan para cobrar sin internet, y Windows, Android y el navegador no. En el navegador, con cualquier permiso, sólo si guarda las ventas de forma que no se pierdan al cerrar la pestaña.
• Red local. Sólo la caja instalada en una computadora puede ser el nodo que atiende a las tabletas y al kiosko. En el navegador y en un teléfono o una tableta, la pantalla «Red local» no trae controles: dice «Aquí no se puede armar» y explica por qué. Lee red local de la caja.
• La dirección con que entras. En el navegador, la dirección puede traer el negocio, la ventana (el papel) y el local. La aplicación instalada no tiene dirección de entrada.
• Pantalla completa. En una computadora siempre se puede pedir; en el navegador, sólo donde el navegador la concede.
• Cómo se pone al día. En el navegador, sola, y con turno abierto espera al cierre. En el teléfono y la tableta, desde su tienda. La instalada en una computadora, sola y en un momento sin uso (10 minutos sin que nadie la toque, si no hay turno), desde la 1.41.21. «Cocina» y «Tomar el pedido» sin turno cuentan como caja sin turno: no esperan a ningún cierre, y al volver siguen con su permiso, su papel y la memoria de lo que ya imprimieron. Lee la caja de Windows se actualiza sola y la caja de Mac se actualiza sola. Una más vieja se instala una vez a mano con su instalador nuevo.
• La pantalla encendida. Con el turno abierto, la pantalla del aparato no se apaga sola; en el navegador, si el navegador lo permite. Lo mismo en «Cocina» y «Tomar el pedido» trabajando sin turno con el permiso de la caja. Con el turno cerrado vuelve a apagarse como siempre. El bloqueo de la propia caja, con el PIN de quien cobra, no cambia.
• «Atrás» en el teléfono o la tableta. El gesto o el botón «atrás» nunca cierra la caja: desde «Configuración» regresa a la pantalla donde cobras, y en esa pantalla no hace nada. Las hojas se cierran con «atrás»; la de cobro, si ya repartiste pagos, pregunta antes «¿Dejar el cobro?».
• Girar el aparato. La caja instalada en un teléfono va sólo en vertical. La tableta gira libre, y en el iPad la caja ocupa siempre la pantalla entera, sin pantalla dividida.
• Entrar con Google. En la pantalla de entrada, «Continuar con Google» va arriba de «Teléfono o correo», cuando el acceso con Google está encendido. En la caja de computadora (Mac o Windows) abre tu navegador: eliges ahí tu cuenta de Google y la caja sigue sola; mientras, dice «Sigue en el navegador», con «Cancelar». En el navegador te lleva a la pantalla de entrada de Cuentela: eliges tu cuenta de Google y te regresa a la caja, que entra sola, sin dejar abierto el panel en ese navegador. Si algo falla, dice «No se pudo entrar con Google. Vuelve a intentarlo, o entra con tu teléfono o tu correo.». En la caja instalada en un iPhone, un iPad o un Android se abre encima de la caja la hoja de cuentas de Google del propio aparato: eliges tu cuenta y la caja entra sola; si cierras la hoja, sigues en la pantalla de entrada como si nada.

Qué no hace

• La caja del navegador no habla con la impresora por cable ni con la de red por su cuenta. Para eso hace falta «Impresión directa» instalada en la computadora, o el cuadro de imprimir del sistema.
• La caja del navegador no puede ser el nodo de la red local. Una pestaña no abre puertos ni presenta certificados: dice «Sin red local · esta caja no la necesita» (en el navegador de un teléfono o una tableta, «Esta caja no reparte la red local») y sigue vendiendo.
• Con turnos y PIN, la caja del navegador no cobra sin internet por sí sola. Sin permiso firmado vigente se bloquea al perder la conexión («Se perdió la conexión con Cuentela… Sin conexión esta caja no cobra») y dice por qué, por ejemplo «No cobra sin internet porque falta revisar y firmar esta caja en el panel.». Sin turnos cobra con la sesión de quien la abrió. En los dos casos necesita guardar las ventas de forma durable.
• Con turnos y PIN, la caja de Windows y la de Android no cobran sin internet sin permiso firmado, como sí lo hacen la de Mac y la de iOS. Sin turnos, todas cobran con la sesión de quien la abrió.
• La aplicación instalada no mide el espacio ni muestra «Queda poco espacio en este equipo». Eso es del navegador.
• Google no abre turnos ni cambia el código de cada persona. Sirve para entrar con tu cuenta, en el mismo lugar donde entras con tu teléfono o tu correo; los turnos y el código de cada quien siguen igual.
• La caja instalada en una computadora no se recarga. La pantalla «La caja tropezó» trae «Recargar la caja» sólo en el navegador; en una computadora dice «Cierra la caja y vuelve a abrirla.»

Cómo se hace

Saber si tu caja corre en una pestaña o instalada:

1. Abre «Configuración» (el botón de la banda; en una barra angosta dice «Opciones»).
2. Lee «Acerca de esta caja»: la tercera línea dice cómo corre y la quinta, dónde guarda los datos y si el navegador los protege.

Instalarla desde el navegador:

1. Si la caja corre en una pestaña y el navegador guardó su oferta de instalación, la banda de Mostrador y de Cobro y entrego trae «Instálala en este equipo: tendrá su propia ventana» (en una barra angosta, «Instalar»). Púlsala.
2. Si aceptas, la caja dice que la abras desde su icono y que tendrá su propia ventana. Si la rechazas, deja de ofrecerse en esta visita.
3. Si el navegador negó guardar los datos y la caja sigue en una pestaña, la banda avisa que ese navegador puede borrarla si pasa una semana sin abrirla, y con ella lo que no haya subido, y explica cómo instalarla: en Safari, Archivo → Añadir al Dock; en Chrome, el icono de instalar en la barra de direcciones.

Entrar a la caja con Google:

1. En la pantalla de entrada de la caja, pulsa «Continuar con Google», arriba de «Teléfono o correo».
2. En la caja de computadora se abre tu navegador: elige ahí tu cuenta de Google. La caja dice «Sigue en el navegador» y, cuando terminas, entra sola. Si te arrepientes, pulsa «Cancelar».
3. En la caja del navegador vas a entrar al panel: elige tu cuenta de Google ahí. Al volver a la caja, pulsa «Entrar como…» con tu nombre.
4. En la caja del teléfono o la tableta se abre la hoja de cuentas de Google del aparato, encima de la caja: elige tu cuenta y la caja entra sola. Si la cierras, no pasa nada: sigues en la pantalla de entrada.

Ver por dónde puede salir el ticket en este equipo:

1. En «Configuración», toca «Impresora».
2. Los caminos que este equipo no puede usar salen apagados, con su razón a la vista.

Qué pasa si…

…al cobrar o al canjear, la caja dijo «La caja estaba guardando otra cosa al mismo tiempo y no se pudo. Vuelve a intentarlo: lo que ya estaba guardado sigue ahí.». Dos cosas quisieron guardar a la vez en la base de la caja; pasa, sobre todo, en la computadora que además atiende a las tabletas del local. No se perdió nada: vuelve a intentarlo. Una caja actualizada espera su turno hasta cinco segundos antes de rendirse, así que casi no sale; una más vieja enseñaba en su lugar un error en inglés con «database is locked».

…la caja del navegador dice «Esta sesión es del panel, no de la caja. Vuelve a entrar aquí para cobrar.» La caja ya no cobra con la sesión de tu panel: necesita la suya. Entra ahí otra vez, con tu código, tu contraseña o Google, y sigue cobrando. Tu panel no se cierra por eso.

…en Windows toco el ícono de la caja y ya estaba abierta. Desde la 1.41.17, la caja que ya está abierta en tu sesión de Windows pasa al frente y no se abre otra. Así no quedan dos cajas sobre la misma base que se quiten la sesión una a la otra al poner el PIN; la que atiende a las tabletas dejaría de mandar a cocina.

…la caja de computadora se quedó en «Sigue en el navegador». Termina de elegir tu cuenta en el navegador, o pulsa «Cancelar». Si pasan 5 minutos sin respuesta de Google, la caja deja de esperar y dice «Pasaron 5 minutos sin respuesta de Google. Vuelve a intentarlo, o entra con tu teléfono o tu correo.».

…no aparece «Continuar con Google». El acceso con Google no está encendido en el servidor, o la caja corre en un iPhone o un iPad y Cuentela todavía no tiene listo su acceso con Google para esa caja (en Android sí aparece). Si el panel ya tiene una sesión abierta en ese navegador, en su lugar sale «Entrar como…». Entra con tu teléfono o tu correo y el código.

…en el teléfono dice «No pudimos abrir tu cuenta de Google. Vuelve a intentarlo, o entra con tu teléfono o tu correo.» La hoja de Google del aparato no entregó tu cuenta (sin internet, o Google no la reconoció). Vuelve a pulsar «Continuar con Google»; si sigue igual, entra con tu teléfono o tu correo y el código.

…quiero cobrar con el celular como en la caja, abriendo la caja en el navegador del celular o de una tableta, con el lector. Se puede: es la misma caja y el navegador del celular la abre igual que el de la computadora. La app del negocio no es la caja; la caja se abre aparte. Abre el enlace que copias en el panel (Mostrador › «Preparar una caja», en el renglón «Caja», «o sólo el enlace»), entra con tu cuenta y sigue «Configurar esta caja» eligiendo «Mostrador». Queda como otra caja del local. En un teléfono el catálogo ocupa la pantalla y abajo va fija la barra con el total y «Cobrar» (tócala para ver «La cesta»); en una tableta angosta el catálogo va arriba y «La cesta» abajo. «Configuración» se llama «Opciones» y los demás botones van en «Más». Se cobra igual. Lo que cambia en el celular:

• Lector: la caja oye cualquier lector que el aparato reciba como teclado y que cierre con Intro, por cable o inalámbrico; en el celular, empareja el tuyo como teclado. No hace falta tocar el buscador: el lector se oye sin que se abra el teclado de la pantalla. Si no tienes lector, el botón con la cámara, dentro del buscador a la izquierda, lee el código de barras de tus productos (la caja instalada en Windows no lo ofrece); el QR de la app de tu cliente se lee en «Leer código del cliente».
• Ticket: sólo por el cuadro de imprimir del aparato; «Impresión directa» aparece, pero es un programa de computadora.
• Sin internet: no cobra sin su permiso, y en una pestaña el navegador puede borrarla si pasa una semana sin abrirla.
• Con cajeros con turno y PIN: se revisa en el panel como cualquier caja nueva, y con turno abierto se bloquea al cambiar de aplicación o al apagarse la pantalla, salvo con permiso vigente para cobrar sin internet.

Lee qué se hace en el teléfono y qué en la computadora.

…en el navegador quiero usar la impresora por cable o la de red. Esos caminos salen apagados. Por cable: «Desde el navegador la caja no puede usar la impresora que tienes por cable: eso lo hace «Impresión directa», el programa que se instala en esta computadora. Instálalo aquí arriba y la eliges de su lista.» Por red: «Desde el navegador la caja no puede hablarle sola a la impresora de red. Lo hace «Impresión directa»: instálala en esta computadora y pon ahí su dirección.» Lee conectar la Impresión directa con tu caja.

…en un teléfono o una tableta quiero «Impresión directa». Sale apagada: «La Impresión directa es un programa de computadora y en un teléfono no hay dónde instalarlo. Manda el ticket a tu impresora por su dirección IP o por Bluetooth.» La impresora por cable, en cambio, sí se ofrece en Android: es la que conectas a la tableta con un cable USB (OTG). En iPhone y iPad sale apagada: «En iPhone y iPad la caja no imprime por cable: iOS no deja a una app hablarle a una impresora USB. Manda el ticket a tu impresora por su dirección IP o por Bluetooth.» Si la caja traía guardada una impresora dada de alta en una computadora, la pantalla «Impresora» del teléfono o la tableta dice que ahí no existe y se abre con el cuadro de imprimir.

…en la caja instalada del teléfono no sé la dirección IP de mi impresora. En «Impresora», elige «Por red (dirección IP)» y pulsa «Buscar impresoras»: toca la tuya y se escriben solas su dirección y su puerto. Lee agregar una impresora de red.

…giro el teléfono y la caja no gira. Es a propósito: en horizontal no caben el catálogo, la cesta y «Cobrar». En una tableta sí gira.

…con el turno abierto la tableta ya no se apaga sola. Es a propósito: así no hay que desbloquear el aparato cada vez que se pausa la fila. Al cerrar el turno vuelve a apagarse sola. Si te alejas, la caja se bloquea con su PIN como siempre. La tableta en «Cocina» o «Tomar el pedido» sin turno tampoco se apaga mientras trabaja con el permiso de la caja, y ahí no hay candado: la pantalla de la cocina no se apaga a media jornada.

…una caja configurada en la computadora se abre en el navegador. Si lo que tenía guardado como destino del ticket no existe en el navegador, la pantalla «Impresora» no se abre en ese destino: se abre con el cuadro de imprimir del sistema, que siempre está, y dice por qué lo cambió.

…una caja configurada en un teléfono se abre en la computadora, en el navegador o en un teléfono del otro sistema. La impresora Bluetooth que eligió un Android sólo sirve en Android, y la que eligió un iPhone o un iPad sólo en iPhone y iPad; la impresora USB de una tableta Android, sólo en Android. En los demás equipos el renglón «Impresora» de «Configuración» dice «Falta elegir la impresora de este equipo» y el asistente, «elegiste impresora de tickets, pero falta decir cuál»: entra a «Impresora» y elige la de ese equipo. De un iPhone o iPad a otro la caja no lo nota: la sigue nombrando, y el primer ticket dice «Este aparato ya no encuentra la impresora «…»…»; antes de cobrar, pulsa «Buscar impresoras Bluetooth» en «Impresora» y «Guardar».

…la caja del navegador no cobra sin internet. La fila «Cobrar sin internet» de Configuración dice por qué. Sin turnos, dice hasta cuándo cobra, por ejemplo «Cobra sin internet hasta el 15 de octubre a las 18:04 · sin turnos, con la sesión de quien la abrió; cada vez que se conecta se le renueva», o que ya no, por ejemplo «No cobra sin internet · pasó demasiado tiempo sin conectarse: conéctala para que se renueve». Con turnos y sin permiso en mano, dice «Sin permiso para cobrar sin internet · …» con el motivo, por ejemplo «todavía no recoge su permiso para cobrar sin internet». Si el navegador no guarda las ventas de forma durable, dice «No cobra sin internet · este navegador no guarda las ventas: se perderían al cerrar la pestaña · para cobrar sin conexión, usa la app de Cuentela Caja instalada en la computadora». Con turnos y PIN, sin conexión el PIN sólo se comprueba si la caja puede cobrar sin internet: lee bloquear la caja y volver con tu PIN y vender sin internet.

…el negocio le quitó el cobro sin internet a la caja. Vale en cualquier equipo, aunque sea una Mac: la fila dice «Necesita internet · el negocio le quitó el cobro sin internet».

…el navegador se queda sin espacio. En el navegador, «Configuración» puede mostrar «Queda poco espacio en este equipo»: el navegador hace sitio borrando datos de sitios web, y los de esta caja entran en el lote, así que se irían las ventas que todavía no llegaron al servidor. Lee configuración de la caja.

Relacionados

• Configuración de la caja: nombre, llave, «Acerca de esta caja» y volver a configurar — Qué trae la pantalla «Configuración» de la caja (nombre, llave, papel, impresora, red local, cobrar sin internet, negocio, modo, volver a configurar, aviso de poco espacio, «Acerca de esta caja» y salir de la cuenta), qué hace cada renglón y qué no se pierde al usarlos.
• Red local de la caja: aceptar tabletas y el kiosko «hay / no hay» — Cómo una caja instalada en una computadora del local atiende a las tabletas del mesero y a los kioskos: aceptar y quitar aparatos, lo que enseña el kiosko («hay / no hay», nunca la cifra), el libro de la LAN, qué le pide la tableta a la caja (la pre-cuenta en papel), cómo sale UNA hoja de cocina de la comanda que manda la tableta (también con dos computadoras, con «Esta caja saca la hoja de lo que mandan las tabletas») y qué dice la caja si no sale, y qué pasa con las tabletas si otra computadora del local toma el lugar de la caja, cómo saber si las computadoras ya se pasaron la lista y cuál vinculó cada aparato.
• Imprimir el ticket y conectar la Impresión directa — Dónde se escoge la impresora de tickets de cada caja, cómo se prueba y para qué sirve la Impresión directa, que es para la caja del navegador.
• Qué impresoras sirven con Cuentela — Qué lenguajes habla Cuentela con las impresoras de tickets y de etiquetas, por dónde las alcanza en cada equipo, qué ajustes tienes para el rollo y los acentos, y qué hacer si el ticket sale con símbolos raros o cortado de los lados.
• Conectar la Impresión directa con tu caja — Cómo se conecta, con un clic o con un código de 8 caracteres, la Impresión directa instalada en una computadora con la caja del navegador que cobra ahí (la caja instalada en la computadora no la usa), quién puede hacerlo y qué pasa si ya estaba conectada.
• Vender sin internet y lo que pide tu atención — Qué sigue funcionando en la caja cuando se va el internet, qué no, y cómo revisas en el panel lo que se cobró sin señal.
• Bloquear la caja y volver con tu PIN: qué pasa con la venta a medias — Cuándo se bloquea la caja con turnos y PIN (a mano, por inactividad, al pasar a segundo plano y en otros casos), qué se queda detrás de «Pantalla bloqueada» y cómo se vuelve con el PIN, con y sin internet.
• Preparar una caja nueva u otra computadora — La caja nace en el aparato que va a cobrar (computadora, tableta o teléfono), cuando alguien del negocio entra ahí. Desde el panel eliges el local, mandas las instrucciones o la abres en esta misma computadora.
• Los papeles de la caja: Mostrador, Cobro y entrego, Pedidos y comandas, Tomar el pedido, Cocina y Verificador de precios — La caja es una sola aplicación y cada pantalla toma uno de seis papeles. Qué hace cada uno, qué herramienta del negocio y qué permiso pide, por qué un papel sale apagado y a quién pedírselo.
• La banda de la caja: «Todo mandado», «Sin internet · sigue cobrando» y los demás avisos — Qué dice cada aviso de la banda de arriba de la caja —«Todo mandado», «Con internet», «Sin internet · sigue cobrando», lo guardado por mandar, «Hay algo que revisar», el permiso para cobrar sin internet y los demás—, en qué orden salen y qué hacer con cada uno.