Documentación de KanbanServicios

Tablero Kanban para los partes de trabajo del plugin Servicios de FacturaScripts.

Requisitos

FacturaScripts 2026 o superior.
Plugin Servicios instalado y activado.

KanbanServicios no crea tablas ni modelos propios: trabaja directamente sobre los servicios y los estados que ya gestiona el plugin Servicios. Por eso no duplica datos ni configuración, y por eso no funciona sin él.

Instalación

Entra en Panel de control → Plugins.
Pulsa Añadir y sube el archivo KanbanServicios-1.0.zip.
Activa el plugin.
Aparecerá una nueva opción en el menú Ventas → Kanban de servicios.

Si acabas de instalar el plugin Servicios, este ya crea cuatro estados de fábrica (Pendiente, Procesando, Completado y Rechazado), así que el tablero funciona desde el primer momento sin configurar nada.

Permisos

El tablero es una página más de FacturaScripts, llamada KanbanServicios.

Para verla, el usuario necesita permiso de acceso a esa página.
Para arrastrar tarjetas, necesita además permiso de actualización. Si no lo tiene,

el tablero se muestra en modo solo lectura y las tarjetas no se pueden mover.

Los permisos se asignan en Administración → Usuarios → Roles, añadiendo la página KanbanServicios al rol correspondiente.

Configurar las columnas

Cada columna del tablero es un estado de servicio. Se configuran en Administrador → Servicios → pestaña Estados.

Puedes crear tantos estados como necesites; el tablero los muestra ordenados por su id, es decir, en el mismo orden en que los creaste.

De cada estado, el tablero usa:

| Campo | Efecto en el tablero | |---|---| | Nombre | Título de la columna | | Color | Color de la cabecera de la columna (primary, secondary, success, danger, warning, info, light o dark) | | Editable | Si está desmarcado, la columna se considera "cerrada": aparece con un candado y limita cuántas tarjetas carga | | Predeterminado | Estado en el que entran los partes nuevos, o sea, la columna donde aparecen al crearse | | Asignado | Si tiene un usuario, al mover un parte a esa columna se le asigna automáticamente | | Avisos por email | Se envían al mover un parte a esa columna (ver más abajo) |

Como son los mismos estados que usa el listado de servicios, cualquier cambio que hagas aquí se refleja también allí. No hay una configuración separada para el kanban.

Un ejemplo de configuración típica para un servicio técnico:

| Nombre | Color | Editable | |---|---|---| | Recibido | info | Sí | | Presupuestado | secondary | Sí | | En reparación | warning | Sí | | Esperando piezas | dark | Sí | | Listo para entregar | primary | Sí | | Entregado | success | No | | Anulado | danger | No |

Usar el tablero

Entra en Ventas → Kanban de servicios.

Verás una columna por estado y, dentro de cada una, una tarjeta por parte de trabajo. Cada tarjeta muestra:

El código del parte (por ejemplo SER2026-34), que es un enlace a su ficha completa.
La fecha del parte.
El cliente.
La descripción del trabajo, recortada a 120 caracteres.

En la cabecera de cada columna, un contador indica cuántas tarjetas hay a la vista. Si en esa columna hay más partes de los que se están mostrando, aparece también el total (por ejemplo 25 / 342).

Con el botón Nuevo servicio de la parte superior creas un parte sin salir del tablero.

Mover una tarjeta

Arrastra la tarjeta desde una columna y suéltala en otra. El cambio se guarda solo, sin recargar la página. Funciona con ratón y con pantalla táctil.

Reordenar tarjetas dentro de una misma columna no hace nada: el orden dentro de la columna siempre es por fecha, de la más reciente a la más antigua.

Qué ocurre al mover un parte

Mover una tarjeta no es un cambio cosmético. El tablero guarda el parte igual que si hubieras editado su ficha, así que se ejecuta toda la lógica normal del plugin Servicios:

Se cambia el estado del parte.
Se actualiza si el parte queda abierto o cerrado, según si el estado de destino es

editable o no.

Si el estado de destino tiene un usuario asignado, se le asigna el parte.
Se registra el cambio en el historial del parte, indicando el estado anterior y el nuevo.
Se envían los avisos por email que tengas marcados en el estado de destino: al cliente,

al comercial, al usuario que creó el parte o al usuario asignado.

Importante: si tienes activado "notificar cliente" en un estado, arrastrar una tarjeta a esa columna enviará un correo al cliente. Revisa la configuración de avisos de tus estados antes de empezar a mover tarjetas en producción.

Si el guardado falla por cualquier motivo, la página se recarga sola para que el tablero nunca muestre un estado distinto al que hay realmente en la base de datos.

Partes cerrados y rendimiento

Las columnas de estados editables (los partes abiertos) cargan todos sus partes.

Las columnas de estados no editables (los cerrados, como Entregado o Anulado) cargan solo los más recientes. Por defecto, los últimos 25. Con el selector Servicios por estado cerrado de la parte superior puedes subirlo a 50, 100 o Todos.

Este límite existe porque una columna de partes cerrados crece indefinidamente: al cabo de unos años tendría miles de tarjetas y el tablero tardaría en abrirse. Si necesitas consultar partes cerrados antiguos, el listado de servicios de siempre (Ventas → Servicios → pestaña Cerrado) sigue siendo la herramienta adecuada, con sus filtros y su buscador.

Preguntas frecuentes

¿Puedo cambiar el orden de las columnas? El tablero ordena las columnas por el id del estado, o sea, por orden de creación. Para cambiar el orden hay que crear los estados en el orden deseado.

¿Puedo tener tableros distintos por almacén, por técnico o por tipo de servicio? En la versión 1.0 no. El tablero muestra todos los partes de la instalación. Los filtros están previstos para una versión posterior.

¿Se pueden ver más datos en la tarjeta? En la 1.0 la tarjeta muestra código, fecha, cliente y descripción. Técnico asignado, prioridad, máquina e importe están previstos para versiones siguientes.

Un parte no aparece en ninguna columna. Ocurre si el parte apunta a un estado que ya no existe, normalmente porque se borró el estado después de crear el parte. Ábrelo desde el listado de servicios y asígnale un estado válido.

No puedo arrastrar las tarjetas. Tu usuario no tiene permiso de actualización sobre la página KanbanServicios. Revísalo en Administración → Usuarios → Roles.

El tablero no se actualiza cuando otro compañero mueve una tarjeta. En la 1.0 no hay refresco automático. Recarga la página para ver los cambios de otros usuarios.

Limitaciones conocidas de la versión 1.0

No hay filtros ni buscador en el tablero.
No hay refresco automático ni actualización en tiempo real entre usuarios.
El orden de las columnas no es configurable.
No hay botones de acción rápida en las tarjetas.

Licencia

KanbanServicios se distribuye bajo la GNU Lesser General Public License v3 o posterior, la misma licencia que FacturaScripts.

La disposición del tablero, los estilos y el script de arrastrar y soltar están basados en el tablero Kanban del plugin Proyectos para FacturaScripts, Copyright (C) 2020-2026 Carlos Garcia Gomez, distribuido también bajo LGPL v3.

Incluye SortableJS 1.15.6, licencia MIT.

Soporte y sugerencias

Para incidencias, dudas o peticiones de nuevas funcionalidades, usa el apartado de issues de la ficha del plugin en facturascripts.com.