Impresión de etiquetas Zebra

Arregio soporta impresión directa a impresoras Zebra (ZD410, ZD620, ZP450 y modelos compatibles) usando ZPL nativo vía el agente oficial Zebra Browser Print (ZBP). Con ZBP instalado, hacer clic en Imprimir etiqueta dispara la impresión con un solo clic; sin ZBP, Arregio cae automáticamente a un fallback en PDF que requiere confirmar el diálogo del navegador.

Esta guía cubre instalación, configuración y troubleshooting para Windows y macOS.

¿Por qué instalar Zebra Browser Print?

La diferencia de experiencia es grande cuando imprimes varias etiquetas al día:

Para talleres que imprimen decenas de etiquetas al día, ZBP es prácticamente obligatorio. Para uso esporádico, el fallback PDF alcanza.

Requisitos

• Impresora Zebra conectada por USB o red local.
• Driver oficial de Zebra (ZDesigner, no el driver genérico "Text Only").
• Windows 10/11, macOS 10.14 o superior, o Linux (Ubuntu 20+).
• Navegador Chromium (Edge, Chrome, Brave) actualizado.

Paso 1: Instalar el driver Zebra (ZDesigner)

1. Entra a la página de soporte de Zebra para tu modelo de impresora:
   • ZD410
   • ZD620
   • Para otros modelos, busca en zebra.com/support-downloads.
2. Descarga el ZDesigner Printer Driver para tu sistema operativo.
3. Ejecuta el instalador y sigue el asistente. Selecciona el modelo exacto de tu impresora (ZD410, ZD620, etc.).
4. Al terminar, verifica en Panel de control → Dispositivos e impresoras (Windows) o Ajustes → Impresoras (macOS) que aparezca algo como ZDesigner ZD410-203dpi ZPL.

Paso 2: Instalar Zebra Browser Print

1. Entra a Zebra Printer Setup Utilities y filtra por Software Utility → Browser Print.
2. Descarga el instalador para tu sistema operativo (aproximadamente 5 MB):
   • Windows: archivo .msi.
   • macOS: archivo .dmg.
3. Ejecuta el instalador y acepta los defaults. Al finalizar, Zebra Browser Print arranca como servicio en segundo plano.
4. Verifica que esté corriendo: abre https://localhost:9101/available en tu navegador. Debes recibir un JSON con la lista de impresoras Zebra detectadas. La primera vez el navegador va a pedir que aceptes un certificado autofirmado; acéptalo (es esperado).

Paso 3: Configurar Zebra Browser Print (elegir impresora por defecto)

Si tienes una sola Zebra conectada, ZBP normalmente la detecta sin configuración extra. Si tienes más de una o si Arregio no detecta la impresora, haz esto:

1. Clic en el ícono de Zebra Browser Print en la bandeja del sistema (Windows) o en la barra superior (macOS).
2. Entra a Settings → Default Devices.
3. Selecciona tu impresora Zebra y márcala como Default.
4. Cierra y vuelve a abrir el panel para confirmar que quedó guardada.

Esto hace que el endpoint /default de ZBP devuelva tu impresora correctamente, lo cual es el path rápido que usa Arregio.

Paso 4: Configurar el tamaño de etiqueta

En Windows:

1. Abre Panel de control → Dispositivos e impresoras.
2. Clic derecho sobre tu Zebra → Preferencias de impresión.
3. Ajusta el tamaño del rollo al que cargaste (por ejemplo, 2×1 pulgadas = 50.8 × 25.4 mm, que es el default de Arregio).
4. Deja velocidad y densidad en los valores recomendados por Zebra, a menos que tengas una razón específica para cambiarlos.
5. Guarda.

En macOS:

1. Abre Ajustes del sistema → Impresoras y escáneres.
2. Selecciona tu Zebra → Opciones y suministros → Utilidad.
3. Configura el tamaño del rollo desde ahí.

También puedes ajustar el tamaño desde Arregio en Configuración → Impresión, donde podés seleccionar el formato de etiqueta que usa tu taller.

Paso 5: Probar desde Arregio

1. Entra a una orden existente en Arregio.
2. Clic en el botón Imprimir etiqueta.
3. La primera vez, el navegador va a pedir permiso para conectarse a localhost:9101. Acepta con Permitir y marca Recordar decisión si la opción aparece.
4. La etiqueta sale automáticamente por la Zebra sin mostrar el diálogo de impresión del navegador.

Si no sale la etiqueta, revisa la sección Troubleshooting más abajo.

Paso 6: Quitar el badge "No seguro" (opcional)

Cuando Arregio se conecta a https://localhost:9101, el navegador detecta el certificado autofirmado de ZBP y degrada el indicador de seguridad de app.arregio.com a "No seguro" (badge rojo en la barra de direcciones). Esto es cosmético, no afecta la funcionalidad ni la seguridad real de la aplicación.

El certificado de Zebra Browser Print es autofirmado por diseño: ninguna autoridad pública puede emitir un certificado válido para localhost, porque cada máquina tiene su propio localhost. La solución es instalar el certificado de Zebra como autoridad raíz confiable en tu máquina.

Si el badge "No seguro" no te molesta o tu empresa no tiene políticas estrictas al respecto, podés saltarte este paso: la impresión funciona igual.

