Expedice a tisk štítků nefunguje

Než začnete

• Přihlaste se do expediční aplikace jako správce nebo expedient.
• Ověřte připojení k internetu a dostupnost tiskárny štítků.
• Zjistěte, u kterého dopravce (DPD, Zásilkovna, PPL, Česká pošta, GLS) problém nastává.

Tiskárna není vidět v Depotu

• USB tiskárna — ovladač není nainstalovaný — stáhněte ovladač ze stránek výrobce (Zebra: zebra.com/setup, Gainscha: viz Instalace ovladačů Gainscha na Linuxu). Po instalaci restartujte tiskárnu i počítač.
• Tiskárna na síti (LAN/WiFi) — ověřte, že tiskárna má přiřazenou pevnou IP adresu. V nastavení tiskárny (web rozhraní na IP adrese tiskárny) zkontrolujte IP, masku a bránu. Pokud se IP mění, nastavte ji staticky nebo přidejte rezervaci v DHCP.
• Tiskárna viditelná v OS ale ne v Depotu — Expediční aplikace tiskne štítek jako PDF: v prohlížeči přes tiskový dialog, v desktopové aplikaci rovnou na vybranou tiskárnu přes systémový tisk. Ověřte, zda aplikace tiskárnu nabízí v seznamu dostupných zařízení. Pokud ne, nastavte ji jako výchozí tiskárnu v OS.
• Linux + Cups — ověřte, že tiskárna je přidána v CUPS (http://localhost:631) a Depoto má přístup k tiskovým frontám. Viz Instalace ovladačů tiskáren Gainscha na Linuxu.

Štítek se tiskne prázdný nebo je špatně formátovaný

• Špatná šířka papíru — Depoto a tiskárna musí mít nastavenu shodnou šířku štítku. Standardní šířky: 100×150 mm (DPD, PPL), 100×100 mm (Zásilkovna). V ovladači tiskárny (nebo ZPL konfiguraci) nastavte přesné rozměry média.
• DPI nesedí — tiskárny Zebra ZD220/ZD421 bývají 203 DPI, vyšší modely 300 DPI. Pokud je v Depotu jiné DPI než v tiskárně, čárový kód na štítku bude nečitelný nebo prázdný. Zkontrolujte, že DPI nastavené pro tisk odpovídá tiskárně.
• ZPL vs EPL — starší tiskárny Zebra používají EPL, novější ZPL. Pokud má tiskárna v ovladači nastavený jiný jazyk, než v jakém skutečně pracuje, tisk selže nebo vytiskne nečitelný text. Přepněte tiskárnu do ZPL módu (kombinace tlačítek při zapínání — viz manuál tiskárny).
• Prázdný štítek — tiskárna tiskne ale papír vyjede prázdný. Nejčastěji: tisk probíhá na nesprávnou stranu tepelného média. Otočte roli papíru (thermal side musí být na vnější straně).

Číslo zásilky na štítku chybí nebo dopravce čárový kód neuznává

• API klíč dopravce je prošlý nebo neplatný — číslo zásilky se generuje voláním API dopravce. Pokud API klíč expiroval, Depoto vrátí chybu a štítek se nevytiskne. Zkontrolujte přístupové údaje příslušného dopravce v Nastavení → Dopravci. U Zásilkovny se klíč mění v portálu zasilkovna.cz, u DPD kontaktujte obchodního zástupce DPD.
• Špatný tarif nebo způsob doručení — každý tarif (např. DPD Parcel vs. DPD Classic) má jiné parametry štítku. Pokud objednávka má tarif, pro který nemáte smlouvu s dopravcem, API vrátí chybu. Ověřte nastavení tarifu v Nastavení → Dopravci.
• Zásilka nevznikla v systému dopravce — štítek se vytiskl z cache, ale API volání selhalo. Zkontrolujte v detailu objednávky u balíku, zda má číslo zásilky: v Expediční aplikaci v záložce Položky u balíku, v klientské aplikaci v sekci Balíky ve sloupci Kód. Pokud chybí, nechte štítek vygenerovat znovu.
• Nesprávný formát čárového kódu — většina dopravců vyžaduje Code 128. Pokud čtečka dopravce kód neuznává, může být problém v hustotě tisku (DPI příliš nízké) nebo poškozené tiskové hlavě.
• Hláška „Chyba při stahování tiskových dat štítku. Ověřte správnost nastavení API dopravce“ — dopravce nevrátil štítek (účet, adresa, služba). Tiskárna za to nemůže; zkontrolujte nastavení dopravce a údaje objednávky.

Od 21. 10. 2026 skončí stažení štítku chybou s hláškou dopravce i tehdy, když Česká pošta tisk odmítne nebo Zásilkovna neodpovídá; prázdný štítek se už nevytiskne.

Hromadný tisk štítků

Pro tisk více štítků najednou (svodová sestava):

1. V expediční aplikaci přejděte do sekce Zabaleno.
2. Označte objednávky (zaškrtávácí políčka) nebo zvolte Označit vše.
3. Klikněte na Tisk štítků (hromadná akce).
4. Systém odešle všechny štítky do tiskové fronty — vytisknou se postupně.
5. Po tisku proveďte svoz pro vytvoření předávacích protokolů.

Pozor: Hromadný tisk funguje jen pro objednávky ve stavu Zabaleno, ne pro objednávky dřív v procesu (Přijaté, K vyskladnění, K zabalení).

Štítek vytištěn, zásilka ale nevznikla u dopravce

• API timeout při velkém objemu — při tisku desítek štítků najednou může API dopravce timeoutovat. Zásilka se vytiskne z lokální šablony bez čísla zásilky od dopravce. Řešení: tiskněte po menších dávkách, nebo použijte hromadné podání zásilek přímo v portálu dopravce.
• Zásilka v Depotu, ale ne v portálu dopravce — ověřte číslo zásilky u balíku v detailu objednávky (sekce Balíky). Pokud tracking číslo existuje, zásilka byla zaregistrována. Pokud chybí, zásilku znovu vygenerujte nebo ji ručně zadejte do portálu dopravce.
• Testovací režim nezapínáte vy – řídí ho server Depota. Pole pro testovací údaje (DPD, FedEx) se použijí jen v testovacím režimu serveru. Zda v něm server běží, poznáte z výsledku tlačítka Otestovat spojení s dopravcem v Nastavení → Dopravci: u výsledku je pak uvedeno „testovací režim“.

Výsledek

Po vyřešení problému ověřte: (1) štítek se vytiskne s čitelným čárovým kódem a správnými údaji dopravce, (2) v detailu objednávky je vyplněno tracking číslo, (3) zásilka je viditelná v portálu dopravce. Poté proveďte svoz a předejte zásilky dopravci.

Související články

• Svoz zásilek: jak předat zásilky dopravci a vytisknout protokol
• Jak funguje napojení na dopravce a tisk štítků
• Hardware pro sklad: tiskárny, čtečky, PDA a váhy
• Procesní stavy expedice
• FAQ a řešení problémů — přehled
• Expediční aplikace nereaguje / zamrzla