Ordova Returns

Dependențe și activare

Ordova Returns funcționează numai împreună cu Ordova for WooCommerce. Pluginul principal furnizează conexiunea Ordova API, nomenclatorul localităților și serviciile necesare pentru AWB-ul de retur.

• WooCommerce trebuie să fie activ.
• Ordova for WooCommerce trebuie să fie activ, conectat și cu un curier AWB configurat.
• Pentru storno este necesar pluginul oficial SmartBill sau Oblio, instalat și configurat.
• Pentru emailuri, livrarea WordPress trebuie testată printr-un serviciu SMTP.

Portalul și eligibilitatea comenzilor

Pluginul nu creează automat o pagină publică. Creează o pagină WordPress, inserează shortcode-ul [ordova_returns_portal], publică pagina și selecteaz-o în setările modulului.

1. Configurează perioada de retur. Numărul de zile este calculat față de data relevantă a comenzii.
2. Alege statusurile eligibile. Nu ești limitat la wc-completed; selectează statusurile acceptate de politica magazinului.
3. Selectează pagina T&C. Linkul din checkboxul obligatoriu al formularului duce la pagina configurată.
4. Testează client autentificat și guest. Guest-ul trebuie să confirme numărul comenzii și emailul folosit la plasare.

Configurarea fluxului

Designul implicit este compact și neutru. Personalizarea din admin se aplică prin variabile CSS, fără a transforma portalul într-o interfață separată de tema magazinului.

Fluxul complet al clientului

Clientul selectează numai cantitățile încă disponibile pentru retur. Fotografierea produselor poate fi obligatorie. Înainte de trimitere, formularul validează rezoluția, adresa de ridicare, câmpurile IBAN când sunt necesare și acceptarea termenilor.

Adresa de ridicare

Un pas dedicat permite alegerea locului de unde curierul preia coletul. Adresa comenzii apare implicit într-un card selectat. Al doilea card, marcat cu plus, deschide formularul pentru o adresă nouă.

• Nume și prenume pentru persoana de contact.
• Telefon, stradă și detalii de adresă.
• Județ și localitate cu același nomenclator și același comportament ca în checkout.
• Validare server-side înainte de salvare și generarea AWB-ului.

Retururile mele în Contul meu

Endpointul „Retururile mele” afișează o listă responsive, cu status normalizat, comanda, data, valoarea și acțiunea de vizualizare. Pagina unui retur oferă un rezumat, produsele, timeline-ul, AWB-ul de retur și documentele disponibile.

• Clientul vede numai retururile proprii.
• AWB-ul și factura storno pot fi descărcate când există.
• Trackingul public folosește linkul Ordova asociat AWB-ului.
• Nu se afișează date administrative, erori API sau note interne.

Administrarea retururilor

Lista administrativă include indicatori compacți, filtre, export CSV și acțiuni contextuale. Pagina returului centralizează informațiile clientului, produsele, rambursarea, transportul, documentele și istoricul statusurilor.

1. Verifică cererea. Produse, cantități, motiv, fotografii, adresă și soluție.
2. Aprobă sau respinge. Decizia actualizează statusul și notifică clientul.
3. Generează AWB-ul. Manual sau automat, în funcție de setări.
4. Înregistrează recepția. Confirmă sosirea și verificarea fizică.
5. Soluționează. Rambursare, voucher, schimb și, când este cazul, storno.

AWB retur și tracking

AWB-ul de retur folosește același endpoint POST /awb/generate, cu is_return: true. Câmpurile destinatar descriu clientul și adresa de pickup; destinația finală este branch-ul configurat pentru curier în Ordova.

{
  "courier": "fan",
  "woo_order_id": "1234",
  "recipient_name": "Ion Popescu",
  "recipient_phone": "0721000000",
  "street": "Str. Florilor 10",
  "city": "Cluj-Napoca",
  "county": "Cluj",
  "weight": 1.5,
  "parcels_count": 1,
  "cod_amount": 0,
  "is_return": true,
  "return_payer": "shop"
}

La retur nu se trimit locker ID, deschidere la livrare, livrare sâmbătă sau ramburs pozitiv. Administratorul poate genera, tipări, retrimite prin email, actualiza trackingul și anula AWB-ul. Clientul primește eticheta și o vede atașată returului.

Rambursare, voucher și schimb

Rambursare prin IBAN

Clientul introduce titularul, IBAN-ul și banca. Administratorul verifică datele și marchează plata după procesare. Modulul nu promite și nu inițiază automat transferul bancar.

Voucher magazin

La soluționare, modulul generează cuponul WooCommerce conform valorii aprobate, îl asociază returului și îl trimite clientului. Generarea este idempotentă pentru a evita cupoanele duplicate.

Schimb de produs

Operatorul folosește notele și acțiunile comenzii pentru a coordona produsul înlocuitor. Stocul și expedierea nouă trebuie verificate conform procedurii magazinului.

Procesarea rambursării

După recepția și verificarea produselor, administratorul poate deschide acțiunea „Procesează rambursare”. Fereastra afișează produsele returnate, cantitățile și valoarea fiecărei poziții, astfel încât suma să poată fi verificată înainte de confirmare.

1. Verifică produsele și totalul. Compară lista din fereastră cu produsele recepționate fizic.
2. Decide dacă rambursezi transportul. Opțiunea dedicată include costul livrării în total atunci când politica magazinului o cere.
3. Confirmă sau ajustează suma. Totalul este calculat automat, dar poate fi corectat justificat înainte de procesare.
4. Adaugă o notă internă. Notează motivul unei ajustări sau detaliile necesare pentru audit.
5. Procesează rambursarea. Modulul creează rambursarea în WooCommerce și actualizează statusul comenzii și al returului.

Factura storno SmartBill și Oblio

Controlul storno apare când returul și comanda îndeplinesc condițiile, iar un provider fiscal oficial este detectat. Modulul folosește configurarea pluginului fiscal instalat, fără credențiale duplicate în Ordova Returns.

• Buton separat pentru fiecare provider disponibil și compatibil.
• Protecție împotriva generării duble și resetarea stărilor „în curs” abandonate.
• Numărul, seria, identificatorul extern și documentele sunt atașate returului.
• Documentul poate fi descărcat, trimis clientului și șters controlat din integrare.
• Erorile complete rămân în jurnalul administrativ, nu în frontend.

Butonul de retragere din contract

Adminul poate activa butonul în pagina Thank You, emailurile comenzii și pagina individuală a comenzii din Contul meu. Butonul nu apare în lista generală de comenzi. Fiecare plasare este controlată separat.

• Textul, culoarea de fundal și stilul sunt editabile.
• Linkul deschide portalul cu numărul comenzii și emailul precompletate.
• O singură instanță este randată pentru fiecare plasare, chiar dacă tema execută hookuri apropiate.
• Eligibilitatea și perioada sunt verificate în portal, nu doar prin ascunderea butonului.

Checklist înainte de producție

• Dependența Ordova for WooCommerce este validată la activare și runtime.
• Pagina cu shortcode și pagina T&C sunt selectate.
• Statusurile eligibile și perioada de retur sunt testate.
• Returul parțial, cantitățile și uploadurile sunt validate.
• Adresa comenzii și o adresă nouă generează date pickup corecte.
• Rambursarea, voucherul și schimbul pot fi trimise și soluționate.
• AWB-ul retur poate fi generat, tipărit, trimis, urmărit și anulat.
• SmartBill și Oblio sunt detectate prin pluginurile oficiale.
• Documentele sunt vizibile numai clientului proprietar și administratorilor.
• Portalul și Contul meu sunt testate pe mobil.