# Alsendo Connect Plugin pro Opencart

**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 OpenCart 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

### Instalace pluginu Alsendo Connect

Plugin Alsendo Connect si nejprve stáhněte.

:::tip[Stažení pluginu]

<a href="/downloads/opencart/alsendo-connect-latest.ocmod.zip" download><strong>Stáhněte si plugin Alsendo Connect</strong></a> (soubor `alsendo-connect-latest.ocmod.zip`).

Aktuální verze: 1.4.01

Datum vydání: 17. 6. 2026

:::

V administraci OpenCart přejděte do sekce **Extensions → Installer** (Obr. 1).

![Obrázek 1: Sekce Extensions → Installer](./assets/opencart/obr-01-installer.png)

<span className="text-muted-foreground">_Obrázek 1: Sekce Extensions → Installer_</span>

Vyhledejte stažený soubor s pluginem a nahrajte ho (Obr. 2).

![Obrázek 2: Nahrání pluginu](./assets/opencart/obr-02-nahrani-pluginu.png)

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

Počkejte, než se plugin načte, a klikněte na **Instalovat** (Obr. 3). Instalace může chvíli trvat.

![Obrázek 3: Instalace pluginu](./assets/opencart/obr-03-instalace-pluginu.png)

<span className="text-muted-foreground">_Obrázek 3: Instalace pluginu_</span>

Po úspěšné instalaci přejděte do **Extensions**, v rozbalovacím seznamu vyberte **Moduly** (Obr. 4).

![Obrázek 4: V rozbalovacím seznamu vyberte Moduly](./assets/opencart/obr-04-moduly.png)

<span className="text-muted-foreground">_Obrázek 4: V rozbalovacím seznamu vyberte Moduly_</span>

Nainstalujte plugin Alsendo kliknutím na zelené tlačítko na konci řádku (Obr. 5).

![Obrázek 5: Instalace modulu Alsendo](./assets/opencart/obr-05-instalace-modulu.png)

<span className="text-muted-foreground">_Obrázek 5: Instalace modulu Alsendo_</span>

### Aktivace v nastavení dopravy

V rozbalovacím seznamu přejděte do **Nastavení → Shipping** (Obr. 6). Ověřte, že je plugin Alsendo zapnutý – přepínač by měl být aktivní (Obr. 6). Stránku aktualizujte a v dolní části menu by se vám měla zobrazit nová položka **Alsendo** (Obr. 7).

![Obrázek 6: Nastavení dopravy](./assets/opencart/obr-06-nastaveni-dopravy.png)

<span className="text-muted-foreground">_Obrázek 6: Nastavení dopravy_</span>

