1. Ce este acest modul

Modulul extinde Magento 2 cu un sistem complet de afiliere care funcționează direct în magazin. Aceasta înseamnă că proprietarul magazinului gestionează partenerii, comisioanele, decontările și materialele promoționale din propriul panou de administrare, iar partenerii folosesc propriul dashboard în contul de client.

În practică, modulul permite implementarea simultană a mai multor modele de colaborare:

• program de afiliere clasic bazat pe linkuri de tracking,
• program de recomandări bazat pe coduri individuale ale partenerilor,
• model hibrid: link de afiliere plus cod de reducere,
• program de parteneriat pentru clienții magazinului, agenții, implementatori și creatori.

2. Valoarea principală pentru business

Cea mai mare valoare a modulului este combinarea vânzărilor, atribuirii, decontărilor și gestionării partenerilor într-un singur loc. Magazinul nu trebuie să mențină un sistem extern de afiliere, să exporte manual comenzile sau să deconteze partenerii în foi de calcul.

Modulul oferă proprietarului magazinului:

• un nou canal de vânzare,
• control asupra regulilor de colaborare,
• gestionare transparentă a comisioanelor și plăților,
• rapoarte clare privind eficiența afiliaților,
• posibilitatea de a lansa în siguranță programul și într-un magazin de scară medie sau mare.

Partenerul primește:

• propriul cod de recomandare,
• propriul link de afiliere,
• un panou gata de utilizare pentru monitorizarea activităților,
• vizibilitate asupra comisioanelor și payouturilor,
• posibilitatea de a utiliza materiale promoționale și bannere.

3. Cui îi este destinat modulul

Modulul este potrivit pentru magazinele care doresc să construiască o rețea de parteneri de vânzări fără a utiliza platforme externe de afiliere sau care vor să păstreze controlul complet asupra datelor și procesului de decontare.

Se potrivește deosebit de bine proiectelor în care programul de afiliere urmează să fie derulat de:

• clienți care recomandă magazinul prietenilor,
• creatori online,
• bloggeri și publisheri,
• specialiști și consultanți,
• parteneri de implementare,
• software house-uri și agenții,
• reselleri și agenți de vânzări B2B,
• ambasadori ai brandului și comunități.

4. Cele mai importante funcții ale modulului

4.1. Înregistrarea afiliatului

Modulul pune la dispoziție un formular de înscriere în programul de afiliere. Clientul își poate înscrie singur participarea la program, furnizând datele de contact de bază, adresa site-ului sau a canalului și o scurtă informație despre promovarea planificată.

După trimiterea formularului:

• este creat contul afiliatului,
• este generat un referral_code unic,
• statusul cererii este setat ca Pending,
• administratorul poate primi o notificare despre o nouă cerere,
• clientul poate primi confirmarea acceptării cererii.

4.2. Aprobarea partenerului

Administratorul poate aproba afiliatul din panoul Magento. După acceptare:

• statusul partenerului se schimbă în Active,
• partenerul poate utiliza complet programul,
• este posibilă activarea cuponului de afiliere,
• clientul poate primi un mesaj despre aprobarea participării.

4.3. Link de afiliere

Fiecare afiliat primește propriul link de afiliere bazat pe referral_code. Linkul funcționează printr-un controller de tracking și salvează atribuirea vizitei. După clic, sistemul poate:

• salva afilierea într-un cookie,
• crea o înregistrare a vizitei,
• crea o înregistrare de atribuire,
• conecta o comandă ulterioară cu un afiliat concret.

4.4. Cod de afiliere și cupon de reducere

Modulul susține și modelul în care referral_code poate funcționa ca un cod de reducere în coș.

Administratorul poate seta în contul afiliatului câmpul:

• Affiliate Coupon Discount (%)

Dacă valoarea este mai mare decât zero, sistemul:

• sincronizează regula nativă Cart Price Rule Magento,
• setează codul cuponului egal cu referral_code,
• aplică o reducere procentuală în coș,
• tratează utilizarea acestui cod ca sursă de afiliere a comenzii.

Astfel, afiliatul poate promova:

• un link de afiliere obișnuit,
• codul de reducere în sine,
• combinația ambelor mecanisme simultan.

Aceasta este una dintre cele mai practice funcții de vânzare ale modulului, deoarece mulți proprietari de magazine se așteaptă ca partenerul nu doar să direcționeze trafic, ci și să ofere clientului un beneficiu concret de preț.

4.5. Atribuirea comenzilor

Modulul poate atribui comanda unui afiliat pe baza:

• clicului pe linkul de afiliere,
• atribuirii active salvate în sesiune sau cookie,
• utilizării codului de afiliere în coș,
• clientului autentificat asociat cu o atribuire activă.

La nivelul comenzii sunt salvate datele:

• affiliate_id,
• affiliate_attribution_id,
• affiliate_referral_code,
• is_affiliate_order,
• affiliate_commission_amount,
• affiliate_commission_status.

Acest lucru permite raportarea sursei vânzării direct pe quote și sales_order.

