Copy page

Integrace - Manažér zásilek

Integrace PrestaShop 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 PrestaShopu 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.

Stažení instalačního souboru a jeho instalace do PrestaShopu

Než se pustíte do samotného propojení, stáhněte si instalační soubor našeho modulu. V administraci vašeho PrestaShopu v levém menu klikněte na Moduly a poté na Správce modulů (Obr. 1, krok 1).

Obrázek 1: Nahrání instalačního souboru Zaslat

Na této stránce správce modulů v pravém horním rohu zvolte možnost Upload a module (Obr. 1, krok 2). Zobrazí se vám klasické drag & drop okno, do kterého jednoduše přetáhněte stažený soubor, nebo jej vyberte ručně z počítače (Obr. 2).

Obrázek 2: Nahrání staženého modulu Zaslat

Po nahrání souboru sjeďte na stránce správce modulů níže. V sekci Shipping & Logistics (Doprava a logistika) najdete náš modul pod názvem Zaslat – 10 dopravců pro váš e‑shop (Obr. 3). Váš modul je úspěšně nainstalovaný a aktivní. Není potřeba provádět žádné další kroky.

Obrázek 3: Nově nainstalovaný a aktivní modul Zaslat

Nastavení exportu v administrační části PrestaShop

V PrestaShopu v levém menu rozbalte nabídku Nástroje (Obr. 4, krok 1) a poté klikněte na Webové služby (Obr. 4, krok 2).

Obrázek 4: Nastavení webové služby

Zvolte možnost Povolit PrestaShop Webservis (Obr. 5, krok 1) a poté Uložit (Obr. 5, krok 2). Dále klikněte na tlačítko Přidat nový klíč webové služby (Obr. 5, krok 3), které vás přesměruje na vytvoření nového API klíče.

Obrázek 5: Přidání nového klíče webové služby

Následně vygenerujte API klíč do pole Klíč. Klikněte na tlačítko Generovat (Obr. 6, krok 1) vedle řádku Klíč. Vygenerovaný kód si zkopírujte do schránky, např. zkratkou Ctrl+C. Do pole Popis klíče vyplňte libovolný název, třeba Zaslat (Obr. 6, krok 2).

Obrázek 6: Vygenerování klíče

Nastavení oprávnění

Přesuneme se k nastavení oprávnění pro tento klíč pro přístup k datům z e-shopu.

U oprávnění je třeba povolit tyto konkrétní přístupy ve sloupci Zobrazit (GET): addresses, countries, currencies, customers, order_states, orders, carriers. Dále povolte přístup pro položku Zaslat – ta se nachází ve stejném seznamu jako výše uvedené. U Zaslat zaškrtněte všechna oprávnění ve všech sloupcích (Zobrazit, Upravit, Přidat, Patch, Odstranit, Náhled), aby modul mohl správně komunikovat s vaším PrestaShopem (Obr. 7).

Obrázek 7: Povolení přístupů (addresses, countries, currencies, customers, order_states, orders, carriers a Zaslat)

Jakmile všechny tyto možnosti potvrdíte, klikněte na tlačítko Uložit (Obr. 8).

Obrázek 8: Uložení nastavení

Aktivace dopravců od Zaslat

V levém menu přejděte do sekce Doručení (Obr. 9, krok 1) a zvolte možnost Dopravci (Obr. 9, krok 2). Zde se vám zobrazí 10 nových dopravců, které nahrál náš modul Zaslat. Jak poznáte, že jde o dopravce od nás? Přibyly dva nové sloupce: Carrier Code – u dopravců Zaslat zde najdete název dopravce (např. ppl, dpd, atd.) a Map Enabled.

Také si všimněte sloupce Status, který ukazuje, jestli je dopravce aktivní. Nově přidaní dopravci nejsou ve výchozím stavu aktivní, takže je potřeba zapnout ty, které chcete na e‑shopu nabídnout. Klikněte proto vpravo na řádku konkrétního dopravce na tlačítko Upravit.

Obrázek 9: Přehled nově přidaných dopravců

V nastavení dopravce (Obr. 10) si můžete vše přizpůsobit – název dopravce, dobu doručení, logo atd. Název dopravce je zcela na vás – ten se pak zobrazí zákazníkům v košíku.

Obrázek 10: Další nastavení konkrétního dopravce

V pravém dolním rohu klikněte na Další (Obr. 11) a projděte si postupně jednotlivé kroky nastavení dopravce, které nabízí PrestaShop – například cílové země, cenové rozpětí apod.

Obrázek 11: Pokračování na další krok

Na posledním kroku Shrnutí nezapomeňte zaškrtnout možnost Aktivováno (Obr. 12, krok 1), aby se dopravce na vašem e‑shopu opravdu zobrazil. Nakonec klikněte na Dokončit (Obr. 12, krok 2).

Obrázek 12: Aktivace dopravce

Pokud jste aktivovali dopravce s možností doručení na výdejní místo (např. DPD – Výdejní místo, GLS Slovensko – Výdejní místo atd.), zákazník si v košíku bude moct pohodlně vybrat výdejní místo z mapy. Tyto dopravce snadno poznáte podle zelené fajfky ve sloupci Map Enabled a také podle názvu, kde je uvedeno „Výdejní místo". A to je vše, co je potřeba udělat, aby byl dopravce aktivní a viditelný pro zákazníky v košíku vašeho e‑shopu.

