Diagnóstico base
- 01
1. Imprime la prueba interna
Si falla, el problema está en conexión, permiso, papel o impresora; todavía no en la integración.
- 02
2. Confirma el destino
Revisa que el trabajo se dirige a la impresora configurada correcta y que está encendida y con papel.
- 03
3. Revisa el permiso
Desconecta y vuelve a conectar USB, o confirma permisos Bluetooth y notificaciones según Android.
- 04
4. Envía texto simple
Quita logo, QR, comandos y caracteres especiales hasta que el recorrido básico funcione.
- 05
5. Recoge datos
Anota modelo, conexión, Android, versión de la app, hora del fallo y resultado de cada prueba.
No imprime o aparece desconectada
Red
Comprueba que la IP responde desde la misma red, que no ha cambiado, que el puerto es correcto y que ninguna red de invitados aísla dispositivos.
USB
Prueba otro cable u OTG, vuelve a conceder permiso, evita hubs sin alimentación y comprueba que Android detecta el dispositivo.
Bluetooth
Elimina y vuelve a emparejar desde Android, acerca los equipos y confirma que otra aplicación no mantiene la conexión.
El ticket sale, pero sale mal
| Síntoma | Comprobación | Acción |
|---|---|---|
| Acentos o símbolos incorrectos | Prueba de páginas de códigos | Selecciona la página compatible y repite el texto real |
| Texto cortado lateralmente | Ancho de papel y tamaño de letra | Corrige perfil, ancho manual o comandos de tamaño |
| Logo deformado o recortado | Anchura, escala de grises e inversión | Reduce la imagen y prueba cada opción por separado |
| Papel avanza demasiado | Líneas antes de corte y saltos | Reduce avance y elimina $intro$ innecesarios |
| No corta o abre cajón | Capacidad ESC/POS del modelo | Prueba variantes y confirma hardware/conector |
| QR no se lee | Tamaño, densidad y contenido | Acorta el dato, cambia el tamaño y evita impresión borrosa |
El trabajo remoto no llega
- Confirma que la prueba interna de la impresora 1 funciona.
- Comprueba que el servicio web está activado y que el dispositivo conserva conexión a Internet.
- Revisa que el linkcode coincide sin publicarlo en capturas o logs.
- Desactiva restricciones de batería para el servicio cuando la política del dispositivo lo permita.
- Mira si hay trabajos pendientes antes de reenviar para no duplicar tickets.
- Recuerda que pn no selecciona impresora en el backend remoto revisado.
Problemas con imágenes y PDF
- Comprueba que la URL o URI es accesible por PosPrinterDriver y que el permiso de lectura sigue vigente.
- Reduce imágenes excesivamente grandes antes de compartirlas.
- Evita fondos transparentes que puedan convertirse en negro de forma inesperada.
- En PDF, solo se procesa la primera página; divide documentos multipágina.
- Si aparece una vista previa, confirma impresora y utiliza direct=1 solo después de probar el flujo.