Copy page

CZ

Integrace Upgates s Manažerem zásilek

S naší integrací nemusíte objednávky přepravy zásilek do Zaslat zadávat ručně, stačí si na pár kliknutí nastavit propojení a objednávky odbavovat jedním tahem.

Díky integraci se vám údaje o zásilkách z Upgates nahrají do Manažeru zásilek automaticky. A co více, pokud bude v datech nějaký nedostatek (například zákazník vyplní chybné telefonní číslo), tak můžete tento nedostatek přímo v Manažeru zásilek napravit.

Následně lze vše naráz objednat, objednat jen některé zásilky nebo snadno změnit dopravce. Možností je mnoho.

Nastavení integrace

Aktivace pluginu do Upgates

Navštivte webové stránky Upgates na následující adrese: https://doplnky.upgates.cz/detail/zaslat

Dostanete se na stránku pluginu Zaslat, který si nyní aktivujte (Obr. 1).

Obrázek 1: Karta pluginu Zaslat v Upgates

Plugin Zaslat se vám nahraje přímo do administrace doplňků ve vašem e-shopu od Upgates. Tady opět klikněte na tlačítko Aktivovat (Obr. 2).

Obrázek 2: Aktivace pluginu Zaslat v Upgates

Vyskakovací okno potvrďte (Obr. 3).

Obrázek 3: Potvrzení aktivace doplňku

Po kliknutí na tlačítko Potvrdit vás systém přesměruje do Manažera zásilek od Zaslat (Obr. 4), kde dokončíte integraci. V případě, že již máte účet pro firmy na Zaslat, přihlaste se. V opačném případě se můžete zdarma zaregistrovat a využívat všechny výhody Zaslat pro firmy.

Obrázek 4: Přihlášení/registrace do Manažera zásilek od Zaslat

Nastavení v Zaslat

Zvolte si libovolný Název této integrace (Obr. 5, krok 1). V řádku Stahovat objednávky (Obr. 5, krok 2) zvolte jednu z možností - Všechny objednávky, Jen ve stavu Zaslat, Jen ve stavu Zpracovává se, nebo si případně můžete definovat Vlastní stav.

Pokud máte nastavený v administraci Upgates vlastní stav Zaslat, pak zde zvolte možnost Jen ve stavu Zaslat pro stahování pouze objednávek v tomto stavu.

V Manažeru zásilek si poté zvolte Výchozí adresu odesílatele (Obr. 5, krok 3) z vašeho adresáře. Na vybrané adrese si dopravce zásilky vyzvedne. Pokud budete chtít u některé zásilky nastavit adresu odesílatele jinou, nevadí, změnu můžete provést později.

Pokud má každá vaše zásilka jiný rozměru a váhu, můžete tuto možnost ponechat prázdnou a rozměry poté doplnit ručně. Pokud posíláte všechny zásilky stejného tvaru a váhy, zvolte si nyní váš požadovaný rozměr v řádku Výchozí balík (Obr. 5, krok 4). V možnostech si vybíráte z vašich uložených Šablon zásilek.

Na závěr klikněte na tlačítko Uložit změny (Obr. 5, krok 5).

Obrázek 5: Nastavení integrace v Manažeru zásilek

Další nastavení v Upgates

Nastavení dopravců v Upgates

Výběr z přednastavených dopravců

Pro doručení na adresu zákazníka vybíráte z přednastavených dopravců přímo v Upgates.

Upgates rozděluje dopravu do dvou kategorií:

• Doručení na adresu zákazníka
• Doručení na výdejní místa

Všechny ostatní přednastavené dopravce můžete použít.

Pro nastavení dopravy klikněte v levém menu na položku Nastavení (Obr. 6, krok 1), dále možnost Objednávky (Obr. 6, krok 2) a zde zvolte možnost Doprava (Obr. 6, krok 3). Na pravé straně poté klikněte na tlačítko Nová (Obr. 6, krok 4).

Obrázek 6: Přidání dopravců z nabídky Upgates

Nastavení dopravy na adresu

