Kowal_Task è un modulo Magento 2 per aziende che gestiscono lavori di progetto, contabilizzano il tempo di lavoro e vogliono seguire le attività dei clienti senza uscire da Magento. Il modulo unisce una semplice gestione delle attività, registrazioni del tempo, pannello cliente, esportazione CSV, REST API e generazione di ordini Magento con stato pending, sulla base dei quali l amministratore può emettere manualmente la fattura nel processo standard di Magento.

La soluzione è pensata per software house, freelance, agenzie e-commerce, team di supporto tecnico e aziende di servizi che lavorano con Magento 2. Se fatturi i clienti a ore, gestisci progetti e alla fine del mese prepari un riepilogo del tempo di lavoro da fatturare, Kowal_Task organizza questo processo in un unico posto.

Vantaggio principale

Invece di gestire le attività in un applicazione esterna, esportare CSV, sommare manualmente le ore e preparare separatamente le fatture, puoi gestire l intero processo in Magento:

aggiungi il cliente, il progetto e le attività,
registri il tempo di lavoro sulle attività,
approvi le registrazioni del tempo per la fatturazione,
generi un ordine Magento con stato pending,
emetti manualmente la fattura dall ordine,
mantieni la cronologia delle fatturazioni, degli ordini e delle fatture collegata alle registrazioni del tempo.

Per chi è pensato Kowal Task?

Il modulo è particolarmente adatto se:

fatturi i clienti per lavori a ore,
gestisci più progetti per uno stesso cliente,
hai bisogno di una vista cliente → progetto → attività,
vuoi offrire al cliente la visualizzazione delle richieste nel suo account Magento,
vuoi permettere al cliente di assegnare attività dal pannello cliente,
hai bisogno dell esportazione CSV per controllo, contabilità o reportistica,
vuoi integrare le attività con un applicazione desktop, un CRM o un altro sistema tramite REST API,
vuoi generare ordini Magento sulla base di registrazioni del tempo approvate, ma emettere le fatture manualmente.

Come funziona il modulo?

Kowal_Task organizza i dati in una semplice struttura ad albero:

cliente,
progetto,
attività,
registrazioni del tempo assegnate all attività.

Ogni attività ha un oggetto, una descrizione, uno stato, una fonte di creazione e una cronologia del tempo di lavoro. Una registrazione del tempo può essere aggiunta manualmente oppure salvata tramite timer. L amministratore può approvare le registrazioni del tempo, contrassegnarle come non fatturabili, esportare i dati in CSV oppure preparare un ordine di fatturazione.

Dopo la generazione dell ordine, le registrazioni del tempo vengono bloccate per la normale modifica, riducendo il rischio di disallineamento dei dati di fatturazione. Dopo l emissione manuale della fattura in Magento, il modulo sincronizza lo stato delle registrazioni del tempo con la fattura.

Funzionalità del modulo

Attività e progetti dei clienti

struttura cliente → progetto → attività,
progetti assegnati agli account cliente nativi di Magento,
attività create dall amministratore o dal cliente,
stati delle attività: nuove, approvate, in corso, completate, rifiutate e archiviate,
descrizione dell attività e breve cronologia del lavoro,
commenti alle attività,
commenti interni visibili solo agli amministratori,
allegati alle attività,
allegati interni non visibili al cliente.

Registrazione del tempo di lavoro

più registrazioni del tempo per una singola attività,
inserimento manuale del numero di minuti,
timer di lavoro opzionale sull attività,
descrizione della registrazione del tempo,
stati di fatturazione: bozza, approvate, nell ordine, fatturate, non fatturabili e archiviate,
blocco della normale modifica delle registrazioni assegnate a un ordine o a una fattura,
audit log per le operazioni che influiscono sulla fatturazione.

Fatturazione in Magento

