# Alsendo Connect Plugin pro PrestaShop

**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 přenesou do Manažeru zásilek automaticky. Zákazníkům v košíku nabídnete dopravce z vašeho účtu Zaslat včetně interaktivní mapy výdejních míst a zásilky pak odešlete přímo z administrace – jednotlivě, s úpravou údajů u konkrétní zásilky, nebo hromadně.

## Požadavky na e-shop

Aby výpočet ceny dopravy, mapa výdejních míst i objednání zásilky fungovaly správně, zkontrolujte nejprve základní nastavení PrestaShopu.

### Země a zóny

V sekci **Mezinárodní → Lokace → Země** ověřte, že jsou země, do kterých posíláte – například **Česko** a **Slovensko** – aktivní (sloupec **Aktivováno**). Ve sloupci **Zóna** vidíte, do které zóny země patří; podle zón se zákazníkům nabízejí dopravci (Obr. 1).

![Obrázek 1: Aktivní země a jejich zóny](./assets/prestashop/obr-01-pozadavky-zeme.png)

<span className="text-muted-foreground">_Obrázek 1: Aktivní země a jejich zóny_</span>

### Platební metody pro další země

Pokud prodáváte i na Slovensko, povolte pro tuto zemi platební metody. V sekci **Platba → Konfigurace** v části **Omezení pro země** zaškrtněte u řádku **Slovensko** platby, které chcete nabízet – například dobírku – a nastavení uložte tlačítkem **Uložit** (Obr. 2). Bez tohoto nastavení nemůže zákazník ze Slovenska objednávku dokončit.

![Obrázek 2: Povolení plateb pro Slovensko](./assets/prestashop/obr-02-pozadavky-platby.png)

<span className="text-muted-foreground">_Obrázek 2: Povolení plateb pro Slovensko_</span>

### Povinné telefonní číslo

Dopravci telefonní číslo příjemce vyžadují – posílají na něj informace o doručení. V sekci **Zákazníci → Adresy** klikněte pod seznamem na **Nastavit požadovaná pole pro tento výběr**, zaškrtněte pole **phone** a uložte tlačítkem **Uložit** (Obr. 3).

![Obrázek 3: Povinné telefonní číslo v adrese](./assets/prestashop/obr-03-pozadavky-telefon.png)

<span className="text-muted-foreground">_Obrázek 3: Povinné telefonní číslo v adrese_</span>

### Hmotnost a rozměry produktů

Cena přepravy se počítá z hmotnosti a rozměrů zásilky. U produktů vyplňte v sekci **Katalog → Produkty** na kartě **Doručení** šířku, výšku, hloubku a hmotnost (Obr. 4).

![Obrázek 4: Hmotnost a rozměry produktu](./assets/prestashop/obr-04-pozadavky-hmotnost.png)

<span className="text-muted-foreground">_Obrázek 4: Hmotnost a rozměry produktu_</span>

## Nastavení integrace

### Instalace modulu Alsendo Connect

Modul Alsendo Connect si nejprve stáhněte.

:::tip[Stažení modulu]

Modul Alsendo Connect stáhněte z <a href="https://addons.prestashop.com/en/shipping-rate/98583-alsendo-multi-carrier-shipping-automation-inpost-dpd-dhl-gls.html" target="_blank" rel="noopener"><strong>oficiálního obchodu PrestaShop Addons</strong></a>.

Podporované verze PrestaShop: **PrestaShop 1.7.8** a **PrestaShop 8** (8.0 a novější). PrestaShop 9 není podporován.

:::

V administraci PrestaShopu přejděte do sekce **Moduly → Správce modulů** a klikněte na tlačítko **Nahrát modul** (Obr. 5).

![Obrázek 5: Sekce Moduly → Správce modulů](./assets/prestashop/obr-05-module-manager.png)

<span className="text-muted-foreground">_Obrázek 5: Sekce Moduly → Správce modulů_</span>

Přetáhněte stažený soubor do okna nebo klikněte na **vyberte soubor** a soubor vyberte (Obr. 6). Instalace může chvíli trvat.

![Obrázek 6: Nahrání modulu](./assets/prestashop/obr-06-nahrani-modulu.png)

<span className="text-muted-foreground">_Obrázek 6: Nahrání modulu_</span>

Po úspěšné instalaci klikněte na **Konfigurace** (Obr. 7).

![Obrázek 7: Modul je nainstalován](./assets/prestashop/obr-07-modul-nainstalovan.png)

<span className="text-muted-foreground">_Obrázek 7: Modul je nainstalován_</span>

### Instalace požadovaných komponent PrestaShopu

