Kowal_Task es un módulo para Magento 2 para empresas que realizan trabajos por proyecto, facturan el tiempo de trabajo y quieren gestionar las tareas de sus clientes sin salir de Magento. El módulo combina un registro sencillo de tareas, entradas de tiempo, panel de cliente, exportación CSV, REST API y la generación de pedidos de Magento con estado pending, a partir de los cuales el administrador puede emitir manualmente una factura en el proceso estándar de Magento.

La solución está pensada para software houses, freelancers, agencias de e-commerce, equipos de soporte técnico y empresas de servicios que trabajan con Magento 2. Si facturas a tus clientes por horas, gestionas proyectos y al final de mes preparas un resumen del tiempo de trabajo para la factura, Kowal_Task organiza este proceso en un solo lugar.

Ventaja principal

En lugar de gestionar tareas en una aplicación externa, exportar CSV, sumar horas manualmente y preparar las facturas por separado, puedes gestionar todo el proceso en Magento:

añades el cliente, el proyecto y las tareas,
registras el tiempo de trabajo en las tareas,
apruebas las entradas de tiempo para su facturación,
generas un pedido de Magento con estado pending,
emites manualmente la factura desde el pedido,
mantienes el historial de facturación, pedidos y facturas junto a las entradas de tiempo.

¿Para quién es Kowal Task?

El módulo resulta especialmente útil cuando:

facturas a tus clientes por trabajos por horas,
gestionas varios proyectos para un mismo cliente,
necesitas una vista cliente → proyecto → tarea,
quieres ofrecer al cliente una vista de sus solicitudes en su cuenta de Magento,
quieres permitir al cliente encargar tareas desde el panel de cliente,
necesitas exportación CSV para control, contabilidad o informes,
quieres integrar las tareas con una aplicación de escritorio, CRM u otro sistema mediante REST API,
quieres generar pedidos de Magento a partir de entradas de tiempo aprobadas, pero emitir las facturas manualmente.

¿Cómo funciona el módulo?

Kowal_Task organiza los datos en una estructura de árbol sencilla:

cliente,
proyecto,
tarea,
entradas de tiempo asignadas a la tarea.

Cada tarea tiene asunto, descripción, estado, origen de creación e historial del tiempo de trabajo. La entrada de tiempo puede añadirse manualmente o registrarse mediante un temporizador. El administrador puede aprobar entradas de tiempo, marcarlas como no facturables, exportar datos a CSV o preparar un pedido de facturación.

Después de generar el pedido, las entradas de tiempo se bloquean para la edición normal, lo que reduce el riesgo de discrepancias en los datos de facturación. Tras emitir manualmente la factura en Magento, el módulo sincroniza el estado de las entradas de tiempo con la factura.

Funciones del módulo

Tareas y proyectos de clientes

estructura cliente → proyecto → tarea,
proyectos asignados a las cuentas nativas de clientes de Magento,
tareas creadas por el administrador o por el cliente,
estados de las tareas: nuevas, aceptadas, en curso, completadas, rechazadas y archivadas,
descripción de la tarea y breve historial de trabajo,
comentarios en las tareas,
comentarios internos visibles solo para administradores,
archivos adjuntos en las tareas,
archivos adjuntos internos no visibles para el cliente.

Registro del tiempo de trabajo

varias entradas de tiempo para una misma tarea,
adición manual del número de minutos,
temporizador de trabajo opcional para la tarea,
descripción de la entrada de tiempo,
estados de facturación: borrador, aprobadas, en pedido, facturadas, no facturables y archivadas,
bloqueo de la edición normal de las entradas asignadas a un pedido o factura,
audit log para operaciones que afectan a la facturación.

Facturación en Magento

tarifa horaria global en la configuración del módulo,
moneda global de facturación,
posibilidad de sobrescribir la tarifa y la moneda a nivel de proyecto,
configuración del producto de servicio utilizado para la línea del pedido,
redondeo del tiempo según la configuración del módulo,
vista previa de la facturación antes de crear el pedido,
generación de un pedido nativo de Magento con estado pending,
emisión manual de la factura desde el pedido en el panel estándar de Magento,
sincronización del estado de las entradas de tiempo tras emitir la factura.

Panel de cliente

El cliente puede trabajar con el módulo sin acceso al panel de administración de Magento. En su cuenta ve los proyectos y tareas asignados, puede enviar una nueva tarea, añadir un comentario, subir un archivo adjunto y descargar un CSV con los datos visibles.

La visibilidad de los datos en el panel de cliente puede controlarse desde la configuración del módulo, entre otros para los importes y las entradas de tiempo que todavía no se han incluido en un pedido o una factura.

Admin SPA en KnockoutJS

La gestión diaria del módulo en el panel de administración se ha diseñado como una pantalla SPA rápida basada en KnockoutJS y en los mecanismos nativos de Magento Admin. Desde una sola vista, el administrador puede consultar el árbol de clientes, añadir proyectos, crear tareas, registrar tiempo, aprobar entradas, gestionar comentarios, archivos adjuntos, informes y la preparación de pedidos.

REST API para integraciones

Kowal_Task ofrece REST API mediante el mecanismo nativo webapi.xml de Magento. Gracias a ello, el módulo puede utilizarse desde:

una sencilla aplicación de escritorio para macOS o Windows,
un CRM externo,
herramientas de informes,
automatizaciones empresariales,
integraciones con sistemas de gestión de incidencias.

La API utiliza service contracts y la autorización nativa de Magento. Se pueden usar tokens de integración, tokens de administrador y tokens de cliente dentro del alcance de sus propios datos.

Exportación CSV e informes

El módulo mantiene una vía práctica de facturación mediante CSV. El administrador puede exportar datos según filtros de cliente, proyecto, fecha, estado de la tarea, estado de facturación y usuario administrativo. El CSV incluye, entre otros, datos del cliente, proyecto, tarea, descripción del trabajo, minutos, horas, tarifa, moneda, importe, número de pedido y número de factura.

¿Por qué facturar mediante un pedido de Magento?

Kowal_Task no crea un sistema de facturas independiente junto a Magento. En su lugar, utiliza el modelo de ventas nativo:

las entradas de tiempo son la fuente de datos,
el módulo crea un pedido de Magento con estado pending,
el administrador revisa el pedido,
la factura se emite manualmente en el workflow estándar de Magento,
el módulo sincroniza las entradas de tiempo con la factura.

Este enfoque es más estable y más fácil de mantener, porque se basa en los mecanismos de Magento: clientes, pedidos, facturas, productos de servicio, ACL, configuración, cron y REST API.

Ejemplo de caso de uso

Una agencia de e-commerce gestiona la tienda de un cliente en Magento 2. El cliente envía una tarea desde su cuenta de cliente: Validar mejor el formulario de checkout. El administrador acepta la tarea, el desarrollador añade varias entradas de tiempo y, al finalizar el mes, el administrador filtra las entradas aprobadas y genera un pedido pending.

El pedido incluye una línea de servicio calculada en función del tiempo de trabajo, la tarifa horaria y la moneda del proyecto. El administrador revisa los datos y emite manualmente la factura en Magento. Las entradas de tiempo reciben el estado invoiced y el historial permanece disponible en la tarea, el proyecto y el cliente.

Resumen

Kowal_Task organiza la facturación de trabajos por proyecto en Magento 2. El módulo combina tareas, tiempo de trabajo, portal de cliente, informes CSV, REST API y pedidos nativos de Magento en un solo proceso. Esto facilita controlar qué se ha realizado, cuánto tiempo ha llevado, qué se ha aprobado para facturación y qué entradas ya se han incluido en un pedido o factura.