tariffa oraria globale nella configurazione del modulo,
valuta globale di fatturazione,
possibilità di sovrascrivere tariffa e valuta a livello di progetto,
configurazione del prodotto di servizio utilizzato come voce dell ordine,
arrotondamento del tempo secondo le impostazioni del modulo,
anteprima della fatturazione prima della creazione dell ordine,
generazione di un ordine Magento nativo con stato pending,
emissione manuale della fattura dall ordine nel pannello standard di Magento,
sincronizzazione dello stato delle registrazioni del tempo dopo l emissione della fattura.

Pannello cliente

Il cliente può utilizzare il modulo senza accesso al pannello amministratore di Magento. Nel proprio account vede i progetti e le attività assegnate, può segnalare una nuova attività, aggiungere un commento, caricare un allegato e scaricare il CSV con i dati visibili.

La visibilità dei dati nel pannello cliente può essere controllata dalla configurazione del modulo, tra l altro per importi e registrazioni del tempo che non sono ancora confluiti in un ordine o in una fattura.

Admin SPA su KnockoutJS

La gestione quotidiana del modulo nel pannello amministratore è stata progettata come una rapida schermata SPA basata su KnockoutJS e sui meccanismi nativi di Magento Admin. Da un unica vista, l amministratore può consultare l albero dei clienti, aggiungere progetti, creare attività, registrare tempo, approvare registrazioni, gestire commenti, allegati, report e preparazione degli ordini.

REST API per integrazioni

Kowal_Task espone REST API tramite il meccanismo nativo webapi.xml di Magento. Grazie a questo il modulo può essere gestito da:

una semplice applicazione desktop per macOS o Windows,
un CRM esterno,
strumenti di reportistica,
automazioni aziendali,
integrazioni con sistemi di gestione delle richieste.

L API utilizza service contracts e l autorizzazione nativa di Magento. È possibile usare token di integrazione, token amministratore e token cliente per l ambito dei suoi dati.

Esportazione CSV e report

Il modulo mantiene un pratico flusso di fatturazione tramite CSV. L amministratore può esportare i dati in base ai filtri di cliente, progetto, data, stato dell attività, stato di fatturazione e utente amministrativo. Il CSV contiene tra l altro dati del cliente, progetto, attività, descrizione del lavoro, minuti, ore, tariffa, valuta, importo, numero ordine e numero fattura.

Perché fatturare tramite ordine Magento?

Kowal_Task non costruisce un sistema di fatture separato accanto a Magento. Al contrario, utilizza il modello di vendita nativo:

le registrazioni del tempo sono la fonte dei dati,
il modulo crea un ordine Magento con stato pending,
l amministratore verifica l ordine,
la fattura viene emessa manualmente nel workflow standard di Magento,
il modulo sincronizza le registrazioni del tempo con la fattura.

Questo approccio è più stabile e più facile da mantenere, perché si basa sui meccanismi di Magento: clienti, ordini, fatture, prodotti di servizio, ACL, configurazione, cron e REST API.

Esempio di scenario d uso

Un agenzia e-commerce gestisce il negozio del cliente su Magento 2. Il cliente invia un attività dal proprio account cliente: Migliorare la validazione del modulo checkout. L amministratore approva l attività, lo sviluppatore aggiunge diverse registrazioni del tempo e, a fine mese, l amministratore filtra le registrazioni approvate e genera un ordine pending.

L ordine contiene una voce di servizio calcolata in base al tempo di lavoro, alla tariffa oraria e alla valuta del progetto. L amministratore verifica i dati ed emette manualmente la fattura in Magento. Le registrazioni del tempo ricevono lo stato invoiced e la cronologia resta disponibile per attività, progetto e cliente.

Riepilogo

Kowal_Task organizza la fatturazione dei lavori di progetto in Magento 2. Il modulo unisce attività, tempo di lavoro, portale cliente, report CSV, REST API e ordini Magento nativi in un unico processo. In questo modo è più facile controllare cosa è stato eseguito, quanto tempo ha richiesto, cosa è stato approvato per la fatturazione e quali registrazioni sono già confluite in un ordine o in una fattura.