Klikněte na zvoleného dopravce (např. GLS, PPL, atd.) (Obr. 6, krok 5). Nastavte si parametry dopravy podle sebe (např. název, cenu). V horní části nezapomeňte zaškrtnout Aktivní (Obr. 7, krok 1). Nakonec klikněte na Uložit (Obr. 7, krok 2).

Obrázek 7: Nastavení dopravy na adresu

Pro doručení na adresu tímto máte hotovo.

Napojení dopravců FedEx, TOPTRANS a UPS

Tyto dopravce v seznamu přednastavených v Upgates nenajdete.

Proto je potřeba nastavit je ručně jako Vlastní přepravu. Vytvořte nového dopravce přes možnost Vlastní přeprava (Obr. 8, krok 1).

Obrázek 8: Přidání dopravců FedEx, TOPTRANS a UPS

Pojmenujte ho přesně: FedEx, Toptrans, nebo UPS (Obr. 9, krok 1). Nastavte další parametry dle potřeby, klikněte na tlačítko Aktivovat (Obr. 9, krok 2) a nakonec Uložte (Obr. 9, krok 3).

Obrázek 9: Nastavení dopravy FedEx (nebo TOPTRANS a UPS)

Výdejní místa: dvě možnosti

Pro doručení na výdejní místa (boxy a pobočky) si vyberte jednu ze dvou možností. Liší se tím, kdo zákazníkovi v košíku zobrazí mapu výdejních míst:

Obě možnosti lze v jednom e-shopu kombinovat – například PPL výdejní místa přes mapu Zaslat a ostatní dopravce přes výběr poboček od Upgates.

PPL výdejní místa nefungují?

Pokud máte PPL nastavené jako přednastaveného dopravce Upgates se zaškrtnutou možností Aktivovat pobočky, zákazník v košíku výdejní místa PPL neuvidí – výběr poboček PPL v Upgates vyžaduje vlastní API klíč od PPL. Bez něj PPL výdejní místa (ParcelShop, ParcelBox, AlzaBox) zprovozníte přes mapu Zaslat:

1. Vypněte původní dopravu PPL s pobočkami. V Nastavení → Objednávky → Doprava otevřete přednastavenou dopravu PPL, u které máte zaškrtnuté Aktivovat pobočky, zrušte zaškrtnutí Aktivní a uložte. Zákazník tak v košíku neuvidí dvě PPL dopravy.

2. Vytvořte novou dopravu typu Vlastní a pojmenujte ji podle toho, co chcete nabídnout:

   • PPL - Výdejní místo – výdejní místa i boxy PPL,
   • PPL - Box – jen boxy (ParcelBox, AlzaBox),
   • PPL - Pobočka – jen výdejní místa s obsluhou (ParcelShop).

   Nastavte cenu, zaškrtněte Aktivní a uložte (podrobně v kroku 1).

3. Vložte kód mapy do e-shopu – jen jednou pro celý e-shop, nejjednodušeji přes Doplňky → Vlastní konverzní kódy (bez Editoru kódu), viz krok 2.

4. Ověřte v košíku, že se po výběru dopravy PPL otevře mapa Zaslat s výdejními místy PPL (krok 3).

Ostatní dopravce můžete klidně nechat ve výběru poboček od Upgates – obě možnosti fungují v jednom e-shopu vedle sebe.

A) Mapa dopravců (Upgates)

Tato nastavení se týkají přednastavených dopravců s výdejními místy (např. Balíkovna, GLS Parcel Shop, DPD Pickup, atd.).

Otevřete daného dopravce (např. GLS – Výdejní místo). Zaškrtněte možnost Aktivovat pobočky (Obr. 10, krok 1). V rozbalovací nabídce Pobočky (Obr. 10, krok 2) zvolte konkrétní variantu – např. GLS Parcel Shop (na výběr máte GLS Parcel Shop, GLS Parcel Box a obě varianty dohromady). Nahoře zaškrtněte Aktivní (Obr. 10, krok 3) a klikněte na Uložit (Obr. 10, krok 4).

Obrázek 10: Nastavení dopravy na výdejní místa

---

Zásilkovna má trochu jiný způsob napojení a je potřeba ji rozdělit na dva samostatné způsoby dopravy.

