Manual de Usuario de Addrly

1. Introducción

Características Principales

• • Análisis Inteligente de Direcciones: Reconoce y analiza automáticamente formatos de direcciones norteamericanas
• • Impresión por lotes: Imprima eficientemente múltiples etiquetas con un flujo de trabajo optimizado
• • Editor de Texto Enriquecido: Edición de etiquetas WYSIWYG con controles de formato
• • Soporte Multi-Protocolo: TSPL, ZPL, EPL, CPCL e impresión Windows
• • Gestión de Direcciones: Guardar, buscar y administrar su base de datos de direcciones
• • Historial de Impresión: Rastrear todas sus actividades de impresión
• • Interfaz Multi-Idioma: Soporte para 11 idiomas
• • Operación Offline: Todos los datos almacenados localmente, sin necesidad de internet
• • Integración con QuickBooks: Integración opcional con QuickBooks Online

Requisitos del Sistema

2. Primeros Pasos

Instalación

Primer Lanzamiento

Cuando inicie Addrly por primera vez, verá la pantalla de bienvenida seguida de la interfaz principal. La aplicación detectará automáticamente las impresoras disponibles en su sistema.

3. Resumen de Características Principales

Figura 1: Interfaz Principal de Addrly: 1. Barra Lateral de Navegación, 2. Área de Entrada de Dirección, 3. Controles de Formato, 4. Panel de Vista Previa

Estructura de la Aplicación

La aplicación consta de cinco secciones principales accesibles desde la barra lateral:

• • Inicio: Crear e imprimir etiquetas
• • Administrador de Direcciones: Administrar su base de datos de direcciones
• • Historial de Impresión: Ver actividades de impresión anteriores
• • Configuraciones: Configurar preferencias de la aplicación

Navegación

Utilice la barra lateral de iconos en la izquierda para navegar entre diferentes secciones. Haga clic en cualquier icono para cambiar a esa sección. La sección activa estará resaltada.

4. Página Principal - Creando Etiquetas

Visión General

La página principal es donde crea, edita, previsualiza e imprime etiquetas de direcciones. Cuenta con un diseño de panel dividido con entrada de dirección a la izquierda y previsualización de etiqueta a la derecha.

Pasos para Crear su Primera Etiqueta

4.1 Ingresando Información de Dirección

4.2 Formateando su Etiqueta

La barra de herramientas de formato proporciona las siguientes opciones:

• Negrita (B): Hacer que el texto seleccionado sea negrita
• Cursiva (I): Hacer que el texto seleccionado sea cursiva
• Subrayado (U): Subrayar el texto seleccionado
• Alineación: Alinear texto a la izquierda, centro o derecha
• Familia de Fuentes: Elegir fuentes del sistema o fuentes integradas
• Tamaño de Fuente: Ajustar el tamaño del texto (8-72 puntos)
• Espaciado entre Letras: Controlar el espaciado entre caracteres
• Alto de Línea: Ajustar el espaciado entre líneas
• Transformación de Texto: Normal, Mayúsculas, Minúsculas o Capitalizar
• Color de Texto: Elegir el color del texto usando el selector de color

4.3 Seleccionando una Plantilla

Addrly viene con varias plantillas de etiquetas preconfiguradas:

• Etiqueta Pequeña: 50mm × 25mm
• Etiqueta Mediana: 70mm × 30mm
• Etiqueta Grande: 100mm × 50mm
• Personalizada: Definir sus propias dimensiones

Seleccione una plantilla del menú desplegable de plantillas, o elija "Personalizada" para configurar su propia anchura y altura en milímetros.

4.4 Configuraciones de Tamaño de Etiqueta

En la sección Tamaño de Etiqueta, puede configurar:

• Anchura (mm): Anchura de etiqueta en milímetros
• Altura (mm): Altura de etiqueta en milímetros
• Margen Izquierdo (mm): Desplazamiento horizontal desde el borde izquierdo
• Margen Superior (mm): Desplazamiento vertical desde el borde superior
• Recuento de Impresión: Número de copias a imprimir
• Rotar 90°: Imprimir la etiqueta rotada 90 grados
• Profundidad de Impresión: Baja, Media o Alta (afecta la calidad de impresión)

4.5 Vista Previa

El panel de vista previa a la derecha muestra una vista previa de alta resolución de cómo se verá su etiqueta cuando se imprima. La vista previa se actualiza automáticamente a medida que realiza cambios en la dirección o el formato.