Při prvním spuštění modul ověří, zda máte nainstalované komponenty **PrestaShop Account**, **PrestaShop EventBus** a **PrestaShop Marketplace**. Pokud některá chybí, klikněte na **Authorize and continue** (Obr. 8) – komponenty se nainstalují automaticky.

![Obrázek 8: Instalace požadovaných komponent](./assets/prestashop/obr-08-pozadovane-komponenty.png)

<span className="text-muted-foreground">_Obrázek 8: Instalace požadovaných komponent_</span>

Po dokončení se v dolní části levého menu zobrazí nová položka **Alsendo** s podsekcemi **Konfigurace** a **Způsoby dopravy** (Obr. 9).

![Obrázek 9: Nová položka menu „Alsendo“](./assets/prestashop/obr-09-menu-alsendo.png)

<span className="text-muted-foreground">_Obrázek 9: Nová položka menu „Alsendo“_</span>

### Propojení s účtem Zaslat pomocí API klíče

Klikněte v levém menu na **Alsendo → Konfigurace**. V sekci **Oblast a konfigurace API** vyberte v poli **Vyberte oblast** zemi **Czechia** – zobrazí se pole **API klíč** (Obr. 10). Volbu **Testovací režim** nechte nezaškrtnutou, slouží pouze pro testovací účty.

![Obrázek 10: Výběr oblasti a vložení API klíče](./assets/prestashop/obr-10-konfigurace-api.png)

<span className="text-muted-foreground">_Obrázek 10: Výběr oblasti a vložení API klíče_</span>

API klíč najdete po přihlášení do vašeho **Manažeru zásilek** v sekci **Nastavení → Integrace** (Obr. 11).

![Obrázek 11: Integrace v Manažeru zásilek](./assets/prestashop/obr-11-integrace.png)

<span className="text-muted-foreground">_Obrázek 11: Integrace v Manažeru zásilek_</span>

Najděte sekci _Napojení pomocí API_ a klikněte na zelené tlačítko **Napojit pomocí API** (Obr. 12). Ve zobrazeném okně zkopírujte váš API klíč ikonou vpravo od pole (Obr. 13).

![Obrázek 12: Napojení pomocí API](./assets/prestashop/obr-12-napojeni-api.png)

<span className="text-muted-foreground">_Obrázek 12: Napojení pomocí API_</span>

![Obrázek 13: Kopírování API klíče v Manažeru zásilek](./assets/prestashop/obr-13-kopirovani-api.png)

<span className="text-muted-foreground">_Obrázek 13: Kopírování API klíče v Manažeru zásilek_</span>

Vložte klíč do pole **API klíč** v PrestaShopu a uložte tlačítkem **Uložit konfiguraci** (Obr. 10).

:::note

Po uložení API klíče **stránku obnovte** (klávesa F5). Teprve poté se v sekci adresy odeslání načte adresář z vašeho Manažeru zásilek.

:::

### Nastavení základních údajů – Výchozí adresa

V sekci **Výchozí adresa odesílatele** ponechte v poli **Vyberte šablonu** volbu **Nová šablona**. V poli **Address from address book** se zobrazí adresy uložené ve vašem Manažeru zásilek – vyberte adresu, ze které budete zásilky posílat (Obr. 14). Údaje adresy se vyplní automaticky.

![Obrázek 14: Načtení adresy z adresáře Manažeru zásilek](./assets/prestashop/obr-14-adresar-zaslat.png)

<span className="text-muted-foreground">_Obrázek 14: Načtení adresy z adresáře Manažeru zásilek_</span>

Doplňte údaje pro dobírku (Obr. 15):

- **Číslo bankovního účtu** a **Bank code** – číslo účtu a kód banky, nutné pro zásilky na dobírku
- **IBAN bank account number** – vyplňte pro zásilky na dobírku do zahraničí

![Obrázek 15: Nastavení bankovního účtu, kódu a IBAN](./assets/prestashop/obr-15-bankovni-ucet.png)

<span className="text-muted-foreground">_Obrázek 15: Nastavení bankovního účtu, kódu a IBAN_</span>

Klikněte na **Uložit**, zadejte název šablony, např. _Výchozí adresa_, a potvrďte tlačítkem **Uložit** (Obr. 16).

![Obrázek 16: Uložení šablony adresy](./assets/prestashop/obr-16-nazev-sablony.png)

<span className="text-muted-foreground">_Obrázek 16: Uložení šablony adresy_</span>