1. Zásilkovna – Výdejní místo
2. Zásilkovna – Z‑Boxy

Opět v nastavení Zásilkovny klikněte na Aktivovat pobočku (Obr. 11, krok 1). U obou variant bude v nastavení systém vyžadovat API klíč – můžete klidně zadat např. „zaslat" (Obr. 11, krok 2). Poté opět Aktivujte (Obr. 11, krok 3) a klikněte na Uložit (Obr. 11, krok 4). Stejný postup opakujte, pokud chcete vašim zákazníkům nabídnout také Z-Boxy.

Obrázek 11: Napojení Zásilkovny

B) Mapa Zaslat (vč. PPL)

V této možnosti zobrazí zákazníkovi v košíku výdejní místa mapa Zaslat – podobně jako u integrace Shoptet. Mapa pozná, kterého dopravce a jaký typ výdejního místa má nabídnout, podle názvu dopravy. Stačí tedy dopravy pojmenovat podle tabulky níže a do e-shopu vložit krátký kód.

Krok 1: Vytvoření doprav

Novou dopravu vytvoříte stejně jako výše v Nastavení → Objednávky → Doprava → Nová (Obr. 6), tentokrát přes možnost Vlastní přeprava.

• Typ dopravy musí být Vlastní (Obr. 12). Přednastavené typy dopravců se zaškrtnutou možností Aktivovat pobočky by místo mapy Zaslat otevřely výběr poboček od Upgates.
• Do pole Název zadejte přesně jeden z názvů z tabulky níže (Obr. 12), např. Balíkovna - Výdejní místo.
• Zaškrtněte Aktivní, nastavte cenu a další parametry dle potřeby a klikněte na Uložit.

Obrázek 12: Doprava typu Vlastní s názvem podle tabulky

Obecné dopravy (všichni dopravci v jedné mapě)

Všichni dopravci jsou Balíkovna, DPD, GLS, PPL, SPS, One by Allegro (WEDO) a Zásilkovna. Můžete použít jednotné i množné číslo (např. „Výdejní místo" i „Výdejní místa"). Tyto názvy ale musí tvořit celý název dopravy – např. „Výdejní místa - všichni dopravci" už mapu neotevře.

Tyto české názvy jsou určené pro e-shopy, které odesílají z Česka – mapa v nich nabídne všechny uvedené dopravce i při doručení na Slovensko (např. PPL z Česka na Slovensko doručuje). E-shopy odesílající ze Slovenska (Zaslat.sk) pojmenují dopravy slovensky, např. „Výdajné miesta" nebo „Packeta - Výdajné miesto" – viz slovenský návod.

Dopravy pro jednoho dopravce

Na velikosti písmen a diakritice nezáleží. Název musí obsahovat dopravce a za ním jedno ze slov Box, Pobočka nebo Výdejní místo – v jednotném i množném čísle (Boxy, Pobočky, Výdejní místa). Oddělovač a další slova nevadí (funguje tedy i PPL Box, PPL - ParcelBox nebo Zásilkovna - Výdejní místa). Dejte si pozor na názvy, které obsahují víc těchto slov: „Zásilkovna - Výdejní místo (Z-BOX)" obsahuje slovo „box", a proto zobrazí jen boxy.

Krok 2: Vložení kódu do e-shopu

Kód mapy vložíte do e-shopu jedním ze dvou způsobů. Použijte jen jeden z nich – kdyby byl kód v e-shopu dvakrát, mapa by se načítala dvakrát. V obou případech vložte kód celý a beze změn – pravidla pro dopravy, které ve svém e-shopu nemáte, ničemu nevadí.

Možnost 1: Vlastní konverzní kódy (bez Editoru kódu)

1. V levém menu Upgates klikněte na Doplňky (Obr. 13, krok 1) a zvolte Vlastní konverzní kódy (Obr. 13, krok 2).
2. V části Kódy umístěné na všech stránkách vložte do pole Kód je umístěn před tagem </body> následující kód (Obr. 13, krok 3). Pokud už v poli nějaký kód máte, vložte náš kód na jeho konec.
3. Klikněte na Uložit (Obr. 13, krok 4).