![Obrázek 7: Nová položka menu „Alsendo"](./assets/opencart/obr-07-polozka-alsendo.png)

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

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

Klikněte v levém menu na **Alsendo** a vyberte možnost **Konfigurace**. Vyberte zemi – Česká republika – a zadejte svůj API klíč (Obr. 8).

![Obrázek 8: Konfigurace a výběr země ČR](./assets/opencart/obr-08-konfigurace-zeme.png)

<span className="text-muted-foreground">_Obrázek 8: Konfigurace a výběr země ČR_</span>

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

![Obrázek 9: Integrace v Manažeru zásilek](./assets/opencart/obr-09-integrace-manazer.png)

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

Najděte sekci _Napojení pomocí API_ (Obr. 10), klikněte na zelené tlačítko a zkopírujte váš API klíč (Obr. 11).

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

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

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

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

Vložte ho do příslušného pole ve vašem OpenCart e-shopu a kliknutím na **Save** uložte (Obr. 12).

![Obrázek 12: Uložení API klíče](./assets/opencart/obr-12-ulozeni-api.png)

<span className="text-muted-foreground">_Obrázek 12: Uložení API klíče_</span>

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

Po propojení doplňte základní údaje:

- **Adresa odeslání** – adresa, ze které zásilky posíláte (Obr. 13)
- **Bankovní účet a kód** – nutné pro zásilky na dobírku
- **IBAN** – vyplňte pro zásilky na dobírku do zahraničí

![Obrázek 13: Nastavení výchozí adresy](./assets/opencart/obr-13-vychozi-adresa.png)

<span className="text-muted-foreground">_Obrázek 13: Nastavení výchozí adresy_</span>

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

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

Vše uložte jako novou šablonu kliknutím na tlačítko **Save as new template** (Obr. 15) s názvem např. _Výchozí adresa_.

![Obrázek 15: Uložení jako nová šablona](./assets/opencart/obr-15-ulozit-sablonu.png)

<span className="text-muted-foreground">_Obrázek 15: Uložení jako nová šablona_</span>

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

V sekci konfigurace balíku nastavte výchozí rozměry a hmotnost zásilek (Obr. 16). Pole označená jako nepovinná nemusíte vyplňovat. Jako identifikátor zásilky v poli **Shipment content** doporučujeme použít **Order ID** (Obr. 17).

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

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

![Obrázek 17: Identifikátor zásilky pomocí Order ID](./assets/opencart/obr-17-order-id.png)

<span className="text-muted-foreground">_Obrázek 17: Identifikátor zásilky pomocí Order ID_</span>

Dále zvolte typ přepravy:

- **Self-printed label** – kurýr sveze zásilky přímo z vaší adresy a vy si sami tisknete štítky. **Tato služba funguje pouze na svozových adresách evidovaných ve vašem Manažeru zásilek.**
- **Label provided by courier** – kurýr si přiveze vlastní štítek.

Nastavení uložte tlačítkem **Save as new template**.

## Nastavení dopravců

### Shipping Configuration a načtení dopravců

V levém menu klikněte na **Shipping Configuration** (Obr. 18) ve vaší Alsendo položce.

![Obrázek 18: Nastavení dopravců v Alsendo pluginu](./assets/opencart/obr-18-shipping-configuration.png)

<span className="text-muted-foreground">_Obrázek 18: Nastavení dopravců v Alsendo pluginu_</span>

V rozbalovacím seznamu **Tax Class** zvolte, zda se jedná o digitální produkty nebo zdanitelné zboží. V pravém horním rohu klikněte na modré tlačítko **Save** (Obr. 19).

![Obrázek 19: Nastavení typu produktu](./assets/opencart/obr-19-typ-produktu.png)

<span className="text-muted-foreground">_Obrázek 19: Nastavení typu produktu_</span>

Nyní načtěte dopravce: klikněte na tlačítko **Enable Carrier Service** (Obr. 20) a potvrďte tlačítkem **Save and Close** (Obr. 21). Systém načte všechny dopravce dostupné ve vašem účtu Zaslat.

![Obrázek 20: Načtení dopravců](./assets/opencart/obr-20-nacteni-dopravcu.png)

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

![Obrázek 21: Uložení dopravců](./assets/opencart/obr-21-ulozeni-dopravcu.png)

<span className="text-muted-foreground">_Obrázek 21: Uložení dopravců_</span>

### Přidání dopravců

Klikněte na tlačítko **Add shipping Method** (Obr. 22) a začněte přidávat jednotlivé dopravce.

![Obrázek 22: Přidání dopravců](./assets/opencart/obr-22-pridani-dopravcu.png)

<span className="text-muted-foreground">_Obrázek 22: Přidání dopravců_</span>

#### Zásilkovna – doručení na adresu

Zadejte název, například _Zásilkovna na adresu_. V možnosti **Courier service** vyberte Zásilkovnu a ujistěte se, že volba **Ship via pickup point** je zaškrtnuta (zásilku podáte na podacím místě). Nastavte cenu a uložte kliknutím na **Save changes** (Obr. 23).

![Obrázek 23: Přidání Zásilkovny s doručením na adresu](./assets/opencart/obr-23-zasilkovna-adresa.png)

<span className="text-muted-foreground">_Obrázek 23: Přidání Zásilkovny s doručením na adresu_</span>

#### Zásilkovna – výdejní místo s mapou

Přidejte Zásilkovnu znovu – tentokrát zvolte **Zásilkovna (Pickup point)**. Zaškrtněte možnost **Ship via pickup point** i **Map**. Zákazníkovi se při výběru dopravy automaticky zobrazí interaktivní mapa výdejních míst (Obr. 24). Stejný princip platí i pro **Balíkovnu**.

![Obrázek 24: Přidání Zásilkovny s doručením na výdejní místo](./assets/opencart/obr-24-zasilkovna-vydejni-misto.png)

<span className="text-muted-foreground">_Obrázek 24: Přidání Zásilkovny s doručením na výdejní místo_</span>

:::note

Dopravci označení v nabídce jako **(Pickup point)** jsou vždy dopravci z podacího místa nebo svozové adresy.

:::

#### DPD a další dopravci

U DPD a ostatních dopravců je postup totožný. Vyberte dopravce, pojmenujte ho – tento název uvidí zákazník v košíku – a nastavte cenu. U DPD i dalších dopravců můžete přidat obě varianty: doručení na adresu i výběr výdejního místa.

## Ověření v e-shopu

Nakonec si vše ověřte přímo v e-shopu. Přejděte do obchodu, přidejte libovolný produkt do košíku a pokračujte na stránku dopravy. Měli byste vidět dopravce, které jste právě nastavili – včetně mapy výdejních míst, pokud jste ji povolili (Obr. 25).

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

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

Integrace Zaslat pro OpenCart je nyní plně nastavena.

![Integrace Zaslat pro OpenCart](./assets/opencart/obr-26-zaver.png)