První uložená šablona se automaticky nastaví jako výchozí – v seznamu je označena jako _default_ (Obr. 17). Šablon adres si můžete vytvořit více; jinou šablonu nastavíte jako výchozí tlačítkem **Nastavit jako výchozí** a u každé zásilky můžete zvolit jinou adresu.

![Obrázek 17: Výchozí šablona adresy](./assets/prestashop/obr-17-vychozi-adresa.png)

<span className="text-muted-foreground">_Obrázek 17: Výchozí šablona adresy_</span>

:::note

Změna šablony se projeví u nových objednávek. Objednávky vytvořené před změnou si ponechávají původní údaje, které můžete upravit při odeslání zásilky.

:::

### Nastavení základních údajů – Výchozí balík

V sekci **Nastavení dopravy** ponechte v poli **Vyberte šablonu** volbu **Nová šablona** a nastavte (Obr. 18):

- **Typ balíku** – typ zásilky, obvykle **Package**. Typ vyberte ze seznamu i v případě, že se zobrazuje předvyplněný.
- **Šířka, Délka, Výška, Hmotnost** – výchozí rozměry a hmotnost zásilky
- **Obsah balíku** – jako identifikátor zásilky doporučujeme použít **Order ID** – vyberte jej v poli **Vložit tag**.

Pole **Dobírka** ponechte na hodnotě 0 – u objednávek s platbou na dobírku se částka doplní automaticky podle objednávky. Pole **Deklarovaná hodnota** není povinné.

![Obrázek 18: Nastavení výchozího balíku](./assets/prestashop/obr-18-sablona-balik.png)

<span className="text-muted-foreground">_Obrázek 18: Nastavení výchozího balíku_</span>

Dále zvolte typ svozu v poli **Typ vyzvednutí** (Obr. 19):

- **occasional** – vlastní tisk štítků: štítky si vytisknete sami a kurýr zásilky sveze z vaší adresy. **Tato služba funguje pouze na svozových adresách evidovaných ve vašem Manažeru zásilek.**
- **ondemand** – jednorázový svoz: kurýr přijede s připraveným štítkem.

![Obrázek 19: Typ vyzvednutí a uložení šablony](./assets/prestashop/obr-19-typ-svozu.png)

<span className="text-muted-foreground">_Obrázek 19: Typ vyzvednutí a uložení šablony_</span>

Šablonu uložte tlačítkem **Uložit** a pojmenujte ji, např. _Výchozí balík_. I zde se první šablona nastaví jako výchozí automaticky (Obr. 20).

![Obrázek 20: Výchozí šablona balíku](./assets/prestashop/obr-20-vychozi-balik.png)

<span className="text-muted-foreground">_Obrázek 20: Výchozí šablona balíku_</span>

### Další nastavení

V sekci **Další nastavení** (Obr. 21) můžete u dopravců PPL, Balíkovna a Zásilkovna předvolit **výchozí odesílací místa**, kde budete zásilky podávat – vyberete je tlačítkem **Vybrat** v mapě. Volba **Automaticky vyplnit deklarovanou hodnotu celkovou částkou objednávky** vyplní deklarovanou hodnotu zásilky podle hodnoty objednávky. Nastavení uložte tlačítkem **Uložit další nastavení**.

![Obrázek 21: Další nastavení](./assets/prestashop/obr-21-dalsi-nastaveni.png)

<span className="text-muted-foreground">_Obrázek 21: Další nastavení_</span>

## Nastavení dopravců

### Způsoby dopravy a načtení dopravců

V levém menu klikněte na **Alsendo → Způsoby dopravy** a načtěte dopravce tlačítkem **Synchronizovat s Alsendo** (Obr. 22). Systém načte všechny dopravce dostupné ve vašem účtu Zaslat.

![Obrázek 22: Načtení dopravců](./assets/prestashop/obr-22-zpusoby-dopravy.png)

<span className="text-muted-foreground">_Obrázek 22: Načtení dopravců_</span>

V seznamu **Dostupné kurýrní služby** zapněte dopravce, které chcete používat – všechny najednou zapnete tlačítkem **Select All**. Výběr potvrďte tlačítkem **Uložit služby** pod seznamem (Obr. 23).

![Obrázek 23: Výběr a uložení dopravců](./assets/prestashop/obr-23-sluzby.png)

<span className="text-muted-foreground">_Obrázek 23: Výběr a uložení dopravců_</span>

### Přidání dopravců

Klikněte na tlačítko **Přidat způsob** – nový řádek se přidá na začátek tabulky. Každý řádek uložte tlačítkem **Uložit** na jeho konci (Obr. 24).

#### Balíkovna – výdejní místo s mapou

