# Integrace PrestaShop s Manažerem zásilek
**S naší integrací nemusíte objednávky přepravy zásilek do [Zaslat](http://zaslat.cz/) zadávat ručně, stačí si na pár kliknutí nastavit propojení a objednávky odbavovat jedním tahem.**
:::tip
**Díky tomuto řešení odpadá veškeré stahování a nahrávání CSV souborů nebo ruční editace souborů v tabulkovém procesoru.**
:::
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.
:::caution
Pokud posíláte jen na adresu a výdejní místa nepotřebujete, nemusíte instalovat modul od Zaslat – v takovém případě pokračujte podle návodu pro integraci PrestaShop bez modulu.
:::
## 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).
:::tip[Stažení modulu]
Stáhněte si instalační soubor našeho modulu (modul Zaslat pro PrestaShop).
**Verze 2.1.1** — datum vydání: 30. 4. 2026
Nová verze PrestaShop modulu **2.0.0** přináší podporu pro nový **PrestaShop 9.x.x**, který byl vydán v průběhu února 2026. Zároveň přidává podporu pro starší, dosud nepodporovanou verzi **PrestaShop 1.6.x**. Tato aktualizace také opravuje několik chyb, které se objevovaly v košíku, a doplňuje validaci vybraného výdejního místa.
Verze **2.1.0** opravuje několik chyb z verze **1.6.0**, přináší zpětnou kompatibilitu a řeší chybu, kvůli které se do PrestaShopu nenačítaly informace o boxech. Verze **2.1.0** rovněž opravuje chybu v instalaci **při verzi 8.2.0 a výš**.
:::
_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](http://zaslat.cz/), nastavit nový stav Zaslat (Obr. 15).
_Obrázek 15: Přiřazení stavu Zaslat k objednávce_
## 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á.