4.6 Impresión

4.7 Guardando Direcciones

Después de crear una etiqueta, puede guardar la dirección para uso futuro:

5. Administrador de Direcciones

Visión General

El Administrador de Direcciones le permite almacenar, buscar, editar y gestionar todas sus direcciones guardadas. Esto es particularmente útil si imprime etiquetas frecuentemente para los mismos destinatarios.

Viendo Direcciones

El Administrador de Direcciones muestra todas sus direcciones guardadas en una lista. Cada dirección muestra el nombre del destinatario y la información básica. Haga clic en cualquier dirección para ver sus detalles completos en el panel derecho.

Buscando Direcciones

Utilice la caja de búsqueda en la parte superior para encontrar direcciones rápidamente por nombre, compañía, ciudad o cualquier otro campo. La lista se filtra en tiempo real mientras escribe.

Figura 2: Dialogo de Agregar Nueva Dirección

Agregando una Nueva Dirección

Analizando Dirección desde Texto

Puede agregar direcciones rápidamente pegando texto de dirección:

Editando una Dirección

Eliminando una Dirección

Importando desde QuickBooks

Si tiene QuickBooks Online conectado, puede importar direcciones de clientes directamente:

Imprimiendo desde Administrador de Direcciones

Puede imprimir una etiqueta directamente desde el Administrador de Direcciones:

5.1. Importando desde QuickBooks

Visión General

La página de Importación de QuickBooks le permite importar direcciones de clientes desde su cuenta de QuickBooks Online. Esta función requiere que haya conectado previamente su cuenta de QuickBooks en Configuraciones.

Accediendo a la Página de Importación

Puede acceder a la página de Importación de QuickBooks de dos maneras:

• Desde el Administrador de Direcciones: Haga clic en el botón "QuickBooks" en la barra de herramientas
• Navegación directa: La página está disponible en la ruta de Importación de QuickBooks

Figura 3: Pantalla de Importación de Clientes QuickBooks

Importando Direcciones de Clientes

Prevención de Duplicados

El sistema de importación usa ID de clientes de QuickBooks para prevenir entradas duplicadas:

• Cada cliente de QuickBooks tiene un ID único
• Al importar, el sistema verifica si ya existe un cliente con el mismo ID
• Si se encuentra un duplicado, se devuelve la dirección existente en lugar de crear una nueva
• Esto asegura que no creará accidentalmente múltiples entradas para el mismo cliente

Actualizando Lista de Clientes

Haga clic en el botón "Actualizar" para recargar la lista de clientes desde QuickBooks. Esto es útil si ha agregado nuevos clientes en QuickBooks desde la última importación.

Estado de Conexión

Si no está conectado a QuickBooks, la página mostrará un mensaje de advertencia con un botón para navegar a la configuración de conexión de QuickBooks. Su estado de conexión se guarda automáticamente y persistirá en los reinicios de la aplicación.

7. Historial de Impresión

Visión General

La página de Historial de Impresión mantiene un registro de todas sus actividades de impresión, incluyendo la dirección impresa, la impresora usada y la marca de tiempo. Esto es útil para rastrear y reimprimir etiquetas.

Viendo Historial de Impresión

El historial de impresión se muestra en formato de lista, con las impresiones más recientes primero. Cada entrada muestra:

• Información de dirección
• Nombre de impresora
• Fecha y hora de impresión

Buscando Historial de Impresión

Use la caja de búsqueda para encontrar registros de impresión específicos por dirección, nombre de impresora o fecha.

Reimprimiendo una Etiqueta

Eliminando Registros de Impresión

Puede eliminar registros de impresión individuales o borrar todo el historial:

• Eliminar Registro Individual: Seleccione un registro y haga clic en el botón de eliminación, luego confirme
• Eliminar Todo el Historial: Haga clic en el botón "Eliminar Todo el Historial" y confirme la acción

7. Configuraciones

Visión General

La página de Configuraciones está dividida en tres pestañas: General, Impresora y QuickBooks. Acceda a Configuraciones desde el icono de la barra lateral.

Figura 6: Configuraciones Generales

7.1 Configuraciones Generales

Idioma

Cambie el idioma de la interfaz desde el menú desplegable. Idiomas soportados incluyen:

