Documentație plugin Prestashop
Integrarea cu PrestaShop vă permite să oferiți clienților magazinului dumneavoastră avantajele ColeteOnline direct din platforma PrestaShop. Prin instalarea modulului, veți putea configura opțiunile de livrare disponibile și veți putea facilita completarea rapidă a adreselor cu ajutorul funcției de completare automată.
Pentru metodele de livrare veți putea fie să le oferiți clienților metode prestabilite (de exemplu, cel mai ieftin curier sau curierul cu cea mai bună evaluare), fie să le permiteți acestora să aleagă dintre curierii pe care îi selectați din cheia de Prestashop.
Pentru completarea adreselor, clienții vor primi sugestii de căutare pentru localitate, județ și stradă, precum și opțiunea de a completa mai rapid datele atunci când introduc codul poștal. În plus, toate informațiile vor fi verificate automat, astfel încât adresa și numărul de telefon introduse să fie corecte, reducând riscul ca o comandă să fie refuzată sau livrată greșit.
În zona de administrare puteți gestiona comenzile de curier, având acces la toate informațiile esențiale legate de statusul și evoluția acestora. De asemenea, aveți posibilitatea de a modifica datele unei comenzi înainte de a genera comanda de curier, astfel încât să vă asigurați că toate detaliile sunt corecte și actualizate pentru o livrare fără probleme.
* Pentru estimarea corectă a prețurilor pentru curieri, produsele prezente în magazin trebuie să conțină toate detaliile privitoare la greutate și dimensiune. În cazul în care curierul sesizează o declarare greșită a greutății sau a dimensiunii coletului, veți fi taxat suplimentar pentru declararea incorectă. (vezi cum poți modifica dimensiunile și greutatea unui produs)
1. Setările cheii Prestashop
A. Crearea cheii
Pentru a crea cheia, trebuie să intrați în platforma Colete-Online și să generați o cheie API pentru Prestashop.
După generarea cheii va trebui să configurați setările acesteia și să le salvați (aceste setări pot fi modificate ulterior).
După ce salvați setările veți primi un mail cu "Client ID" și "Client Secret" pe care le veți folosi în setările plugin-ului.
B. Setari generale
Nume cheie: Numele cu care puteți identifica cheia ulterior.
URL: URL-ul site-ului dumneavoastra.
Adresa ridicare: Setează adresa default de unde se vor ridica comenzile.
Comentariu: Cateva detalii despre cheia dumneavoastra.
Iar pentru setarile Avansate mai avem urmatoarele campuri:
Afișează un preț de rezervă
Afișează un preț de rezervă, în cazul în care prețurile nu pot fi calculate
Opțiuni disponibile:
- Nu afișa un preț de rezervă → În acest caz opțiunea este dezactivată, iar prețul afișat este cel calculat de sistemul nostru.
- Afișează un preț de rezervă dacă există probleme → În cazul unor probleme tehnice, se afișează un preț de rezervă configurat de dumneavoastră.
- Preț de rezervă
- Afișează nume de rezervă pentru serviciu
- Afișează un preț de rezervă mereu (chiar dacă adresa este incorectă) → Această opțiune poate fi folosită dacă doriți să afișați un preț de rezervă atât în cazul unor probleme tehnice și până utilizatorul introduce adresa de livrare. (aceleași câmpuri ca la opțiunea anterioară sunt afișate)
Dacă această opțiune este selectată veți avea acces la următoarele câmpuri:
Preț de rezervă (disponibil din versiunea 1.0.0)
Câmpul care definește prețul de rezervă în cazul în care doriți să afișați un preț de rezervă.
Afișează nume de rezervă pentru serviciu (disponibil din versiunea 1.0.0)
Câmpul care definește numele de rezervă pentru serviciul personalizat în cazul în care doriți să afișați un preț de rezervă.
Trimite mail către destinatar
Când comanda este creată, trimite un email destinatarului cu informații legate de livrare și de comandă.
Opțiuni disponibile:
- Da → Destinatarul va primi un mail cu informații legate de livrare la crearea comenzii.
- Nu → În acest caz opțiunea este dezactivată.
C. Setari servicii curierat
Pentru modul "Simplu" de setări, în această secțiune este afișat doar tabelul din care puteți selecta serviciile dorite.
În setările avansate este selectat să se afișeze doar un număr limitat de servicii conform ordonării alese.
Pentru setarile Avansate mai avem urmatoarele campuri:
Mod selectie
Selectați câte servicii doriți să afișați
Opțiuni disponibile:
- Afișează doar un serviciu → Afișați doar un serviciu selectat din tabel
- Afișează toate serviciile selectate → Toate serviciile selectate vor fi afișate, iar utilizatorul va putea alege dintre ele.
- Afișează un număr limitat de servicii
- Afișează un nume personalizat pentru servicii
Dacă această opțiune este selectată veți avea acces la următoarele câmpuri:
Tip selectie
Afișați serviciile în funcție de diferite criterii
Opțiuni disponibile:
- Folosește ordinea din tabel
- Folosește prețul serviciilor
- Folosește nota serviciilor
Afișează un nume personalizat pentru primul serviciu din listă
Permite afișarea unui nume personalizat pentru metoda de transport
Dacă această opțiune este selectată veți avea acces la următoarele câmpuri:
- Nume personalizat afișat
Afișează un număr limitat de servicii
Indică câte servicii de curierat ar trebui prezentate utilizatorului. Spre exemplu, dacă opțiunea precedentă selectată este "bestPrice" și selecția din câmpul curent este 2, doar primii 2 cei mai ieftini curieri vor fi afișați. Selectează 0 sau lasă spațiul liber ca să fie afișați toți
Afișează un nume personalizat pentru servicii
Afișează un nume personalizat pentru serviciile găsite. [courierName] și [name] pot fi folosite și vor fi înlocuite cu numele curierului respectiv numele serviciului
Nume personalizat afișat
Afișează un nume personalizat pentru primul serviciu din listă. [courierName] și [name] pot fi folosite și vor fi înlocuite cu numele curierului respectiv numele serviciului.
Setări preț
Preț afișat
Afișează un preț fix sau un preț calculat pe baza adresei
Opțiuni disponibile:
- Preț calculat →Afișează clientului prețul calculat de sistemul nostru. Acest preț ia în calcul produsele din coș, adresele de expediție și destinație și alte extra opțiuni indicate.
- Preț fix →Afișează clientului un preț fix setat de dumneavoastră.
- Preț fix avansat
Adaugă o sumă fixă la preț
Adaugă un preț fix la costurile de livrare (înainte de taxe)
Adaugă un procent la preț
Adaugă un procent la costurile de livrare (0 - 100%, înainte de taxe)
Rotunjește prețul
Rotunjește prețul la cea mai apropiată sumă (înainte de taxă. Spre exemplu, dacă prețul este de 13.2) și rotunjirea este setată la 1, suma va fi 14. Dacă rotunjirea setată are valoarea de 5, suma va fi 15
Permite transportul gratuit
Opțiuni disponibile:
- Fara transport gratuit → Nu oferiti transport gratuit
- După sumă → Oferiti transport gratuit dupa sume setate de dvs.
- Pentru comenzile cu suma mai mare de
- Numele curierului pentru transport gratuit
Dacă această opțiune este selectată veți avea acces la următoarele câmpuri:
Pentru comenzile cu suma mai mare de
Transport gratuit dacă prețul comenzii, fără transport este mai mare decât această sumă
Numele curierului pentru transport gratuit
Numele curierului pentru transport gratuit. Pentru configurare se pot folosi tag-urile [courierName] și [name] care vor fi înlocuite cu numele curierului respectiv numele serviciului. Ex: [courierName] [name] - Gratuit = FanCourier Standard - Gratuit
D. Lockere/puncte de livrare
Pentru modul "Simplu de setări", în această secțiune este afișat doar tabelul din care puteți selecta serviciile dorite.
Pentru setarile Avansate mai avem urmatoarele campuri:
Afișare servicii
Tipul de afișare al serviciilor de lockere/puncte de livrare
Opțiuni disponibile:
- Toate punctele din localitate → Afișați toate punctele din localitatea aleasă.
- Afișează cele mai apropiate puncte → Afișați cele mai apropiate puncte de adresa.
- Raza afișare puncte apropiate
Dacă această opțiune este selectată veți avea acces la următoarele câmpuri:
Raza afișare puncte apropiate
Se vor afișa cele mai apropiate puncte dacă sunt în raza definită (în km)
Afișează un nume personalizat pentru servicii
Permite afișarea unui nume personalizat
- Nume personalizat serviciu
Dacă această opțiune este selectată veți avea acces la următoarele câmpuri:
Nume personalizat serviciu
Permite afișarea unui nume personalizat pentru metodele de transport folosind tag-urile [courierName] și [serviceName] care voi fi înlocuite cu numele curierului respectiv numele serviciului.
Exemple:
- Pentru serviciul DPD Standard, sintaxa "Curier: [courierName], Serviciu: [serviceName]" se traduce în "Curier: DPD, Serviciu: Standard"
Afișează un număr limitat de servicii
Limitează numărul de servicii de la un curier
Setări preț
Preț afișat
Afișează un preț fix sau un preț calculat
Opțiuni disponibile:
- Preț calculat →Afișează clientului prețul calculat de sistemul nostru. Acest preț ia în calcul produsele din coș, adresele de expediție și destinație și alte extra opțiuni indicate.
- Preț fix →Afișează clientului un preț fix setat de dumneavoastră (acest preț este fără taxă).
- Preț fix avansat Această opțiune va permite să alegeți dacă doriți un preț calculat sau nu, la fiecare serviciu ales. Dacă selectați "Nu" veți putea să setați un preț fix serviciului.
Adaugă o sumă fixă la preț
Adaugă un preț fix la costurile de livrare (înainte de taxe)
Adaugă un procent la preț
Adaugă un procent la costurile de livrare (0 - 100%, înainte de taxe)
Rotunjește prețul
Rotunjește prețul la cea mai apropiată sumă (înainte de taxă. Spre exemplu, dacă prețul este de 13.2) și rotunjirea este setată la 1, suma va fi 14. Dacă rotunjirea setată are valoarea de 5, suma va fi 15
Permite transportul gratuit
Opțiuni disponibile:
- Fara transport gratuit → Nu oferiti transport gratuit
- După sumă → Oferiti transport gratuit dupa sume setate de dvs.
- Pentru comenzile cu suma mai mare de
- Numele curierului pentru transport gratuit
Dacă această opțiune este selectată veți avea acces la următoarele câmpuri:
E. Predare la locker
Proces prin care clientul lasă coletul într-un locker automat pentru expediere sau retur.
2. Instalarea plugin-ului
Pentru a instala modulul, descărcați arhiva apăsând pe butonul de mai jos:
După descărcare, accesați panoul de administrare al magazinului, navigați la secțiunea Modules și apăsați pe butonul Upload a module pentru a încărca arhiva. Pașii sunt ilustrați în imaginea de mai jos.
3. Setările plugin-ului
Pentru a accesa setările plugin-ului trebuie să intrați în PrestaShop → Improve → Modules → Module Manager, apoi apăsați pe butonul de „Configure” din modulul Colete Online.
Pagina care se va deschide este următoarea:
Pentru a vedea toate setările este nevoie să vă logați cu credențialele generate de noi pentru plugin. Pentru generarea credențialelor, vă rugam să faceți o cerere aici. După ce introduceți credențialele, asigurați-vă că apăsați pe butonul "Save changes".
Până la logare, toate facilitățile plugin-ului nu vor fi disponibile. După ce logarea se face cu succes veți avea posibilitatea să configurați pluginul așa cum doriți.
Setările Modulului
Mod de testare ( disponibil din versiunea 1.0.0 )
Setare care indică dacă comenzile plasate sunt de test sau trebuie generată comanda de curier pentru ele.
Opțiuni disponibile:
- Da → Pluginul va fi în testare și comenzile create nu se vor transmite către firmele de curierat și nu vor consuma din banii din cont. Comenzi în modul de testare se pot pune doar cu FedEx / TNT. Pentru restul curierilor comenzile vor da eroare și nu se vor activa. Această setare trebuie folosită doar pentru teste.
- Nu → Comenzile plasate se vor transmite către firmele de curierat. Aceasta este setarea care trebuie folosită după ce veți configura pluginul.
Comenzile plasate în modul de testare apar în platforma noastră cu scris roșu:
* Atenție! Când modul de test este activ, prețurile sunt păstrate în cache doar 10 secunde, iar modificările de adresă sau date forțează recalcularea, astfel că după cele 10 secunde este suficient un refresh pentru a vedea noile prețuri și curieri.
Deschidere la livrare
Opțiuni disponibile:
- Lasă clientul să decidă → Clientul poate selecta dacă vrea sau nu deschidere la livrare.
- Nu → Deschiderea la livrare nu este permisa.
- Mereu → Permite mereu deschiderea coletului la livrare.
Asigurare
Alege dacă pachetul trebuie asigurat.
Opțiuni disponibile:
- Nu → Dacă este setat pe nu, AWB-ul va fi creat fără valoare declarată.
- Da → Toate comenzile vor avea asigurare.
- Doar atunci când nu se cere ramburs → Comenzile vor beneficia de asigurare numai în cazul în care nu se cere ramburs.
* Atenție! În cazul în care coletele neasigurate suferă daune materiale pe parcursul transportului, asigurarea legală reprezintă de 5 ori valoarea transportului, dacă comanda este fără ramburs. În caz contrar valoarea asigurării este reprezentată de rambursul comenzii.
Metoda de ambalare
Modul în care va fi împachetată comanda implicit după plasare:
Opțiuni disponibile:
- Toate într-un pachet → Toate produsele sunt puse într-un singur colet.
- Câte unul într-un pachet → Fiecare produs este ambalat individual (pentru n produse avem n colete).
Tip ambalare
Această opțiune indică preferințele dumneavoastră pentru pachetele mici. De obicei opțiunea "Plic" este folosită pentru a trimite documente astfel încât poate duce la imposibilitatea de a compensa pierderea sau distrugerea pachetului dumneavoastră . Folosiți această opțiune numai dacă înțelegeti posibilele probleme:
Opțiuni disponibile:
- Păstrează ca și colet → Pachetele mici vor fi declarate colete.
- Plic → Pachetele mici vor fi declarate plicuri.
Conținut pachete
Modul în care conținutul pachetelor o să fie trimis la curier.
Opțiuni disponibile:
- Automat folosind numele produselor → Continutul comenzii va fi generat automat folosind produsele prezente in comanda.
- Folosește un text fix pentru conținut când conținutul generat automat e prea lung → Implicit, lungimea maximă a conținutului este de 50 de caractere. În cazul în care acest număr este depășit, înlocuiește conținutul cu un text predefinit configurat de dumneavoastră.
- Conținut fix pachete
- Folosește un text fix pentru conținut → Folosește un text fix, configurat de dumneavoastră, pentru conținutul comenzii.
- Conținut fix pachete
Dacă această opțiune este selectată veți avea acces la următoarele câmpuri:
Dacă această opțiune este selectată veți avea acces la următoarele câmpuri:
Conținut fix pachete
Conținutul fix al pachetelor care va fi afișat în cazul în care ați optat pentru afișarea unui conținut fix.
Referință client
Adaugă o referință a clientului pentru comandă. ([orderId] va fi înlocuit cu numărul comenzii).
Exemplu:
Pentru o comanda cu id-ul 123, sintaxa "Id comanda: [orderId]" se traduce in "Id comanda: 123"
Schimbă statusul comenzii atunci când AWB-ul este creat
Când se crează comanda către curier, schimbă statusul comenzii din "Procesare " în "Livrare".
Opțiuni disponibile:
- Nu → În acest caz opțiunea este dezactivată.
- Da → Schimbă statusul comenzii în momentul creării AWB-ului.
Tip formular de checkout
Această setare îți permite să alegi ce tip de formular va fi afișat clienților în pagina de finalizare a comenzii:
Opțiuni disponibile:
- Folosește formularul Colete-Online → Formularul din pagina de finalizare comandă va fi înlocuit cu formularul Colete-Online incluzând toate funcționalitățile acestuia (câmpuri cu autocompletare, căutare după cod postal, etc..).
* ATENȚIE! Numărul de telefon este opțional în mod implicit. Totuși, dacă nu este completat, comanda nu va putea fi creată. Din setări, puteți alege ca numărul de telefon să devină obligatoriu.
- Folosește formularul Prestashop (fără autocompletarea adresei din plugin-ul Colete-Online) → Formularul din pagina de finalizare comandă va fi înlocuit cu formularul implicit din Prestashop. Atenție! Această opțiune nu vă permite să folosiți funcția de autocompletare a câmpurilor din plugin-ul nostru!
Ascunde livrarea la puncte fixe de ridicare pentru metodele de plată
Alegeți metodele de plată pentru care NU doriți să permiteți clienților dumneavoastră să plaseze comenzi folosind punctele de ridicare.
4. Crearea unei comenzi
* ATENȚIE! Pentru efectuarea comenzilor cu ramburs trebuie trecut în opțiuni, contul făcut la noi în platformă!
Pentru a crea un cont in platforma noastra, trebuie sa dati clic pe utilizator, apoi pe setari si selectați rambursuri.
După ce ați intrat în rambursuri va trebui să completați câmpurile cu numele titularului contului și IBAN-ul contului. De asemenea puteți selecta intervalul de timp după care veți primi rambursurile de la clienți. După efectuarea pașilor de mai sus, trebuie să salvați setările.
A. Generarea unui singur AWB
Pentru generarea unui singur AWB este necesar să efectuați pașii următori:
1. Accesați panoul Orders din meniul Prestashop.
2. Selectați comanda pentru care doriți să generați AWB-ul.
3. În partea de jos a paginii puteți vedea și edita comanda cu toate detaliile ei.
4. Pentru a vedea ofertele apăsam pe "Show offers"
5. După ce alegem curierul dorit, apăsam butonul "Create courier order"
După ce AWB-ul a fost creat, curierul urmează să ridice coletul și să îl livreze la adresa specificată în pagina de detalii.
B. Opțiuni extra
Din pagina unei comenzi putem de asemenea modifica și opțiunile extra:
C. Generarea unei comenzi cu livrare la punct fix de ridicare
Pentru a putea permite clienților dumneavoastră să plaseze comenzi cu livrare la puncte fixe de ridicare, trebuie să activați aceste servicii din platforma Colete-Online. Puteti configura aceste servicii editand cheia de Prestashop din platforma noastra.
După activarea serviciilor de livrare la puncte fixe, clienții dumneavoastră vor regăsi în lista de curieri din pagina de finalizare comandă și aceste servicii.
Activarea unei comenzi cu livrare la punct fix se face aproape similar cu activarea unei comenzi obișnuite. Singura diferență este că în lista de oferte veți regăsi o listă separată pentru fiecare curier cu lista de puncte aferentă.
Inițial, punctul selectat va fi cel ales de client în pagina de finalizare comandă. Ulterior, puteți să îl schimbați cu orice punct doriți.
G. Generarea unei comenzi cu predare la punct fix de ridicare
Pentru a plasa o comandă cu predare la punct fix de ridicare, urmați pașii pentru a genera o comandă obișnuită. La sfârșit, alegeți serviciul dorit și punctul la care doriți să predați comanda pentru livrare.
5. Setări produse
Setările produselor din magazinul dumneavoastră influențează direct prețul serviciilor.
Pentru configurarea setărilor unui produs accesăm secțiunea Products din meniul Catalog:
Alegem produsul pe care dorim să îl editam:
După care, în tabelul de sus selectăm Shipping
Mai jos putem observa toate setarile referitoare la greutatea si dimensiunea produsului, precum si alte setari.
6. Câmpuri cu autocompletare
Pluginul nostru dispune de câmpuri cu auto-completare pentru oraș, județ și stradă. De asemenea, dacă din întâmplare nu cunoașteți adresa cu exactitate, puteți introduce codul postal asociat adresei iar noi vom avea grijă să completăm câmpurile pentru județ și oraș:
Mai jos putem observa un exemplu in care orasul si strada sunt completate dupa codul postal:
* Atenție! Pentru ca autocompletarea străzii să fie funcțională, trebuie mai întăi să completați câmpul/câmpurile oraș și județ!