netSEO Buton Retragere si Retur pentru CS-Cart - Modul Cereri Retragere din Comanda cu Formular Client, Guest OTP si Panou Admin

netSEO: Buton retragere si retur pentru CS-Cart

netSEO: Buton retragere si retur este un addon profesional pentru CS-Cart care permite clientilor sa solicite retragerea din contract sau returul produselor direct din magazin, in conformitate cu practicile e-commerce moderne. Modulul ofera formular pentru clienti autentificati, flux de verificare OTP pentru vizitatori (guest), gestionare completa in admin (si in panoul vendor pentru Multi-Vendor), notificari email native CS-Cart si reguli configurabile de eligibilitate (perioada, status comanda, cantitati).

Buton retragere in contul clientului

Clientii logati pot initia o cerere direct din detaliile comenzii:

• Buton vizibil doar pentru comenzi eligibile (status, perioada, produse returnabile)
• Link catre formular dedicat netseo_withdrawal.request
• Text buton configurabil din setari sau variabila lingvistica
• Validare proprietate comanda si licenta addon activa

Fluxul este integrat nativ in pagina de detalii comanda, fara modificari in fisierele core CS-Cart.

Formular client autentificat

Formularul de solicitare include toate datele necesare procesarii:

• Selectie produse si cantitati returnate (retur partial configurabil)
• Motiv solicitare, observatii client, IBAN pentru rambursare
• Text legal configurabil (HTML) afisat pe formular
• Protectie CSRF si token anti-trimitere dubla
• Cod unic cerere (format RET-AN-NNNNNN) si pagina de confirmare succes

La salvare se trimit automat emailuri de confirmare catre client, notificare admin si (in Multi-Vendor) notificare vendor.

Formular guest cu verificare OTP

Pentru clientii fara cont, modulul ofera un flux public securizat:

• Pagina publica guest (dispatch sau URL SEO configurabil, ex. retragere-comanda)
• Identificare comanda prin numar comanda + email sau telefon
• Trimitere cod OTP pe email (template dedicat), expirare si limita incercari configurabile
• Mesaje generice la identificare esuata (anti-enumerare) si rate limiting
• Dupa verificarea OTP: afisare comanda si posibilitatea de a continua solicitarea

OTP-urile sunt stocate hash-uit (password_hash), cu invalidare la expirare sau depasirea numarului maxim de incercari.

Reguli de eligibilitate configurabile

Administratorul controleaza cand apare butonul si cand se accepta cereri:

• Perioada retragere – numar de zile de la finalizarea comenzii (implicit 14)
• Statusuri comanda eligibile – de ex. doar „Complet” (C), selectie multipla
• Retur partial – activat/dezactivat; cantitati per linie de produs
• Blocare produse deja incluse intr-o cerere activa (status Deschis)
• Validare cantitati: nu se poate depasi cantitatea ramasa returnabila

Panou admin – gestionare cereri

In backend, meniul Comenzi → Cereri retragere / retur ofera:

• Lista paginata cu filtre: status, comanda, email, telefon, interval date
• Detaliu cerere: date client, comanda, produse, motiv, IBAN, observatii admin
• Schimbare status: Deschis, Anulat, Finalizat
• Istoric complet al statusurilor (cine, cand, comentariu)
• Snapshot date vendor (Multi-Vendor) la momentul cererii

Multi-Vendor – cereri separate per vendor

In CS-Cart Multi-Vendor, modulul gestioneaza corect comenzile cu produse de la mai multi vendori:

• O cerere separata per company_id la submit
• Vendorul vede doar cererile proprii in panoul vendor (filtru runtime.company_id)
• Meniu dedicat vendor: Comenzi → Cereri retragere / retur
• Vendorul poate schimba statusul cererilor proprii si adauga observatii
• Email catre client la schimbare status, cu Reply-To la emailul vendorului
• Admin marketplace vede toate cererile tuturor vendorilor

Notificari email (sistem nativ CS-Cart)

Toate emailurile folosesc template-urile CS-Cart (Documente → Email templates), editabile din admin:

• request_created – confirmare client la cerere noua
• guest_otp – cod verificare pentru flux guest
• status_open, status_cancelled, status_completed – la schimbare status
• admin_new_request – alerta administrator marketplace
• vendor_new_request – alerta vendor (Multi-Vendor)

Trimitere prin Tygh::$app['mailer'], cu variabile standard (cod cerere, comanda, produse, date vendor) si Reply-To configurat unde este cazul.

Securitate si integritate date

Modulul include masuri de protectie pentru fluxuri sensibile:

• Tranzactii InnoDB la salvare cerere, cu FOR UPDATE pe comanda
• Verificare acces admin/vendor per company_id
• CSRF pe formulare, regenerare session ID dupa OTP valid
• Throttle la identificare guest si limita rate OTP per comanda
• Tabele dedicate: cereri, linii produse, istoric status, OTP-uri

Setari addon

Configurare din panoul de administrare CS-Cart (sectiuni separate):

• Licenta (cod licenta netSEO)
• General: perioada, guest form, dispatch/SEO URL, statusuri eligibile, retur partial
• OTP: expirare (minute), numar maxim incercari
• Notificari: email admin, trimitere email la schimbare status
• Storefront: text buton public, text legal formular

Licenta, Addons Manager si actualizari

Modulul depinde de netSEO Addons Manager:

• Verificare licenta la activare si periodic in backend
• Cod licenta configurat din setarile addon-ului
• Upgrade Center Connector pentru update-uri automate (api.cs-cart.ro)
• Comportament aliniat cu celelalte addon-uri netSEO

Compatibilitate

Addon-ul este construit pentru stabilitate si scalabilitate:

• Compatibil CS-Cart 4.10.1+, editii ULTIMATE si MULTIVENDOR
• Dependenta obligatorie: netSEO Addons Manager
• Traduceri romana prin fisier .po; fara texte hardcodate in PHP/template
• Dezinstalare curata: elimina tabelele addon-ului din baza de date

Integrare nativa in CS-Cart

netSEO: Buton retragere si retur se integreaza in storefront (buton comanda, formulare client si guest, pagina succes), in admin (meniu Comenzi, lista si detaliu cereri, template-uri email) si in panoul vendor Multi-Vendor (lista, detaliu, schimbare status). Fara un astfel de modul, cererile de retragere sunt gestionate manual (email, telefon, foi de calcul), cu risc de pierdere a solicitarilor, lipsa trasabilitatii si dificultati de conformare la termenele legale de retragere. Acest addon centralizeaza procesul: de la butonul din contul client sau formularul public guest, pana la gestionarea in admin si notificarile automate, inclusiv scenarii Multi-Vendor cu cereri separate per furnizor.