Code
<script>
window.ZASLAT_MAP_CONFIG = {
  shippingMethods: [
    // Obecné dopravy pojmenované česky (e-shop odesílá z Česka) -
    // všichni dopravci podporovaní mapou
    { match: /^\s*vydejni\s+mist[oa]\s*$/,   carriers: ['balikovna', 'dpd', 'gls', 'ppl', 'sps', 'wedo', 'zasilkovna'] },
    { match: /^\s*vydejni\s+boxy?\s*$/,      carriers: ['balikovna', 'dpd', 'gls', 'ppl', 'sps', 'wedo', 'zasilkovna'], pointType: 'locker' },
    { match: /^\s*vydejni\s+pobock[ay]\s*$/, carriers: ['balikovna', 'dpd', 'gls', 'ppl', 'sps', 'wedo', 'zasilkovna'], pointType: 'branch' },

    // Obecné dopravy pojmenované slovensky (e-shop odesílá ze Slovenska) -
    // dopravci Zaslat.sk
    { match: /^\s*vydajn[eay]\s+miest[oa]\s*$/,  carriers: ['dpd', 'sps', 'zasilkovna'] },
    { match: /^\s*vydajn[eay]\s+boxy?\s*$/,      carriers: ['dpd', 'sps', 'zasilkovna'], pointType: 'locker' },
    { match: /^\s*vydajn[eay]\s+pobock[ay]\s*$/, carriers: ['dpd', 'sps', 'zasilkovna'], pointType: 'branch' },

    // Dopravy pro jednoho dopravce - české i slovenské názvy
    { match: /ppl.*box/,    carriers: ['ppl'], pointType: 'locker' },
    { match: /ppl.*pobock/, carriers: ['ppl'], pointType: 'branch' },
    { match: /ppl.*(vyd[ae]jn[aeiy]\s+mie?st[oa]|pickup\s+point)/, carriers: ['ppl'] },

    { match: /gls.*box/,    carriers: ['gls'], pointType: 'locker' },
    { match: /gls.*pobock/, carriers: ['gls'], pointType: 'branch' },
    { match: /gls.*(vyd[ae]jn[aeiy]\s+mie?st[oa]|pickup\s+point)/, carriers: ['gls'] },

    { match: /(zasilkovna|packeta).*box/,    carriers: ['zasilkovna'], pointType: 'locker' },
    { match: /(zasilkovna|packeta).*pobock/, carriers: ['zasilkovna'], pointType: 'branch' },
    { match: /(zasilkovna|packeta).*(vyd[ae]jn[aeiy]\s+mie?st[oa]|pickup\s+point)/, carriers: ['zasilkovna'] },

    { match: /balikovna.*box/,    carriers: ['balikovna'], pointType: 'locker' },
    { match: /balikovna.*pobock/, carriers: ['balikovna'], pointType: 'branch' },
    { match: /balikovna.*(vyd[ae]jn[aeiy]\s+mie?st[oa]|pickup\s+point)/, carriers: ['balikovna'] },

    { match: /dpd.*box/,    carriers: ['dpd'], pointType: 'locker' },
    { match: /dpd.*pobock/, carriers: ['dpd'], pointType: 'branch' },
    { match: /dpd.*(vyd[ae]jn[aeiy]\s+mie?st[oa]|pickup\s+point)/, carriers: ['dpd'] },

    { match: /sps.*box/,    carriers: ['sps'], pointType: 'locker' },
    { match: /sps.*pobock/, carriers: ['sps'], pointType: 'branch' },
    { match: /sps.*(vyd[ae]jn[aeiy]\s+mie?st[oa]|pickup\s+point)/, carriers: ['sps'] },

    { match: /(one\s*by\s*allegro|wedo).*box/,    carriers: ['wedo'], pointType: 'locker' },
    { match: /(one\s*by\s*allegro|wedo).*pobock/, carriers: ['wedo'], pointType: 'branch' },
    { match: /(one\s*by\s*allegro|wedo).*(vyd[ae]jn[aeiy]\s+mie?st[oa]|pickup\s+point)/, carriers: ['wedo'] },
  ],
};

