Instalar la Impresión directa en Mac

Qué hace

La Impresión directa es el programa de Cuentela que se instala en la computadora del mostrador y le pasa el ticket a tu impresora desde la caja del navegador. La caja instalada en la computadora (Mac o Windows) no la usa: imprime ella sola por cable o por red. Mientras no esté instalada, la caja del navegador imprime con su navegador.

En una Mac se instala con un archivo .pkg. Hay dos, uno por tipo de procesador: cuentela-impresion-directa-<versión>-macos-arm64.pkg para las Mac con chip Apple y cuentela-impresion-directa-<versión>-macos-amd64.pkg para las Mac con Intel. Cada uno sólo se deja instalar en su tipo de Mac, y los dos piden macOS 13 o más nuevo.

Lo que deja instalado:

• El programa, en /usr/local/libexec/cuentela/.
• Su arranque automático, en /Library/LaunchAgents/. Como queda ahí y no en tu carpeta personal, arranca para cualquier persona que entre a esa Mac.
• Una línea en /etc/hosts (127.0.0.1 local.cuentela.com), siempre. En Windows esa línea es opcional; aquí no. La pantalla de bienvenida del instalador la presenta como lo que permite que la impresión siga funcionando aunque se caiga el internet.

Cuando termina, enciende el programa para la persona que tiene la sesión abierta en ese momento. Si la Mac no tiene una sesión abierta, arranca al iniciar sesión. El programa no tiene ventana, y la instalación termina sin abrir ningún navegador.

Antes de instalar, el instalador apaga la Impresión directa que estuviera corriendo, para sustituirla sin dejar un programa viejo ocupando los puertos. Tu configuración se queda donde está, en ~/Library/Application Support/Cuentela/ImpresionDirecta.

Imprimir con la Impresión directa no tiene un candado de plan propio: va dentro de Mostrador, que es de paga.

Qué no hace

• No conecta la Mac con tu negocio. Instalarla deja el programa listo; la conexión se hace después desde la caja.
• No elige tu impresora. La impresora se escoge en la caja, después de conectar.
• No se instala en una Mac con macOS más viejo que el 13, ni en un disco que no sea el del sistema, ni te deja escoger qué partes instalar.
• No se instala el .pkg del otro tipo de procesador. El de chip Apple no se instala en una Mac Intel ni al revés.
• No tiene botón de desinstalar. macOS no trae desinstalador para este tipo de instalador; el de Cuentela es un script, desinstalar.sh, que se corre desde Terminal. La pantalla de bienvenida del instalador lo menciona: «Para desinstalarlo, usa desinstalar.sh».
• Desinstalarla no desvincula la Mac en el panel. Eso se hace con «Desvincular».
• No se actualiza sola. Cuando hay una versión más nueva se descarga y se instala encima.

Cómo se hace

Descargar el instalador (desde la caja, en la Mac donde cobras):

1. Abre la caja en esa Mac.
2. Pulsa «Configuración» (en pantallas angostas dice «Opciones») y entra a «Impresora».
3. Elige la tarjeta «Impresión directa».
4. La caja busca el programa en esta Mac y, si no lo encuentra, dice «No encontramos la Impresión directa en esta computadora». En «1. Descárgala, si todavía no la tienes en esta computadora», pulsa «Mac con chip Apple» o «Mac con Intel». La caja no puede saber cuál es tu Mac, por eso ofrece los dos. Para saberlo, abre el menú Apple y elige «Acerca de esta Mac»: si dice «Apple M1/M2/M3/M4» es chip Apple; si no, es Intel. Si bajas el que no es, el instalador no te deja instalarlo. Esos botones se ven mientras esta caja no esté conectada con ninguna Impresión directa y el programa no conteste en esta Mac: si ya está abierta, la caja dice «Impresión directa 0.4.2 lista en esta computadora» y sólo falta conectarla.

Instalarla:

1. Abre el .pkg que bajaste. La pantalla de bienvenida dice qué se instala: el programa, su arranque automático y la línea de /etc/hosts.
2. Sigue el instalador. Como escribe en carpetas del sistema, el instalador corre con permisos de administrador.
3. Al terminar, no se abre ningún navegador. Vuelve a la caja y conéctala con tu negocio: conectar la Impresión directa con tu caja.

