Integrácia Upgates s Manažérom zásielok
S našou integráciou nemusíte objednávky prepravy zásielok do Zaslat.sk zadávať ručne, stačí si na pár kliknutí nastaviť prepojenie a objednávky odbavovať jedným ťahom.
Vďaka tomuto riešeniu odpadá akékoľvek sťahovanie a nahrávanie CSV súborov alebo ručná editácia súborov v tabuľkovom procesore.
Vďaka integrácii sa vám údaje o zásielkach z Upgates nahrajú do Manažéra zásielok automaticky. A čo viac, ak budú v dátach nejaké nedostatky (napríklad zákazník vyplní chybné telefónne číslo), môžete tento nedostatok priamo v Manažéri zásielok napraviť.
Následne možno všetko naraz objednať, objednať len niektoré zásielky alebo jednoducho zmeniť dopravcu. Možností je mnoho.
Výdajné miesta: mapa dopravcov, alebo mapa Zaslat
Výdajné miesta môžete zákazníkom ponúknuť dvoma spôsobmi – cez mapu dopravcov (výber pobočiek od Upgates), alebo cez mapu Zaslat s dopravcami DPD, SPS a Packeta v jednej mape.
Nastavenie integrácie
Aktivácia pluginu do Upgates
Navštívte webové stránky Upgates na nasledujúcej adrese: https://doplnky.upgates.sk/detail/zaslat
Dostanete sa na stránku pluginu Zaslat, ktorý si teraz aktivujte (Obr. 1).

Plugin Zaslat sa vám nahrá priamo do administrácie doplnkov vo vašom e-shope od Upgates. Tu opäť kliknite na tlačidlo Aktivovať (Obr. 2).

Vyskakovacie okno potvrďte (Obr. 3).

Po kliknutí na tlačidlo Potvrdiť vás systém presmeruje do Manažéra zásielok od Zaslat (Obr. 4), kde dokončíte integráciu. V prípade, že už máte účet pre firmy na Zaslat, prihláste sa. V opačnom prípade sa môžete zdarma zaregistrovať a využívať všetky výhody Zaslat pre firmy.

Nastavenie v Zaslat
Zvoľte si ľubovoľný Názov tejto integrácie (Obr. 5, krok 1). V riadku Sťahovať objednávky (Obr. 5, krok 2) zvoľte jednu z možností – Všetky objednávky, Len v stave Zaslat, Len v stave Spracováva sa, alebo si prípadne môžete definovať Vlastný stav.
Ak máte nastavený v administrácii Upgates vlastný stav Zaslat, zvoľte tu možnosť Len v stave Zaslat pre sťahovanie iba objednávok v tomto stave.
V Manažéri zásielok si potom zvoľte Východiskovú adresu odosielateľa (Obr. 5, krok 3) z vášho adresára. Na vybranej adrese si dopravca zásielky vyzdvihne. Ak budete chcieť pri niektorej zásielke nastaviť adresu odosielateľa inú, nevadí, zmenu môžete vykonať neskôr.
Ak má každá vaša zásielka iné rozmery a váhu, môžete túto možnosť ponechať prázdnu a rozmery doplniť ručne neskôr. Ak posielate všetky zásielky rovnakého tvaru a váhy, zvoľte si teraz požadovaný rozmer v riadku Východiskový balík (Obr. 5, krok 4). V možnostiach si vyberáte z vašich uložených Šablón zásielok.
Na záver kliknite na tlačidlo Uložiť zmeny (Obr. 5, krok 5).

Ďalšie nastavenia v Upgates
Nastavenie dopravcov v Upgates
Výber z prednastavených dopravcov
V novej verzii integrácie už nepoužívame možnosť „Vlastná preprava", ako tomu bolo skôr, ale vyberáme z prednastavených dopravcov priamo v Upgates.
Upgates rozdeľuje dopravu do dvoch kategórií:
- Doručenie na adresu zákazníka
- Doručenie na výdajné miesta
❗ Z dostupných dopravcov nepodporujeme tieto možnosti:
Česká pošta – Balík do rukySlovenská pošta – Balík do rukyZásilkovna – Doručení domů
Všetkých ostatných prednastavených dopravcov môžete použiť.
Pre nastavenie dopravy kliknite v ľavom menu na položku Nastavenia (Obr. 6, krok 1), ďalej možnosť Objednávky (Obr. 6, krok 2) a tu zvoľte možnosť Doprava (Obr. 6, krok 3). Na pravej strane potom kliknite na tlačidlo Nová (Obr. 6, krok 4).

