Dacă nu aveți planul Advanced, puteți în continuare să folosiți toate celelalte funcționalități ale plugin-ului. Comenzile vor fi activate manual din platforma Colete Online, iar tarifele de transport pot fi setate fix în Shopify.
Documentație plugin Shopify
Instalarea aplicației Colete Online în Shopify, vă oferă posibilitatea de a folosi serviciile noastre direct în platforma Shopify. Prin intermediul plugin-ului dedicat platformei de e-commerce Shopify vă punem la dispoziție una dintre cele mai complete soluții de expediere a coletelor de pe piață.
Pluginul nostru nu vă oferă doar posibilitatea de a genera documentele de transportul necesare expedierii comenzilor ci și opțiunea de a alege dintr-o listă variată de servicii de curierat, din care dumneavoastră sau clienții dumneavoastră pot selecta cel mai bun sau cel mai ieftin serviciu. De asemenea vă oferim opțiuni avansate de personalizare a plugin-ului, astfel încât încercăm să satisfacem cele mai importante cerințe ale clienților noștri.
Prezentare generală
Plugin-ul Colete Online pentru Shopify vă oferă o soluție completă de gestionare a expedierii coletelor direct din platforma Shopify. Integrarea permite automatizarea procesului de expediere și oferă clienților dumneavoastră opțiuni flexibile de livrare.
Funcționalități principale
Activare comenzi cu orice curier
Disponibil pe toate planurile Shopify
Activați și generați AWB-uri pentru comenzi folosind orice curier integrat în platforma Colete Online (DPD, FanCourier, Cargus, Sameday, etc.).
Gestionarea comenzilor Shopify în platforma Colete Online
Corectarea erorilor
Disponibil pe toate planurile Shopify
Identificați rapid erorile apărute în procesul de generare AWB și corectați-le direct din interfața Colete Online. Sistemul vă ghidează automat spre soluțiile posibile pentru fiecare tip de eroare.
Exemple de erori detectate automat și corectate direct din platformă
Hartă interactivă cu puncte de livrare
Disponibil pe toate planurile Shopify
Clienții pot selecta puncte de livrare (lockere, puncte de ridicare) direct din Thank you page folosind o hartă interactivă Google Maps.
Clienții pot selecta lockere-le direct la Thank you Page după selectarea metodei de livrare din Checkout Page
Tarife calculate în timp real
Disponibil pe planul Shopify Advanced sau superior
Afișați tarifele exacte de livrare pentru fiecare curier direct în Checkout, permițând clienților să aleagă curierul preferat în Thank You page.
Clienții aleg curierul și văd prețul exact la Thank You Page
Despre planurile Shopify
Funcționalitatea de afișare a tarifelor calculate în timp real (carrier-calculated shipping rates) este o limitare a platformei Shopify, nu a plugin-ului Colete Online. Această funcționalitate necesită planul Shopify Advanced sau superior.
Pentru detalii despre planurile Shopify, consultați: Shopify Pricing
Dacă sunteți deținătorul unui magazin mai mic (până la aproximativ 7.000–8.000 de comenzi pe lună), nu veți avea nimic de plată, întrucât vă veți încadra garantat în limita de request-uri gratuite oferită de Google.
Cerințe preliminare
Înainte de a începe instalarea, asigurați-vă că aveți:
< Obligatoriu
- Cont activ Colete Online(Crează cont aici)
- Magazin Shopify activ
Obligatoriu pentru activare comenzi
- Credit disponibil în contul Colete Online(Alimentează cont)
- Date de facturare complete în Colete Online(Completează aici)
- Cont bancar pentru rambursuri configurat(Configurează aici) - doar pentru comenzi cu ramburs
Opțional (pentru funcții avansate)
- Plan Shopify "Advanced" sau superior - necesar pentru:
- Afișarea tarifelor calculate în timp real la Thank You Page
- Opțiuni avansate de configurare tarife
Atenție: Fără aceste date complete, veți întâmpina erori la activarea comenzilor!
Instalarea aplicației Colete-Online în Shopify
Pas 1.1: Accesează Shopify App Store
Metoda 1: Link direct
Deschide aplicația în Shopify App StoreMetoda 2: Căutare manuală
- Loghează-te în Shopify Admin
- Click pe "Apps" în meniul din stânga
- Click pe "Shopify App Store"
- Caută "Colete Online"
Aplicația Colete Online în Shopify App Store
Pas 1.2: Instalează aplicația
- Click pe butonul verde "Add app" / "Adaugă aplicație"
- Shopify va solicita permisiuni - citește și aprobă permisiunile necesare:
- Acces la comenzi (pentru sincronizare)
- Acces la produse (pentru calcul greutate/dimensiuni)
- Acces la tarife transport (pentru afișare în Thank You Page)
- Click "Install app"
Pas 1.3: Conectare cont Colete Online
După instalare, vei fi redirecționat către platforma Colete Online pentru autentificare:
- Introdu email-ul și parola contului tău Colete Online
- Sau creează un cont nou dacă nu ai unul
- Click "Autorizează aplicația"
Notă: Aplicația va genera automat o cheie API pentru magazinul tău Shopify
2. Configurarea setărilor
După instalarea plugin-ului în platforma Shopify, pentru efectuarea configurărilor veți fi redirecționat către platforma Colete Online. Puteți modifica ulterior oricând aceste setări accesând secțiunea integrare din contul dumneavoastră in platforma Colete Online.
Anumite setări avansate de configurare nu vor fi disponibile decât utilizatorilor care au activat planul tarifar "Advanced" (sau alt plan superior) al platformei Shopify pe care îl regăsiți la link-ul următor: https://www.shopify.com/pricing
În pagina de configurare regăsiți mai multe secțiuni:
- Setări generale: modificarea denumirii cheii de api și setări care se aplica tuturor expedierilor
- Setări servicii de curierat: setarea curierilor, a tarifelor și serviciilor
- Lockere / puncte de livrare: configurare livrare la lockere și puncte de ridicare
Asigurați-vă că ați completat toate setările în mod corespunzător înainte de salvarea cheii, consultând toate categoriile disponibile ( ex: "Setări servicii de curierat", "Lockere/puncte de livrare", etc. ).
3. Setările plugin-ului
3.1 Setări generale
Nume cheie: (disponibil din versiunea 1.0.0)
Setare care indică numele cheii pentru identificarea ei. O puteți redenumi după preferințele dumneavoastră.
Metodă de ambalare: (disponibil din versiunea 1.0.0)
Setare care indică modul de ambalare al coletelor pe care doriți să îl adoptați la expedierea acestora.
Opțiuni disponibile:
- Toate în același colet → Produsele vor fi ambalate într-un singur colet care să cuprindă tot conținutul comenzii.
- Individual → Fiecare produs va fi împachetat într-un colet separat, generandu-se câte o etichetă pentru fiecare colet.
Conținut pachete (disponibil din versiunea 1.0.0)
Setare care indică cum vom trimite conținutul comenzii către curier.
Opțiuni disponibile:
- În funcție de conținutul comenzii → Sistemul va crea automat un text care să conțină toate produsele din comandă.
- Folosește un text predefinit dacă conținutul este prea lung → În mod normal, lungimea maximă a textului referitor la conținut este de 50 de caractere. Dacă textul generat automat este prea lung, se recurge la un text predefinit de dumneavoastră.
- Text predefinit conținut
Dacă această opțiune este selectată veți avea acces la următoarele câmpuri:
Text predefinit conținut ( disponibil din versiunea 1.0.0 )
Setare care indică conținutul predefinit pentru comandă. Aveți astfel posibilitatea de a seta un singur text pentru comenzile dumneavoastră.
Afișează un preț de rezervă (disponibil din versiunea 1.0.0)
Indică prețul afișat în cazul în care există probleme sau adresa este incorectă.
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 automat de sistemul nostru.
- Afișează un preț de rezervă dacă există probleme → În cazul în care întâmpinam probleme tehnice și prețul nu poate fi calculat, se afișează un preț de rezervă configurat de dumneavoastră.
- Preț de rezervă
- Afișează un nume de rezervă pentru serviciu
- Afișează un preț de rezervă mereu (chiar dacă adresa este greșită) → 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ă în momentul în care utilizatorul introduce adresa de livrare.
- Preț de rezervă
- Afișează un nume de rezervă pentru serviciu
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:
Preț de rezervă (disponibil din versiunea 1.0.0)
Setarea valorii prețului de rezervă, dacă se dorește acest lucru.
Nume de rezervă (disponibil din versiunea 1.0.0)
Câmpul în care se configurează denumirea prețului de rezervă în cazul în care acesta a fost setat.
Comentariu ( disponibil din versiunea 1.0.0 )
Detalii extra pentru cheia dumneavoastră.
3.2 Setări servicii de curierat
Selecție serviciu
Activează / Dezactivează categorie ( disponibil din versiunea 1.0.0 )
Activează sau dezactivează categoria curentă. În cazul dezactivării categoriei, serviciile respective nu vor mai putea fi utilizate, până la reactivare.
* Atenție! Dacă dezactivați o categorie, toate setările aferente acelei categorii vor reveni la valoarea lor inițială!
Tabel servicii
În tabelul de servicii puteți activa sau dezactiva curierii sau îi puteți ordona în cazul în care dumneavoastră ați configurat acest lucru.
Pentru a putea plasa comenzi este necesar sa selectati minim un curier in tabel!
Pentru a schimba ordinea tabelului, trageți de iconița aferentă curierului dorit aflată la începutul fiecărei linii.
Setări Avansate
Setările de mai jos vor fi afișate, doar daca veți selecta din setările integrării opțiunea "Avansat".
Dacă comutați pe modul simplu, toate setările avansate vor reveni la valoarea inițială.
Mod selecție (disponibil din versiunea 1.0.0)
Modul în care curierii vor fi afișați utilizatorului.
Opțiuni disponibile:
- Afișează doar un serviciu → Clientului i se va oferi posibilitatea de a alege un singur curier care corespunde cu setările dumneavoastră.
- Individual → Fiecare produs va fi împachetat într-un colet separat, generandu-se câte o etichetă pentru fiecare colet.
- Tip selecție
- Afișează un nume personalizat pentru metoda de livrare
- Afișează toate serviciile selectate → Clientul poate alege dintre ofertele de curierat calculate de sistemul nostru
- Ordine afișare
- Afișează un număr limitat de servicii
- Afișează un nume personalizat pentru servicii
- Afișează un nume personalizat pentru metoda de livrare
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:
Tip selecție (disponibil din versiunea 1.0.0)
Specifică criteriul după care va fi aleasă metoda de transport oferită către client.
Opțiuni disponibile:
- Selectează primul curier din listă → Selectează primul curier din lista de oferte indiferent de notă sau preț.
- Selectează curierul cu cel mai bun preț → Selectează curierul cu cel mai bun preț din lista de oferte.
- Selectează curierul cu nota cea mai bună → Selecteaza curierul cu cea mai buna nota.
Această setare depinde foarte mult de ordinea din tabelul de servicii
Ordine afișare (disponibil din versiunea 1.0.0)
Specifică criteriul după care vor fi ordonați curierii.
Opțiuni disponibile:
- Ordonează în funcție de preț → Ordonează crescător lista de curieri, începând de la curierul cu cel mai bun preț.
- Ordonează în funcție de notă → Ordonează crescător lista de curieri, începând de la curierul cu nota cea mai bună.
- Folosește ordinea din tabel → Ordonează curierii in functie de ordinea indicata in tabelul de servicii
Afișează un număr limitat de servicii (disponibil din versiunea 1.0.0)
Indică numărul de servicii afișate clientului. Setarea aceasta poate restrânge numărul de servicii de curierat afișate clientului. Spre exemplu, dacă veți selecta 3 curieri dintr-un total de 7, clientul va putea vizualiza și selecta doar primi 3 din 7 curieri conform criteriilor selectate de dumneavoastră (cel mai bun preț/cea mai bună notă/ etc).
Afișează un nume personalizat pentru servicii (disponibil din versiunea 1.0.0)
Permite afișarea unui nume pe care îl puteți personaliza după preferințele dumneavoastră în cazul în care utilizatorului îi vor fi afișate mai multe metode de transport. Puteți include în acest text tagurile [courierName] și [serviceName] care vor fi înlocuite cu numele curierului respectiv numele serviciului.
Exemple:
Pentru DPD Standard, sintaxa "Curier: [courierName], Serviciu: [serviceName]" se traduce în "Curier: DPD, Serviciu: Standard".
Afișează un nume personalizat pentru metoda de livrare (disponibil din versiunea 1.0.0)
Permite afișarea unui nume pe care îl puteți personaliza după preferințele dumneavoastră, în cazul în care utilizatorului îi va fi afișat doar un singur curier, puteți include în acest text și tagurile [courierName] și [serviceName] care vor fi înlocuite cu numele curierului respectiv numele serviciului.
Exemple:
Pentru DPD Standard, sintaxa "Curier: [courierName], Serviciu: [serviceName]" se traduce în "Curier: DPD, Serviciu: Standard".
Setări preț
Pentru a putea utiliza setările de preț este nevoie să achiziționați planul tarifar "Advanced" (sau alt plan superior) al platformei Shopify, disponibil la adresa https://www.shopify.com/pricing și să activați din setările generale opțiunea "Afișează tarifele Colete Online clienților tăi în Shopify"
Preț afișat (disponibil din versiunea 1.0.0)
Setare care indică modul în care prețul va fi calculat.
Opțiuni disponibile:
- Preț calculat → Prețul afișat va fi calculat automat de sistemul nostru în funcție de comandă.
- Preț fix → Afișează un preț fix setat de dumneavoastră.
- PreÈ› fix
- Preț fix avansat → Oferă posibilitatea configurării prețurilor pentru fiecare curier în parte ( inclusiv prețul opțiunilor extra ) utilizând tabelul de preturi de mai jos:
Dacă această opțiune este selectată veți avea acces la următoarele câmpuri:
PreÈ› fix (disponibil din versiunea 1.0.0)
Setare care specifică prețul fix afișat clientului în cazul în care ați optat pentru un preț fix.
Adaugă o sumă fixa la preț (disponibil din versiunea 1.0.0)
La prețul final al ofertelor, fie el fix sau calculat, se va adaugă valoarea setată de dumneavoastră.
Adaugă un procent la preț (disponibil din versiunea 1.0.0)
la prețul final al ofertelor, fie el fix sau calculat, se va adaugă procentul setat de dumneavoastră
Rotunjește prețul: (disponibil din versiunea 1.0.0)
Opțiuni disponibile:
- 0 → prețul rămâne nemodificat.
- 0.5
- 1
- 5
- 10
Exemple:
Pentru prețul de 13.2 lei avem:
- Pentru 0 → 13.2 lei
- Pentru 0.5 → 13.5 lei
- Pentru 1 → 14 lei
- Pentru 5 → 15 lei
- Pentru 10 → 20 lei
Permite transportul gratuit (disponibil din versiunea 1.0.0)
Setare care vă oferă posibilitatea de a oferi clienților transport gratuit.
Opțiuni disponibile:
- Fară transport gratuit → În acest caz, setarea este dezactivată, iar clientulul va plăti o taxă de transport.
- După sumă → Dacă prețul comenzii depășește valoarea specificată de dumneavoastră, clientul va beneficia de transport gratuit.
- Pentru comenzile cu suma mai mare de
- Text transport gratuit
Dacă această opțiune este selectată veți avea acces la următoarele câmpuri:
Pentru comenzile cu suma mai mare de (disponibil din versiunea 1.0.0)
Pragul de la care se oferă transportul gratuit.
Text transport gratuit (disponibil din versiunea 1.0.0)
Textul cu care va fi înlocuit numele curierului în cazul în care se oferă transport gratuit
3.3 Setări comandă
Deschidere la livrare (disponibil din versiunea 1.0.0)
Configurează opțiunea de "deschidere la livrare" a comenzii. În cazul în care va fi selectată opțiunea "Nu" clientul nu poate beneficia de serviciul "deschidere la livrare" pentru curierii care îl oferă iar în cazul opțiuni "Da" acest serviciu va fi activ pentru toate comenzile generate.
Asigurare (disponibil din versiunea 1.0.0)
Configurează opțiunea de "asigurare" a comenzii. În situația în care comanda nu este asigurată, în cazul pierderii/deteriorării veți fi despăgubit conform legilor poștale (cu de 5 ori valoarea transportului).
Trimite mail către destinatar (disponibil din versiunea 1.0.0)
Setare care specifică dacă la crearea comenzii, destinatarul ar trebui să primească un mail cu datele acesteia precum și informații legate de livrare.
4. Comandă în Shopify
Serviciile de curierat selectate în tabelul de servicii for fi afișate și în platforma shopify în cazul în care ați oferiți clientului opțiunea de a alege curierul. Daca aveți activ pe contul dumneavoastră Shopify planul tarifar "Advanced" (sau alt plan superior) vor fi afișate și tarifele fiecărui curier.
Pentru a vedea comenzile trebuie să intrați în utilizator, iar mai apoi să intrați în comenzi shopify și veți vedea toate comenzile dumneavoastră afișate în tabel.
În tabel vi se vor afișa toate comenzile, pe care le veți putea activa făcând click pe oriunde pe rândul aferent comenzii.
Înainte de activarea comenzilor asigurați-vă că aveți următoarele date completate în contul dumneavoastră Colete Online:
- Datele de facturare: puteți modifica sau completa aceste date accesând https://www.colete-online.ro/profile/invoice-data
- Contul bancar pentru rambursuri: accesând următorul link https://www.colete-online.ro/profile/settings/repayment puteți completa contul bancar pentru rambursuri
- Credit suficient în cont: puteți alimenta contul Colete Online folosind următorul link: https://www.colete-online.ro/profile/prepay
Absenta acestor informații din contul dumneavoastră va genera erori în momentul activării comenzilor dumneavoastră generate prin Shopify
Pentru a putea activa o comandă trebuie să aveți în vedere completarea corectă a tuturor câmpurilor în cazul în care există erori. După corectarea erorilor aplicația vă permite selectarea serviciilor de curierat dorite. Câmpurile fără erori vor avea culoarea verde cu specificația "Gata de activare" și vor putea fi activate prin selecție multiplă bifând căsuță aferentă din partea strângă.
Info: dacă veți configura dimensiunile unui produs ele se pot salva folosind butonul din dreapta, astfel încât pe viitor platforma nu le va mai solicita. Totodată puteți salva și configurația pachetului în cazul în care expediați frecvent tipul respectiv de comenzi.
5. Puncte de ridicare (Lockere)
Ce sunt punctele de ridicare?
Funcționalitatea de Lockere permite clienților dumneavoastră să selecteze puncte de livrare alternative (lockere, puncte de ridicare) direct din Thank you Page-ul Shopify, folosind o hartă interactivă Google Maps.
Pentru a utiliza funcționalitatea de Lockere cu hartă interactivă, este necesar să configurați Google Maps API. Fiecare client trebuie să-și creeze propriul API Key de la Google Maps Platform. Documentația acesteia se regǎsește mai jos.
Atenție: Google oferă 10.000 de request-uri gratuite, adică aproximativ 7.000 de comenzi gratuite. După acest prag, Google va taxa fiecare request conform politicii lor de prețuri. Costurile vor fi suportate de către dumneavoastră, nu de Colete Online.
5.1. Creare cont de billing Google Cloud
Pentru a putea utiliza Google Maps API, este obligatoriu să aveți un cont de billing activ în Google Cloud. Urmați pașii de mai jos pentru a crea și configura contul de billing:
Pas 5.1.1: Accesare Google Cloud Console și verificare cont
- Accesați Google Cloud Console
- Autentificați-vă cu contul dumneavoastră Google
- Dacă este prima dată când folosiți Google Cloud, veți fi ghidat să creați un proiect
Utilizator nou?
Dacă nu aveți încă un cont Google Cloud, Google oferă un credit gratuit de 300 USD la crearea contului (valabil pentru testare). În plus, platforma include limite gratuite lunare, precum aproximativ 10 000 de request-uri – suficient pentru majoritatea magazinelor mici și medii (echivalent cu circa 7 000-8 000 de comenzi).
Pas 5.1.2: Accesare Google Maps Platform
- În Google Cloud Console, navigați la Google Maps Platform
- Sau accesați direct Google Maps Platform Overview
- Veți vedea un buton "Finish account setup" dacă nu aveți billing configurat
Pagina Google Maps Platform - click pe "Finish account setup"
Pas 5.1.3: Creare cont de billing
După ce ați accesat secțiunea de billing, urmați pașii:
- Click pe "Finish account setup" sau "Create billing account"
- Completați formularul de creare cont de billing:
- Name - Introduceți un nume sugestiv (ex: "My Maps Billing Account")
- Country - Selectați țara dumneavoastră (ex: "Romania")
- Currency - Va fi setat automat pe USD
- Click pe butonul "Continue"
Formular de creare cont de billing - completați numele și țara
Numele contului de billing este doar pentru identificarea internă și nu va fi vizibil public. Alegeți un nume care vă ajută să identificați ușor contul (ex: "Shopify Maps", "Colete Online Maps", etc.)
Pas 5.1.4: Configurare profil de billing
După crearea contului, va trebui să configurați profilul de billing:
- Veți fi redirecționat către pagina "Set up your billing profile"
- Veți vedea două secțiuni care trebuie completate:
- Contact information - informațiile dumneavoastră de contact
- Payment method - metoda de plată (card bancar)
- Click pe "Change" la secțiunea Contact information pentru a completa/verifica datele
- Click pe "Change" la secțiunea Payment method pentru a adăuga un card
Configurare profil de billing - completați informațiile de contact și metoda de plată
Ce card să folosesc?
Google acceptă carduri de credit și debit Visa, Mastercard și American Express. Nu veți fi taxat imediat - Google va face doar o verificare a cardului (preautorizare de aproximativ 1 USD care va fi returnată).
Pas 5.1.5: Adăugare metodă de plată
- Click pe "Change" la secțiunea Payment method
- Veți fi redirecționat să vă verificați identitatea
- Click pe "Continue" în dialog-ul "Verify it's you"
- Se va deschide o fereastră nouă unde veți introduce datele cardului
- Completați toate informațiile cardului și click pe "Submit"
Verificare identitate - click pe "Continue" pentru a adăuga cardul
Asigurați-vă că sunteți pe un site securizat Google (verificați URL-ul să conțină "google.com"). Nu introduceți datele cardului pe site-uri suspecte. Google nu va solicita niciodată datele cardului prin email.
Pas 5.1.6: Finalizare și activare billing
- După adăugarea cardului, veți fi redirecționat înapoi la pagina de billing profile
- Verificați că ambele secțiuni (Contact information și Payment method) sunt completate
- Click pe butonul "Submit and enable billing"
- Veți vedea un mesaj de confirmare că billing-ul a fost activat cu succes
Billing activat cu succes!
Contul dumneavoastră de billing este acum activ și puteți continua cu activarea Google Maps API și crearea cheii API. Veți beneficia automat de 300 USD credit gratuit lunar de la Google.
Informații despre costuri și monitorizare
După activarea billing-ului, este important să monitorizați costurile:
- Credit gratuit: 300 USD/lună pentru toate serviciile Google Maps
- Maps JavaScript API: 7 USD per 1,000 requests (după consumarea creditului gratuit)
- Estimare pentru magazine mici: în general, nu există costuri suplimentare dacă aveți sub 7.000–8.000 de comenzi pe lună
Cum să monitorizați costurile:
- Accesați Google Cloud Billing
- Selectați contul de billing creat
- Navigați la "Reports" pentru a vedea utilizarea și costurile
- Setați alerte de buget în secțiunea "Budgets & alerts"
Recomandări pentru reducerea costurilor:
- Implementați cache pentru adrese deja căutate
- Folosiți restricții stricte pe API Key (vezi secțiunea următoare)
- Monitorizați utilizarea săptămânal în Google Cloud Console
- Setați alerte de buget pentru a evita surprize neplăcute
Pentru tarife actualizate și detalii complete, consultați: Google Maps Pricing Official Documentation
5.2. Obținere cheie Google Maps API
După ce ați configurat contul de billing, puteți crea cheia API necesară pentru funcționalitatea de Lockere. Urmați pașii de mai jos:
Pas 5.2.1: Activare Maps JavaScript API
- Accesați Google Cloud Console → APIs & Services → Library
- Căutați "Maps JavaScript API"
- Click pe "Enable the Maps JavaScript API"
- Click pe butonul "Enable"
Activați Maps JavaScript API pentru proiectul dumneavoastră
Notă
După activarea API-ului, poate dura câteva minute până devine activ. Dacă API-ul este deja activat, veți vedea butonul "Manage" în loc de "Enable".
Pas 5.2.2: Creare cheie API
- Accesați Google Maps Platform → Keys & Credentials
- Click pe "Go to the Keys & Credentials page"
- Selectați proiectul dorit (dacă aveți mai multe)
- Sub "API Keys", găsiți lista de chei disponibile
Accesați pagina de gestionare a cheilor API
Creare cheie nouă:
- Click pe "+ Create credentials" → "API key"
- Va apărea un dialog cu cheia dvs. nou creată
- Click pe "Name" pentru a edita numele cheii (ex: "Shopify - Colete Online Lockere")
Creați o cheie API nouă pentru funcționalitatea Lockere
Pas 5.2.3: Configurare restricții API Key (IMPORTANT!)
Google recomandă să restricționați cheia API pentru a preveni utilizarea neautorizată și costuri nedorite. Sunteți responsabil financiar pentru abuzul de chei API nerestriționate!
Pagina de restricții pentru cheia API
Configurare restricții:
- Click pe numele cheii API pentru a o edita
- Scroll până la secțiunea "Key restrictions"
- Application restrictions:
- Selectați "HTTP referrers (websites)"
- Adăugați domeniile magazinului dvs. Shopify:
*.myshopify.com/*(pentru backend Shopify)your-store.com/*(înlocuiți cu domeniul dvs. custom)
- API restrictions:
- Selectați "Restrict key"
- Din dropdown, selectați "Maps JavaScript API"
- Opțional, puteți adăuga și alte API-uri necesare (ex: Places API, Geocoding API)
- Click "Save"
Best Practice
Restricționați cheia API la minimum necesar:
- Doar domeniul magazinului dvs. Shopify
- Doar Maps JavaScript API (nu toate serviciile Google Maps)
Pentru mai multe detalii: Google Maps Security Best Practices
Pas 5.2.4: Copiază și salvează cheia API
- Click pe "Show key" pentru a vizualiza cheia
- Copiați cheia API (șir alfanumeric lung)
- Salvați cheia într-un loc sigur - o veți folosi în configurarea Lockere-lor din platforma Colete Online
Copiați cheia API pentru a o introduce în setările Lockere
Nu partajați cheia API public și nu o salvați în repository-uri publice (GitHub, etc.)
5.3. Configurare Lockere în platforma Colete Online
După ce ați obținut cheia Google Maps API, puteți configura funcționalitatea de Lockere în platforma Colete Online:
Pas 5.3.1: Accesare setări Lockere
- Autentificați-vă în platforma Colete Online
- Navigați la Utilizator → Integrări → Shopify
- Selectați cheia API a magazinului dumneavoastră Shopify
- Click pe tab-ul "Lockere/puncte de livrare"
Accesați tab-ul "Lockere/puncte de livrare" din setările integrării Shopify
Nu uitați sǎ salavați modificǎrile fǎcute!
Pas 5.3.2: Activare categorie Lockere
- În partea de sus a paginii, veți vedea switch-ul "Activează categoria 'Lockere / Punct de ridicare'"
- Activați acest switch pentru a activa funcționalitatea de Lockere
- După activare, vor apărea câmpurile de configurare
Dacă dezactivați categoria Lockere, toate setările aferente vor reveni la valoarea lor inițială! Salvați cheia API Google Maps într-un loc sigur pentru a o putea reintroduce dacă este necesar.
Pas 5.3.3: Introducere cheie API Google Maps
- În câmpul "Cheie API Google Maps", introduceți cheia API pe care ați copiat-o anterior
- Verificați că ați introdus cheia corect (fără spații la început sau final)
Atenție! În cazul în care cheia este incorectă, harta nu va fi afișată iar clienții nu vor putea alege lockere!
Asigurați-vă că:
- Cheia API este corectă și completă
- Maps JavaScript API este activat în Google Cloud Console
- Billing-ul este activat și functional
- Restricțiile sunt configurate corect (domeniile Shopify și Colete Online sunt permise)
Pas 5.3.4: Configurare setări Lockere
Configurați setările suplimentare pentru funcționalitatea de Lockere:
- Nume metodă livrare lockere: Denumirea care va apărea în checkout Shopify (ex: "Livrare la locker")
- Rază afișare puncte apropiate: Distanța în km pentru afișarea lockere-lor disponibile (ex: "2" km)
- Afișează un număr limitat de lockere: Numărul maxim de lockere afișate pe hartă (ex: "3")
Recomandare
Recomandăm să limitați numărul de lockere afișate la 3-5 pentru a nu copleși clientul cu prea multe opțiuni. Raza de 2-5 km este de obicei suficientă pentru zone urbane.
Pas 5.3.5: Configurare curieri disponibili pentru Lockere
În tabelul de servicii, selectați curierii care vor fi disponibili pentru livrarea la lockere:
- Scroll până la secțiunea "Tabel servicii"
- Bifați curierii care oferă serviciu de lockere (ex: Cargus Easy Collect, DPD 2Locker)
- Puteți reordona curierii tragând de iconița din partea stângă
Pentru a putea plasa comenzi cu lockere este necesar să selectați minim un curier care oferă acest serviciu!
Pas 5.3.6: Configurare notificări Lockere
Pentru a gestiona mai eficient comenzile cu livrare la locker, configurați notificări automate care vor fi trimise când clienții nu selectează un locker la plasarea comenzii.
1. Notificare către client:
- Activați switch-ul "Trimite mail către clienții care nu selectează locker"
- Configurați "Notifică clientul după (minute)":
- Valoarea recomandată: 10 minute
- Clientul va primi un email cu link pentru a selecta lockerul după acest interval
Ce conține email-ul către client?
Clientul va primi un email automat cu un link pentru a selecta un locker. Email-ul include detaliile comenzii și instrucțiuni clare pentru selectarea lockerului.
2. Notificare către administrator:
- Activați switch-ul "Trimite mail către administrator dacă clientul nu selectează locker"
- Configurați "Interval verificare (minute)":
- Valoarea recomandată: 30 minute
- La numărul de minute setate se vor verifica toate comenzile cu livrare la punct și se va notifica magazinul
- Important: Se va trimite un mail nou doar dacă apare o comandă nouă pentru care nu s-a trimis notificare
Ce conține email-ul către administrator?
Veți primi un email cu lista comenzilor pentru care clienții nu au selectat lockere, împreună cu datele de contact ale clienților pentru a-i putea contacta telefonic.
Activare notificare automată către client și administrator
3. Setări avansate notificări:
Timp de la plasare comandă:
- Configurați "Timp de la plasare comandă (minute)":
- Valoarea recomandată: 5 minute
- Când se face o verificare, aceasta specifică de cât timp trebuie să fi fost plasată comanda
Program trimitere notificări:
- Configurați "Program trimitere notificări":
- Oricând
- Doar de luni până vineri - Notificări doar în zilele lucrătoare
- Program personalizat - Setați intervalul orar specific
- Configurați "Început interval trimitere notificări":
- Valoarea recomandată: 09:00
- Ora de început în care se pot trimite notificările
- Configurați "Sfârșit interval trimitere notificări":
- Valoarea recomandată: 17:00
- Ora de sfârșit în care se pot trimite notificările
Dacă setați un program personalizat (ex: 09:00 - 17:00), notificările vor fi trimise doar în acest interval. Comenzile plasate în afara programului vor primi notificări la începutul următorului interval activ.
Adresă de email:
- Selectați "Adresă de mail":
- Trimite către adresa contului Colete-Online - Notificările se trimit la email-ul principal (recomandat)
- Trimite către o altă adresă - Specificați o adresă email personalizată
- Dacă alegeți adresă personalizată, puteți introduce mai multe adrese separate prin virgulă (,)
Configurare setări avansate: timp, program și adresă email
Recomandări pentru configurarea notificărilor:
- Notificare client: 10 minute - Suficient timp pentru client să finalizeze comanda
- Interval verificare admin: 30 minute - Evită spam-ul de email-uri
- Timp de la plasare: 5 minute - Interval optim pentru verificare
- Program trimitere: Setați conform programului magazinului (ex: 09:00 - 17:00, Luni-Vineri)
- Adresă email: Folosiți adresa principală sau setați una dedicată pentru notificări
Valori implicite pentru configurarea notificărilor:
- Trimite mail către clienții care nu selectează locker: Activat
- Notifică clientul după: 10 minute
- Trimite mail către administrator dacă clientul nu selectează locker: Activat
- Interval verificare: 30 minute
- Timp de la plasare comandă: 5 minute
- Program trimitere notificări: Doar de luni până vineri
- Început interval trimitere notificări: 09:00
- Sfârșit interval trimitere notificări: 17:00
- Adresă de mail: Trimite către adresa contului Colete-Online
Dacă aceste valori nu sunt modificate manual în panoul de administrare, ele vor fi folosite automat de sistem la trimiterea notificărilor.
Activarea notificărilor ajută la reducerea erorilor de livrare și asigură că toate comenzile cu lockere sunt procesate corect. Intervalele recomandate sunt optimizate pentru a nu face spam dar nici să întârzieze notificările importante.
5.4. Configurare metodă de livrare Lockere în Shopify
După ce ați configurat cheia Google Maps API și setările de Lockere în platforma Colete Online, este obligatoriu să adăugați metoda de livrare pentru Lockere în setările Shopify. Fără acest pas, clienții nu vor putea selecta opțiunea de livrare la locker la checkout.
Cerințe preliminare
Înainte de a configura metoda de livrare, asigurați-vă că:
- Aplicația Colete Online este instalată din Shopify App Store
- Sunteți autentificat cu contul corect în platforma Colete Online
- Aveți acces la setările magazinului Shopify
Pas 5.4.1: Configurare limbă și locație magazin
Setare limbă română:
- Accesați Settings → General în Shopify Admin
- La secțiunea "Store details", setați limba magazinului pe Română
- Salvați modificările
Configurare locație magazin:
- Accesați Settings → Locations
- Verificați că locația magazinului este setată pe România
- Dacă este necesar, editați locația și setați țara corectă
De ce este important?
Setarea corectă a limbii și locației asigură că metodele de livrare și punctele de livrare vor fi afișate corect pentru clienții din România.
Pas 5.4.2: Adăugare bloc Lockere în Checkout
Accesare editor Checkout:
- Navigați la Sales Channels → Online Store
- Click pe "Customize" la tema curentă activă
- În partea de sus, în dropdown-ul de selectare pagini (centru ecran), selectați "Checkout"
Dacă încercați să accesați Checkout-ul și primiți eroare "Failed to load the page", NU folosiți URL-ul manual din preview. Folosiți exclusiv dropdown-ul de selectare pagini.
Adăugare bloc "Colete Online lockers map":
- În sidebar-ul din stânga, veți vedea 3 secțiuni de configurare
- Click pe ultima secțiune (Apps) din sidebar
- Va apărea lista de app extensions disponibile
- Căutați "Colete Online lockers map"
- Click pe "Add block" sau butonul "+" pentru a adăuga blocul
Selectați "Colete Online lockers map" din lista de app extensions
Important! Adăugați blocul pe următoarele pagini:
- Thank you page - oferă funcționalitatea clienților de a-și selecta lockerul la plasarea comenzii
- Order status page - clienții pot vede lockerul selectat după finalizarea comenzii
- După adăugarea blocului pe Thank you page, click pe "Save"
- Selectați din dropdown "Order status"
- Repetați pașii 2-5 pentru a adăuga blocul și pe această pagină
- Click pe "Save"
IMPORTANT!
În Shopify, secțiunea Customize → Checkout este folosită doar pentru a activa integrarea lockere-lor Colete Online. Aceasta permite afișarea hărții cu punctele de livrare pe Thank You Page și pe Order Status Page.
În modul de testare, etapa de Checkout servește doar pentru a selecta opțiunea de livrare la locker. Alegerea efectivă a lockerului (prin hartă interactivă) se face ulterior, după finalizarea plății, direct pe Thank You Page.
Bloc adăugat cu succes!
Harta cu lockere va fi afișată acum în Thank you Page (pagina de confirmare a comenzii).
Pas 5.4.3: Configurare piață (Market) pentru România
- Navigați la Settings → Markets
- Click pe "Add market"
- Denumiți market-ul: "România"
- Selectați România din lista de țări
- Click pe "Save"
Ce sunt Markets?
Markets în Shopify permit configurarea de setări specifice pentru diferite regiuni geografice, inclusiv metode de livrare și prețuri diferite.
Pas 5.4.4: Adăugare metodă de livrare "Livrare la locker"
IMPORTANT: Acest pas este OBLIGATORIU! Fără metoda de livrare configurată, punctele de ridicare nu vor apărea la Thank you Page!
Denumirea metodei de livrare ("Livrare la locker") trebuie să fie identică cu cea configurată în platforma Colete-Online. Asigurați-vă că denumirea se potrivește exact pentru ca harta cu lockerele să fie afișată corect în Shopify.
Shipping and Delivery - Shopify
Nume metoda livrare lockere - Colete Online
- Accesați Settings → Shipping and delivery
- La secțiunea "Shipping", găsiți market-ul "România"
- Click pe "Manage" la market-ul România
- Scroll până la secțiunea de shipping rates
- Click pe "Add rate" (sau "Create shipping zone" dacă nu aveți zone create)
Pagina de configurare Shipping pentru market-ul România - adăugați metoda "Livrare la locker"
Configurare detalii metodă de livrare:
- Rate name: Introduceți
"Livrare la locker" - Price: Setați prețul (ex: 0 pentru gratuit, sau un preț fix)
- Opțional: Configurați condiții (ex: preț minim comandă, greutate maximă)
- Click pe "Done"
- Click pe "Save" în partea de sus a paginii
Configurare avansată prețuri
Dacă aveți planul Shopify Advanced sau superior și ați configurat tarifele calculate în timp real în setările Colete Online, prețurile vor fi calculate automat în funcție de adresa clientului și greutatea coletului.
Altfel, puteți seta un preț fix sau gratuit pentru această metodă de livrare.
Pas 5.4.5: Verificare funcționalitate
Testare configurație Lockere:
- Accesați magazinul dumneavoastră Shopify (preview)
- Adăugați un produs în coș
- Mergeți la Checkout
- Introduceți o adresă de livrare din România
- Verificați că metoda "Livrare la locker" apare în opțiunile de shipping
- Selectați metoda "Livrare la locker"
- Ar trebui să apară harta Google Maps cu lockerele disponibile în Tahnk You page
- Testați selectarea unui locker din hartă
Configurare completă!
Funcționalitatea Lockere este acum complet configurată și funcțională. Clienții pot selecta puncte de livrare (lockere) direct din Thank you Page folosind harta interactivă.
Probleme comune și soluții
Harta nu apare la Thank you Page
Cauze posibile:
- Cheia Google Maps API este incorectă sau lipsește
- Billing-ul Google Cloud nu este activat
- Restricțiile API Key blochează domeniul Shopify
- Metoda de livrare "Livrare la locker" nu este creată în Settings → Shipping
- Blocul "Colete Online lockers map" nu este adăugat în Thank you Page
Soluție:
- Verificați cheia API în setările Lockere din platforma Colete Online
- Verificați că billing-ul este activ în Google Cloud Console
- Verificați restricțiile API Key să permită domeniul
*.myshopify.com - Verificați că ați creat metoda de livrare "Livrare la locker" în Shopify (Pas 3.4.4)
- Verificați că ați adăugat blocul în Thank you Page (Pas 3.4.2)
Metoda "Livrare la locker" nu apare la Checkout
Cauze posibile:
- Metoda de livrare nu este configurată în Settings → Shipping and delivery
- Market-ul România nu este creat sau configurat corect
- Clientul introduce o adresă din afara României
Soluție:
- Urmați pașii din Pas 6.4.4 pentru a crea metoda de livrare
- Verificați că market-ul România include țara România (Pas 6.4.3)
- Testați cu o adresă validă din România
Lockere-le nu sunt în apropierea adresei clientului
Soluție:
- Accesați setările Lockere în platforma Colete Online
- Ajustați "Rază afișare puncte apropiate" (recomandăm 2-5 km pentru zone urbane)
- Ajustați "Afișează un număr limitat de lockere" (recomandăm 3-5 lockere)
- Salvați modificările
Eroare "Failed to load the page" când încerc să accesez Checkout
Cauză:
Încercați să accesați checkout-ul prin URL manual sau prin preview în loc să folosiți dropdown-ul de selectare pagini.
Soluție:
- NU folosiți URL-ul manual din bara de preview
- Folosiți exclusiv dropdown-ul de selectare pagini din partea de sus (centru ecran)
- Selectați "Checkout" din listă
Activare notificare automată către client și administrator
3. Setări avansate notificări:
Timp de la plasare comandă:
- Configurați "Timp de la plasare comandă (minute)":
- Valoarea recomandată: 5 minute
- Când se face o verificare, aceasta specifică de cât timp trebuie să fi fost plasată comanda
Program trimitere notificări:
- Configurați "Program trimitere notificări":
- Oricând
- Doar de luni până vineri - Notificări doar în zilele lucrătoare
- Program personalizat - Setați intervalul orar specific
- Configurați "Început interval trimitere notificări":
- Valoarea recomandată: 09:00
- Ora de început în care se pot trimite notificările
- Configurați "Sfârșit interval trimitere notificări":
- Valoarea recomandată: 17:00
- Ora de sfârșit în care se pot trimite notificările
Dacă setați un program personalizat (ex: 09:00 - 17:00), notificările vor fi trimise doar în acest interval. Comenzile plasate în afara programului vor primi notificări la începutul următorului interval activ.
Adresă de email:
- Selectați "Adresă de mail":
- Trimite către adresa contului Colete-Online - Notificările se trimit la email-ul principal (recomandat)
- Trimite către o altă adresă - Specificați o adresă email personalizată
- Dacă alegeți adresă personalizată, puteți introduce mai multe adrese separate prin virgulă (,)
Configurare setări avansate: timp, program și adresă email
Recomandări pentru configurarea notificărilor:
- Notificare client: 10 minute - Suficient timp pentru client să finalizeze comanda
- Interval verificare admin: 30 minute - Evită spam-ul de email-uri
- Timp de la plasare: 5 minute - Interval optim pentru verificare
- Program trimitere: Setați conform programului magazinului (ex: 09:00 - 17:00, Luni-Vineri)
- Adresă email: Folosiți adresa principală sau setați una dedicată pentru notificări
Valori implicite pentru configurarea notificărilor:
- Trimite mail către clienții care nu selectează locker: Activat
- Notifică clientul după: 10 minute
- Trimite mail către administrator dacă clientul nu selectează locker: Activat
- Interval verificare: 30 minute
- Timp de la plasare comandă: 5 minute
- Program trimitere notificări: Doar de luni până vineri
- Început interval trimitere notificări: 09:00
- Sfârșit interval trimitere notificări: 17:00
- Adresă de mail: Trimite către adresa contului Colete-Online
Dacă aceste valori nu sunt modificate manual în panoul de administrare, ele vor fi folosite automat de sistem la trimiterea notificărilor.
Activarea notificărilor ajută la reducerea erorilor de livrare și asigură că toate comenzile cu lockere sunt procesate corect. Intervalele recomandate sunt optimizate pentru a nu face spam dar nici să întârzieze notificările importante.
