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. Instalarea plugin-ului

Pentru a instala modulul, descărcați arhiva apăsând pe butonul de mai jos:

Descarcă arhivă Download Icon

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.

Image showing how to upload a module in prestashop

2. 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.

Image showing where the Colete Online settings are located

Pagina care se va deschide este următoarea:

A visual representation of how Colete Online settings page looks like.

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.

Setarile 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:

A visual representation of how an order placed in testing mode looks like.

* Atentie! 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:

Lasa clientul sa decida → Clientul poate selecta daca 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 in cazul in care nu se cere ramburs.

* Atentie! In cazul in care coletele neasigurate sufera daune materiale pe parcursul transportului, asigurarea legala reprezinta de 5 ori valoarea transportului, daca comanda este fara ramburs. In caz contrar valoarea asigurarii este reprezentata de rambursul comenzii.

Metoda de ambalare

Modul în care va fi împachetată comanda implicit după plasare:

Opțiuni disponibile:

Toate intr-un pachet → Toate produsele sunt puse într-un singur colet.
Cate unul intr-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ă.

Dacă această opțiune este selectată veți avea acces la următoarele câmpuri:

Conținut fix pachete

Folosește un text fix pentru conținut → Foloseste un text fix, configurat de dumneavoastra, pentru continutul comenzii.

Dacă această opțiune este selectată veți avea acces la următoarele câmpuri:

Conținut fix pachete

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.

A visual representation of how the colete online checkout form looks like

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!

A visual representation of how the default prestashop form looks like

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.

3. Setarile cheii Prestashop

A. Setari generale

Nume cheie: Numele cu care puteti identifica cheia ulterior.

URL: URL-ul site-ului dumneavoastra.

Adresa ridicare: Seteaza adresa default de unde se vor ridica comenzile.

Comentariu: Cateva detalii despre cheia dumneavoastra.

Iar pentru setarile Avansate mai avem urmatoarele campuri:

Afiseaza un pret de rezerva

Afiseaza un pret de rezerva, in cazul in care preturile 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ă.

Dacă această opțiune este selectată veți avea acces la următoarele câmpuri:

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 ci și până utilizatorul introduce adresa de livrare.(aceleasi campuri ca la optinuea anterioara sunt afisate)

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 rezerva.

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 rezerva.

Trimite mail către destinatar

Când comanda este creată trimite un email desinatarului 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ă.

B. Setari servicii curierat

Pentru modul "Simplu" de setari, in aceasta sectiune este afisat doar tabelul din care puteti 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

Selectati cate servicii doriti sa afisati

Opțiuni disponibile:

Afiseaza doar un serviciu → Afisati doar un serviciu selectat din tabel
Afiseaza toate serviciile selectate → Toate serviciile selectate vor fi afișate, iar utilizatorul va putea alege dintre ele.

Dacă această opțiune este selectată veți avea acces la următoarele câmpuri:

Afiseaza un numar limitat de servicii
Afiseaza un nume personalizat pentru servicii

Tip selectie

Afisati serviciile in functie de diferite criterii

Opțiuni disponibile:

Foloseste ordinea din tabel
Foloseste pretul serviciilor
Foloseste nota serviciilor

Afiseaza un nume personalizat pentru primul serviciu din lista

Permite afisarea unui nume personalizat pentru metoda de transport

Dacă această opțiune este selectată veți avea acces la următoarele câmpuri:

Nume personalizat afisat

Afiseaza un numar limitat de servicii

Indica cate servicii de curierat ar trebuie prezentate utilizatorului. Spre exemplu, daca optiunea precedent selectata este "bestPrice" si selectia din campul curent este 2, doar primii 2 cei mai ieftini curieri vor fi afisati. Selecteaza 0 sau lasa spatiul liber ca sa fie afisati toti

Afiseaza un nume personalizat pentru servicii

Afiseaza un nume peronalizat pentru serviciile gasite. [courierName] si [name] pot fi folosite si vor fi inlocuite cu numele curierului respectiv numele serviciului

Nume personalizat afisat

Afiseaza un nume personalizat pentru primul serviciu din lista. [courierName] si [name] pot fi folosite si vor fi inlocuite cu numele curierului respectiv numele serviciului.

Setari pret

Pret afisat

Afiseaza un pret fix sau un pret calculat pe baza adresei

Opțiuni disponibile:

Pret 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ă.
Pret fix avansat

Adauga o suma fixa la pret

Adauga un pret fix la costurile de livrare (inainte de taxe)

Adauga un procent la pret

Adauga un procent la costurile de livrare (0 - 100%, inainte de taxe)

Rotunjeste pretul

Rotunjeste pretul la cea mai apropiata suma (inainte de taxa. Spre exemplu, daca pretul este de 13.2) si rotunjirea este setata la 1, suma va fi 14. Daca rotunjirea setata are valoarea de 5, suma va fi 15