Nastavenie dopravy na adresu
Kliknite na zvoleného dopravcu (napr. GLS, SPS, atď.) (Obr. 6, krok 5). Nastavte si parametre dopravy podľa seba (napr. názov, cenu). V hornej časti nezabudnite zaškrtnúť Aktívny (Obr. 7, krok 1). Nakoniec kliknite na Uložiť (Obr. 7, krok 2).

Pre doručenie na adresu tým máte hotovo.
Napojenie dopravcov FedEx, TOPTRANS a UPS
Títo dopravcovia v zozname prednastavených v Upgates nie sú.
Preto je potrebné nastaviť ich ručne ako Vlastnú prepravu. Vytvorte nového dopravcu cez možnosť Vlastná preprava (Obr. 8, krok 1).

Pomenujte ho presne: FedEx, Toptrans, alebo UPS (Obr. 9, krok 1). Nastavte ďalšie parametre podľa potreby, kliknite na tlačidlo Aktivovať (Obr. 9, krok 2) a nakoniec Uložte (Obr. 9, krok 3).

Výdajné miesta: dve možnosti
Pre doručenie na výdajné miesta (boxy a pobočky) si vyberte jednu z dvoch možností. Líšia sa tým, kto zákazníkovi v košíku zobrazí mapu výdajných miest:
| A) Mapa dopravcov – výber pobočiek od Upgates | B) Mapa Zaslat – DPD, SPS a Packeta v jednej mape | |
|---|---|---|
| Mapa v košíku | výber pobočiek priamo od Upgates, pre každého dopravcu zvlášť | jedna mapa Zaslat pre všetkých dopravcov |
| Podporovaní dopravcovia | prednastavení dopravcovia Upgates s pobočkami (okrem nepodporovaných nižšie) | DPD, SPS a Packeta |
| Viac dopravcov v jednej mape | nie | áno (napr. doprava „Výdajné miesta" so všetkými dopravcami) |
| Nastavenie | zaškrtnutie Aktivovať pobočky pri prednastavenom dopravcovi | doprava typu Vlastná so správnym názvom + vloženie kódu cez Vlastné konverzné kódy (alebo do common.js) |
| Kam sa uloží vybrané miesto | priamo k objednávke v Upgates | do poznámky k objednávke |
Obe možnosti možno v jednom e-shope kombinovať – napríklad SPS výdajné miesta cez mapu Zaslat a ostatných dopravcov cez výber pobočiek od Upgates.
A) Mapa dopravcov (Upgates)
Tieto nastavenia sa týkajú prednastavených dopravcov s výdajnými miestami (napr. Packeta, GLS Parcel Shop, atď.).
❗ Nepodporujeme:
Česká pošta – Balík na poštuDepoSlovenská pošta – Balík na poštuSlovenská pošta – BalíkoBOX
Otvorte daného dopravcu (napr. GLS – Výdajné miesto). Zaškrtnite možnosť Aktivovať pobočky (Obr. 10, krok 1). V rozbaľovacej ponuke Pobočky (Obr. 10, krok 2) zvoľte konkrétnu variantu – napr. GLS Parcel Shop. Hore zaškrtnite Aktívny (Obr. 10, krok 3) a kliknite na Uložiť (Obr. 10, krok 4).

Packeta má trochu iný spôsob napojenia a je potrebné ju rozdeliť na dva samostatné spôsoby dopravy.
- Packeta – Výdajné miesto
- Packeta – Z‑Boxy
Opäť v nastavení Packety kliknite na Aktivovať pobočku (Obr. 11, krok 1). Pri oboch variantách bude v nastavení systém vyžadovať API kľúč – môžete pokojne zadať napr. „zaslat" (Obr. 11, krok 2). Potom opäť Aktivujte (Obr. 11, krok 3) a kliknite na Uložiť (Obr. 11, krok 4). Rovnaký postup zopakujte, ak chcete svojim zákazníkom ponúknuť aj Z-Boxy.