(function () {
  var s = document.createElement('script');
  s.src = 'https://app.zaslat.cz/map/upgatesv2.js';
  s.defer = true;
  document.head.appendChild(s);
})();
</script>

Obrázek 13: Kód vložený do Vlastních konverzních kódů

Možnost 2: Editor kódu (common.js)

1. V levém menu Upgates přejděte do Grafika → Editor kódu.
2. Ve složce Scripts (Obr. 14, krok 1) otevřete soubor common.js (Obr. 14, krok 2).
3. Na úplný konec souboru vložte následující kód (Obr. 14, krok 3) a klikněte na Uložit (Obr. 14, krok 4).

Code
window.ZASLAT_MAP_CONFIG = {
  shippingMethods: [
    // Obecné dopravy pojmenované česky (e-shop odesílá z Česka) -
    // všichni dopravci podporovaní mapou
    { match: /^\s*vydejni\s+mist[oa]\s*$/,   carriers: ['balikovna', 'dpd', 'gls', 'ppl', 'sps', 'wedo', 'zasilkovna'] },
    { match: /^\s*vydejni\s+boxy?\s*$/,      carriers: ['balikovna', 'dpd', 'gls', 'ppl', 'sps', 'wedo', 'zasilkovna'], pointType: 'locker' },
    { match: /^\s*vydejni\s+pobock[ay]\s*$/, carriers: ['balikovna', 'dpd', 'gls', 'ppl', 'sps', 'wedo', 'zasilkovna'], pointType: 'branch' },

    // Obecné dopravy pojmenované slovensky (e-shop odesílá ze Slovenska) -
    // dopravci Zaslat.sk
    { match: /^\s*vydajn[eay]\s+miest[oa]\s*$/,  carriers: ['dpd', 'sps', 'zasilkovna'] },
    { match: /^\s*vydajn[eay]\s+boxy?\s*$/,      carriers: ['dpd', 'sps', 'zasilkovna'], pointType: 'locker' },
    { match: /^\s*vydajn[eay]\s+pobock[ay]\s*$/, carriers: ['dpd', 'sps', 'zasilkovna'], pointType: 'branch' },

    // Dopravy pro jednoho dopravce - české i slovenské názvy
    { match: /ppl.*box/,    carriers: ['ppl'], pointType: 'locker' },
    { match: /ppl.*pobock/, carriers: ['ppl'], pointType: 'branch' },
    { match: /ppl.*(vyd[ae]jn[aeiy]\s+mie?st[oa]|pickup\s+point)/, carriers: ['ppl'] },

    { match: /gls.*box/,    carriers: ['gls'], pointType: 'locker' },
    { match: /gls.*pobock/, carriers: ['gls'], pointType: 'branch' },
    { match: /gls.*(vyd[ae]jn[aeiy]\s+mie?st[oa]|pickup\s+point)/, carriers: ['gls'] },

    { match: /(zasilkovna|packeta).*box/,    carriers: ['zasilkovna'], pointType: 'locker' },
    { match: /(zasilkovna|packeta).*pobock/, carriers: ['zasilkovna'], pointType: 'branch' },
    { match: /(zasilkovna|packeta).*(vyd[ae]jn[aeiy]\s+mie?st[oa]|pickup\s+point)/, carriers: ['zasilkovna'] },

    { match: /balikovna.*box/,    carriers: ['balikovna'], pointType: 'locker' },
    { match: /balikovna.*pobock/, carriers: ['balikovna'], pointType: 'branch' },
    { match: /balikovna.*(vyd[ae]jn[aeiy]\s+mie?st[oa]|pickup\s+point)/, carriers: ['balikovna'] },

    { match: /dpd.*box/,    carriers: ['dpd'], pointType: 'locker' },
    { match: /dpd.*pobock/, carriers: ['dpd'], pointType: 'branch' },
    { match: /dpd.*(vyd[ae]jn[aeiy]\s+mie?st[oa]|pickup\s+point)/, carriers: ['dpd'] },

    { match: /sps.*box/,    carriers: ['sps'], pointType: 'locker' },
    { match: /sps.*pobock/, carriers: ['sps'], pointType: 'branch' },
    { match: /sps.*(vyd[ae]jn[aeiy]\s+mie?st[oa]|pickup\s+point)/, carriers: ['sps'] },

    { match: /(one\s*by\s*allegro|wedo).*box/,    carriers: ['wedo'], pointType: 'locker' },
    { match: /(one\s*by\s*allegro|wedo).*pobock/, carriers: ['wedo'], pointType: 'branch' },
    { match: /(one\s*by\s*allegro|wedo).*(vyd[ae]jn[aeiy]\s+mie?st[oa]|pickup\s+point)/, carriers: ['wedo'] },
  ],
};

