Integración externa - Paperless-ngx

Desarrollo
1

cover-paperless

¡Hola a todos!

La serie de autoalojamiento continúa, para quienes tienen un NAS o un servidor en casa. Después de las películas de Sonarr & Radarr (que disfruté hacer), ahora es el turno de los papeles: Paperless-ngx, que ingiere las facturas escaneadas y las organiza solo. Ahora, Gladys sabe cuándo llega el correo.

Qué hace

  • Un dispositivo Paperless-ngx: en línea, total de documentos, documentos en la bandeja de entrada (por clasificar), añadidos hoy, tareas en curso y fallidas, número de corresponsales, tipos y etiquetas, almacenamiento libre, versión y actualización disponible.
  • Tres disparadores: «Nuevo documento» (filtrable por corresponsal y por tipo), «Nuevo documento con una etiqueta» y «Fallo en el procesamiento de un documento».
  • Un widget «Correo por clasificar»: el número de documentos por clasificar y los últimos títulos.
  • Solo lectura: Gladys no toca nada en Paperless-ngx.
  • En francés, inglés, alemán y español.

La parte divertida

Factura de EDF recibida (corresponsal EDF, tipo Factura) → notificación con el título
Documento etiquetado Urgente → la luz de la entrada se pone en naranja
Sábado a las 10 h, si queda correo por clasificar → pequeño recordatorio

Instalación

:warning: Gladys 5.1 mínimo.

Llega a la tienda en el próximo paso del indexador. Mientras tanto: Integraciones → Instalar desde GitHub, con GitHub - guim31/gladys-paperless: Paperless-ngx document management for Gladys Assistant · GitHub

  1. En Paperless-ngx: su nombre en la esquina superior derecha → Mi perfil → Token de autenticación de API (créez-le s’il n’existe pas), y cópielo. El token de un administrador da además el almacenamiento libre.
  2. En Gladys: la dirección de Paperless-ngx (la de su navegador) y el token, luego Probar la conexión.
  3. Pestaña Descubrimiento: añada el dispositivo.

Pequeñas reservas honestas

  • Una sola instancia, en solo lectura: ni envío ni etiquetado desde Gladys.
  • La integración ve lo que ve el usuario del token: sus documentos y aquellos compartidos con él.
  • Los filtros comparan nombres exactos (EDF no coincide con edf), y una etiqueta añadida manualmente más tarde no dispara nada.
  • Paperless-ngx 1.x no es compatible.
  • Probado contra Paperless-ngx 2.20.6 y 3.3.1 reales, lanzados para la ocasión desde las imágenes oficiales y llenos de documentos (incluido un PDF roto, para el fallo de procesamiento), con un token de administrador y un token simple. No probado en una instalación real de Gladys, ni detrás de un proxy inverso o un SSO, y el anuncio de una actualización no ha podido ser visto en la práctica: sus comentarios son bienvenidos.

Como las anteriores, desarrollada con Claude Code. Proyecto independiente, no afiliado a Paperless-ngx.

Depósito: GitHub - guim31/gladys-paperless: Paperless-ngx document management for Gladys Assistant · GitHub