Kowal_Task est un module Magento 2 destiné aux entreprises qui réalisent des travaux de projet, facturent le temps de travail et souhaitent gérer les tâches clients sans quitter Magento. Le module combine un suivi simple des tâches, des entrées de temps, un espace client, l’export CSV, REST API ainsi que la génération de commandes Magento avec le statut pending, à partir desquelles l’administrateur peut émettre manuellement une facture dans le processus standard de Magento.

La solution est conçue pour les software houses, les freelances, les agences e-commerce, les équipes de support technique et les sociétés de services travaillant avec Magento 2. Si vous facturez vos clients à l’heure, gérez des projets et préparez en fin de mois un relevé du temps de travail à joindre à la facture, Kowal_Task organise ce processus en un seul endroit.

Avantage principal

Au lieu de gérer les tâches dans une application externe, d’exporter un CSV, de totaliser manuellement les heures et de préparer séparément les factures, vous pouvez gérer l’ensemble du processus dans Magento :

vous ajoutez un client, un projet et des tâches,
vous enregistrez le temps de travail sur les tâches,
vous validez les entrées de temps pour la facturation,
vous générez une commande Magento avec le statut pending,
vous émettez manuellement la facture à partir de la commande,
vous conservez l’historique des facturations, des commandes et des factures au niveau des entrées de temps.

À qui s’adresse Kowal Task ?

Le module est particulièrement adapté si :

vous facturez vos clients pour des travaux au temps passé,
vous gérez plusieurs projets pour un même client,
vous avez besoin d’une vue client → projet → tâche,
vous souhaitez permettre au client de consulter ses demandes dans son compte Magento,
vous souhaitez permettre au client de créer des tâches depuis son espace client,
vous avez besoin d’un export CSV pour le contrôle, la comptabilité ou le reporting,
vous souhaitez intégrer les tâches avec une application desktop, un CRM ou un autre système via REST API,
vous souhaitez générer des commandes Magento à partir des entrées de temps approuvées, tout en émettant les factures manuellement.

Comment fonctionne le module ?

Kowal_Task organise les données dans une structure arborescente simple :

client,
projet,
tâche,
entrées de temps associées à la tâche.

Chaque tâche dispose d’un sujet, d’une description, d’un statut, d’une source de création et d’un historique du temps de travail. Une entrée de temps peut être ajoutée manuellement ou enregistrée via un timer. L’administrateur peut valider les entrées de temps, les marquer comme non facturables, exporter les données en CSV ou préparer une commande de facturation.

Après génération de la commande, les entrées de temps sont bloquées pour l’édition standard, ce qui limite le risque d’écart dans les données de facturation. Après l’émission manuelle de la facture dans Magento, le module synchronise le statut des entrées de temps avec la facture.

Fonctionnalités du module

Tâches et projets clients

structure client → projet → tâche,
projets associés aux comptes clients Magento natifs,
tâches créées par l’administrateur ou le client,
statuts des tâches : nouvelles, acceptées, en cours, terminées, rejetées et archivées,
description de la tâche et bref historique du travail,
commentaires sur les tâches,
commentaires internes visibles uniquement par les administrateurs,
pièces jointes aux tâches,
pièces jointes internes invisibles pour le client.

Suivi du temps de travail

plusieurs entrées de temps pour une même tâche,
ajout manuel du nombre de minutes,
timer de travail optionnel sur la tâche,
description de l’entrée de temps,
statuts de facturation : brouillon, approuvées, dans la commande, facturées, non facturables et archivées,
blocage de l’édition standard des entrées associées à une commande ou une facture,
audit log pour les opérations ayant un impact sur la facturation.

Facturation dans Magento

tarif horaire global dans la configuration du module,
devise globale de facturation,
possibilité de remplacer le tarif et la devise au niveau du projet,
configuration du produit de service utilisé pour les lignes de commande,
arrondi du temps selon les paramètres du module,
aperçu de la facturation avant la création de la commande,
génération d’une commande Magento native avec le statut pending,
émission manuelle de la facture à partir de la commande dans l’interface standard de Magento,
synchronisation du statut des entrées de temps après émission de la facture.

Espace client

Le client peut utiliser le module sans accès au panneau d’administration Magento. Dans son compte, il voit les projets et tâches qui lui sont attribués, peut signaler une nouvelle tâche, ajouter un commentaire, envoyer une pièce jointe et télécharger un CSV contenant les données visibles.

La visibilité des données dans l’espace client peut être contrôlée depuis la configuration du module, notamment pour les montants ainsi que pour les entrées de temps qui n’ont pas encore été intégrées à une commande ou une facture.

Admin SPA sur KnockoutJS

L’utilisation quotidienne du module dans le panneau d’administration a été conçue comme un écran SPA rapide reposant sur KnockoutJS et les mécanismes natifs de Magento Admin. Depuis une seule vue, l’administrateur peut parcourir l’arborescence des clients, ajouter des projets, créer des tâches, enregistrer du temps, valider des entrées, gérer les commentaires, les pièces jointes, les rapports et la préparation des commandes.

REST API pour les intégrations

Kowal_Task met à disposition REST API via le mécanisme natif webapi.xml de Magento. Grâce à cela, le module peut être utilisé par :

une application desktop simple sur macOS ou Windows,
un CRM externe,
des outils de reporting,
des automatisations d’entreprise,
des intégrations avec des systèmes de gestion des demandes.

L’API utilise les service contracts et l’autorisation native de Magento. Il est possible d’utiliser des tokens d’intégration, des tokens administrateur ainsi que des tokens client dans le périmètre de ses propres données.

Export CSV et rapports

Le module conserve un processus de facturation pratique via CSV. L’administrateur peut exporter les données selon des filtres par client, projet, date, statut de tâche, statut de facturation et utilisateur administrateur. Le CSV contient notamment les données client, le projet, la tâche, la description du travail, les minutes, les heures, le tarif, la devise, le montant, le numéro de commande et le numéro de facture.

Pourquoi facturer via une commande Magento ?

Kowal_Task ne crée pas un système de facturation séparé à côté de Magento. À la place, il exploite le modèle de vente natif :

les entrées de temps constituent la source des données,
le module crée une commande Magento avec le statut pending,
l’administrateur vérifie la commande,
la facture est émise manuellement dans le workflow standard de Magento,
le module synchronise les entrées de temps avec la facture.

Cette approche est plus stable et plus facile à maintenir, car elle repose sur les mécanismes de Magento : clients, commandes, factures, produits de service, ACL, configuration, cron et REST API.

Exemple de scénario d’utilisation

Une agence e-commerce gère la boutique du client sur Magento 2. Le client soumet une tâche depuis son compte client : ‘Corriger la validation du formulaire checkout’. L’administrateur accepte la tâche, le développeur ajoute plusieurs entrées de temps et, à la fin du mois, l’administrateur filtre les entrées approuvées et génère une commande pending.

La commande contient une ligne de service calculée sur la base du temps de travail, du tarif horaire et de la devise du projet. L’administrateur vérifie les données et émet manuellement la facture dans Magento. Les entrées de temps reçoivent le statut invoiced, et l’historique reste disponible au niveau de la tâche, du projet et du client.

Résumé

Kowal_Task structure la facturation des travaux de projet dans Magento 2. Le module réunit les tâches, le temps de travail, le portail client, les rapports CSV, REST API et les commandes Magento natives dans un seul processus. Il devient ainsi plus facile de contrôler ce qui a été réalisé, combien de temps cela a pris, ce qui a été approuvé pour la facturation et quelles entrées ont déjà été intégrées à une commande ou une facture.