4.6. Calcularea comisioanelor

Comisionul este creat automat pentru comanda de afiliere. În modelul actual:

• comisionul este calculat procentual din subtotalul comenzii,
• rata implicită provine din configurația modulului,
• sistemul evită duplicarea comisioanelor pentru aceeași comandă și același afiliat,
• rezultatul este salvat în tabelul de comisioane și pe comandă.

Statusurile de comision acceptate includ, printre altele:

• pending,
• approved,
• ready_for_payout,
• paid,
• rejected,
• cancelled,
• charged_back.

4.7. Hold period și acceptare automată

Modulul susține o perioadă de reținere a comisionului. Aceasta înseamnă că un comision nu trebuie să fie imediat gata de plată. Poate rămâne pentru o perioadă determinată în status de așteptare, iar abia după expirarea perioadei stabilite poate fi aprobat automat de cron.

Această soluție este deosebit de importantă în cazul:

• riscului de retururi,
• verificării manuale a comenzilor,
• modelelor de vânzare cu finalizare întârziată,
• necesității de a proteja programul împotriva abuzurilor.

4.8. Plăți pentru afiliați

Partenerul poate depune o cerere de plată dacă a fost îndeplinit pragul minim și dispune de un sold aprobat suficient.

Workflow-ul payouturilor include:

• trimiterea unui payout request,
• atribuirea comisioanelor la payout,
• schimbarea statusului comisionului în ready_for_payout,
• marcarea plății ca plătită,
• schimbarea statusurilor comisioanelor în paid.

Astfel, proprietarul magazinului poate gestiona plățile într-un mod ordonat și auditabil.

4.9. Fraud prevention

Modulul dispune de un strat antifraudă de bază, care ajută la eliminarea celor mai evidente abuzuri.

Acesta include, printre altele:

• blocarea self-referral,
• marcarea comisioanelor ca respinse la detectarea unui abuz,
• gestionarea cazurilor de fraudă,
• registrul motivelor de respingere,
• o vizualizare separată a fraud case-urilor pentru administrator.

În plus, modulul gestionează:

• anulările de comenzi,
• chargebackurile,
• refundurile prin creditmemo,
• schimbarea statusurilor comisioanelor după retururi.

4.10. Notificări

Modulul are propriul sistem de punere în coadă și procesare a notificărilor. Poate salva evenimente operaționale și trimite mesaje e-mail.

Cazurile acceptate includ, printre altele:

• o nouă cerere de afiliat,
• confirmarea acceptării cererii,
• acceptarea afiliatului,
• evenimente de comision,
• payouturi,
• fraud alerts.

4.11. Panoul afiliatului

Partenerul folosește un dashboard extins în contul de client Magento. Dashboardul nu este doar o listă de comisioane, ci un panou operațional complet.

În panoul afiliatului sunt disponibile:

• statusul participării la program,
• codul de recomandare,
• linkul complet de afiliere,
• calea implicită a targetului,
• rezumatul comisioanelor,
• istoricul comisioanelor,
• trecerea la payouturi,
• conținutul regulilor de colaborare,
• snippete promoționale gata de utilizare,
• previzualizarea bannerului,
• generator de banner AI.

4.12. Generator de banner AI

Modulul include o funcție asistată de AI, care permite afiliatului să pregătească un banner promoțional gata de utilizare pe baza unui brief.

Utilizatorul poate introduce:

• brief textual,
• direcție vizuală,
• culori,
• stil,
• URL opțional al graficii,
• target link opțional.

Sistemul transmite către stratul AI:

• brief-ul utilizatorului,
• referral link,
• target path,
• cerințele tehnice privind formatul răspunsului.

HTML-ul generat al bannerului poate fi salvat în contul afiliatului și utilizat de partener ca material promoțional gata de folosire.

4.13. Raportare

Modulul susține rapoarte și exporturi CSV pentru ariile-cheie ale programului:

• comisioane,
• payouturi,
• fraud case-uri,
• insighturi AI.

Acest lucru facilitează atât operarea zilnică a programului, cât și analiza eficienței partenerilor.

5. Panou de administrare

Modulul extinde panoul de administrare Magento cu configurarea și gestionarea programului de afiliere.

Administratorul are acces la:

• setările globale ale programului,
• setările comisioanelor,
• setările payouturilor,
• setările portalului afiliatului,
• setările notificărilor,
• setările de fraud,
• setările AI,
• setările de raportare.

În plus, în panou sunt disponibile secțiuni operaționale:

• Affiliate Commissions,
• Affiliate Payouts,
• Affiliate Fraud Cases,
• Affiliate Reports.

În lista de clienți și în editarea clientului sunt vizibile datele de afiliere, precum:

• participarea la program,
• statusul afiliatului,
• soldul afiliatului,
• codul de recomandare,
• procentul de reducere al cuponului de afiliere.

6. Cum funcționează afilierea în practică

6.1. Scenariul linkului de afiliere

