Kowal_Task este un modul Magento 2 pentru companii care realizează lucrări de proiect, facturează timpul de lucru și doresc să gestioneze sarcinile clienților fără a părăsi Magento. Modulul combină o evidență simplă a sarcinilor, înregistrări de timp, panou client, export CSV, REST API și generarea de comenzi Magento cu statusul pending, pe baza cărora administratorul poate emite manual factura în procesul standard Magento.

Soluția este destinată software house-urilor, freelancerilor, agențiilor e-commerce, echipelor de suport tehnic și companiilor de servicii care lucrează pe Magento 2. Dacă facturezi clienții la oră, gestionezi proiecte și la sfârșitul lunii pregătești un centralizator al timpului de lucru pentru factură, Kowal_Task organizează acest proces într-un singur loc.

Cel mai important beneficiu

În loc să gestionezi sarcinile într-o aplicație externă, să exporți CSV, să aduni manual orele și să pregătești separat facturile, poți gestiona întregul proces în Magento:

adaugi clientul, proiectul și sarcinile,
înregistrezi timpul de lucru pentru sarcini,
aprobi înregistrările de timp pentru decontare,
generezi o comandă Magento cu statusul pending,
emiți manual factura din comandă,
păstrezi istoricul decontărilor, comenzilor și facturilor la nivelul înregistrărilor de timp.

Pentru cine este Kowal Task?

Modulul este deosebit de potrivit atunci când:

facturezi clienții pentru lucrări la oră,
gestionezi mai multe proiecte pentru același client,
ai nevoie de o structură client → proiect → sarcină,
vrei să oferi clientului vizibilitate asupra solicitărilor în contul său Magento,
vrei să permiți clientului să trimită sarcini din panoul de client,
ai nevoie de export CSV pentru control, contabilitate sau raportare,
vrei să integrezi sarcinile cu o aplicație desktop, CRM sau alt sistem prin REST API,
vrei să generezi comenzi Magento pe baza înregistrărilor de timp acceptate, dar să emiți facturile manual.

Cum funcționează modulul?

Kowal_Task organizează datele într-o structură simplă de tip arbore:

client,
proiect,
sarcină,
înregistrări de timp atribuite sarcinii.

Fiecare sarcină are un subiect, o descriere, un status, sursa creării și istoricul timpului de lucru. O înregistrare de timp poate fi adăugată manual sau salvată prin timer. Administratorul poate aproba înregistrările de timp, le poate marca drept nedecontabile, poate exporta datele în CSV sau poate pregăti o comandă de decontare.

După generarea comenzii, înregistrările de timp sunt blocate pentru editarea obișnuită, ceea ce reduce riscul de neconcordanțe în datele de decontare. După emiterea manuală a facturii în Magento, modulul sincronizează statusul înregistrărilor de timp cu factura.

Funcțiile modulului

Sarcini și proiecte ale clienților

structură client → proiect → sarcină,
proiecte atribuite conturilor native de client Magento,
sarcini create de administrator sau de client,
statusuri de sarcină: noi, acceptate, în lucru, finalizate, respinse și arhivate,
descrierea sarcinii și un scurt istoric al lucrării,
comentarii la sarcini,
comentarii interne vizibile doar pentru administratori,
atașamente la sarcini,
atașamente interne invizibile pentru client.

Evidența timpului de lucru

mai multe înregistrări de timp pentru aceeași sarcină,
adăugare manuală a numărului de minute,
timer opțional pentru lucrul la sarcină,
descrierea înregistrării de timp,
statusuri de decontare: draft, aprobate, în comandă, facturate, nedecontabile și arhivate,
blocarea editării obișnuite a înregistrărilor atribuite unei comenzi sau facturi,
audit log pentru operațiunile care afectează decontările.

Decontări în Magento

