> For the complete documentation index, see [llms.txt](https://napoveda.rocketoo.cz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://napoveda.rocketoo.cz/rocketoo/rozsireni/zaslat.md).

# Zaslat.cz

Modul **Zaslat.cz** slouží k rychlému vytvoření zásilky přímo z objednávky v administraci e‑shopu. Umožňuje správu zásilek přes API, integraci s nejpoužívanějšími dopravci, tisk štítků a sledování zásilek s automatickou synchronizací stavů.

Co vám modul přinese:

* Generování zásilek pro podporované dopravce přes [Zaslat.cz](https://www.zaslat.cz/)
* Uložení čísla zásilky (tracking) k objednávce
* Podpora dobírky (pokud je objednávka na dobírku)

## **Typy dopravy a dopravci**

Modul podporuje široké spektrum přepravních služeb:

* **Zásilkovna** – výdejní místa a doručení na adresu
* **GLS** – doručení v ČR a SK, výdejní místa GLS ParcelShop
* **PPL** – standardní doručení i PPL ParcelShop
* **DPD** – doručení na adresu i DPD Pickup místa
* **Další dopravci:** FedEx, TNT, UPS, Toptrans, Balíkovna, Liftago, WeDo

### Kde modul najdu?

{% hint style="info" %}
Modul je nutné nejprve nainstalovat ve **Správci rozšíření**. 
{% endhint %}

* V administraci otevřete **detail objednávky**.
* V horní liště (toolbaru) uvidíte akce pro **Zaslat.cz** (např. *Generovat zásilku*).

## Prvotní nastavení

{% stepper %}
{% step %}

### API klíč

V účtu Zaslat.cz si vygenerujte **API klíč** (v nastavení účtu) a vložte ho do nastavení modulu.
{% endstep %}

{% step %}

### Adresa pro vyzvednutí (svoz)

* Vyberte **adresu odesílatele / místo svozu**.
* Tato adresa se typicky vybírá z adresáře kontaktů v Zaslat.cz.
  {% endstep %}

{% step %}

### Režim svozu

Zvolte režim podle toho, jak máte u dopravců nastavený svoz:

* **Jednorázový svoz** – štítky obvykle tiskne dopravce
* **Příležitostný svoz** – štítky tisknete vy
* **Pravidelný svoz** – štítky tisknete vy

Poznámka: pokud je režim špatně, zásilka se může vytvořit chybně nebo vůbec.
{% endstep %}

{% step %}

### Způsob platby

Vyberte, jak chcete zásilky přes Zaslat.cz platit (např. kredit / faktura – podle toho, co máte u Zaslat.cz povoleno).
{% endstep %}

{% step %}

### IBAN pro dobírky (pokud používáte dobírku)

Pokud posíláte dobírky, vyplňte **IBAN**, kam má Zaslat.cz dobírky vyplácet.
{% endstep %}

{% step %}

### Mapování stavů pro tracking (doporučeno)

V nastavení trackingu si můžete nastavit, na jaký **stav objednávky** se má objednávka přepnout, když se zásilka doručí / je na doručení / je stornovaná.
{% endstep %}
{% endstepper %}

## Vytvoření zásilky z objednávky

{% stepper %}
{% step %}
Otevřete **detail objednávky**.
{% endstep %}

{% step %}
Klikněte na **Generovat zásilku** (Zaslat.cz).
{% endstep %}

{% step %}
Pokud je vše v pořádku, modul:

* vytvoří zásilku na Zaslat.cz
* uloží **tracking číslo** do objednávky
* (volitelně) změní stav objednávky na „expedováno“ podle nastavení

{% hint style="info" %}
Pokud něco chybí, zobrazí se **konkrétní důvod** (např. chybí telefon, adresa, PSČ…). Chybovou správu najdete i v *Historii objednávky*.
{% endhint %}
{% endstep %}
{% endstepper %}

## Hromadné generování zásilek

{% stepper %}
{% step %}
V seznamu objednávek označte objednávky, pro které chcete zásilky vytvořit.
{% endstep %}

{% step %}
Spusťte hromadnou akci **Generovat zásilky**.
{% endstep %}

{% step %}
Zobrazí se report, které objednávky prošly a které ne – u chyb uvidíte důvod.
{% endstep %}
{% endstepper %}

## Tisk štítku

* V detailu objednávky použijte akci **Tisk štítku**.
* Pokud máte nastavený režim svozu, kde štítky tisknete vy, štítek se vygeneruje a stáhnete si ho.

{% hint style="info" %}
Dostupnost tisku štítků závisí na režimu svozu a nastavení účtu u Zaslat.cz.
{% endhint %}

## Dobírka (COD)

Pokud je objednávka placená dobírkou, modul při vytváření zásilky automaticky přidá službu **dobírka**.

Podmínky pro fungování dobírky:

* objednávka musí být označená jako dobírka
* v nastavení modulu musí být vyplněný **IBAN** pro výplatu dobírek

## Sledování zásilek (tracking)

Modul umí průběžně sledovat stav zásilky a podle toho upravovat stav objednávky (pokud to máte nastavené).

Doporučení:

* Nastavte mapování stavů (např. „doručeno“, „na doručení“, „stornováno“).
* Sledujte, zda se objednávky správně přepínají podle reálného stavu zásilky.

## Nejčastější chyby a jak je vyřešit

<details>

<summary>„Chybí telefonní číslo příjemce“</summary>

Doplňte telefon v doručovací adrese (nebo v profilu zákazníka, pokud se odtud přebírá).

</details>

<details>

<summary>„Chybí e-mailová adresa zákazníka“</summary>

Doplňte e-mail u zákazníka.

</details>

<details>

<summary>„Chybí ulice / město / PSČ“</summary>

Zkontrolujte doručovací adresu v objednávce.

</details>

<details>

<summary>„Není nastavena adresa pro vyzvednutí (svoz)“</summary>

V nastavení modulu vyberte adresu pro svoz.

</details>

<details>

<summary>„Způsob dopravy nemá nastaven kód dopravce Zaslat.cz“</summary>

Zkontrolujte, že použitá doprava v objednávce je z doprav, které jsou napojené na Zaslat.cz.

</details>

<details>

<summary>„Chyba API Zaslat.cz: …“</summary>

Modul zobrazí zprávu přímo z API (často jde o validační chybu nebo nastavení účtu – např. nepovolený typ platby).

</details>