(function () {
  var s = document.createElement('script');
  s.src = 'https://app.zaslat.cz/map/upgatesv2.js';
  s.defer = true;
  document.head.appendChild(s);
})();

Obrázek 14: Kód vložený na konec souboru common.js

Krok 3: Ověření v košíku

Vložte do košíku libovolný produkt a v kroku Doprava a platba zvolte některou z nově vytvořených doprav. Otevře se mapa výdejních míst Zaslat s dopravci podle názvu dopravy (Obr. 15). Mapa zobrazuje výdejní místa v zemi doručení, kterou zákazník v košíku zvolil – při doručení na Slovensko se Zásilkovna v mapě zobrazuje jako Packeta.

Obrázek 15: Mapa výdejních míst Zaslat v košíku

Po výběru výdejního místa se jeho adresa zobrazí pod názvem dopravy a zákazník ho může odkazem Změnit výdejní místo kdykoliv změnit – mapa se pak otevře rovnou na dříve vybraném místě (Obr. 16). Bez vybraného výdejního místa zákazník v objednávce nepokračuje.

Obrázek 16: Vybrané výdejní místo pod názvem dopravy

Po odeslání objednávky najdete vybrané výdejní místo v detailu objednávky v poli Poznámka od zákazníka (Obr. 17). Případný text, který zákazník do poznámky napsal, zůstává zachovaný nad značkou.

Obrázek 17: Značka vybraného výdejního místa v poznámce k objednávce

Vlastní názvy doprav

Pravidla v kódu jsou tzv. regulární výrazy – určují, které názvy doprav mapa rozpozná. Pokud potřebujete dopravy pojmenovat jinak, nebo chcete v jedné mapě nabídnout jinou kombinaci dopravců, je potřeba pravidla upravit.

Nastavení stavů objednávek

Aby se nepřenášely do Zaslat všechny objednávky z vašeho Upgates, ale jen ty, které chcete přes Zaslat skutečně poslat, musíte si v Upgates nastavit vlastní Stav objednávky. V levém menu klikněte na položku Nastavení (Obr. 18, krok 1), zvolte možnost Objednávky (Obr. 18, krok 2), poté klikněte v menu na možnost Stavy (Obr. 18, krok 3) a v pravém horním roku klikněte na tlačítko Nový (Obr. 18, krok 4).

Obrázek 18: Nastavení stavů objednávek

Do políčka Název (Obr. 19, krok 1) vepište Zaslat a klikněte na tlačítko Uložit (Obr. 19, krok 2).

Obrázek 19: Vytvoření nového stavu Zaslat

Přiřazení stavů k objednávkám

Nyní máte nový stav objednávek vytvořený a můžete jej přiřadit ve vašich objednávkách. V detailu objednávky můžete změnit stav objednávky na nový vámi vytvořený stav Zaslat.cz (Obr. 20).

Obrázek 20: Přiřazení stavů k objednávkám

Import objednávek

Import objednávek do Zaslat a jejich úpravy

Pokaždé, když budete posílat zásilky, už stačí jen v přehledu objednávek Manažera zásilek aktualizovat objednávky z integrací kliknutím na tlačítko Synchronizovat integrace (Obr. 21, krok 1) v pravém horním rohu a všechny objednávky z Upgates vám zobrazíme v uceleném přehledu. Přeprava v tento moment ještě není objednaná, v každé objednávce si můžete cokoliv upravit - adresu odesílatele, příjemce, rozměry, váhu, dobírku, i dopravce. Jakmile si vše zkontrolujete, můžete Objednat (Obr. 21, krok 2).

Obrázek 21: Import objednávek