Zadejte **Název způsobu**, například _Balíkovna – výdejní místo_ (tento název uvidí zákazník v košíku). V poli **Kurýrní služba** vyberte **Balíkovna (Pickup point)** a nastavte cenu. Zaškrtněte **Mapa** – zákazníkovi se v pokladně zobrazí interaktivní mapa výdejních míst – a **Ship via Pickup Point**, pokud zásilky podáváte na podacím místě. V poli **Package template** můžete dopravci přiřadit vlastní šablonu balíku (Obr. 24). Stejný postup platí i pro **Zásilkovnu** a **PPL** – zvolte _Zásilkovna (Pickup point)_ nebo _PPL (Pickup point)_.

![Obrázek 24: Přidání dopravce s výdejním místem](./assets/prestashop/obr-24-pridani-metody.png)

<span className="text-muted-foreground">_Obrázek 24: Přidání dopravce s výdejním místem_</span>

:::note

Dopravci označení v nabídce jako **(Pickup point)** jsou vždy dopravci s doručením na výdejní místo.

:::

#### PPL, DPD, GLS – doručení na adresu

U doručení na adresu je postup totožný. Vyberte dopravce (**PPL**, **DPD** nebo **GLS**), pojmenujte ho – například _DPD – doručení na adresu_ – a nastavte cenu. Volbu **Mapa** nezaškrtávejte. Uložené způsoby dopravy uvidíte v přehledu (Obr. 25).

![Obrázek 25: Uložené způsoby dopravy](./assets/prestashop/obr-25-metody-ulozene.png)

<span className="text-muted-foreground">_Obrázek 25: Uložené způsoby dopravy_</span>

### Přiřazení dopravců k zónám

Každý uložený způsob dopravy se v PrestaShopu automaticky vytvoří jako dopravce v sekci **Doručení → Dopravci** (Obr. 26) a je dostupný ve všech zónách.

![Obrázek 26: Dopravci vytvoření modulem](./assets/prestashop/obr-26-dopravci-seznam.png)

<span className="text-muted-foreground">_Obrázek 26: Dopravci vytvoření modulem_</span>

Pokud chcete dopravce nabízet jen v některých zemích, otevřete jej tlačítkem **Upravit** a v kroku **Přepravní místa a náklady** ponechte zaškrtnuté jen zóny, do kterých má doručovat – například **Europe** pro Česko a Slovensko (Obr. 27).

![Obrázek 27: Zóny dopravce](./assets/prestashop/obr-27-dopravce-zony.png)

<span className="text-muted-foreground">_Obrázek 27: Zóny dopravce_</span>

:::tip

Výsledná cena v košíku může zahrnovat i manipulační poplatek PrestaShopu, který nastavíte v **Doručení → Konfigurace**.

:::

## Ověření v e-shopu

Nakonec si vše ověřte přímo v e-shopu. Přidejte libovolný produkt do košíku a pokračujte na krok **Způsob přepravy**. Měli byste vidět dopravce, které jste nastavili. U dopravce s mapou se zobrazí tlačítko **Vyberte výdejní místo** (Obr. 28).

![Obrázek 28: Dopravci v pokladně e-shopu](./assets/prestashop/obr-28-pokladna.png)

<span className="text-muted-foreground">_Obrázek 28: Dopravci v pokladně e-shopu_</span>

Po kliknutí na tlačítko se zákazníkovi otevře mapa výdejních míst. Místo vybere v mapě nebo v přehledu **Seznam** a potvrdí tlačítkem **Vybrat Místo** (Obr. 29).

![Obrázek 29: Mapa výdejních míst ve vašem e-shopu](./assets/prestashop/obr-29-mapa.png)

<span className="text-muted-foreground">_Obrázek 29: Mapa výdejních míst ve vašem e-shopu_</span>

## Odeslání zásilky

### Rychlé odeslání

Otevřete **Objednávky** a vyberte objednávku. V detailu objednávky najdete sekci **Doprava Alsendo** s adresou odesílatele, doručovací adresou, údaji o balíku a vybraným výdejním místem (Obr. 30). Zkontrolujte, že jsou všechny údaje správné.

![Obrázek 30: Sekce Doprava Alsendo v objednávce](./assets/prestashop/obr-30-objednavka-alsendo.png)

<span className="text-muted-foreground">_Obrázek 30: Sekce Doprava Alsendo v objednávce_</span>

V poli **Šablona** můžete pro tuto zásilku zvolit jinou šablonu balíku. Zásilku odešlete tlačítkem **Rychlé odeslání** (Obr. 31).