Desinstalarla: el script desinstalar.sh se corre con sudo. Sin opciones quita el programa, su arranque automático y la línea de /etc/hosts, y deja tu configuración. Con --con-datos borra también la configuración de cada usuario de la Mac, y después hay que volver a conectarla. El script no viene en los botones de descarga de la caja, que sólo ofrecen el instalador: pídeselo a Cuentela. Antes de desinstalar, si la Mac se va a otra parte, entra a Mostrador, pestaña «Cajas y equipos», sección «Impresión», abre «Detalles técnicos» en la tarjeta de esa computadora, pulsa «Desvincular» y confirma con «Sí, desvincularla». Ese botón lo ve la persona dueña o quien tiene el permiso «Monta y configura cajas».

Qué pasa si…

…el instalador se cancela porque la instalación no es segura. El script de instalación escribe «la instalación NO es segura y se cancela». Antes de arrancar, el instalador revisa que /usr, /usr/local, /usr/local/libexec, la carpeta del programa, /Library, /Library/LaunchAgents y los dos archivos que instala sean de root, no se puedan escribir por grupo ni por otros y no sean enlaces simbólicos. Si alguno falla, cancela, porque el programa arranca con la identidad de quien entra a la Mac y un administrador podría cambiarlo para todos los demás. Lo habitual es /usr/local en una Mac con Intel que usa Homebrew. Si ése es tu caso, escribe a Cuentela antes de cambiar esos permisos: según el propio instalador, cambiarlos le rompe brew.

…la Mac no tiene una sesión abierta al instalar. El programa arranca la próxima vez que se inicie una sesión.

…cierro la Impresión directa desde su página local. El botón «Cerrar la impresión directa» avisa que los tickets dejarán de salir solos hasta que la vuelvas a abrir. Si la cierras tú a propósito, no se enciende de nuevo sola hasta el siguiente inicio de sesión; si se cae por un error, la Mac la levanta otra vez.

…entran dos personas a la misma Mac. El arranque es para cualquier persona que entre, y cada una tiene su propia configuración en su carpeta. Si otra sesión ya tiene la Impresión directa abierta, la página local avisa: «Otra sesión de este equipo ya tiene abierta la impresión directa; ésta usa otros puertos.».

…la caja dice «Tu Mac no tiene ninguna impresora configurada». El mensaje completo es «Tu Mac no tiene ninguna impresora configurada. Conéctala, ábrela en Ajustes del sistema > Impresoras y escáneres y vuelve aquí.». Si la Impresión directa está conectada pero no ve ninguna, la lista para escoger tu impresora dice «Este aparato no ve ninguna impresora. Conéctala y dala de alta en su sistema.».

…la caja dice que macOS necesita tu permiso. El mensaje es «macOS necesita tu permiso para hablar con la impresora. Abre Ajustes del sistema > Privacidad y seguridad > Red local y activa “Impresión directa de Cuentela”.». Pasa con las impresoras de red: macOS 15 pide ese permiso por aplicación y por usuario, y un programa que arranca solo no siempre recibe la pregunta. El programa lo reconoce cuando la conexión falla en menos de 50 milisegundos, y es un diagnóstico por indicios: si se equivoca, el aviso sólo te manda a comprobar el permiso.

…ya tenía una versión anterior. El instalador la apaga antes de copiar la nueva y tu configuración se queda; la caja sigue conectada.

…quito la Impresión directa y no la desvinculo. En el panel la computadora sigue vinculada hasta que pulses «Desvincular». Al desvincular, si alguna caja imprimía por esa conexión, pasa a imprimir con el navegador hasta que la vuelvas a configurar, y no se puede deshacer: para volver a usarla hay que conectarla de nuevo.

Relacionados

• 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.
• Instalar la Impresión directa en Windows — Cómo se descarga e instala en Windows el programa que le pasa el ticket a tu impresora, sin permisos de administrador, con una casilla opcional para imprimir aunque se caiga el internet, y cómo se quita.
• 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.
• No sale el ticket: qué dice cada mensaje y qué hacer — Qué significa cada aviso de «no salió» en la caja (con la Impresión directa, en el navegador; por cable o por red, en la instalada), en qué orden revisar la impresora, la computadora y la conexión, y cómo recuperar el ticket de una venta ya cobrada.
• 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.