6.1. Descargar el certificado de Zebra

1. Abre Edge, Chrome o Brave.
2. Ve a https://localhost:9101/ssl_support.
3. Zebra muestra una página con un botón o link para descargar el Zebra Root CA.
4. Guarda el archivo .crt (o .cer) en tu disco.

6.2. Instalar en Windows 10/11

1. Doble clic sobre el archivo .crt descargado.
2. Clic en Instalar certificado.
3. Elige Equipo local (no "Usuario actual") y dale Siguiente. Si Windows pide permisos de administrador, autorizá.
4. Selecciona Colocar todos los certificados en el siguiente almacén, clic en Examinar, elige Entidades de certificación raíz de confianza y clic en Aceptar.
5. Siguiente → Finalizar.
6. Windows va a pedir que confirmes la instalación de un root certificate. Acepta (es legítimo, viene de Zebra).

6.3. Instalar en macOS

1. Doble clic sobre el archivo .crt → se abre Keychain Access.
2. Agrégalo al keychain System.
3. Doble clic sobre el certificado ya agregado → expande Trust → When using this certificate → selecciona Always Trust.
4. Cierra la ventana. macOS pide tu contraseña para confirmar.

6.4. Reiniciar el navegador

Cierra todas las ventanas del navegador y vuelve a abrir. El badge "No seguro" ahora debe cambiar a "Seguro" (candado) en app.arregio.com.

Notas importantes

• El certificado se instala por máquina, no por cuenta. Si una sucursal tiene 3 PCs que imprimen etiquetas, hay que instalarlo en las 3.
• Si cambias de máquina (reinstalación de Windows, PC nueva), hay que repetir el proceso.
• Al actualizar ZBP, en casos raros puede regenerar el certificado. Si el badge vuelve a "No seguro" después de una actualización, repetí los pasos.

Troubleshooting

Error: "No se detectó Zebra Browser Print"

Causa: El servicio ZBP no está corriendo o no se puede alcanzar.

Solución:

• Windows: abre Services.msc, busca "Zebra Browser Print" y verifica que esté en estado Running. Si no, hacé clic derecho → Start.
• macOS/Linux: ejecutá ps aux | grep -i zebra en una terminal. Debe aparecer al menos un proceso.
• Abre https://localhost:9101/available en el navegador. Si no responde, reinstala ZBP.
• Si aparece el aviso de "Sitio no seguro", acepta el certificado autofirmado (Arregio lo maneja de forma transparente una vez aceptado).

Error: "Impresora no encontrada" o /default no devuelve nada

Causa: ZBP no tiene una impresora marcada como default, o la Zebra está apagada/desconectada.

Solución:

• Confirma que la Zebra esté encendida, con papel cargado y conectada por USB o red.
• Abre el panel de ZBP → Settings → Default Devices y marca tu Zebra como default (ver Paso 3).
• Reinicia el servicio de ZBP desde el panel o desde Services.msc (Windows).

La etiqueta sale en blanco o con barras raras

Causa: Driver incorrecto o rollo mal cargado.

Solución:

• Verifica que el driver sea ZDesigner XXX ZPL (no EPL ni Text Only).
• Abre la Zebra y reinstala el rollo, asegurándote de que esté bien alineado.
• Corre un test de impresión desde el propio driver (Preferencias de impresión → Probar impresión) para descartar problema de hardware.

La etiqueta sale con tamaño equivocado

Causa: El tamaño configurado en Arregio no coincide con el rollo físico cargado en la Zebra.

Solución:

• En Arregio: Configuración → Impresión → Tamaño de etiqueta → elige 2×1" o 4×2" según tu rollo.
• En Windows: Panel de control → Impresoras → ZDesigner → Preferencias de impresión → confirma el mismo tamaño.
• Ambos tienen que coincidir con el rollo real.

El navegador sigue mostrando "No seguro" después de instalar el certificado

Causa: El navegador tiene cacheado el estado de seguridad anterior.

Solución:

• Cierra todas las ventanas del navegador (no solo la pestaña) y volvé a abrirlo.
• Si sigue apareciendo, borra la caché del sitio: Configuración → Privacidad y seguridad → Borrar datos de navegación y marca "Cookies y datos del sitio".
• Confirma que el certificado está instalado correctamente: en Windows, abre certmgr.msc → Entidades de certificación raíz de confianza → Certificados → debe aparecer "Zebra Technologies".

Para administradores con múltiples sucursales

Zebra Browser Print es por máquina, no por cuenta de Arregio. Esto significa:

• Cada PC que vaya a imprimir etiquetas necesita su propia instalación de ZBP + driver ZDesigner.
• Si una sucursal tiene 3 PCs compartidas, hay que instalar en las 3.
• El certificado del Paso 6 también es por máquina.

Te recomendamos documentar internamente qué PC tiene qué impresora Zebra conectada, para facilitar el troubleshooting cuando un asesor reporte problemas.

Referencia técnica

• Endpoint local de ZBP: https://localhost:9101
• Documentación oficial de Zebra: zebra.com/browser-print
• Fallback de Arregio: si ZBP no está disponible, Arregio imprime la etiqueta como PDF para que la envíes manualmente desde el diálogo del navegador. No hace falta configuración extra para activar este fallback; es automático.