• English
• 简体中文 (Simplified Chinese)
• Español (Spanish)
• Français (French)
• Deutsch (German)
• Italiano (Italian)
• Português (Portuguese)
• Русский (Russian)
• 日本語 (Japanese)
• 한국어 (Korean)
• العربية (Arabic)

El cambio de idioma tiene efecto inmediato. No olvide hacer clic en "Guardar" para persistir su configuración.

Dirección de Remitente Predeterminada

Configure su dirección de devolución predeterminada que se usará al crear etiquetas de dirección de devolución:

También puede hacer clic en "Imprimir" para crear inmediatamente una etiqueta con su dirección de remitente.

Figura 7: Gestión de Impresoras

7.2 Gestión de Impresoras

Agregando una Impresora

Probando una Impresora

Después de agregar una impresora, puede probar la conexión:

Editando una Impresora

Haga clic en el icono de edición junto a una impresora para modificar su configuración. Haga sus cambios y haga clic en "Guardar".

Eliminando una Impresora

Haga clic en el icono de eliminación junto a una impresora para eliminarla de su configuración. Esta acción no se puede deshacer.

Actualizando Lista de Impresoras

Haga clic en el botón "Actualizar" para escanear nuevas impresoras conectadas a su sistema.

7.3 Integración con QuickBooks (Opcional)

Addrly puede integrarse opcionalmente con QuickBooks Online para importar direcciones de clientes. Esta integración usa OAuth 2.0 con PKCE para autenticación segura.

Conectándose a QuickBooks

Importando Clientes

Después de conectarse a QuickBooks, puede importar direcciones de clientes:

Servidor Proxy OAuth (Avanzado)

Si está usando una configuración de OAuth basada en servidor, puede configurar una URL de servidor proxy:

Desconectándose de QuickBooks

Para desconectar su cuenta de QuickBooks:

9. Impresión

Proceso de Impresión

Cuando hace clic en el botón "Imprimir", Addrly:

1. Renderiza el diseño de etiqueta a un bitmap de alta resolución
2. Convierte el bitmap al formato de comando de impresora apropiado (TSPL, ZPL, etc.)
3. Envía los comandos a la impresora seleccionada vía USB, puerto COM o red
4. Registra el trabajo de impresión en su historial de impresión

Configuraciones de Calidad de Impresión

La configuración "Profundidad de Impresión" afecta la calidad de impresión:

• Baja: Impresión más rápida, impresión ligera
• Media: Equilibrio de velocidad y calidad (recomendado)
• Alta: Impresión más lenta, impresión más oscura y duradera

Solución de Problemas de Impresión

Impresora No Responde

• Verifique que la impresora esté encendida y conectada
• Asegúrese de que el tipo de conexión coincida con su configuración (USB, COM o Red)
• Intente actualizar la lista de impresoras en Configuraciones
• Pruebe la conexión de impresora usando el botón "Probar" en Configuraciones

Problemas de Calidad de Impresión

• Ajuste la configuración "Profundidad de Impresión" (pruebe Media o Alta)
• Verifique que el tamaño de etiqueta coincida con sus dimensiones físicas de etiqueta
• Asegúrese de que la configuración de resolución de impresora coincida con la resolución real de su impresora
• Limpie la cabeza de impresora si las impresiones aparecen descoloridas o rayadas

Texto No Cabe en la Etiqueta

• Reduzca el tamaño de fuente
• Ajuste el espaciado entre letras y alto de línea
• Use una plantilla de etiqueta más grande
• Elimine texto o formato innecesario

Problemas de Alineación de Etiqueta

• Ajuste la configuración de "Margen Izquierdo" y "Margen Superior"
• Verifique que la etiqueta esté correctamente cargada en la impresora
• Calibre su impresora si tiene una función de calibración

10. Solución de Problemas

Problemas de Aplicación

La Aplicación No Se Inicia

• Verifique que su sistema cumpla con los requisitos mínimos
• Intente reiniciar su computadora
• Reinstale la aplicación si el problema persiste
• Verifique mensajes de error en los registros del sistema

Análisis de Dirección No Funciona

• Asegúrese de que la dirección siga un formato estándar (Nombre, Calle, Ciudad, Estado, Código Postal)
• Intente editar manualmente los campos analizados si el análisis automático falla
• Verifique que todos los componentes de dirección estén en líneas separadas

Vista Previa No Se Actualiza