1. Partenerul primește linkul său.
2. Clientul face clic pe link și ajunge în magazin.
3. Sistemul salvează vizita și atribuirea.
4. Clientul plasează comanda.
5. Comanda este atribuită afiliatului.
6. Este creat comisionul.
7. După expirarea hold period, comisionul poate fi aprobat.
8. După îndeplinirea condițiilor, partenerul poate depune o cerere de plată.

6.2. Scenariul codului de afiliere în coș

1. Partenerul își publică codul de afiliere.
2. Clientul introduce codul în coș.
3. Magento aplică reducerea din regula de coș.
4. Modulul recunoaște codul ca fiind codul afiliatului.
5. Comanda este atribuită afiliatului.
6. Este creat comisionul conform regulilor programului.

6.3. Scenariu hibrid

Clientul poate intra mai întâi în magazin prin linkul de afiliere, iar apoi poate utiliza codul de reducere al afiliatului. Un astfel de model permite combinarea trackingului clasic cu beneficiile pentru clientul final.

7. Arii de securitate

Modulul a fost pregătit pentru implementare în producție, de aceea include:

• înregistrări de audit,
• gestionarea retururilor și anulărilor,
• blocarea self-referral,
• coada de notificări,
• mecanisme care limitează duplicarea comisioanelor,
• stocarea sigură a configurației AI,
• limitarea datelor trimise către stratul AI,
• posibilitatea diagnosticării erorilor de integrare.

8. Integrare cu AI

Stratul AI din modul este opțional și nu blochează funcționarea programului de afiliere de bază. Poate fi utilizat pentru:

• asistentul afiliatului,
• generarea de insighturi,
• generarea de bannere,
• retrieval de cunoștințe despre produse prin vector_store_id.

Modulul nu trebuie să mențină propria bază de produse pentru AI dacă magazinul folosește deja un modul extern care gestionează cunoștințele despre produse și Vector Store.

9. Utilizări comerciale

Modulul poate fi vândut ca soluție pentru mai multe tipuri de proiecte:

• magazine B2C cu program de recomandări,
• magazine premium care doresc să construiască o rețea de ambasadori ai brandului,
• businessuri B2B cu program pentru parteneri comerciali,
• magazine digitale și software,
• implementări realizate de agenții, unde clientul are nevoie de un program complet de parteneriat fără SaaS extern.

Argumente de vânzare deosebit de puternice sunt:

• control complet asupra datelor,
• lipsa abonamentului pentru o platformă externă de afiliere,
• integrare cu Magento 2 fără intermediari,
• suport pentru linkuri și cupoane de afiliere,
• panou de partener gata de utilizare,
• posibilitatea extinderii ulterioare cu AI.

10. Cele mai importante avantaje ale modulului

Cele mai importante avantaje ale acestei soluții sunt:

• funcționează direct în Magento 2,
• susține atât linkuri, cât și coduri de afiliere,
• gestionează cupoane de reducere asociate afiliatului,
• permite gestionarea partenerilor din nivelul clientului Magento,
• are un workflow real pentru comisioane și payouturi,
• include securitate de bază și audit,
• dispune de un dashboard modern pentru afiliat,
• este pregătit pentru dezvoltarea cu funcții enterprise suplimentare.

11. Cerințe de sistem

Modulul este destinat pentru:

• Magento Open Source / Adobe Commerce 2.4.7+
• PHP 8.2 / 8.3

Necesită module Magento compatibile legate de:

• Customer,
• Quote,
• Sales,
• SalesRule,
• Cms,
• Email,
• Backend,
• Store.

12. Domeniul de implementare

Modulul poate fi implementat etapizat:

• început cu linkuri de afiliere și comisioane,
• extindere cu payouturi,
• extindere cu cupoane de afiliere,
• extindere cu AI și content pentru afiliați,
• dezvoltare ulterioară cu reguli de comision mai avansate și fraud scoring.

Aceasta înseamnă că este potrivit atât pentru implementări MVP, cât și pentru dezvoltarea pe termen lung a programului de parteneriat.

13. Rezumat

Kowal_Affiliate este un modul matur de afiliere pentru Magento 2, care permite vânzarea și lansarea unui program complet de parteneriat în cadrul propriului magazin. Combină linkuri de afiliere clasice, coduri de recomandare, cupoane de reducere, comisioane, payouturi, fraud prevention de bază, raportare și un panou modern pentru partener.

Din perspectivă comercială, acesta nu este doar un add-on pentru linkuri de recomandare, ci un strat complet de parteneriat pentru Magento 2, care poate fi oferit ca:

• modul standalone,
• element al implementării magazinului,
• parte a unui pachet growth / performance,
• bază pentru un program mai avansat de parteneri și ambasadori ai brandului.

În practică, este o soluție care răspunde nevoilor reale ale magazinelor care întreabă despre:

• program de afiliere în Magento 2,
• coduri de reducere pentru parteneri,
• decontarea comisioanelor,
• panou pentru partener,
• pregătire pentru vânzare și lucru în producție.