B) Mapa Zaslat
V tejto možnosti zobrazí zákazníkovi v košíku výdajné miesta mapa Zaslat. Mapa spozná, ktorého dopravcu a aký typ výdajného miesta má ponúknuť, podľa názvu dopravy. Stačí teda dopravy pomenovať podľa tabuľky nižšie a do e-shopu vložiť krátky kód.
Na čo myslieť
- Vybrané výdajné miesto sa ukladá do poznámky k objednávke. Pri odoslaní objednávky sa na koniec poznámky od zákazníka automaticky pripíše značka, napr.
[zsltpsid#SPS-D007412@sps](kód výdajného miesta a dopravcu). Podľa nej Zaslat pri importe spozná, ktoré výdajné miesto si zákazník vybral. Značku v poznámke preto nemažte ani neupravujte. - Dopravy musia byť správne pomenované. Mapa sa riadi názvom dopravy. Ak dopravu premenujete na názov, ktorý v tabuľke nie je, mapa sa pri nej prestane zobrazovať. Názvy preto držte podľa tabuľky – alebo si nechajte upraviť pravidlá v kóde (pozri Vlastné názvy dopráv).
Krok 1: Vytvorenie dopráv
Novú dopravu vytvoríte rovnako ako vyššie v Nastavenia → Objednávky → Doprava → Nová (Obr. 6), tentoraz cez možnosť Vlastná preprava.
- Typ dopravy musí byť Vlastná (Obr. 12). Prednastavené typy dopravcov so zaškrtnutou možnosťou Aktivovať pobočky by namiesto mapy Zaslat otvorili výber pobočiek od Upgates.
- Do poľa Názov zadajte presne jeden z názvov z tabuľky nižšie (Obr. 12), napr.
Packeta - Výdajné miesto. - Zaškrtnite Aktívny, nastavte cenu a ďalšie parametre podľa potreby a kliknite na Uložiť.

Všeobecné dopravy (viac dopravcov v jednej mape)
| Názov dopravy (vložte do poľa „Názov") | Mapa zobrazí |
|---|---|
| Výdajné miesta, Výdajné miesto | všetky výdajné miesta a boxy dopravcov DPD, SPS a Packeta |
| Výdajné boxy, Výdajný box | len boxy dopravcov DPD, SPS a Packeta |
| Výdajné pobočky, Výdajná pobočka | len pobočky (výdajné miesta s obsluhou) dopravcov DPD, SPS a Packeta |
Môžete použiť jednotné aj množné číslo (napr. „Výdajné miesto" aj „Výdajné miesta"). Tieto názvy však musia tvoriť celý názov dopravy – napr. „Výdajné miesta - všetci dopravcovia" už mapu neotvorí.
Dopravy pre jedného dopravcu
| Dopravca | Len boxy | Len pobočky | Boxy aj pobočky |
|---|---|---|---|
| DPD | DPD - Box | DPD - Pobočka | DPD - Výdajné miesto, DPD - Výdajné miesta |
| SPS | SPS - Box | SPS - Pobočka | SPS - Výdajné miesto, SPS - Výdajné miesta |
| Packeta | Packeta - Box | Packeta - Pobočka | Packeta - Výdajné miesto, Packeta - Výdajné miesta |
Na veľkosti písmen a diakritike nezáleží. Názov musí obsahovať dopravcu a za ním jedno zo slov Box, Pobočka alebo Výdajné miesto – v jednotnom aj množnom čísle (Boxy, Pobočky, Výdajné miesta). Oddeľovač a ďalšie slová nevadia (funguje teda aj SPS Box, Packeta Z-BOX alebo Packeta - Výdajné miesta). Dajte si pozor na názvy, ktoré obsahujú viac týchto slov: „Packeta - Výdajné miesto (Z-BOX)" obsahuje slovo „box", a preto zobrazí len boxy.
Doprava na adresu (napr. „Packeta na adresu") mapu neotvorí – takéto názvy slová Box, Pobočka ani Výdajné miesto neobsahujú. Dopravu na adresu nastavte podľa časti Nastavenie dopravy na adresu.
Krok 2: Vloženie kódu do e-shopu
Kód mapy vložíte do e-shopu jedným z dvoch spôsobov. Použite len jeden z nich – keby bol kód v e-shope dvakrát, mapa by sa načítavala dvakrát. V oboch prípadoch vložte kód celý a bez zmien – pravidlá pre dopravy, ktoré vo svojom e-shope nemáte, ničomu nevadia. Kód je rovnaký ako v českom návode, takže funguje aj pre e-shop, ktorý predáva na Slovensko aj do Česka.
| Možnosť 1: Vlastné konverzné kódy | Možnosť 2: Editor kódu (common.js) | |
|---|---|---|
| Kde v Upgates | Doplnky → Vlastné konverzné kódy | Grafika → Editor kódu → Scripts → common.js |
| Potrebujete Editor kódu | nie – zachováte si modul Designer aj podporu grafiky od Upgates | áno – musia byť zapnuté Rozšírené možnosti Editora kódu |
| Kód | obalený do <script> … </script> | bez <script> |
| Pre koho | odporúčané pre väčšinu e-shopov | e-shopy, ktoré už Editor kódu používajú |
Možnosť 1: Vlastné konverzné kódy (bez Editora kódu)
- V ľavom menu Upgates kliknite na Doplnky (Obr. 13, krok 1) a zvoľte Vlastné konverzné kódy (Obr. 13, krok 2).
- V časti Kódy umiestnené na všetkých stránkach vložte do poľa Kód je umiestnený pred tagom
</body>nasledujúci kód (Obr. 13, krok 3). Ak už v poli nejaký kód máte, vložte náš kód na jeho koniec. - Kliknite na Uložiť (Obr. 13, krok 4).
Code
E-shop vo viacerých jazykoch
Polia sú zvlášť pre každý jazyk e-shopu – skratku jazyka (napr. sk) vidíte vpravo dole v poli. Kód vložte do poľa Kód je umiestnený pred tagom </body> pri každom jazyku.

Možnosť 2: Editor kódu (common.js)
Zapnutie Editora kódu vypne Designer
V predvolenom nastavení Upgates do priečinka Scripts prístup nemáte – je potrebné zapnúť Rozšírené možnosti Editora kódu. Tým prídete o možnosť ďalej používať modul Designer, o nové funkcie budúcich verzií grafiky, o úpravy z Editora kódu pri prípadnom návrate k Designeru a o technickú podporu ku grafike zo strany Upgates. Ak Editor kódu zatiaľ nepoužívate, zvoľte možnosť 1.
- V ľavom menu Upgates prejdite do Grafika → Editor kódu.
- V priečinku Scripts (Obr. 14, krok 1) otvorte súbor common.js (Obr. 14, krok 2).
- Na úplný koniec súboru vložte nasledujúci kód (Obr. 14, krok 3) a kliknite na Uložiť (Obr. 14, krok 4).
Code

Krok 3: Overenie v košíku
Vložte do košíka ľubovoľný produkt a v kroku Doprava a platba zvoľte niektorú z novo vytvorených dopráv. Otvorí sa mapa výdajných miest Zaslat s dopravcami podľa názvu dopravy (Obr. 15). Mapa zobrazuje výdajné miesta v krajine doručenia, ktorú zákazník v košíku zvolil, a je v jazyku e-shopu.

Po výbere výdajného miesta sa jeho adresa zobrazí pod názvom dopravy a zákazník ho môže odkazom Zmeniť výdajné miesto kedykoľvek zmeniť – mapa sa potom otvorí rovno na predtým vybranom mieste (Obr. 16). Bez vybraného výdajného miesta zákazník v objednávke nepokračuje.

Po odoslaní objednávky nájdete vybrané výdajné miesto v detaile objednávky v poli Poznámka od zákazníka (Obr. 17). Prípadný text, ktorý zákazník do poznámky napísal, zostáva zachovaný nad značkou.

Vlastné názvy dopráv
Pravidlá v kóde sú tzv. regulárne výrazy – určujú, ktoré názvy dopráv mapa rozpozná. Ak potrebujete dopravy pomenovať inak, alebo chcete v jednej mape ponúknuť inú kombináciu dopravcov, je potrebné pravidlá upraviť.
Pravidlá upravujte len vtedy, ak viete, ako regulárne výrazy fungujú. Chybné pravidlo môže zobraziť mapu aj pri doručení na adresu, alebo ju naopak nezobraziť vôbec.
Radi vám pomôžeme – napíšte nám na admin@zaslat.cz názvy svojich dopráv a pravidlá vám pripravíme.
Nastavenie stavov objednávok
Aby sa neprenášali do Zaslat všetky objednávky z vášho Upgates, ale len tie, ktoré chcete cez Zaslat skutočne poslať, musíte si v Upgates nastaviť vlastný Stav objednávky. V ľavom menu kliknite na položku Nastavenia (Obr. 18, krok 1), zvoľte možnosť Objednávky (Obr. 18, krok 2), potom kliknite v menu na možnosť Stavy (Obr. 18, krok 3) a v pravom hornom rohu kliknite na tlačidlo Nový (Obr. 18, krok 4).

Do políčka Názov (Obr. 19, krok 1) vpíšte Zaslat a kliknite na tlačidlo Uložiť (Obr. 19, krok 2).

Priradenie stavov k objednávkam
Teraz máte nový stav objednávok vytvorený a môžete ho priradiť vo vašich objednávkach. V detaile objednávky môžete zmeniť stav objednávky na nový vami vytvorený stav Zaslat.sk (Obr. 20).

Import objednávok
Import objednávok do Zaslat a ich úpravy
Vždy, keď budete posielať zásielky, stačí v prehľade objednávok Manažéra zásielok aktualizovať objednávky z integrácií kliknutím na tlačidlo Synchronizovať integrácie (Obr. 21, krok 1) v pravom hornom rohu a všetky objednávky z Upgates vám zobrazíme v prehľadnom zozname. Preprava v tomto momente ešte nie je objednaná – v každej objednávke si môžete čokoľvek upraviť: adresu odosielateľa, príjemcu, rozmery, váhu, dobierku aj dopravcu. Keď si všetko skontrolujete, môžete Objednať (Obr. 21, krok 2).