• Intente hacer clic en el editor de dirección para refrescar la vista previa
• Verifique que no haya excedido los límites de tamaño de etiqueta
• Reinicie la aplicación si la vista previa permanece congelada

Configuraciones No Se Guardan

• Asegúrese de hacer clic en el botón "Guardar" después de realizar cambios
• Verifique que tenga permisos de escritura en el directorio de datos de la aplicación
• Intente reiniciar la aplicación y volver a ingresar su configuración

Problemas de Datos

Direcciones Desaparecen

• Verifique el filtro de búsqueda - es posible que tenga una consulta de búsqueda activa
• Verifique que las direcciones no se hayan eliminado accidentalmente
• Verifique el directorio de datos de la aplicación para archivos de base de datos

Historial de Impresión No Se Muestra

• Asegúrese de haber impreso al menos una etiqueta
• Verifique que el historial de impresión no se haya borrado
• Intente refrescar la página o reiniciar la aplicación

11. Preguntas Frecuentes

Preguntas Generales

¿Addrly es gratuito?

R: Addrly ofrece una prueba gratuita de 15 días con todas las funciones. Después del período de prueba, consulta el sitio web oficial para las opciones de licencia.

¿La aplicación requiere conexión a internet?

R: No, Addrly funciona completamente offline. Todos los datos se almacenan localmente en su computadora. Solo se requiere internet para la integración opcional con QuickBooks.

¿Mis datos están seguros?

R: Sí, todos sus datos se almacenan localmente en su computadora. Nunca se suben direcciones o datos personales a internet. La aplicación usa las características de seguridad de memoria de Rust y encriptación de base de datos local.

¿Puedo usar Addrly en múltiples computadoras?

R: Sí, puede instalar Addrly en múltiples computadoras. Sin embargo, los datos de direcciones y configuraciones se almacenan localmente en cada computadora y no se sincronizan automáticamente.

Preguntas de Impresión

¿Qué marcas de impresoras son compatibles?

R: Addrly es compatible con TSC, Zebra, Eltron, Cognitive y otras marcas que usan protocolos TSPL, ZPL, EPL o CPCL. También es compatible con impresoras genéricas compatibles con Windows.

¿Puedo imprimir en una impresora de red?

R: Sí, al agregar una impresora, seleccione "WiFi/LAN" como tipo de conexión e ingrese la dirección IP y el número de puerto de la impresora.

¿Cómo sé qué protocolo de impresión usar?

R: Verifique la documentación de su impresora o sitio web del fabricante. Protocolos comunes:

• Impresoras TSC → TSPL
• Impresoras Zebra → ZPL
• Impresoras Eltron → EPL
• Impresoras Cognitive → CPCL

¿Puedo imprimir múltiples copias de la misma etiqueta?

R: Sí, use la configuración "Recuento de Impresión" en la página principal para especificar cuántas copias desea imprimir.

Preguntas de Gestión de Direcciones

¿Cuántas direcciones puedo guardar?

R: No hay límite estricto en la cantidad de direcciones que puede guardar. El límite depende de su espacio libre en disco.

¿Puedo importar direcciones desde un archivo CSV?

R: Actualmente, las direcciones se pueden ingresar manualmente, analizar desde texto pegado o importar desde QuickBooks Online. La importación CSV puede estar disponible en versiones futuras.

¿Cómo previene QuickBooks la importación de duplicados?

R: El sistema usa ID de clientes de QuickBooks para identificar clientes únicos. Al importar, si ya existe un cliente con el mismo ID en su base de datos de direcciones, será omitido para evitar duplicados.

¿Puedo exportar mis direcciones?

R: Los datos de direcciones se almacenan en una base de datos local. La funcionalidad de exportación puede estar disponible en versiones futuras.

Preguntas Técnicas

¿Dónde se almacenan mis datos?

R: Todos los datos se almacenan localmente en el directorio de datos de la aplicación:

• Windows: %APPDATA%\Addrly\
• macOS: ~/Library/Application Support/Addrly/
• Linux: ~/.config/Addrly/

¿Cómo actualizo Addrly?

R: Descargue la versión más reciente desde el sitio web oficial e instálela. Sus datos y configuraciones existentes se conservarán.

¿Puedo personalizar las plantillas de etiquetas?

R: Sí, puede crear tamaños de etiqueta personalizados seleccionando "Personalizada" del menú desplegable de plantillas e ingresando la anchura y altura deseadas en milímetros.