Permite transportul gratuit

Opțiuni disponibile:

Fara transport gratuit → Nu oferiti transport gratuit
Dupa suma → Oferiti transport gratuit dupa sume setate de dvs.

Dacă această opțiune este selectată veți avea acces la următoarele câmpuri:

Pentru comenzile cu suma mai mare de
Numele curierului pentru transport gratuit

Pentru comenzile cu suma mai mare de

Transport gratuit daca pretul comenzii, fara transport este mai mare decat aceasta suma

Numele curierului pentru transport gratuit

Numele curierului pentru transport gratuit. Pentru configurare se pot folosi tag-urile [courierName] si [name] care vor fi inlocuite cu numele curierului respectiv numele serviciului. Ex: [courierName] [name] - Gratuit = FanCourier Standard - Gratuit

C. Lockere/puncte de livrare

Pentru modul "Simplu de setari", in aceasta sectiune este afisat doar tabelul din care puteti selecta serviciile dorite.

Pentru setarile Avansate mai avem urmatoarele campuri:

Afisare servicii

Tipul de afisare al serviciilor de lockere/puncte de livrare

Opțiuni disponibile:

Toate punctele din localitate → Afisati toate punctele din localitatea aleasa.
Afiseaza cele mai apropiate puncte → Afisati cele mai apropiate puncte de adresa.

Dacă această opțiune este selectată veți avea acces la următoarele câmpuri:

Raza afisare puncte apropiate

Raza afisare puncte apropiate

Se vor afisa cele mai apropiate puncte daca sunt in raza definita (in km)

Afiseaza un nume personalizat pentru servicii

Permite afisarea unui nume personalizat

Dacă această opțiune este selectată veți avea acces la următoarele câmpuri:

Nume personalizat serviciu

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"

Afiseaza un numar limitat de servicii

Limiteaza numarul de servicii de la un curier

Setari pret

Pret afisat

Afiseaza un pret fix sau un pret calculat

Opțiuni disponibile:

Pret 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 pret este fara taxa).
Pret fix avansat Aceasta optiune va va permite sa alegeti daca doriti un pret calculat sau nu, la fiecare serviciu ales. Daca selectati "Nu" veti putea sa setati un pret fix serviciului.

Adauga o suma fixa la pret

Adauga un pret fix la costurile de livrare (inainte de taxe)

Adauga un procent la pret

Adauga un procent la costurile de livrare (0 - 100%, inainte de taxe)

Rotunjeste pretul

Permite transportul gratuit

Opțiuni disponibile:

Fara transport gratuit → Nu oferiti transport gratuit
Dupa suma → Oferiti transport gratuit dupa sume setate de dvs.

Dacă această opțiune este selectată veți avea acces la următoarele câmpuri:

Pentru comenzile cu suma mai mare de
Numele curierului pentru transport gratuit

D. Predare la locker

Proces prin care clientul lasă coletul într-un locker automat pentru expediere sau retur.

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 selectati rambursuri.

Visual representation of where to find repayments settings inside Colete-Online platform

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.

Visual representation of how repayments settings looks like in Colete-Online platform, as well as how to save them

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.

Visual representation of how an order looks like in Prestashop

4. Pentru a vedea ofertele apăsam pe "Show offers"

Visual representation of how to show offers for an order in Prestashop

5. După ce alegem curierul dorit, apăsam butonul "Create courier order"

Visual representation of some offers for an order inside Prestashop admin panel

Dupa ce AWB-ul a fost creat, curierul urmeaza sa ridice coletul si sa il livreze la adresa specificata in pagina de detalii.

B. Opțiuni extra

Din pagina unei comenzi putem de asemenea modifica și opțiunile extra:

Visual representation of extra options field inside the Prestashop admin order page

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.

Visual representation of where to find the locker settings inside the Colete-Online platform when editing your Prestashop key

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.

Visual representation of how delivery to fixed points services looks like insde checkout page

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ă.

Visual representation of how delivery to fixed points points services looks like inside admin order page

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.

Visual representation of how from delivery to fixed points services looks like

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:

Visual representation of where to find the products section inside Prestashop menu

Alegem produsul pe care dorim să îl editam:

Visual representation of how to edit a product configuration inside products section

După care, în tabelul de sus selectăm Shipping

Visual representation of where to find the shipping settings of a product

Mai jos putem observa toate setarile referitoare la greutatea si dimensiunea produsului, precum si alte setari.

Visual representation of the product shipping settings

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ș:

Visual representation of how the autocomplete works on address fields

Mai jos putem observa un exemplu in care orasul si strada sunt completate dupa codul postal:

Visual representation of how the autocomplete works when the postal code is completed

* 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ț!