Nastavení stavů objednávek

Aby se nepřenášely do Zaslat všechny objednávky z vašeho PrestaShopu, ale jen ty, které chcete přes Zaslat skutečně poslat, musíte si v PrestaShopu nastavit vlastní Stav objednávky. Tento krok je obzvlášť užitečný, pokud používáte více dopravců a potřebujete mít v objednávkách jasno, který balík půjde přes Zaslat.

V nabídce Nastavení e-shopu (Obr. 13, krok 1) přejděte do Nastavení objednávek (Obr. 13, krok 2) a zobrazte si záložku Stavy objednávek (Obr. 13, krok 3). Poté klikněte na Přidat nový stav objednávky (Obr. 13, krok 4).

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

Jméno stavu nastavte na Zaslat (Obr. 14, krok 1) a klikněte na tlačítko Uložit (Obr. 14, krok 2).

Obrázek 14: Přidání nového stavu objednávky

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

Nyní máte nový stav objednávek vytvořený a můžete jej použít v objednávkách. V přehledu objednávek můžete u vybraných objednávek, které chcete importovat do Zaslat, nastavit nový stav Zaslat (Obr. 15).

Obrázek 15: Přiřazení stavu Zaslat k objednávce

Proměnné pro výdejní místa (PUDO) v e-mailových šablonách

Pokud zákazník v košíku vybere výdejní místo, můžete do e-mailu s potvrzením objednávky doplnit i údaje o tomto místě. Modul do všech e-mailových šablon, jejichž název začíná na order_conf (včetně šablony pro dobírku order_conf_dobierka – od verze 2.3.6), přidává tyto proměnné:

Proměnná	Popis
{zslt_pudo_id}	ID výdejního místa
{zslt_pudo_carrier}	Kód dopravce (např. dpd, ppl, zasilkovna)
{zslt_pudo_name}	Název výdejního místa
{zslt_pudo_street}	Ulice a číslo popisné
{zslt_pudo_city}	Město
{zslt_pudo_zip}	PSČ
{zslt_pudo_country}	Země

Proměnné se vyplní pouze u objednávek, kde zákazník skutečně vybral výdejní místo; u doručení na adresu zůstávají prázdné.

Šablony upravíte v administraci PrestaShopu v Parametrech e-shopu → E-maily (v starších verzích Nastavení e-shopu → E-maily) – vyberte šablonu Potvrzení objednávky (případně Potvrzení objednávky – dobírka). Příklad využití v šabloně:

Code
{if $zslt_pudo_name != ''}
Vaše zásilka bude doručena na výdejní místo:
{$zslt_pudo_name}, {$zslt_pudo_street}, {$zslt_pudo_zip} {$zslt_pudo_city}
{/if}

Nastavení v Zaslat

Nastavení importu v Manažeru zásilek

Přihlaste se do vaší administrace v Manažeru zásilek. Navštivte v levém menu záložku Nastavení (Obr. 16, krok 1) a v ní zvolte možnost Integrace (Obr. 16, krok 2). Klikněte na tlačítko Propojit e-shop s Manažerem zásilek (Obr. 16, krok 3).

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

Ve výběru e-shopů vyberte PrestaShop (Obr. 17).

Obrázek 17: Volba PrestaShopu v nabídce e-shopů

Zvolte si libovolný Název této integrace.

Do řádku URL zkopírujte celou adresu vašeho e-shopu včetně protokolu https://. Například: https://vasobchod.cz. Nejjednodušší je adresu zkopírovat přímo z adresního řádku prohlížeče – tím získáte správný formát automaticky.

Do řádku API klíč zadejte klíč, který jste si zkopírovali v PrestaShopu (Obr. 18).

Obrázek 18: Nastavení integrace v Zaslat (API klíč)

V řádku Stahovat objednávky (Obr. 19) 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 jste si během nastavení PrestaShopu vytvořili vlastní stav Zaslat, pak zde zvolte možnost Jen ve stavu Zaslat pro stahování pouze objednávek v tomto stavu.

Obrázek 19: Stahování objednávek jen ve stavu Zaslat

V Manažeru zásilek si poté zvolte Výchozí adresu odesílatele (Obr. 20, krok 1) 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ěr 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. 20, krok 2). 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 Vytvořit novou integraci (Obr. 20, krok 3).

Obrázek 20: Dokončení integrace v Zaslat

Import objednávek a jejich úpravy

Pokaždé, když budete posílat zásilky, už stačí jen v přehledu objednávek 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 PrestaShopu 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

Aktualizace modulu

Modul aktualizujeme nepravidelně – zejména v případě, kdy je potřeba opravit chybu nebo přidat nové funkce.

V případě vydání nové verze zůstávají starší verze nadále funkční (pokud není uvedeno jinak). Je tedy na vás, zda si modul aktualizujete, nebo zůstanete u stávající verze.

Po aktualizaci bude potřeba znovu projít kroky uvedené v části Aktivace dopravců od Zaslat. Nastavení, jako jsou ceny, poplatky nebo DPH, si ale systém uchová.