Zásilkovna, PPL a Česká pošta: tracking SMS s živým časem doručení

Zákazník v ČR po objednávce 4× zkontroluje stav balíku. Když dorazí SMS „Balík dorazí dnes mezi 14:00–16:00“, spokojenost stoupne o 23 % a objem hovorů na zákaznickou linku klesne o 41 %. 4notify napojí Zásilkovnu, PPL a Českou poštu do jedné pipeline — bez toho, abyste sledovali tři různé API a tři různé verze webhooku.

Problém

Každý český dopravce má vlastní webhook formát, vlastní seznam stavů a vlastní rate-limity. Bez jednotného konektoru píšete tři adaptéry a každý měsíc je upravujete, protože Zásilkovna přidala Z-BOX, PPL přejmenovala status nebo Česká pošta zavedla nové výjimky.

Právní rámec

Zákon č. 89/2012 Sb. § 2079 (kupní smlouva)

Prodávající musí kupujícího bez zbytečného odkladu informovat o předání zboží dopravci a o jeho doručení.

Zákon č. 634/1992 Sb. o ochraně spotřebitele

Spotřebitel má právo na informaci o reálném termínu doručení; nepravdivý ETA může být klamavá obchodní praktika.

GDPR čl. 6 odst. 1 písm. b

Tracking SMS je plnění smlouvy o doručení — opt-in marketing není potřeba, opt-out z transakční komunikace ale musí být dostupný.

Architektura

Unifikovaný status model

Webhooky od Zásilkovny, PPL a České pošty se normalizují do 7 univerzálních stavů: HANDED_OVER, IN_TRANSIT, ARRIVED_AT_PICKUP, OUT_FOR_DELIVERY, DELIVERED, RETURNED, EXCEPTION.

Živý ETA z geografie kurýra

U PPL „last-mile“ volání API vrací pozici vozu; 4notify dopočítá ETA na adresu příjemce a zařadí do textu SMS — „dorazí dnes mezi 14:00–16:00“.

Z-BOX a alternativní vyzvednutí

Při ARRIVED_AT_PICKUP nabízí 4notify alternativy — sousední pobočku, prodloužení skladu na 7+7 dní nebo doručení na adresu kurýrem.

Reakce na výjimku

EXCEPTION (nedostupný adresát, poškozený balík, návrat odesílateli) automaticky eskaluje na zákaznický tým s plným kontextem objednávky.

Kód

json
// 4notify universal carrier status (normalised from 3 carriers):
{
  "carrier": "zasilkovna",   // | "ppl" | "ceska_posta"
  "tracking_number": "Z1234567890",
  "order_id": "2026-CZ-0481",
  "status": "OUT_FOR_DELIVERY",
  "eta_window": {
    "from": "2026-05-29T14:00:00+02:00",
    "to":   "2026-05-29T16:00:00+02:00"
  },
  "pickup_location": null,
  "courier_phone": "+420774xxx",
  "events_history": [ ... ]
}