![Obrázek 31: Rychlé odeslání zásilky](./assets/prestashop/obr-31-quick-send.png)

<span className="text-muted-foreground">_Obrázek 31: Rychlé odeslání zásilky_</span>

### Úprava údajů u konkrétní zásilky

Pokud potřebujete u zásilky cokoliv změnit, klikněte na **Vytvořit zásilku**. Otevře se úplný formulář, ve kterém můžete:

- v poli **Address Book** zvolit **jinou adresu odeslání** z adresáře Manažeru zásilek (Obr. 32) a upravit bankovní účet pro dobírku,
- upravit adresu příjemce nebo **změnit či vymazat výdejní místo** tlačítky **Změnit** a **Vymazat**,
- v poli **Šablona balíku** zvolit **jinou šablonu balíku** a upravit rozměry, hmotnost a obsah (Obr. 33).

![Obrázek 32: Výběr adresy odeslání pro konkrétní zásilku](./assets/prestashop/obr-32-plny-formular-adresa.png)

<span className="text-muted-foreground">_Obrázek 32: Výběr adresy odeslání pro konkrétní zásilku_</span>

![Obrázek 33: Výdejní místo a šablona balíku pro konkrétní zásilku](./assets/prestashop/obr-33-plny-formular-balik.png)

<span className="text-muted-foreground">_Obrázek 33: Výdejní místo a šablona balíku pro konkrétní zásilku_</span>

Zkontrolujte částku **Dobírka**, klikněte na **Získat cenovou nabídku** a vyberte službu dopravce. Zásilku odešlete tlačítkem **Odeslat zásilku**, případně ji uložte pro pozdější odeslání tlačítkem **Uložit** (Obr. 34).

![Obrázek 34: Výpočet ceny a odeslání zásilky](./assets/prestashop/obr-34-plny-formular-cena.png)

<span className="text-muted-foreground">_Obrázek 34: Výpočet ceny a odeslání zásilky_</span>

Po odeslání se v sekci **Doprava Alsendo** zobrazí sledovací číslo zásilky. Štítek stáhnete tlačítkem **Stáhnout štítek**, zásilku můžete také zrušit tlačítkem **Zrušit zásilku** (Obr. 35).

![Obrázek 35: Odeslaná zásilka a stažení štítku](./assets/prestashop/obr-35-odeslano.png)

<span className="text-muted-foreground">_Obrázek 35: Odeslaná zásilka a stažení štítku_</span>

:::note[Velikost štítku]

Modul pro PrestaShop nemá vlastní nastavení velikosti štítku. Formát štítku (A4 nebo A6) nastavíte v **Manažeru zásilek** v sekci **Nastavení → Nastavení aplikace → Tisk štítků** (Obr. 36).

:::

![Obrázek 36: Nastavení velikosti štítku v Manažeru zásilek](./assets/prestashop/obr-36-tisk-stitku.png)

<span className="text-muted-foreground">_Obrázek 36: Nastavení velikosti štítku v Manažeru zásilek_</span>

### Hromadné odeslání

V seznamu **Objednávky** zaškrtněte objednávky, které chcete odeslat, a klikněte na **Odeslat přes Alsendo** (Obr. 37).

![Obrázek 37: Výběr objednávek k hromadnému odeslání](./assets/prestashop/obr-37-hromadne-vyber.png)

<span className="text-muted-foreground">_Obrázek 37: Výběr objednávek k hromadnému odeslání_</span>

Na stránce **Hromadné odeslání** můžete u každé objednávky změnit šablonu balíku nebo údaje upravit tlačítkem **Upravit**. Poté klikněte na **Odeslat všechny objednávky** (Obr. 38). Ve sloupci **Zpráva / Akce** se zobrazí výsledek u každé objednávky; štítky všech odeslaných zásilek stáhnete najednou tlačítkem **Stáhnout všechny štítky (ZIP)**.

![Obrázek 38: Hromadné odeslání objednávek](./assets/prestashop/obr-38-hromadne-odeslani.png)

<span className="text-muted-foreground">_Obrázek 38: Hromadné odeslání objednávek_</span>

Odeslané zásilky se zároveň zobrazí ve vašem **Manažeru zásilek** v sekci **Zásilky** (Obr. 39), kde najdete i výdejní místo, dobírku, štítek a stav doručení.

![Obrázek 39: Zásilka v Manažeru zásilek](./assets/prestashop/obr-39-manazer-zasilka.png)

<span className="text-muted-foreground">_Obrázek 39: Zásilka v Manažeru zásilek_</span>

Integrace Zaslat pro PrestaShop je nyní plně nastavena.