# 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://napoveda.rocketoo.cz/rocketoo/rozsireni/zaslat.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.