tarif orar global în configurația modulului,
monedă globală pentru decontări,
posibilitatea de a suprascrie tariful și moneda la nivel de proiect,
configurarea produsului de servicii utilizat ca poziție în comandă,
rotunjirea timpului conform setărilor modulului,
previzualizarea decontării înainte de crearea comenzii,
generarea unei comenzi Magento native cu statusul pending,
emiterea manuală a facturii din comandă în panoul standard Magento,
sincronizarea statusului înregistrărilor de timp după emiterea facturii.

Panou client

Clientul poate lucra cu modulul fără acces la panoul de administrare Magento. În contul său vede proiectele și sarcinile atribuite, poate trimite o sarcină nouă, poate adăuga un comentariu, încărca un atașament și descărca CSV cu datele vizibile.

Vizibilitatea datelor în panoul client poate fi controlată din configurația modulului, inclusiv pentru sume și înregistrările de timp care nu au ajuns încă într-o comandă sau factură.

Admin SPA pe KnockoutJS

Utilizarea zilnică a modulului în panoul de administrare a fost proiectată ca un ecran SPA rapid, bazat pe KnockoutJS și pe mecanismele native Magento Admin. Administratorul poate dintr-o singură vizualizare să parcurgă arborele clienților, să adauge proiecte, să creeze sarcini, să adauge timp, să aprobe înregistrări, să gestioneze comentarii, atașamente, rapoarte și pregătirea comenzilor.

REST API pentru integrări

Kowal_Task oferă REST API prin mecanismul nativ Magento webapi.xml. Datorită acestui lucru, modulul poate fi utilizat prin:

o aplicație desktop simplă pentru macOS sau Windows,
un CRM extern,
instrumente de raportare,
automatizări interne ale companiei,
integrări cu sisteme de gestionare a solicitărilor.

API-ul utilizează service contracts și autorizarea nativă Magento. Pot fi folosite tokenuri de integrare, tokenuri de administrator și tokenuri de client în limita propriilor sale date.

Export CSV și rapoarte

Modulul păstrează o cale practică de decontare prin CSV. Administratorul poate exporta datele după filtre de client, proiect, dată, status al sarcinii, status al decontării și utilizator administrativ. CSV-ul conține, printre altele, datele clientului, proiectul, sarcina, descrierea lucrării, minutele, orele, tariful, moneda, suma, numărul comenzii și numărul facturii.

De ce decontare prin comandă Magento?

Kowal_Task nu construiește un sistem separat de facturi în afara Magento. În schimb, utilizează modelul nativ de vânzare:

înregistrările de timp sunt sursa datelor,
modulul creează o comandă Magento cu statusul pending,
administratorul verifică comanda,
factura este emisă manual în workflow-ul standard Magento,
modulul sincronizează înregistrările de timp cu factura.

Această abordare este mai stabilă și mai ușor de întreținut, deoarece se bazează pe mecanismele Magento: clienți, comenzi, facturi, produse de servicii, ACL, configurație, cron și REST API.

Exemplu de scenariu de utilizare

O agenție e-commerce gestionează magazinul clientului pe Magento 2. Clientul trimite o sarcină din contul de client: Poprawić walidację formularza checkout. Administratorul acceptă sarcina, programatorul adaugă câteva înregistrări de timp, iar la sfârșitul lunii administratorul filtrează înregistrările aprobate și generează o comandă pending.

Comanda conține o poziție de serviciu calculată pe baza timpului de lucru, a tarifului orar și a monedei proiectului. Administratorul verifică datele și emite manual factura în Magento. Înregistrările de timp primesc statusul invoiced, iar istoricul rămâne disponibil la nivelul sarcinii, proiectului și clientului.

Rezumat

Kowal_Task organizează decontarea lucrărilor de proiect în Magento 2. Modulul combină sarcini, timp de lucru, portal client, rapoarte CSV, REST API și comenzi Magento native într-un singur proces. Astfel, este mai ușor să controlezi ce a fost realizat, cât timp a durat, ce a fost acceptat pentru decontare și care înregistrări au ajuns deja într-o comandă sau factură.